Skip to main content
Drupal API
User account menu
  • Log in

Breadcrumb

  1. Drupal Core 11.1.x

Request.php

Same filename in this branch
  1. 11.1.x vendor/composer/composer/src/Composer/DependencyResolver/Request.php
  2. 11.1.x vendor/symfony/browser-kit/Request.php
  3. 11.1.x vendor/symfony/http-foundation/Request.php

Namespace

GuzzleHttp\Psr7

File

vendor/guzzlehttp/psr7/src/Request.php

View source
<?php

declare (strict_types=1);
namespace GuzzleHttp\Psr7;

use InvalidArgumentException;
use Psr\Http\Message\RequestInterface;
use Psr\Http\Message\StreamInterface;
use Psr\Http\Message\UriInterface;

/**
 * PSR-7 request implementation.
 */
class Request implements RequestInterface {
    use MessageTrait;
    
    /** @var string */
    private $method;
    
    /** @var string|null */
    private $requestTarget;
    
    /** @var UriInterface */
    private $uri;
    
    /**
     * @param string                               $method  HTTP method
     * @param string|UriInterface                  $uri     URI
     * @param (string|string[])[]                  $headers Request headers
     * @param string|resource|StreamInterface|null $body    Request body
     * @param string                               $version Protocol version
     */
    public function __construct(string $method, $uri, array $headers = [], $body = null, string $version = '1.1') {
        $this->assertMethod($method);
        if (!$uri instanceof UriInterface) {
            $uri = new Uri($uri);
        }
        $this->method = strtoupper($method);
        $this->uri = $uri;
        $this->setHeaders($headers);
        $this->protocol = $version;
        if (!isset($this->headerNames['host'])) {
            $this->updateHostFromUri();
        }
        if ($body !== '' && $body !== null) {
            $this->stream = Utils::streamFor($body);
        }
    }
    public function getRequestTarget() : string {
        if ($this->requestTarget !== null) {
            return $this->requestTarget;
        }
        $target = $this->uri
            ->getPath();
        if ($target === '') {
            $target = '/';
        }
        if ($this->uri
            ->getQuery() != '') {
            $target .= '?' . $this->uri
                ->getQuery();
        }
        return $target;
    }
    public function withRequestTarget($requestTarget) : RequestInterface {
        if (preg_match('#\\s#', $requestTarget)) {
            throw new InvalidArgumentException('Invalid request target provided; cannot contain whitespace');
        }
        $new = clone $this;
        $new->requestTarget = $requestTarget;
        return $new;
    }
    public function getMethod() : string {
        return $this->method;
    }
    public function withMethod($method) : RequestInterface {
        $this->assertMethod($method);
        $new = clone $this;
        $new->method = strtoupper($method);
        return $new;
    }
    public function getUri() : UriInterface {
        return $this->uri;
    }
    public function withUri(UriInterface $uri, $preserveHost = false) : RequestInterface {
        if ($uri === $this->uri) {
            return $this;
        }
        $new = clone $this;
        $new->uri = $uri;
        if (!$preserveHost || !isset($this->headerNames['host'])) {
            $new->updateHostFromUri();
        }
        return $new;
    }
    private function updateHostFromUri() : void {
        $host = $this->uri
            ->getHost();
        if ($host == '') {
            return;
        }
        if (($port = $this->uri
            ->getPort()) !== null) {
            $host .= ':' . $port;
        }
        if (isset($this->headerNames['host'])) {
            $header = $this->headerNames['host'];
        }
        else {
            $header = 'Host';
            $this->headerNames['host'] = 'Host';
        }
        // Ensure Host is the first header.
        // See: https://datatracker.ietf.org/doc/html/rfc7230#section-5.4
        $this->headers = [
            $header => [
                $host,
            ],
        ] + $this->headers;
    }
    
    /**
     * @param mixed $method
     */
    private function assertMethod($method) : void {
        if (!is_string($method) || $method === '') {
            throw new InvalidArgumentException('Method must be a non-empty string.');
        }
    }

}

Classes

Title Deprecated Summary
Request PSR-7 request implementation.

API Navigation

  • Drupal Core 11.1.x
  • Topics
  • Classes
  • Functions
  • Constants
  • Globals
  • Files
  • Namespaces
  • Deprecated
  • Services
RSS feed
Powered by Drupal