nette/http 3.3.4

Author: dg

http/cs/configuration.texy

@@ -108,6 +108,18 @@ http:
 ```
 
 
+Vynucení HTTPS .{data-version:3.3.4}
+------------------------------------
+
+Bezpodmínečně vynutí HTTPS schéma požadavku. Hodí se pro weby běžící výhradně na HTTPS za load balancerem nebo reverzní proxy, která terminuje TLS, ale neposílá hlavičku `X-Forwarded-Proto`, takže by standardní detekce HTTPS (ani s nastavenou [#HTTP proxy]) nezabrala.
+
+```neon
+http:
+	# vynutí HTTPS schéma u všech požadavků
+	forceHttps: true       # (bool) výchozí je false
+```
+
+
 Session
 =======
 

http/cs/request.texy

@@ -236,6 +236,7 @@ RequestFactory lze před zavoláním `fromGlobals()` konfigurovat:
 
 - metodou `$factory->setBinary()` vypnete automatické čištění vstupních parametrů od kontrolních znaků a neplatných UTF-8 sekvencí.
 - metodou `$factory->setProxy(...)` uvedete IP adresu [proxy serveru |configuration#HTTP proxy], což je nezbytné pro správnou detekci IP adresy uživatele.
+- metodou `$factory->setForceHttps()` .{data-version:3.3.4} vynutíte HTTPS schéma požadavku bez ohledu na prostředí serveru.
 
 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 například nesprávnou implementací komentářových systémů na různých webech:
 

http/en/configuration.texy

@@ -108,6 +108,18 @@ http:
 ```
 
 
+Force HTTPS .{data-version:3.3.4}
+---------------------------------
+
+Unconditionally forces the request scheme to HTTPS. This is useful for HTTPS-only sites running behind a load balancer or reverse proxy that terminates TLS but does not pass the `X-Forwarded-Proto` header, so the standard HTTPS detection (even with [#HTTP Proxy] configured) would not catch it.
+
+```neon
+http:
+	# force HTTPS scheme for all requests
+	forceHttps: true       # (bool) defaults to false
+```
+
+
 Session
 =======
 

http/en/request.texy

@@ -236,6 +236,7 @@ RequestFactory can be configured before calling `fromGlobals()`:
 
 - using the `$factory->setBinary()` method disables automatic cleansing of input parameters from control characters and invalid UTF-8 sequences.
 - using the `$factory->setProxy(...)` method specifies the IP address of the [proxy server |configuration#HTTP Proxy], which is necessary for correct detection of the user's IP address.
+- using the `$factory->setForceHttps()` .{data-version:3.3.4} method forces the request scheme to HTTPS regardless of the server environment.
 
 RequestFactory allows defining filters that automatically transform parts of the URL request. These filters remove unwanted characters from URLs that might have been inserted, for example, by incorrect implementations of comment systems on various websites: