: str_replace(): Passing null to parameter #2 ($replace) of type array|string is deprecated in
declare (strict_types=1);
namespace YoastSEO_Vendor\GuzzleHttp\Psr7;
use YoastSEO_Vendor\GuzzleHttp\Psr7\Exception\MalformedUriException;
use YoastSEO_Vendor\Psr\Http\Message\UriInterface;
* PSR-7 URI implementation.
* @author Michael Dowling
* @author Tobias Schultze
* @author Matthew Weier O'Phinney
class Uri implements \YoastSEO_Vendor\Psr\Http\Message\UriInterface, \JsonSerializable
* Absolute http and https URIs require a host per RFC 7230 Section 2.7
* but in generic URIs the host can be empty. So for http(s) URIs
* we apply this default host when no host is given yet to form a
private const HTTP_DEFAULT_HOST = 'localhost';
private const DEFAULT_PORTS = ['http' => 80, 'https' => 443, 'ftp' => 21, 'gopher' => 70, 'nntp' => 119, 'news' => 119, 'telnet' => 23, 'tn3270' => 23, 'imap' => 143, 'pop' => 110, 'ldap' => 389];
* Unreserved characters for use in a regex.
* @see https://datatracker.ietf.org/doc/html/rfc3986#section-2.3
private const CHAR_UNRESERVED = 'a-zA-Z0-9_\\-\\.~';
* Sub-delims for use in a regex.
* @see https://datatracker.ietf.org/doc/html/rfc3986#section-2.2
private const CHAR_SUB_DELIMS = '!\\$&\'\\(\\)\\*\\+,;=';
private const QUERY_SEPARATORS_REPLACEMENT = ['=' => '%3D', '&' => '%26'];
/** @var string Uri scheme. */
/** @var string Uri user info. */
/** @var string Uri host. */
/** @var int|null Uri port. */
/** @var string Uri path. */
/** @var string Uri query string. */
/** @var string Uri fragment. */
/** @var string|null String representation */
private $composedComponents;
public function __construct(string $uri = '')
$parts = self::parse($uri);
throw new \YoastSEO_Vendor\GuzzleHttp\Psr7\Exception\MalformedUriException("Unable to parse URI: {$uri}");
$this->applyParts($parts);
* UTF-8 aware \parse_url() replacement.
* The internal function produces broken output for non ASCII domain names
* (IDN) when used with locales other than "C".
* On the other hand, cURL understands IDN correctly only when UTF-8 locale
* is configured ("C.UTF-8", "en_US.UTF-8", etc.).
* @see https://bugs.php.net/bug.php?id=52923
* @see https://www.php.net/manual/en/function.parse-url.php#114817
* @see https://curl.haxx.se/libcurl/c/CURLOPT_URL.html#ENCODING
private static function parse(string $url)
if (\preg_match('%^(.*://\\[[0-9:a-f]+\\])(.*?)$%', $url, $matches)) {
/** @var array{0:string, 1:string, 2:string} $matches */
$encodedUrl = \preg_replace_callback('%[^:/@?&=#]+%usD', static function ($matches) {
return \urlencode($matches[0]);
$result = \parse_url($prefix . $encodedUrl);
if ($result === \false) {
return \array_map('urldecode', $result);
public function __toString() : string
if ($this->composedComponents === null) {
$this->composedComponents = self::composeComponents($this->scheme, $this->getAuthority(), $this->path, $this->query, $this->fragment);
return $this->composedComponents;
* Composes a URI reference string from its various components.
* Usually this method does not need to be called manually but instead is used indirectly via
* `Psr\Http\Message\UriInterface::__toString`.
* PSR-7 UriInterface treats an empty component the same as a missing component as
* getQuery(), getFragment() etc. always return a string. This explains the slight
* difference to RFC 3986 Section 5.3.
* Another adjustment is that the authority separator is added even when the authority is missing/empty
* for the "file" scheme. This is because PHP stream functions like `file_get_contents` only work with
* `file:///myfile` but not with `file:/myfile` although they are equivalent according to RFC 3986. But
* `file:///` is the more common syntax for the file scheme anyway (Chrome for example redirects to
* @see https://datatracker.ietf.org/doc/html/rfc3986#section-5.3
public static function composeComponents(?string $scheme, ?string $authority, string $path, ?string $query, ?string $fragment) : string
// weak type checks to also accept null until we can add scalar type hints
if ($authority != '' || $scheme === 'file') {
$uri .= '//' . $authority;
if ($authority != '' && $path != '' && $path[0] != '/') {
* Whether the URI has the default port of the current scheme.
* `Psr\Http\Message\UriInterface::getPort` may return null or the standard port. This method can be used
* independently of the implementation.
public static function isDefaultPort(\YoastSEO_Vendor\Psr\Http\Message\UriInterface $uri) : bool
return $uri->getPort() === null || isset(self::DEFAULT_PORTS[$uri->getScheme()]) && $uri->getPort() === self::DEFAULT_PORTS[$uri->getScheme()];
* Whether the URI is absolute, i.e. it has a scheme.
* An instance of UriInterface can either be an absolute URI or a relative reference. This method returns true
* if it is the former. An absolute URI has a scheme. A relative reference is used to express a URI relative
* to another URI, the base URI. Relative references can be divided into several forms:
* - network-path references, e.g. '//example.com/path'
* - absolute-path references, e.g. '/path'
* - relative-path references, e.g. 'subpath'
* @see Uri::isNetworkPathReference
* @see Uri::isAbsolutePathReference
* @see Uri::isRelativePathReference
* @see https://datatracker.ietf.org/doc/html/rfc3986#section-4
public static function isAbsolute(\YoastSEO_Vendor\Psr\Http\Message\UriInterface $uri) : bool
return $uri->getScheme() !== '';
* Whether the URI is a network-path reference.
* A relative reference that begins with two slash characters is termed an network-path reference.
* @see https://datatracker.ietf.org/doc/html/rfc3986#section-4.2
public static function isNetworkPathReference(\YoastSEO_Vendor\Psr\Http\Message\UriInterface $uri) : bool
return $uri->getScheme() === '' && $uri->getAuthority() !== '';
* Whether the URI is a absolute-path reference.
* A relative reference that begins with a single slash character is termed an absolute-path reference.
* @see https://datatracker.ietf.org/doc/html/rfc3986#section-4.2
public static function isAbsolutePathReference(\YoastSEO_Vendor\Psr\Http\Message\UriInterface $uri) : bool
return $uri->getScheme() === '' && $uri->getAuthority() === '' && isset($uri->getPath()[0]) && $uri->getPath()[0] === '/';
* Whether the URI is a relative-path reference.
* A relative reference that does not begin with a slash character is termed a relative-path reference.
* @see https://datatracker.ietf.org/doc/html/rfc3986#section-4.2
public static function isRelativePathReference(\YoastSEO_Vendor\Psr\Http\Message\UriInterface $uri) : bool
return $uri->getScheme() === '' && $uri->getAuthority() === '' && (!isset($uri->getPath()[0]) || $uri->getPath()[0] !== '/');
* Whether the URI is a same-document reference.
* A same-document reference refers to a URI that is, aside from its fragment
* component, identical to the base URI. When no base URI is given, only an empty
* URI reference (apart from its fragment) is considered a same-document reference.
* @param UriInterface $uri The URI to check
* @param UriInterface|null $base An optional base URI to compare against
* @see https://datatracker.ietf.org/doc/html/rfc3986#section-4.4
public static function isSameDocumentReference(\YoastSEO_Vendor\Psr\Http\Message\UriInterface $uri, \YoastSEO_Vendor\Psr\Http\Message\UriInterface $base = null) : bool
$uri = \YoastSEO_Vendor\GuzzleHttp\Psr7\UriResolver::resolve($base, $uri);
return $uri->getScheme() === $base->getScheme() && $uri->getAuthority() === $base->getAuthority() && $uri->getPath() === $base->getPath() && $uri->getQuery() === $base->getQuery();
return $uri->getScheme() === '' && $uri->getAuthority() === '' && $uri->getPath() === '' && $uri->getQuery() === '';
* Creates a new URI with a specific query string value removed.
* Any existing query string values that exactly match the provided key are
* @param UriInterface $uri URI to use as a base.
* @param string $key Query string key to remove.
public static function withoutQueryValue(\YoastSEO_Vendor\Psr\Http\Message\UriInterface $uri, string $key) : \YoastSEO_Vendor\Psr\Http\Message\UriInterface
$result = self::getFilteredQueryString($uri, [$key]);
return $uri->withQuery(\implode('&', $result));
* Creates a new URI with a specific query string value.
* Any existing query string values that exactly match the provided key are
* removed and replaced with the given key value pair.
* A value of null will set the query string key without a value, e.g. "key"
* instead of "key=value".
* @param UriInterface $uri URI to use as a base.
* @param string $key Key to set.
* @param string|null $value Value to set
public static function withQueryValue(\YoastSEO_Vendor\Psr\Http\Message\UriInterface $uri, string $key, ?string $value) : \YoastSEO_Vendor\Psr\Http\Message\UriInterface
$result = self::getFilteredQueryString($uri, [$key]);
$result[] = self::generateQueryString($key, $value);
return $uri->withQuery(\implode('&', $result));
* Creates a new URI with multiple specific query string values.
* It has the same behavior as withQueryValue() but for an associative array of key => value.
* @param UriInterface $uri URI to use as a base.
* @param (string|null)[] $keyValueArray Associative array of key and values
public static function withQueryValues(\YoastSEO_Vendor\Psr\Http\Message\UriInterface $uri, array $keyValueArray) : \YoastSEO_Vendor\Psr\Http\Message\UriInterface
$result = self::getFilteredQueryString($uri, \array_keys($keyValueArray));
foreach ($keyValueArray as $key => $value) {
$result[] = self::generateQueryString((string) $key, $value !== null ? (string) $value : null);
return $uri->withQuery(\implode('&', $result));
* Creates a URI from a hash of `parse_url` components.
* @see https://www.php.net/manual/en/function.parse-url.php
* @throws MalformedUriException If the components do not form a valid URI.
public static function fromParts(array $parts) : \YoastSEO_Vendor\Psr\Http\Message\UriInterface
$uri->applyParts($parts);
public function getScheme() : string
public function getAuthority() : string
$authority = $this->host;
if ($this->userInfo !== '') {
$authority = $this->userInfo . '@' . $authority;
if ($this->port !== null) {
$authority .= ':' . $this->port;
public function getUserInfo() : string
public function getHost() : string
public function getPort() : ?int
public function getPath() : string
public function getQuery() : string
public function getFragment() : string
public function withScheme($scheme) : \YoastSEO_Vendor\Psr\Http\Message\UriInterface
$scheme = $this->filterScheme($scheme);
if ($this->scheme === $scheme) {
$new->composedComponents = null;
$new->removeDefaultPort();
public function withUserInfo($user, $password = null) : \YoastSEO_Vendor\Psr\Http\Message\UriInterface
$info = $this->filterUserInfoComponent($user);
if ($password !== null) {
$info .= ':' . $this->filterUserInfoComponent($password);
if ($this->userInfo === $info) {
$new->composedComponents = null;
public function withHost($host) : \YoastSEO_Vendor\Psr\Http\Message\UriInterface
$host = $this->filterHost($host);
if ($this->host === $host) {
$new->composedComponents = null;
public function withPort($port) : \YoastSEO_Vendor\Psr\Http\Message\UriInterface
$port = $this->filterPort($port);
if ($this->port === $port) {
$new->composedComponents = null;
$new->removeDefaultPort();
public function withPath($path) : \YoastSEO_Vendor\Psr\Http\Message\UriInterface
$path = $this->filterPath($path);
if ($this->path === $path) {
$new->composedComponents = null;
public function withQuery($query) : \YoastSEO_Vendor\Psr\Http\Message\UriInterface
$query = $this->filterQueryAndFragment($query);
if ($this->query === $query) {
$new->composedComponents = null;
public function withFragment($fragment) : \YoastSEO_Vendor\Psr\Http\Message\UriInterface
$fragment = $this->filterQueryAndFragment($fragment);
if ($this->fragment === $fragment) {
$new->fragment = $fragment;
$new->composedComponents = null;
public function jsonSerialize() : string
return $this->__toString();
* Apply parse_url parts to a URI.
* @param array $parts Array of parse_url parts to apply.
private function applyParts(array $parts) : void
$this->scheme = isset($parts['scheme']) ? $this->filterScheme($parts['scheme']) : '';
$this->userInfo = isset($parts['user']) ? $this->filterUserInfoComponent($parts['user']) : '';
$this->host = isset($parts['host']) ? $this->filterHost($parts['host']) : '';
$this->port = isset($parts['port']) ? $this->filterPort($parts['port']) : null;
$this->path = isset($parts['path']) ? $this->filterPath($parts['path']) : '';
$this->query = isset($parts['query']) ? $this->filterQueryAndFragment($parts['query']) : '';
$this->fragment = isset($parts['fragment']) ? $this->filterQueryAndFragment($parts['fragment']) : '';
if (isset($parts['pass'])) {
$this->userInfo .= ':' . $this->filterUserInfoComponent($parts['pass']);
$this->removeDefaultPort();
* @throws \InvalidArgumentException If the scheme is invalid.
private function filterScheme($scheme) : string
if (!\is_string($scheme)) {
throw new \InvalidArgumentException('Scheme must be a string');
return \strtr($scheme, 'ABCDEFGHIJKLMNOPQRSTUVWXYZ', 'abcdefghijklmnopqrstuvwxyz');
* @param mixed $component
* @throws \InvalidArgumentException If the user info is invalid.
private function filterUserInfoComponent($component) : string
if (!\is_string($component)) {
throw new \InvalidArgumentException('User info must be a string');
return \preg_replace_callback('/(?:[^%' . self::CHAR_UNRESERVED . self::CHAR_SUB_DELIMS . ']+|%(?![A-Fa-f0-9]{2}))/', [$this, 'rawurlencodeMatchZero'], $component);
* @throws \InvalidArgumentException If the host is invalid.
private function filterHost($host) : string
if (!\is_string($host)) {
throw new \InvalidArgumentException('Host must be a string');
return \strtr($host, 'ABCDEFGHIJKLMNOPQRSTUVWXYZ', 'abcdefghijklmnopqrstuvwxyz');
* @throws \InvalidArgumentException If the port is invalid.
private function filterPort($port) : ?int
if (0 > $port || 0xffff < $port) {
throw new \InvalidArgumentException(\sprintf('Invalid port: %d. Must be between 0 and 65535', $port));
* @param (string|int)[] $keys
private static function getFilteredQueryString(\YoastSEO_Vendor\Psr\Http\Message\UriInterface $uri, array $keys) : array
$current = $uri->getQuery();
It is recommended that you Edit text format, this type of Fix handles quite a lot in one request
