.. include:: /Includes.rst.txt

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

===================================
$GLOBALS['TYPO3_CONF_VARS']['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.

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

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

.. confval:: allow_redirects

   :Path: $GLOBALS['TYPO3_CONF_VARS']['HTTP']
   :type: mixed

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


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

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

.. confval:: allow_redirects strict

   :Path: $GLOBALS['TYPO3_CONF_VARS']['HTTP']
   :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:

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

.. confval:: allow_redirects max

   :Path: $GLOBALS['TYPO3_CONF_VARS']['HTTP']
   :type: int
   :Default: 5

   Maximum number of tries before an exception is thrown.

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

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

.. confval:: cert

   :Path: $GLOBALS['TYPO3_CONF_VARS']['HTTP']
   :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<http//docs.guzzlephp.org/en/latest/request-options.html#cert>`

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

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

.. confval:: connect_timeout

   :Path: $GLOBALS['TYPO3_CONF_VARS']['HTTP']
   :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.

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

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

.. confval:: proxy

   :Path: $GLOBALS['TYPO3_CONF_VARS']['HTTP']
   :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:`AdditionalConfiguration.php`; see :ref:`typo3ConfVars-additionalConfiguration`
   for details.

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

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

.. confval:: ssl_key

   :Path: $GLOBALS['TYPO3_CONF_VARS']['HTTP']
   :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:

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

.. confval:: timeout

   :Path: $GLOBALS['TYPO3_CONF_VARS']['HTTP']
   :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:

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

.. confval:: verify

   :Path: $GLOBALS['TYPO3_CONF_VARS']['HTTP']
   :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:

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

.. confval:: version

   :Path: $GLOBALS['TYPO3_CONF_VARS']['HTTP']
   :type: text
   :Default: '1.1'

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