httpclient.php

См. документацию.

<?php

 
namespace Bitrix\Main\Web;
 
use Bitrix\Main\IO;
use Bitrix\Main\Config\Configuration;
use Bitrix\Main\ArgumentException;
use Psr\Log;
use Psr\Http\Message\RequestInterface;
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Client\ClientInterface;
use Psr\Http\Client\ClientExceptionInterface;
use Psr\Http\Client\NetworkExceptionInterface;
use Http\Promise\Promise as PromiseInterface;
 
class HttpClient implements Log\LoggerAwareInterface, ClientInterface, Http\DebugInterface
{
    use Log\LoggerAwareTrait;
    use Http\DebugInterfaceTrait;
 
    const HTTP_1_0 = '1.0';
    const HTTP_1_1 = '1.1';
 
    const HTTP_GET = 'GET';
    const HTTP_POST = 'POST';
    const HTTP_PUT = 'PUT';
    const HTTP_HEAD = 'HEAD';
    const HTTP_PATCH = 'PATCH';
    const HTTP_DELETE = 'DELETE';
    const HTTP_OPTIONS = 'OPTIONS';
 
    const DEFAULT_SOCKET_TIMEOUT = 30;
    const DEFAULT_STREAM_TIMEOUT = 60;
    const DEFAULT_STREAM_TIMEOUT_NO_WAIT = 1;
 
    protected $proxyHost = '';
    protected $proxyPort = 80;
    protected $proxyUser = '';
    protected $proxyPassword = '';
    protected $socketTimeout = self::DEFAULT_SOCKET_TIMEOUT;
    protected $streamTimeout = self::DEFAULT_STREAM_TIMEOUT;
    protected $waitResponse = true;
    protected $redirect = true;
    protected $redirectMax = 5;
    protected $redirectCount = 0;
    protected $compress = false;
    protected $version = self::HTTP_1_1;
    protected $requestCharset = '';
    protected $sslVerify = true;
    protected $bodyLengthMax = 0;
    protected $privateIp = true;
    protected $contextOptions = [];
    protected $outputStream = null;
    protected $useCurl = false;
    protected $curlLogFile = null;
    protected $shouldFetchBody = null;
    protected $sendEvents = true;
    protected Http\ResponseBuilderInterface $responseBuilder;
 
    protected HttpHeaders $headers;
    protected ?Http\Request $request = null;
    protected ?Http\Response $response = null;
    protected ?Http\Queue $queue = null;
    protected ?IpAddress $effectiveIp = null;
    protected $effectiveUrl;
    protected $error = [];

    public function __construct(array $options = null)
    {
        $this->headers = new HttpHeaders();
 
        if ($options === null)
        {
            $options = [];
        }
 
        $defaultOptions = Configuration::getValue('http_client_options');
        if ($defaultOptions !== null)
        {
            $options += $defaultOptions;
        }
 
        if (!empty($options))
        {
            if (isset($options['redirect']))
            {
                $this->setRedirect($options["redirect"], $options["redirectMax"] ?? null);
            }
            if (isset($options['waitResponse']))
            {
                $this->waitResponse($options['waitResponse']);
            }
            if (isset($options['socketTimeout']))
            {
                $this->setTimeout($options['socketTimeout']);
            }
            if (isset($options['streamTimeout']))
            {
                $this->setStreamTimeout($options['streamTimeout']);
            }
            if (isset($options['version']))
            {
                $this->setVersion($options['version']);
            }
            if (isset($options['proxyHost']))
            {
                $this->setProxy($options['proxyHost'], $options['proxyPort'] ?? null, $options['proxyUser'] ?? null, $options['proxyPassword'] ?? null);
            }
            if (isset($options['compress']))
            {
                $this->setCompress($options['compress']);
            }
            if (isset($options['charset']))
            {
                $this->setCharset($options['charset']);
            }
            if (isset($options['disableSslVerification']) && $options['disableSslVerification'] === true)
            {
                $this->disableSslVerification();
            }
            if (isset($options['bodyLengthMax']))
            {
                $this->setBodyLengthMax($options['bodyLengthMax']);
            }
            if (isset($options['privateIp']))
            {
                $this->setPrivateIp($options['privateIp']);
            }
            if (isset($options['debugLevel']))
            {
                $this->setDebugLevel((int)$options['debugLevel']);
            }
            if (isset($options['cookies']))
            {
                $this->setCookies($options['cookies']);
            }
            if (isset($options['headers']))
            {
                $this->setHeaders($options['headers']);
            }
            if (isset($options['useCurl']))
            {
                $this->useCurl = (bool)$options['useCurl'];
            }
            if (isset($options['curlLogFile']))
            {
                $this->curlLogFile = $options['curlLogFile'];
            }
            if (isset($options['sendEvents']))
            {
                $this->sendEvents = (bool)$options['sendEvents'];
            }
            if (isset($options['responseBuilder']))
            {
                $this->setResponseBuilder($options['responseBuilder']);
            }
        }
 
        if ($this->useCurl && !function_exists('curl_init'))
        {
            $this->useCurl = false;
        }
    }

