Attention

TYPO3 v11 has reached end-of-life as of October 31th 2024 and is no longer being maintained. Use the version switcher on the top left of this page to select documentation for a supported version of TYPO3.

Need more time before upgrading? You can purchase Extended Long Term Support (ELTS) for TYPO3 v11 here: TYPO3 ELTS.

HTTP - tune requests

HTTP configuration to tune how TYPO3 behaves on HTTP requests made by TYPO3. See Guzzle documentation for more background information on those settings.

Note

The configuration values listed here are keys in the global PHP array $GLOBALS['TYPO3_CONF_VARS']['HTTP'] .

This variable can be set in one of the following files:

allow_redirects

$GLOBALS['TYPO3_CONF_VARS']['HTTP']['allow_redirects']

type: mixed

Mixed, set to false if you want to disallow redirects, or use it as an array to add more configuration values (see below).

strict

$GLOBALS['TYPO3_CONF_VARS']['HTTP']['allow_redirects']['strict']

type: bool
Default: false

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

max

$GLOBALS['TYPO3_CONF_VARS']['HTTP']['allow_redirects']['max']

type: int
Default: 5

Maximum number of tries before an exception is thrown.

cert

$GLOBALS['TYPO3_CONF_VARS']['HTTP']['cert']

type: mixed
Default: null

Set to a string to specify the path to a file containing a PEM formatted client side certificate. See Guzzle option cert

connect_timeout

$GLOBALS['TYPO3_CONF_VARS']['HTTP']['connect_timeout']

type: int
Default: 10

Default timeout for connection in seconds. Exception will be thrown if connecting to a remote host takes longer then this timeout.

proxy

$GLOBALS['TYPO3_CONF_VARS']['HTTP']['proxy']

type: mixed
Default: null

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 AdditionalConfiguration.php; see File AdditionalConfiguration.php for details.

ssl_key

$GLOBALS['TYPO3_CONF_VARS']['HTTP']['ssl_key']

type: mixed
Default: null

Local certificate and an optional passphrase, see Guzzle option ssl-key

timeout

$GLOBALS['TYPO3_CONF_VARS']['HTTP']['timeout']

type: int
Default

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 0 to not set a limit.

verify

$GLOBALS['TYPO3_CONF_VARS']['HTTP']['verify']

type: mixed
Default: true

Describes the SSL certificate verification behavior of a request, see Guzzle option verify

version

$GLOBALS['TYPO3_CONF_VARS']['HTTP']['version']

type: text
Default: '1.1'

Default HTTP protocol version. Use either "1.0" or "1.1".