9.5/_http_utility_8php_source.html

<?php

namespace ‪TYPO3\CMS\Core\Utility;


/*

 * This file is part of the TYPO3 CMS project.

 *

 * It is free software; you can redistribute it and/or modify it under

 * the terms of the GNU General Public License, either version 2

 * of the License, or any later version.

 *

 * For the full copyright and license information, please read the

 * LICENSE.txt file that was distributed with this source code.

 *

 * The TYPO3 project - inspiring people to share!

 */


class ‪HttpUtility

{

    // HTTP Headers, see https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml

    // INFORMATIONAL CODES

    const ‪HTTP_STATUS_100 = 'HTTP/1.1 100 Continue';

    const ‪HTTP_STATUS_101 = 'HTTP/1.1 101 Switching Protocols';

    const ‪HTTP_STATUS_102 = 'HTTP/1.1 102 Processing';

    const ‪HTTP_STATUS_103 = 'HTTP/1.1 103 Early Hints';

    // SUCCESS CODES

    const ‪HTTP_STATUS_200 = 'HTTP/1.1 200 OK';

    const ‪HTTP_STATUS_201 = 'HTTP/1.1 201 Created';

    const ‪HTTP_STATUS_202 = 'HTTP/1.1 202 Accepted';

    const ‪HTTP_STATUS_203 = 'HTTP/1.1 203 Non-Authoritative Information';

    const ‪HTTP_STATUS_204 = 'HTTP/1.1 204 No Content';

    const ‪HTTP_STATUS_205 = 'HTTP/1.1 205 Reset Content';

    const ‪HTTP_STATUS_206 = 'HTTP/1.1 206 Partial Content';

    const ‪HTTP_STATUS_207 = 'HTTP/1.1 207 Multi-status';

    const ‪HTTP_STATUS_208 = 'HTTP/1.1 208 Already Reported';

    const ‪HTTP_STATUS_226 = 'HTTP/1.1 226 IM Used';

    // REDIRECTION CODES

    const ‪HTTP_STATUS_300 = 'HTTP/1.1 300 Multiple Choices';

    const ‪HTTP_STATUS_301 = 'HTTP/1.1 301 Moved Permanently';

    const ‪HTTP_STATUS_302 = 'HTTP/1.1 302 Found';

    const ‪HTTP_STATUS_303 = 'HTTP/1.1 303 See Other';

    const ‪HTTP_STATUS_304 = 'HTTP/1.1 304 Not Modified';

    const ‪HTTP_STATUS_305 = 'HTTP/1.1 305 Use Proxy';

    const ‪HTTP_STATUS_306 = 'HTTP/1.1 306 Switch Proxy'; // Deprecated

    const ‪HTTP_STATUS_307 = 'HTTP/1.1 307 Temporary Redirect';

    const ‪HTTP_STATUS_308 = 'HTTP/1.1 308 Permanent Redirect';

    // CLIENT ERROR

    const ‪HTTP_STATUS_400 = 'HTTP/1.1 400 Bad Request';

    const ‪HTTP_STATUS_401 = 'HTTP/1.1 401 Unauthorized';

    const ‪HTTP_STATUS_402 = 'HTTP/1.1 402 Payment Required';

    const ‪HTTP_STATUS_403 = 'HTTP/1.1 403 Forbidden';

    const ‪HTTP_STATUS_404 = 'HTTP/1.1 404 Not Found';

    const ‪HTTP_STATUS_405 = 'HTTP/1.1 405 Method Not Allowed';

    const ‪HTTP_STATUS_406 = 'HTTP/1.1 406 Not Acceptable';

    const ‪HTTP_STATUS_407 = 'HTTP/1.1 407 Proxy Authentication Required';

    const ‪HTTP_STATUS_408 = 'HTTP/1.1 408 Request Timeout';

    const ‪HTTP_STATUS_409 = 'HTTP/1.1 409 Conflict';

    const ‪HTTP_STATUS_410 = 'HTTP/1.1 410 Gone';

    const ‪HTTP_STATUS_411 = 'HTTP/1.1 411 Length Required';

    const ‪HTTP_STATUS_412 = 'HTTP/1.1 412 Precondition Failed';

    const ‪HTTP_STATUS_413 = 'HTTP/1.1 413 Request Entity Too Large';

    const ‪HTTP_STATUS_414 = 'HTTP/1.1 414 URI Too Long';

    const ‪HTTP_STATUS_415 = 'HTTP/1.1 415 Unsupported Media Type';

    const ‪HTTP_STATUS_416 = 'HTTP/1.1 416 Requested range not satisfiable';

    const ‪HTTP_STATUS_417 = 'HTTP/1.1 417 Expectation Failed';

    const ‪HTTP_STATUS_418 = 'HTTP/1.1 418 I\'m a teapot';

    const ‪HTTP_STATUS_422 = 'HTTP/1.1 422 Unprocessable Entity';

    const ‪HTTP_STATUS_423 = 'HTTP/1.1 423 Locked';