    public function get($url)
    {
        if ($this->query(Http\Method::GET, $url))
        {
            return $this->getResult();
        }
        return false;
    }

    public function head($url)
    {
        if ($this->query(Http\Method::HEAD, $url))
        {
            return $this->getHeaders();
        }
        return false;
    }

    public function post($url, $postData = null, $multipart = false)
    {
        if ($multipart)
        {
            $postData = $this->prepareMultipart($postData);
            if ($postData === false)
            {
                return false;
            }
        }
 
        if ($this->query(Http\Method::POST, $url, $postData))
        {
            return $this->getResult();
        }
        return false;
    }

    protected function prepareMultipart($postData)
    {
        if (is_array($postData))
        {
            try
            {
                $data = new Http\MultipartStream($postData);
                $this->setHeader('Content-type', 'multipart/form-data; boundary=' . $data->getBoundary());
 
                return $data;
            }
            catch (ArgumentException $e)
            {
                $this->addError('MULTIPART', $e->getMessage(), true);
                return false;
            }
        }
 
        return $postData;
    }

    public function query($method, $url, $entityBody = null)
    {
        $this->effectiveUrl = $url;
        $this->effectiveIp = null;
        $this->error = [];
 
        if (is_array($entityBody))
        {
            $entityBody = new Http\FormStream($entityBody);
        }
 
        if ($entityBody instanceof Http\Stream)
        {
            $body = $entityBody;
        }
        elseif (is_resource($entityBody))
        {
            $body = new Http\Stream($entityBody);
        }
        else
        {
            $body = new Http\Stream('php://temp', 'r+');
            $body->write($entityBody ?? '');
        }
 
        $this->redirectCount = 0;
 
        while (true)
        {
            //Only absoluteURI is accepted
            $uri = new Uri($this->effectiveUrl);
 
            // make a PSR-7 request
            $request = new Http\Request($method, $uri, $this->headers->getHeaders(), $body, $this->version);
 
            try
            {
                // PSR-18 magic is here
                $this->sendRequest($request);
            }
            catch (ClientExceptionInterface $e)
            {
                // compatibility mode
                if ($e instanceof NetworkExceptionInterface)
                {
                    $this->addError('NETWORK', $e->getMessage());
                }
                return false;
            }
 
            if (!$this->waitResponse)
            {
                return true;
            }
 
            if ($this->redirect && ($location = $this->getHeaders()->get('Location')) != '')
            {
                if ($this->redirectCount < $this->redirectMax)
                {
                    // there can be a different host in Location
                    $this->headers->delete('Host');
 
                    // relative URI is possible according to RFC 9110
                    $this->effectiveUrl = (string)(new Uri($location))->resolveRelativeUri($uri);
 
                    $status = $this->getStatus();
                    if ($status == 302 || $status == 303)
                    {
                        $method = Http\Method::GET;
                    }
 
                    $this->redirectCount++;
                }
                else
                {
                    $this->addError('REDIRECT', "Maximum number of redirects ({$this->redirectMax}) has been reached at URL {$url}", true);
                    return false;
                }
            }
            else
            {
                return true;
            }
        }
    }

