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, tento objekt je automaticky vytvořen frameworkem a můžete si jej nechat předat pomocí [dependency injection |dependency-injection:passing-dependencies]. V presenterech 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]
 
@@ -199,28 +199,36 @@ echo $httpRequest->detectLanguage($langs); // en
 RequestFactory
 ==============
 
-Objekt aktuálního HTTP requestu vyrobí [api:Nette\Http\RequestFactory]. Pokud píšete aplikaci, která nepoužívá DI kontejner, vyrobíte request takto:
+Třída [api:Nette\Http\RequestFactory] slouží k vytvoření instance `Nette\Http\Request`, která reprezentuje aktuální HTTP požadavek. (Pokud pracujete s Nette, objekt HTTP požadavku je automaticky vytvořen frameworkem.)
 
 ```php
 $factory = new Nette\Http\RequestFactory;
 $httpRequest = $factory->fromGlobals();
 ```
 
-RequestFactory lze před zavoláním `fromGlobals()` konfigurovat. Můžeme vypnout sanitizaci vstupních parametrů od kontrolních znaků a neplatných UTF-8 sekvencí pomocí `$factory->setBinary()`. A také nastavit proxy server pomocí `$factory->setProxy(...)`, což je důležité pro správnou detekci IP adresy uživatele.
+Metoda `fromGlobals()` vytvoří objekt požadavku na základě aktuálních globálních proměnných PHP (`$_GET`, `$_POST`, `$_COOKIE`, `$_FILES` a `$_SERVER`). 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í, což zajišťuje bezpečnost při další práci s těmito daty.
 
-Pomocí tzv. filtrů lze URL vyčistit od znaků, které se do něj mohou dostat např. kvůli špatně implementovaným komentářovým systémům na různých cizích webech:
+RequestFactory lze před zavoláním `fromGlobals()` konfigurovat:
+
+1. **Vypnutí sanitizace vstupů** - metodou `$factory->setBinary()` vypnete automatické čištění vstupních parametrů od kontrolních znaků a neplatných UTF-8 sekvencí.
+
+2. **Informace o proxy serveru** - metodou `$factory->setProxy(...)` sdělíte factory, jakou proxy server používáte, což je nezbytné pro správnou detekci IP adresy uživatele.
+
+RequestFactory umožňuje definovat filtry, které automaticky transformují části URL požadavku. Tyto filtry odstraňují nežádoucí znaky z URL, které tam mohou být vloženy nesprávnou například implementací komentářových systémů na různých webech:
 
 ```php
-// odstraníme mezery z cesty
+// odstranění mezer z cesty
 $requestFactory->urlFilters['path']['%20'] = '';
 
-// odstraníme tečku, čárku nebo pravou závorku z konce URI
+// odstranění tečky, čárky nebo pravé závorky z konce URI
 $requestFactory->urlFilters['url']['[.,)]$'] = '';
 
-// vyčistíme cestu od zdvojených lomítek (výchozí filtr)
+// vyčištění cesty od zdvojených lomítek (výchozí filtr)
 $requestFactory->urlFilters['path']['/{2,}'] = '/';
 ```
 
+První klíč (`'path'` nebo `'url'`) určuje, na kterou část URL se má filtr použít. Druhý klíč je regulární výraz, který se má vyhledat, a hodnota je náhrada, která se použije místo nalezeného textu.
+
 
 Uploadované soubory
 ===================

http/cs/response.texy

@@ -4,7 +4,7 @@ HTTP response
 .[perex]
 Nette zapouzdřuje HTTP odpověď do objektů se srozumitelným API.
 
-HTTP odpověď představuje objekt [api:Nette\Http\Response], 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 `$httpResponse = $this->getHttpResponse()`.
+HTTP odpověď představuje objekt [api:Nette\Http\Response]. Pokud pracujete s Nette, tento objekt je automaticky vytvořen frameworkem a můžete si jej nechat předat pomocí [dependency injection |dependency-injection:passing-dependencies]. V presenterech stačí jen zavolat metodu `$this->getHttpResponse()`.
 
 → [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` je základní URL adresa aplikace včetně domény a části cesty ke kořenovému adresáři aplikace
+- `basePath` je část cesty ke kořenovému adresáři aplikace
+- `scriptPath` je cesta k aktuálnímu skriptu
+- `relativePath` je název skriptu (případně další segmenty cesty) relativní k basePath
+- `relativeUrl` je celá část URL za baseUrl, včetně query string a fragmentu.
+- `pathInfo` dnes už málo využívaná část URL za názvem skriptu
+
 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.