---
title: "HTTP - tune requests"
manual: "TYPO3 Explained"
version: "11.5"
permalink: "https://docs.typo3.org/permalink/t3coreapi:typo3confvars-http@11.5"
source: "Configuration/Typo3ConfVars/HTTP.rst"
rendered: "2026-10-21T15:30:00+00:00"
---

> [!WARNING]
> **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](https://typo3.com/services/extended-support-elts).

# HTTP - tune requests {#typo3confvars-http}

HTTP configuration to tune how TYPO3 behaves on HTTP requests made by TYPO3.
See [Guzzle documentation](https://docs.guzzlephp.org/en/latest/request-options.html)
for more background information on those settings.

-   [allow_redirects](https://docs.typo3.org/permalink/t3coreapi:allow-redirects@11.5)
-   [cert](https://docs.typo3.org/permalink/t3coreapi:cert@11.5)
-   [connect_timeout](https://docs.typo3.org/permalink/t3coreapi:connect-timeout@11.5)
-   [proxy](https://docs.typo3.org/permalink/t3coreapi:proxy@11.5)
-   [ssl_key](https://docs.typo3.org/permalink/t3coreapi:ssl-key@11.5)
-   [timeout](https://docs.typo3.org/permalink/t3coreapi:timeout@11.5)
-   [verify](https://docs.typo3.org/permalink/t3coreapi:verify@11.5)
-   [version](https://docs.typo3.org/permalink/t3coreapi:version@11.5)

> [!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:
>
> -   [typo3conf/LocalConfiguration.php](https://docs.typo3.org/permalink/t3coreapi:typo3confvars-localconfiguration@11.5)
> -   [typo3conf/AdditionalConfiguration.php](https://docs.typo3.org/permalink/t3coreapi:typo3confvars-additionalconfiguration@11.5)

## allow_redirects {#typo3confvars-http-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 {#typo3confvars-http-allow-redirects-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](https://datatracker.ietf.org/doc/html/rfc2616/))

    -   **`FALSE`**

        redirect POST requests with GET requests,
        needed for compatibility with most browsers

### max {#typo3confvars-http-allow-redirects-max}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['HTTP'\]\['allow_redirects'\]\['max'\]**

    -   *type:* int
    -   *Default:* 5

    Maximum number of tries before an exception is thrown.

## cert {#typo3confvars-http-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](https://docs.guzzlephp.org/en/latest/request-options.html#cert)

## connect_timeout {#typo3confvars-http-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 {#typo3confvars-http-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](https://docs.guzzlephp.org/en/latest/request-options.html#proxy)
    for details.

    The configuration with an array must be made in the
    `AdditionalConfiguration.php`; see [File AdditionalConfiguration.php](https://docs.typo3.org/permalink/t3coreapi:typo3confvars-additionalconfiguration@11.5)
    for details.

## ssl_key {#typo3confvars-http-ssl-key}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['HTTP'\]\['ssl_key'\]**

    -   *type:* mixed
    -   *Default:* null

    Local certificate and an optional passphrase, see
    [Guzzle option ssl-key](https://docs.guzzlephp.org/en/latest/request-options.html#ssl-key)

## timeout {#typo3confvars-http-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](https://docs.typo3.org/permalink/t3coreapi:typo3confvars-http-connect-timeout@11.5) or
    `0` to not set a limit.

## verify {#typo3confvars-http-verify}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['HTTP'\]\['verify'\]**

    -   *type:* mixed
    -   *Default:* true

    Describes the SSL certificate verification behavior of a request, see
    [Guzzle option verify](https://docs.guzzlephp.org/en/latest/request-options.html#verify)

## version {#typo3confvars-http-version}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['HTTP'\]\['version'\]**

    -   *type:* text
    -   *Default:* '1.1'

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