    public function setHeader($name, $value, $replace = true)
    {
        if ($replace || !$this->headers->has($name))
        {
            $this->headers->set($name, $value);
        }
        return $this;
    }

    public function setHeaders(array $headers)
    {
        foreach ($headers as $name => $value)
        {
            $this->setHeader($name, $value);
        }
        return $this;
    }

    public function getRequestHeaders(): HttpHeaders
    {
        if ($this->request)
        {
            return $this->request->getHeadersCollection();
        }
        return $this->headers;
    }

    public function clearHeaders()
    {
        $this->headers->clear();
    }

    public function setCookies(array $cookies)
    {
        if (!empty($cookies))
        {
            $this->setHeader('Cookie', (new HttpCookies($cookies))->implode());
        }
 
        return $this;
    }

    public function setAuthorization($user, $pass)
    {
        $this->setHeader('Authorization', 'Basic ' . base64_encode($user . ':' . $pass));
        return $this;
    }

    public function setRedirect($value, $max = null)
    {
        $this->redirect = (bool)$value;
        if ($max !== null)
        {
            $this->redirectMax = intval($max);
        }
        return $this;
    }

    public function waitResponse($value)
    {
        $this->waitResponse = (bool)$value;
        if (!$this->waitResponse)
        {
            $this->setStreamTimeout(self::DEFAULT_STREAM_TIMEOUT_NO_WAIT);
        }
 
        return $this;
    }

    public function setTimeout($value)
    {
        $this->socketTimeout = intval($value);
        return $this;
    }

    public function setStreamTimeout($value)
    {
        $this->streamTimeout = intval($value);
        return $this;
    }

    public function setVersion($value)
    {
        $this->version = $value;
        return $this;
    }

    public function setCompress($value)
    {
        $this->compress = (bool)$value;
        return $this;
    }

    public function setCharset($value)
    {
        $this->requestCharset = $value;
        return $this;
    }

    public function disableSslVerification()
    {
        $this->sslVerify = false;
        return $this;
    }

    public function setPrivateIp($value)
    {
        $this->privateIp = (bool)$value;
        return $this;
    }

    public function setProxy($proxyHost, $proxyPort = null, $proxyUser = null, $proxyPassword = null)
    {
        $this->proxyHost = $proxyHost;
        $proxyPort = (int)$proxyPort;
        if ($proxyPort > 0)
        {
            $this->proxyPort = $proxyPort;
        }
        $this->proxyUser = $proxyUser ?? '';
        $this->proxyPassword = $proxyPassword ?? '';
 
        return $this;
    }

    public function setOutputStream($handler)
    {
        $this->outputStream = $handler;
        return $this;
    }

    public function setBodyLengthMax($bodyLengthMax)
    {
        $this->bodyLengthMax = intval($bodyLengthMax);
        return $this;
    }

    public function download($url, $filePath, string $method = Http\Method::GET, $entityBody = null)
    {
        $result = $this->query($method, $url, $entityBody);
 
        if ($result && ($status = $this->getStatus()) >= 200 && $status < 300)
        {
            $this->saveFile($filePath);
 
            return true;
        }
 
        return false;
    }

    public function saveFile($filePath)
    {
        $dir = IO\Path::getDirectory($filePath);
        IO\Directory::createDirectory($dir);
 
        $file = new IO\File($filePath);
        $handler = $file->open('w+');
 
        $this->setOutputStream($handler);
        $this->getResult();
 
        $file->close();
    }

    public function getEffectiveUrl()
    {
        return $this->effectiveUrl;
    }

    public function setContextOptions(array $options)
    {
        $this->contextOptions = array_replace_recursive($this->contextOptions, $options);
        return $this;
    }

    public function getHeaders(): HttpHeaders
    {
        if ($this->response)
        {
            return $this->response->getHeadersCollection();
        }
        return new HttpHeaders();
    }

    public function getCookies(): HttpCookies
    {
        return $this->getHeaders()->getCookies();
    }

    public function getStatus()
    {
        if ($this->response)
        {
            return $this->response->getStatusCode();
        }
        return 0;
    }

