.. include:: /Includes.rst.txt

.. index::
   TYPO3_CONF_VARS; HTTP
   TYPO3_CONF_VARS HTTP
.. _typo3ConfVars_http:

====================
HTTP - tune requests
====================

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.

..  contents::
    :local:

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

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

    *   :ref:`config/system/settings.php <typo3ConfVars-settings>`
    *   :ref:`config/system/additional.php <typo3ConfVars-additional>`


.. index::
   TYPO3_CONF_VARS HTTP; allow_redirects
.. _typo3ConfVars_http_allow_redirects:

allow_redirects
===============

.. confval:: $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).

.. index::
   TYPO3_CONF_VARS HTTP; allow_redirects strict
.. _typo3ConfVars_http_allow_redirects_strict:

strict
------

.. confval:: $GLOBALS['TYPO3_CONF_VARS']['HTTP']['allow_redirects']['strict']

   :type: bool
   :Default: false

   Whether to keep request method on redirects via status 301 and 302

   :php:`TRUE`
      Strict RFC compliant redirects mean that POST redirect requests are
      sent as POST requests. This is needed for compatibility with
      `RFC 2616 <http://www.faqs.org/rfcs/rfc2616>`__)
   :php:`FALSE`
      redirect POST requests with GET requests,
      needed for compatibility with most browsers

.. index::
   TYPO3_CONF_VARS HTTP; allow_redirects max
.. _typo3ConfVars_http_allow_redirects_max:

max
---

.. confval:: $GLOBALS['TYPO3_CONF_VARS']['HTTP']['allow_redirects']['max']

   :type: int
   :Default: 5

   Maximum number of tries before an exception is thrown.

.. index::
   TYPO3_CONF_VARS HTTP; cert
.. _typo3ConfVars_http_cert:

cert
====

.. confval:: $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>`__

.. index::
   TYPO3_CONF_VARS HTTP; connect_timeout
.. _typo3ConfVars_http_connect_timeout:

connect_timeout
===============

.. confval:: $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 than this timeout.

.. index::
   TYPO3_CONF_VARS HTTP; proxy
.. _typo3ConfVars_http_proxy:

proxy
=====

.. confval:: $GLOBALS['TYPO3_CONF_VARS']['HTTP']['proxy']

   :type: mixed
   :Default: null

   Enter a single proxy server as string, for example :php:`'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
   :file:`config/system/additional.php`; see :ref:`typo3ConfVars-additional`
   for details.

.. index::
   TYPO3_CONF_VARS HTTP; ssl_key
.. _typo3ConfVars_http_ssl_key:

ssl_key
=======

.. confval:: $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>`__

.. index::
   TYPO3_CONF_VARS HTTP; timeout
.. _typo3ConfVars_http_timeout:

timeout
=======

.. confval:: $GLOBALS['TYPO3_CONF_VARS']['HTTP']['timeout']

   :type: int
   :Default: 0

   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
   :ref:`connection timeout<typo3ConfVars_http_connect_timeout>` or
   :php:`0` to not set a limit.

.. index::
   TYPO3_CONF_VARS HTTP; verify
.. _typo3ConfVars_http_verify:

verify
======

.. confval:: $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>`__

.. index::
   TYPO3_CONF_VARS HTTP; version
.. _typo3ConfVars_http_version:

version
=======

.. confval:: $GLOBALS['TYPO3_CONF_VARS']['HTTP']['version']

   :type: text
   :Default: '1.1'

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