wip

Author: dg

http/cs/request.texy

@@ -4,9 +4,9 @@ HTTP request
 .[perex]
 Nette zapouzdřuje HTTP požadavek do objektů se srozumitelným API a zároveň poskytuje sanitizační filtr.
 
-HTTP požadavek představuje objekt [api:Nette\Http\Request], ke kterému se dostanete tak, že si jej necháte předat pomocí [dependency injection |dependency-injection:passing-dependencies]. V presenterech stačí jen zavolat `$httpRequest = $this->getHttpRequest()`.
+HTTP požadavek představuje objekt [api:Nette\Http\Request]. Pokud pracujete s Nette Frameworkem, tento objekt je automaticky vytvořen frameworkem a můžete si jej nechat předat pomocí [dependency injection |dependency-injection:passing-dependencies]. V presenterech dokonce stačí jen zavolat metodu `$this->getHttpRequest()`. Pokud pracujete mimo Nette Framework, můžete si vytvořit objekt pomocí [RequestFactory|#RequestFactory].
 
-Co je důležité, tak že Nette když [vytváří|#RequestFactory] tento objekt, všechny vstupní parametry GET, POST, COOKIE a také URL pročistí od kontrolních znaků a neplatných UTF-8 sekvencí. Takže s daty pak můžete bezpečně dále pracovat. Očištěná data se následně používají v presenterech a formulářích.
+Velkou předností Nette je, že při vytváření objektu automaticky pročišťuje všechny vstupní parametry GET, POST, COOKIE a také URL od kontrolních znaků a neplatných UTF-8 sekvencí. S těmito daty pak můžete bezpečně dále pracovat. Očištěná data se následně používají v presenterech a formulářích.
 
 → [Instalace a požadavky |@home#Instalace]
 

http/cs/urls.texy

@@ -131,7 +131,7 @@ Url::removeDotSegments('./today/../file.txt');          // 'file.txt'
 UrlImmutable
 ============
 
-Třída [api:Nette\Http\UrlImmutable] je immutable (neměnnou) alternativou třídy `Url` (podobně jako je v PHP `DateTimeImmutable` neměnnou alternativou `DateTime`). Místo setterů má tzv. withery, které objekt nemění, ale vracejí nové instance s upravenou hodnotou:
+Třída [api:Nette\Http\UrlImmutable] je immutable (neměnnou) alternativou třídy [#Url] (podobně jako je v PHP `DateTimeImmutable` neměnnou alternativou `DateTime`). Místo setterů má tzv. withery, které objekt nemění, ale vracejí nové instance s upravenou hodnotou:
 
 ```php
 use Nette\Http\UrlImmutable;
@@ -230,7 +230,9 @@ $url->isEqual('https://nette.org');
 UrlScript
 =========
 
-Třída [api:Nette\Http\UrlScript] je potomkem `UrlImmutable` a navíc rozlišuje tyto další logické části URL:
+Třída [api:Nette\Http\UrlScript] je potomkem [#UrlImmutable] a rozšiřuje jej o další virtuální komponenty URL, jako je kořenový adresáři projektu apod. Stejně jako rodičovská třída je immutable (neměnným) objektem.
+
+Následující diagram zobrazuje komponenty, které UrlScript rozpoznává:
 
 /--pre
       baseUrl    basePath  relativePath  relativeUrl
@@ -242,6 +244,13 @@ Třída [api:Nette\Http\UrlScript] je potomkem `UrlImmutable` a navíc rozlišuj
                    scriptPath       pathInfo
 \--
 
+- **baseUrl** - základní URL adresa aplikace včetně domény a části cesty ke kořenovému adresáři aplikace
+- **basePath** - části cesty ke kořenovému adresáři aplikace
+- **scriptPath** - cesta k aktuálnímu skriptu
+- **relativePath** - název skriptu (případně další segmenty cesty) relativní k basePath
+- **relativeUrl** - celá část URL za baseUrl, včetně query string a fragmentu.
+- **pathInfo** - část URL za názvem skriptu, dnes už moc nepoužívaná
+
 Pro vrácení částí URL jsou k dispozici metody:
 
 .[language-php]
@@ -254,4 +263,4 @@ Pro vrácení částí URL jsou k dispozici metody:
 | `getRelativeUrl(): string`	| `'script.php/pathinfo/?name=param#footer'`
 | `getPathInfo(): string`		| `'/pathinfo/'`
 
-Objekty `UrlScript` přímo nevytváříme, ale vrací jej metoda [Nette\Http\Request::getUrl()|request].
+Objekty `UrlScript` obvykle přímo nevytváříme, ale vrací jej metoda [Nette\Http\Request::getUrl()|request] s již správně nastavenými komponentami pro aktuální HTTP požadavek.