    public function getResult()
    {
        $result = '';
        if ($this->response)
        {
            $body = $this->response->getBody();
 
            if ($this->outputStream === null)
            {
                $result = (string)$body;
            }
            elseif ($body instanceof Http\Stream)
            {
                $body->copyTo($this->outputStream);
            }
        }
        return $result;
    }

    public function getResponse()
    {
        return $this->response;
    }

    public function getError()
    {
        return $this->error;
    }

    public function getContentType()
    {
        return $this->getHeaders()->getContentType();
    }

    public function getCharset()
    {
        return $this->getHeaders()->getCharset();
    }

    public function getPeerAddress()
    {
        if ($this->effectiveIp)
        {
            return (string)$this->effectiveIp;
        }
        return false;
    }
 
    protected function addError($code, $message, $triggerWarning = false)
    {
        $this->error[$code] = $message;
 
        if ($triggerWarning)
        {
            trigger_error($message, E_USER_WARNING);
        }
    }
 
    protected function buildRequest(RequestInterface $request): Http\Request
    {
        $method = $request->getMethod();
        $uri = $request->getUri();
        $body = $request->getBody();
 
        $punyUri = new Uri((string)$uri);
        if (($punyHost = $punyUri->convertToPunycode()) != $uri->getHost())
        {
            $uri = $uri->withHost($punyHost);
            $request = $request->withUri($uri);
        }
 
        if (!$request->hasHeader('Host'))
        {
            $request = $request->withHeader('Host', $uri->getHost());
        }
        if (!$request->hasHeader('Connection'))
        {
            $request = $request->withHeader('Connection', 'close');
        }
        if (!$request->hasHeader('Accept'))
        {
            $request = $request->withHeader('Accept', '*/*');
        }
        if (!$request->hasHeader('Accept-Language'))
        {
            $request = $request->withHeader('Accept-Language', 'en');
        }
        if ($this->compress)
        {
            $request = $request->withHeader('Accept-Encoding', 'gzip');
        }
        if (($userInfo = $uri->getUserInfo()) != '')
        {
            $request = $request->withHeader('Authorization', 'Basic ' . base64_encode($userInfo));
        }
        if ($this->proxyHost != '' && $this->proxyUser != '')
        {
            $request = $request->withHeader('Proxy-Authorization', 'Basic ' . base64_encode($this->proxyUser . ':' . $this->proxyPassword));
        }
 
        // the client doesn't support "Expect-Continue", set empty value for cURL
        if ($this->useCurl)
        {
            $request = $request->withHeader('Expect', '');
        }
 
        if ($method == Http\Method::POST)
        {
            //special processing for POST requests
            if (!$request->hasHeader('Content-Type'))
            {
                $contentType = 'application/x-www-form-urlencoded';
                if ($this->requestCharset != '')
                {
                    $contentType .= '; charset=' . $this->requestCharset;
                }
                $request = $request->withHeader('Content-Type', $contentType);
            }
        }
 
        $size = $body->getSize();
 
        if ($size > 0 || $method == Http\Method::POST || $method == Http\Method::PUT)
        {
            // A valid Content-Length field value is required on all HTTP/1.0 request messages containing an entity body.
            if (!$request->hasHeader('Content-Length'))
            {
                $request = $request->withHeader('Content-Length', $size ?? strlen((string)$body));
            }
        }
 
        if ($this->sendEvents)
        {
            // Here's the chance to tune up the client and to rebuild the request.
            $event = new Http\RequestEvent($this, $request, 'OnHttpClientBuildRequest');
            $event->send();
 
            foreach ($event->getResults() as $eventResult)
            {
                $request = $eventResult->getRequest();
            }
        }
 
        return new Http\Request(
            $request->getMethod(),
            $request->getUri(),
            $request->getHeaders(),
            $request->getBody(),
            $request->getProtocolVersion()
        );
    }
 