    const ‪HTTP_STATUS_424 = 'HTTP/1.1 424 Failed Dependency';

    const ‪HTTP_STATUS_425 = 'HTTP/1.1 425 Unordered Collection';

    const ‪HTTP_STATUS_426 = 'HTTP/1.1 426 Upgrade Required';

    const ‪HTTP_STATUS_428 = 'HTTP/1.1 428 Precondition Required';

    const ‪HTTP_STATUS_429 = 'HTTP/1.1 429 Too Many Requests';

    const ‪HTTP_STATUS_431 = 'HTTP/1.1 431 Request Header Fields Too Large';

    const ‪HTTP_STATUS_451 = 'HTTP/1.1 451 Unavailable For Legal Reasons';

    // SERVER ERROR

    const ‪HTTP_STATUS_500 = 'HTTP/1.1 500 Internal Server Error';

    const ‪HTTP_STATUS_501 = 'HTTP/1.1 501 Not Implemented';

    const ‪HTTP_STATUS_502 = 'HTTP/1.1 502 Bad Gateway';

    const ‪HTTP_STATUS_503 = 'HTTP/1.1 503 Service Unavailable';

    const ‪HTTP_STATUS_504 = 'HTTP/1.1 504 Gateway Time-out';

    const ‪HTTP_STATUS_505 = 'HTTP/1.1 505 Version not Supported';

    const ‪HTTP_STATUS_506 = 'HTTP/1.1 506 Variant Also Negotiates';

    const ‪HTTP_STATUS_507 = 'HTTP/1.1 507 Insufficient Storage';

    const ‪HTTP_STATUS_508 = 'HTTP/1.1 508 Loop Detected';

    const ‪HTTP_STATUS_509 = 'HTTP/1.1 509 Bandwidth Limit Exceeded';

    const ‪HTTP_STATUS_511 = 'HTTP/1.1 511 Network Authentication Required';

    // URL Schemes

    const ‪SCHEME_HTTP = 1;

    const ‪SCHEME_HTTPS = 2;


    public static function ‪redirect($url, $httpStatus = self::HTTP_STATUS_303)

    {

        ‪self::setResponseCode($httpStatus);

        header('Location: ' . GeneralUtility::locationHeaderUrl($url));

        die;

    }


    public static function ‪setResponseCode($httpStatus = self::HTTP_STATUS_303)

    {

        header($httpStatus);

    }


    public static function ‪setResponseCodeAndExit($httpStatus = self::HTTP_STATUS_303)

    {

        ‪self::setResponseCode($httpStatus);

        die;

    }


    public static function ‪buildUrl(array $urlParts)

    {

        return (isset($urlParts['scheme']) ? $urlParts['scheme'] . '://' : '') .

            (isset($urlParts['user']) ? $urlParts['user'] .

            (isset($urlParts['pass']) ? ':' . $urlParts['pass'] : '') . '@' : '') .

            ($urlParts['host'] ?? '') .

            (isset($urlParts['port']) ? ':' . $urlParts['port'] : '') .

            ($urlParts['path'] ?? '') .

            (isset($urlParts['query']) ? '?' . $urlParts['query'] : '') .

            (isset($urlParts['fragment']) ? '#' . $urlParts['fragment'] : '');

    }


    public static function ‪buildQueryString(array $parameters, string $prependCharacter = '', bool $skipEmptyParameters = false): string

    {

        if (empty($parameters)) {

            return '';

        }


        if ($skipEmptyParameters) {

            // This callback filters empty strings, array and null but keeps zero integers

            $parameters = ‪ArrayUtility::filterRecursive(

                $parameters,

                function ($item) {

                    return $item !== '' && $item !== [] && $item !== null;

                }

            );

        }


        $queryString = http_build_query($parameters, '', '&', PHP_QUERY_RFC3986);

        $prependCharacter = $prependCharacter === '?' || $prependCharacter === '&' ? $prependCharacter : '';


        return $queryString && $prependCharacter ? $prependCharacter . $queryString : $queryString;

    }


    public static function ‪idn_to_ascii(string $domain)

    {

        if (defined('INTL_IDNA_VARIANT_UTS46') && !defined('TYPO3_IDN_TO_ASCII_USE_COMPAT')) {

            return ‪idn_to_ascii($domain, IDNA_DEFAULT, INTL_IDNA_VARIANT_UTS46);

        }

        // This is done due to some heavy old systems where native functionality is there, but does not support UTS46 yet.

        if (!defined('TYPO3_IDN_TO_ASCII_USE_COMPAT')) {

            define('TYPO3_IDN_TO_ASCII_USE_COMPAT', true);

        }

        if (!defined('INTL_IDNA_VARIANT_UTS46')) {

            define('INTL_IDNA_VARIANT_UTS46', 1);

        }

        $result = [];

        return \Symfony\Polyfill\Intl\Idn\Idn::idn_to_ascii($domain, IDNA_DEFAULT, INTL_IDNA_VARIANT_UTS46, $result);

    }

}