HTTP - tune requests
HTTP configuration to tune how TYPO3 behaves on HTTP requests made by TYPO3. See Guzzle documentation for more background information on many of those settings.
Note
The configuration values listed here are keys in the global PHP array
$GLOBALS.
This variable can be set in one of the following files:
allow_redirects
-
- Type
- mixed
- Path
- $GLOBALS['TYPO3_CONF_VARS']['HTTP']['allow_redirects']
Mixed, set to false if you want to disallow redirects, or use it as an array to add more configuration values (see below).
-
- Type
- bool
- Default
- false
- Path
- $GLOBALS['TYPO3_CONF_VARS']['HTTP']['allow_redirects']['strict']
Whether to keep request method on redirects via status 301 and 302
TRUE- Strict RFC compliant redirects mean that POST redirect requests are sent as POST requests. This is needed for compatibility with RFC 2616)
FALSE- redirect POST requests with GET requests, needed for compatibility with most browsers
-
- Type
- int
- Default
- 5
- Path
- $GLOBALS['TYPO3_CONF_VARS']['HTTP']['allow_redirects']['max']
Maximum number of tries before an exception is thrown.
allowed_hosts
-
- Type
- array / null
- Path
- $GLOBALS['TYPO3_CONF_VARS']['HTTP']['allowed_hosts']
This option is not passed on to guzzle. Instead, it configures an array of allowed hosts to interact with TYPO3.
-
- Type
- array / null
- Default
- null
- Path
- $GLOBALS['TYPO3_CONF_VARS']['HTTP']['allowed_hosts']['webhooks']
For now, the only supported array key is
webhooksto configure an array of valid hostnames that webhooks ofEXT:are allowed to connect to (see forge#106229 as a protection against DNS rebinding).webhooks Wildcards in the array values are allowed, like
*..example. com An empty array is allowed, but in that case it is better to actually remove the
EXT:extension (all hosts are blocked).webhooks Setting this option to null (or having it unset) is the default, and will allow any connection.
cert
-
- Type
- mixed
- Default
- null
- Path
- $GLOBALS['TYPO3_CONF_VARS']['HTTP']['cert']
Set to a string to specify the path to a file containing a PEM formatted client side certificate. See Guzzle option cert
connect_timeout
-
- Type
- int
- Default
- 10
- Path
- $GLOBALS['TYPO3_CONF_VARS']['HTTP']['connect_timeout']
Default timeout for connection in seconds. Exception will be thrown if connecting to a remote host.
proxy
-
- Type
- mixed
- Default
- null
- Path
- $GLOBALS['TYPO3_CONF_VARS']['HTTP']['proxy']
Enter a single proxy server as string, for example
'proxy.example. org' Multiple proxies for different protocols can be added separately as an array as authentication and port; see Guzzle documentation for details.
The configuration with an array must be made in the
config/; see File config/system/additional.php for details.system/ additional. php
ssl_key
-
- Type
- mixed
- Default
- null
- Path
- $GLOBALS['TYPO3_CONF_VARS']['HTTP']['ssl_key']
Local certificate and an optional passphrase, see Guzzle option ssl-key
timeout
-
- Type
- int
- Default
- 0
- Path
- $GLOBALS['TYPO3_CONF_VARS']['HTTP']['timeout']
Default timeout for whole request. Exception will be thrown if sending the request takes more than this number of seconds.
Should be greater than the connection timeout or
0to not set a limit.
verify
-
- Type
- mixed
- Default
- true
- Path
- $GLOBALS['TYPO3_CONF_VARS']['HTTP']['verify']
Describes the SSL certificate verification behavior of a request, see Guzzle option verify
version
-
- Type
- text
- Default
- '1.1'
- Path
- $GLOBALS['TYPO3_CONF_VARS']['HTTP']['version']
Default HTTP protocol version. Use either "1.0" or "1.1".