    protected function checkRequest(RequestInterface $request): bool
    {
        $uri = $request->getUri();
 
        $scheme = $uri->getScheme();
        if ($scheme !== 'http' && $scheme !== 'https')
        {
            $this->addError('URI_SCHEME', 'Only http and https shemes are supported.');
            return false;
        }
 
        if ($uri->getHost() == '')
        {
            $this->addError('URI_HOST', 'Incorrect host in URI.');
            return false;
        }
 
        $punyUri = new Uri((string)$uri);
        $error = $punyUri->convertToPunycode();
        if ($error instanceof \Bitrix\Main\Error)
        {
            $this->addError('URI_PUNICODE', "Error converting hostname to punycode: {$error->getMessage()}");
            return false;
        }
 
        if (!$this->privateIp)
        {
            $ip = IpAddress::createByUri($punyUri);
            if ($ip->isPrivate())
            {
                $this->addError('PRIVATE_IP', "Resolved IP is incorrect or private: {$ip->get()}");
                return false;
            }
            $this->effectiveIp = $ip;
        }
 
        return true;
    }

    public function sendRequest(RequestInterface $request): ResponseInterface
    {
        if (!$this->checkRequest($request))
        {
            throw new Http\RequestException($request, reset($this->error));
        }
 
        $this->request = $this->buildRequest($request);
 
        $handler = $this->createHandler($this->request);
 
        $this->response = $handler->execute();
 
        return $this->response;
    }

    public function sendAsyncRequest(RequestInterface $request): PromiseInterface
    {
        if (!$this->checkRequest($request))
        {
            throw new Http\RequestException($request, reset($this->error));
        }
 
        $this->request = $this->buildRequest($request);
 
        if ($this->queue === null)
        {
            $this->queue = $this->createQueue();
        }
 
        $handler = $this->createHandler($this->request, true);
 
        $promise = $this->createPromise($handler, $this->queue);
 
        $this->queue->add($promise);
 
        return $promise;
    }

    protected function createHandler(RequestInterface $request, bool $async = false)
    {
        if ($this->sslVerify === false)
        {
            $this->contextOptions['ssl']['verify_peer_name'] = false;
            $this->contextOptions['ssl']['verify_peer'] = false;
            $this->contextOptions['ssl']['allow_self_signed'] = true;
        }
 
        $handlerOptions = [
            'waitResponse' => $this->waitResponse,
            'bodyLengthMax' => $this->bodyLengthMax,
            'proxyHost' => $this->proxyHost,
            'proxyPort' => $this->proxyPort,
            'effectiveIp' => $this->effectiveIp,
            'contextOptions' => $this->contextOptions,
            'socketTimeout' => $this->socketTimeout,
            'streamTimeout' => $this->streamTimeout,
            'async' => $async,
            'curlLogFile' => $this->curlLogFile,
        ];
 
        if (!isset($this->responseBuilder))
        {
            $this->responseBuilder = new Http\ResponseBuilder();
        }
 
        if ($this->useCurl)
        {
            $handler = new Http\Curl\Handler($request, $this->responseBuilder, $handlerOptions);
        }
        else
        {
            $handler = new Http\Socket\Handler($request, $this->responseBuilder, $handlerOptions);
        }
 
        if ($this->logger !== null)
        {
            $handler->setLogger($this->logger);
            $handler->setDebugLevel($this->debugLevel);
        }
 
        if ($this->shouldFetchBody !== null)
        {
            $handler->shouldFetchBody($this->shouldFetchBody);
        }
 
        return $handler;
    }

    protected function createPromise($handler, Http\Queue $queue)
    {
        if ($this->useCurl)
        {
            return new Http\Curl\Promise($handler, $queue);
        }
        return new Http\Socket\Promise($handler, $queue);
    }

    protected function createQueue()
    {
        if ($this->useCurl)
        {
            return new Http\Curl\Queue();
        }
        return new Http\Socket\Queue();
    }

    public function wait(): array
    {
        $responses = [];
 
        if ($this->queue)
        {
            foreach ($this->queue->wait() as $promise)
            {
                $responses[$promise->getId()] = $promise->wait();
            }
        }
 
        return $responses;
    }

    public function shouldFetchBody(callable $callback)
    {
        $this->shouldFetchBody = $callback;
        return $this;
    }

    public function setResponseBuilder(Http\ResponseBuilderInterface $responseBuilder)
    {
        $this->responseBuilder = $responseBuilder;
        return $this;
    }
}