FileXXXXXXXXXXX

File manager - Edit - /var/www/payraty/hris/vendor/league/uri/Uri.php

Back
<?php /** * League.Uri (https://uri.thephpleague.com) * * (c) Ignace Nyamagana Butera <nyamsprod@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / declare(strict_types=1); namespace League\Uri; use Deprecated; use finfo; use League\Uri\Contracts\UriComponentInterface; use League\Uri\Contracts\UriException; use League\Uri\Contracts\UriInterface; use League\Uri\Exceptions\ConversionFailed; use League\Uri\Exceptions\MissingFeature; use League\Uri\Exceptions\SyntaxError; use League\Uri\Idna\Converter as IdnConverter; use League\Uri\UriTemplate\TemplateCanNotBeExpanded; use Psr\Http\Message\UriInterface as Psr7UriInterface; use SensitiveParameter; use Stringable; use function array_filter; use function array_map; use function base64_decode; use function base64_encode; use function count; use function explode; use function file_get_contents; use function filter_var; use function implode; use function in_array; use function inet_pton; use function ltrim; use function preg_match; use function preg_replace_callback; use function rawurlencode; use function str_contains; use function str_replace; use function strlen; use function strpos; use function strspn; use function strtolower; use function substr; use const FILEINFO_MIME; use const FILTER_FLAG_IPV4; use const FILTER_FLAG_IPV6; use const FILTER_NULL_ON_FAILURE; use const FILTER_VALIDATE_BOOLEAN; use const FILTER_VALIDATE_IP; /* * @phpstan-import-type ComponentMap from UriString * @phpstan-import-type InputComponentMap from UriString / final class Uri implements UriInterface { /* * RFC3986 invalid characters. * * @link https://tools.ietf.org/html/rfc3986#section-2.2 * * @var string / private const REGEXP_INVALID_CHARS = '/[\x00-\x1f\x7f]/'; /* * RFC3986 schema regular expression pattern. * * @link https://tools.ietf.org/html/rfc3986#section-3.1 * * @var string / private const REGEXP_SCHEME = ',^[a-z]([-a-z\d+.]+)?$,i'; /* * RFC3986 host identified by a registered name regular expression pattern. * * @link https://tools.ietf.org/html/rfc3986#section-3.2.2 * * @var string / private const REGEXP_HOST_REGNAME = '/^( (?<unreserved>[a-z\d_~\-\.])\| (?<sub_delims>[!$&\'()+,;=])\| (?<encoded>%[A-F\d]{2}) )+$/x'; /** * RFC3986 delimiters of the generic URI components regular expression pattern. * * @link https://tools.ietf.org/html/rfc3986#section-2.2 * * @var string / private const REGEXP_HOST_GEN_DELIMS = '/[:\/?#\[\]@ ]/'; // Also includes space. /* * RFC3986 IPvFuture regular expression pattern. * * @link https://tools.ietf.org/html/rfc3986#section-3.2.2 * * @var string / private const REGEXP_HOST_IP_FUTURE = '/^ v(?<version>[A-F\d])+\. (?: (?<unreserved>[a-z\d_~\-\.])\| (?<sub_delims>[!$&\'()+,;=:]) # also include the : character )+ $/ix'; /** * RFC3986 IPvFuture host and port component. * * @var string / private const REGEXP_HOST_PORT = ',^(?<host>(\[.]\|[^:]))(:(?<port>[^/?#]))?$,x'; /** * Significant 10 bits of IP to detect Zone ID regular expression pattern. * * @var string / private const HOST_ADDRESS_BLOCK = "\xfe\x80"; /* * Regular expression pattern to for file URI. * <volume> contains the volume but not the volume separator. * The volume separator may be URL-encoded (`\|` as `%7C`) by ::formatPath(), * so we account for that here. * * @var string / private const REGEXP_FILE_PATH = ',^(?<delim>/)?(?<volume>[a-zA-Z])(?:[:\|\\|]\|%7C)(?<rest>.)?,'; /** * Mimetype regular expression pattern. * * @link https://tools.ietf.org/html/rfc2397 * * @var string / private const REGEXP_MIMETYPE = ',^\w+/[-.\w]+(?:\+[-.\w]+)?$,'; /* * Base64 content regular expression pattern. * * @link https://tools.ietf.org/html/rfc2397 * * @var string / private const REGEXP_BINARY = ',(;\|^)base64$,'; /* * Windows file path string regular expression pattern. * <root> contains both the volume and volume separator. * * @var string / private const REGEXP_WINDOW_PATH = ',^(?<root>[a-zA-Z][:\|\\|]),'; /* * Supported schemes and corresponding default port. * * @var array<string, int\|null> / private const SCHEME_DEFAULT_PORT = [ 'data' => null, 'file' => null, 'ftp' => 21, 'gopher' => 70, 'http' => 80, 'https' => 443, 'ws' => 80, 'wss' => 443, ]; /* * Maximum number of cached items. * * @var int / private const MAXIMUM_CACHED_ITEMS = 100; /* * All ASCII letters sorted by typical frequency of occurrence. * * @var string / private const ASCII = "\x20\x65\x69\x61\x73\x6E\x74\x72\x6F\x6C\x75\x64\x5D\x5B\x63\x6D\x70\x27\x0A\x67\x7C\x68\x76\x2E\x66\x62\x2C\x3A\x3D\x2D\x71\x31\x30\x43\x32\x2A\x79\x78\x29\x28\x4C\x39\x41\x53\x2F\x50\x22\x45\x6A\x4D\x49\x6B\x33\x3E\x35\x54\x3C\x44\x34\x7D\x42\x7B\x38\x46\x77\x52\x36\x37\x55\x47\x4E\x3B\x4A\x7A\x56\x23\x48\x4F\x57\x5F\x26\x21\x4B\x3F\x58\x51\x25\x59\x5C\x09\x5A\x2B\x7E\x5E\x24\x40\x60\x7F\x00\x01\x02\x03\x04\x05\x06\x07\x08\x0B\x0C\x0D\x0E\x0F\x10\x11\x12\x13\x14\x15\x16\x17\x18\x19\x1A\x1B\x1C\x1D\x1E\x1F"; private readonly ?string $scheme; private readonly ?string $user; private readonly ?string $pass; private readonly ?string $userInfo; private readonly ?string $host; private readonly ?int $port; private readonly ?string $authority; private readonly string $path; private readonly ?string $query; private readonly ?string $fragment; private readonly string $uri; private function __construct( ?string $scheme, ?string $user, #[SensitiveParameter] ?string $pass, ?string $host, ?int $port, string $path, ?string $query, ?string $fragment ) { $this->scheme = $this->formatScheme($scheme); $this->user = Encoder::encodeUser($user); $this->pass = Encoder::encodePassword($pass); $this->host = $this->formatHost($host); $this->port = $this->formatPort($port); $this->path = $this->formatPath($path); $this->query = Encoder::encodeQueryOrFragment($query); $this->fragment = Encoder::encodeQueryOrFragment($fragment); $this->userInfo = $this->formatUserInfo($this->user, $this->pass); $this->authority = UriString::buildAuthority($this->toComponents()); $this->uri = UriString::buildUri($this->scheme, $this->authority, $this->path, $this->query, $this->fragment); $this->assertValidState(); } /* * Format the Scheme and Host component. * * @throws SyntaxError if the scheme is invalid / private function formatScheme(?string $scheme): ?string { if (null === $scheme) { return null; } $formattedScheme = strtolower($scheme); static $cache = []; if (isset($cache[$formattedScheme])) { return $formattedScheme; } if ( !array_key_exists($formattedScheme, self::SCHEME_DEFAULT_PORT) && 1 !== preg_match(self::REGEXP_SCHEME, $formattedScheme) ) { throw new SyntaxError('The scheme `'.$scheme.'` is invalid.'); } $cache[$formattedScheme] = 1; if (self::MAXIMUM_CACHED_ITEMS < count($cache)) { array_shift($cache); } return $formattedScheme; } /* * Set the UserInfo component. / private function formatUserInfo( ?string $user, #[SensitiveParameter] ?string $password ): ?string { return match (null) { $password => $user, default => $user.':'.$password, }; } /* * Validate and Format the Host component. / private function formatHost(?string $host): ?string { if (null === $host \|\| '' === $host) { return $host; } static $cache = []; if (isset($cache[$host])) { return $cache[$host]; } $formattedHost = '[' === $host[0] ? $this->formatIp($host) : $this->formatRegisteredName($host); $cache[$host] = $formattedHost; if (self::MAXIMUM_CACHED_ITEMS < count($cache)) { array_shift($cache); } return $formattedHost; } /* * Validate and format a registered name. * * The host is converted to its ascii representation if needed * * @throws MissingFeature if the submitted host required missing or misconfigured IDN support * @throws SyntaxError if the submitted host is not a valid registered name * @throws ConversionFailed if the submitted IDN host cannot be converted to a valid ascii form / private function formatRegisteredName(string $host): string { $formattedHost = rawurldecode($host); return match (1) { preg_match(self::REGEXP_HOST_REGNAME, $formattedHost) => $formattedHost, preg_match(self::REGEXP_HOST_GEN_DELIMS, $formattedHost) => throw new SyntaxError('The host `'.$host.'` is invalid : a registered name cannot contain URI delimiters or spaces.'), default => IdnConverter::toAsciiOrFail($host), }; } /* * Validate and Format the IPv6/IPvfuture host. * * @throws SyntaxError if the submitted host is not a valid IP host / private function formatIp(string $host): string { $ip = substr($host, 1, -1); if (false !== filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) { return $host; } if (1 === preg_match(self::REGEXP_HOST_IP_FUTURE, $ip, $matches) && !in_array($matches['version'], ['4', '6'], true)) { return $host; } $pos = strpos($ip, '%'); if (false === $pos) { throw new SyntaxError('The host `'.$host.'` is invalid : the IP host is malformed.'); } if (1 === preg_match(self::REGEXP_HOST_GEN_DELIMS, rawurldecode(substr($ip, $pos)))) { throw new SyntaxError('The host `'.$host.'` is invalid : the IP host is malformed.'); } $ip = substr($ip, 0, $pos); if (false === filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) { throw new SyntaxError('The host `'.$host.'` is invalid : the IP host is malformed.'); } //Only the address block fe80::/10 can have a Zone ID attach to //let's detect the link local significant 10 bits if (str_starts_with((string)inet_pton($ip), self::HOST_ADDRESS_BLOCK)) { return $host; } throw new SyntaxError('The host `'.$host.'` is invalid : the IP host is malformed.'); } /* * Format the Port component. * * @throws SyntaxError / private function formatPort(?int $port = null): ?int { $defaultPort = self::SCHEME_DEFAULT_PORT[$this->scheme] ?? null; return match (true) { null === $port, $defaultPort === $port => null, 0 > $port => throw new SyntaxError('The port `'.$port.'` is invalid.'), default => $port, }; } /* * Create a new instance from a string. / public static function new(Stringable\|string $uri = ''): self { $components = match (true) { $uri instanceof UriInterface => $uri->toComponents(), default => UriString::parse($uri), }; return new self( $components['scheme'], $components['user'], $components['pass'], $components['host'], $components['port'], $components['path'], $components['query'], $components['fragment'] ); } /* * Creates a new instance from a URI and a Base URI. * * The returned URI must be absolute. / public static function fromBaseUri( Stringable\|string $uri, Stringable\|string\|null $baseUri = null ): self { $uri = self::new($uri); $baseUri = BaseUri::from($baseUri ?? $uri); /* @var self $uri / $uri = match (true) { $baseUri->isAbsolute() => $baseUri->resolve($uri)->getUri(), default => throw new SyntaxError('the URI `'.$baseUri.'` must be absolute.'), }; return $uri; } /* * Creates a new instance from a template. * * @throws TemplateCanNotBeExpanded if the variables are invalid or missing * @throws UriException if the resulting expansion cannot be converted to a UriInterface instance / public static function fromTemplate(UriTemplate\|Stringable\|string $template, iterable $variables = []): self { return match (true) { $template instanceof UriTemplate => self::fromComponents($template->expand($variables)->toComponents()), $template instanceof UriTemplate\Template => self::new($template->expand($variables)), default => self::new(UriTemplate\Template::new($template)->expand($variables)), }; } /* * Create a new instance from a hash representation of the URI similar * to PHP parse_url function result. * * @param InputComponentMap $components a hash representation of the URI similar to PHP parse_url function result / public static function fromComponents(array $components = []): self { $components += [ 'scheme' => null, 'user' => null, 'pass' => null, 'host' => null, 'port' => null, 'path' => '', 'query' => null, 'fragment' => null, ]; if (null === $components['path']) { $components['path'] = ''; } return new self( $components['scheme'], $components['user'], $components['pass'], $components['host'], $components['port'], $components['path'], $components['query'], $components['fragment'] ); } /* * Create a new instance from a data file path. * * @param resource\|null $context * * @throws MissingFeature If ext/fileinfo is not installed * @throws SyntaxError If the file does not exist or is not readable / public static function fromFileContents(Stringable\|string $path, $context = null): self { FeatureDetection::supportsFileDetection(); $path = (string) $path; $fileArguments = [$path, false]; $mimeArguments = [$path, FILEINFO_MIME]; if (null !== $context) { $fileArguments[] = $context; $mimeArguments[] = $context; } set_error_handler(fn (int $errno, string $errstr, string $errfile, int $errline) => true); $raw = file_get_contents(...$fileArguments); restore_error_handler(); if (false === $raw) { throw new SyntaxError('The file `'.$path.'` does not exist or is not readable.'); } $mimetype = (string) (new finfo(FILEINFO_MIME))->file(...$mimeArguments); return Uri::fromComponents([ 'scheme' => 'data', 'path' => str_replace(' ', '', $mimetype.';base64,'.base64_encode($raw)), ]); } /* * Create a new instance from a data URI string. * * @throws SyntaxError If the parameter syntax is invalid / public static function fromData(string $data, string $mimetype = '', string $parameters = ''): self { static $regexpMimetype = ',^\w+/[-.\w]+(?:\+[-.\w]+)?$,'; $mimetype = match (true) { '' === $mimetype => 'text/plain', 1 === preg_match($regexpMimetype, $mimetype) => $mimetype, default => throw new SyntaxError('Invalid mimeType, `'.$mimetype.'`.'), }; if ('' === $parameters) { return self::fromComponents([ 'scheme' => 'data', 'path' => self::formatDataPath($mimetype.','.rawurlencode($data)), ]); } $isInvalidParameter = static function (string $parameter): bool { $properties = explode('=', $parameter); return 2 !== count($properties) \|\| 'base64' === strtolower($properties[0]); }; if (str_starts_with($parameters, ';')) { $parameters = substr($parameters, 1); } return match ([]) { array_filter(explode(';', $parameters), $isInvalidParameter) => self::fromComponents([ 'scheme' => 'data', 'path' => self::formatDataPath($mimetype.';'.$parameters.','.rawurlencode($data)), ]), default => throw new SyntaxError(sprintf('Invalid mediatype parameters, `%s`.', $parameters)) }; } /* * Create a new instance from a Unix path string. / public static function fromUnixPath(Stringable\|string $path): self { $path = implode('/', array_map(rawurlencode(...), explode('/', (string) $path))); return Uri::fromComponents(match (true) { '/' !== ($path[0] ?? '') => ['path' => $path], default => ['path' => $path, 'scheme' => 'file', 'host' => ''], }); } /* * Create a new instance from a local Windows path string. / public static function fromWindowsPath(Stringable\|string $path): self { $path = (string) $path; $root = ''; if (1 === preg_match(self::REGEXP_WINDOW_PATH, $path, $matches)) { $root = substr($matches['root'], 0, -1).':'; $path = substr($path, strlen($root)); } $path = str_replace('\\', '/', $path); $path = implode('/', array_map(rawurlencode(...), explode('/', $path))); //Local Windows absolute path if ('' !== $root) { return Uri::fromComponents(['path' => '/'.$root.$path, 'scheme' => 'file', 'host' => '']); } //UNC Windows Path if (!str_starts_with($path, '//')) { return Uri::fromComponents(['path' => $path]); } [$host, $path] = explode('/', substr($path, 2), 2) + [1 => '']; return Uri::fromComponents(['host' => $host, 'path' => '/'.$path, 'scheme' => 'file']); } /* * Creates a new instance from a RFC8089 compatible URI. * * @see https://datatracker.ietf.org/doc/html/rfc8089 / public static function fromRfc8089(Stringable\|string $uri): UriInterface { $fileUri = self::new((string) preg_replace(',^(file:/)([^/].)$,i', 'file:///$2', (string) $uri)); $scheme = $fileUri->getScheme(); return match (true) { 'file' !== $scheme => throw new SyntaxError('As per RFC8089, the URI scheme must be `file`.'), 'localhost' === $fileUri->getAuthority() => $fileUri->withHost(''), default => $fileUri, }; } /** * Create a new instance from the environment. / public static function fromServer(array $server): self { $components = ['scheme' => self::fetchScheme($server)]; [$components['user'], $components['pass']] = self::fetchUserInfo($server); [$components['host'], $components['port']] = self::fetchHostname($server); [$components['path'], $components['query']] = self::fetchRequestUri($server); return Uri::fromComponents($components); } /* * Returns the environment scheme. / private static function fetchScheme(array $server): string { $server += ['HTTPS' => '']; return match (true) { false !== filter_var($server['HTTPS'], FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE) => 'https', default => 'http', }; } /* * Returns the environment user info. * * @return non-empty-array{0: ?string, 1: ?string} / private static function fetchUserInfo(array $server): array { $server += ['PHP_AUTH_USER' => null, 'PHP_AUTH_PW' => null, 'HTTP_AUTHORIZATION' => '']; $user = $server['PHP_AUTH_USER']; $pass = $server['PHP_AUTH_PW']; if (str_starts_with(strtolower($server['HTTP_AUTHORIZATION']), 'basic')) { $userinfo = base64_decode(substr($server['HTTP_AUTHORIZATION'], 6), true); if (false === $userinfo) { throw new SyntaxError('The user info could not be detected'); } [$user, $pass] = explode(':', $userinfo, 2) + [1 => null]; } if (null !== $user) { $user = rawurlencode($user); } if (null !== $pass) { $pass = rawurlencode($pass); } return [$user, $pass]; } /* * Returns the environment host. * * @throws SyntaxError If the host cannot be detected * * @return array{0:string\|null, 1:int\|null} / private static function fetchHostname(array $server): array { $server += ['SERVER_PORT' => null]; if (null !== $server['SERVER_PORT']) { $server['SERVER_PORT'] = (int) $server['SERVER_PORT']; } if (isset($server['HTTP_HOST']) && 1 === preg_match(self::REGEXP_HOST_PORT, $server['HTTP_HOST'], $matches)) { $matches += ['host' => null, 'port' => null]; if (null !== $matches['port']) { $matches['port'] = (int) $matches['port']; } return [$matches['host'], $matches['port'] ?? $server['SERVER_PORT']]; } if (!isset($server['SERVER_ADDR'])) { throw new SyntaxError('The host could not be detected'); } if (false === filter_var($server['SERVER_ADDR'], FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) { return ['['.$server['SERVER_ADDR'].']', $server['SERVER_PORT']]; } return [$server['SERVER_ADDR'], $server['SERVER_PORT']]; } /* * Returns the environment path. * * @return list<?string> / private static function fetchRequestUri(array $server): array { $server += ['IIS_WasUrlRewritten' => null, 'UNENCODED_URL' => '', 'PHP_SELF' => '', 'QUERY_STRING' => null]; if ('1' === $server['IIS_WasUrlRewritten'] && '' !== $server['UNENCODED_URL']) { return explode('?', $server['UNENCODED_URL'], 2) + [1 => null]; } if (isset($server['REQUEST_URI'])) { [$path] = explode('?', $server['REQUEST_URI'], 2); $query = ('' !== $server['QUERY_STRING']) ? $server['QUERY_STRING'] : null; return [$path, $query]; } return [$server['PHP_SELF'], $server['QUERY_STRING']]; } /* * Format the Path component. / private function formatPath(string $path): string { return match ($this->scheme) { 'data' => Encoder::encodePath(self::formatDataPath($path)), 'file' => $this->formatFilePath(Encoder::encodePath($path)), default => Encoder::encodePath($path), }; } /* * Filter the Path component. * * @link https://tools.ietf.org/html/rfc2397 * * @throws SyntaxError If the path is not compliant with RFC2397 / private static function formatDataPath(string $path): string { if ('' == $path) { return 'text/plain;charset=us-ascii,'; } if (strlen($path) !== strspn($path, self::ASCII) \|\| !str_contains($path, ',')) { throw new SyntaxError('The path `'.$path.'` is invalid according to RFC2937.'); } $parts = explode(',', $path, 2) + [1 => null]; $mediatype = explode(';', (string) $parts[0], 2) + [1 => null]; $data = (string) $parts[1]; $mimetype = $mediatype[0]; if (null === $mimetype \|\| '' === $mimetype) { $mimetype = 'text/plain'; } $parameters = $mediatype[1]; if (null === $parameters \|\| '' === $parameters) { $parameters = 'charset=us-ascii'; } self::assertValidPath($mimetype, $parameters, $data); return $mimetype.';'.$parameters.','.$data; } /* * Assert the path is a compliant with RFC2397. * * @link https://tools.ietf.org/html/rfc2397 * * @throws SyntaxError If the mediatype or the data are not compliant with the RFC2397 / private static function assertValidPath(string $mimetype, string $parameters, string $data): void { if (1 !== preg_match(self::REGEXP_MIMETYPE, $mimetype)) { throw new SyntaxError('The path mimetype `'.$mimetype.'` is invalid.'); } $isBinary = 1 === preg_match(self::REGEXP_BINARY, $parameters, $matches); if ($isBinary) { $parameters = substr($parameters, 0, - strlen($matches[0])); } $res = array_filter(array_filter(explode(';', $parameters), self::validateParameter(...))); if ([] !== $res) { throw new SyntaxError('The path parameters `'.$parameters.'` is invalid.'); } if (!$isBinary) { return; } $res = base64_decode($data, true); if (false === $res \|\| $data !== base64_encode($res)) { throw new SyntaxError('The path data `'.$data.'` is invalid.'); } } /* * Validate mediatype parameter. / private static function validateParameter(string $parameter): bool { $properties = explode('=', $parameter); return 2 != count($properties) \|\| 'base64' === strtolower($properties[0]); } /* * Format path component for file scheme. / private function formatFilePath(string $path): string { return (string) preg_replace_callback( self::REGEXP_FILE_PATH, static fn (array $matches): string => $matches['delim'].$matches['volume'].(isset($matches['rest']) ? ':'.$matches['rest'] : ''), $path ); } /* * assert the URI internal state is valid. * * @link https://tools.ietf.org/html/rfc3986#section-3 * @link https://tools.ietf.org/html/rfc3986#section-3.3 * * @throws SyntaxError if the URI is in an invalid state according to RFC3986 * @throws SyntaxError if the URI is in an invalid state according to scheme specific rules / private function assertValidState(): void { if (null !== $this->authority && ('' !== $this->path && '/' !== $this->path[0])) { throw new SyntaxError('If an authority is present the path must be empty or start with a `/`.'); } if (null === $this->authority && str_starts_with($this->path, '//')) { throw new SyntaxError('If there is no authority the path `'.$this->path.'` cannot start with a `//`.'); } $pos = strpos($this->path, ':'); if (null === $this->authority && null === $this->scheme && false !== $pos && !str_contains(substr($this->path, 0, $pos), '/') ) { throw new SyntaxError('In absence of a scheme and an authority the first path segment cannot contain a colon (":") character.'); } if (! match ($this->scheme) { 'data' => $this->isUriWithSchemeAndPathOnly(), 'file' => $this->isUriWithSchemeHostAndPathOnly(), 'ftp', 'gopher' => $this->isNonEmptyHostUriWithoutFragmentAndQuery(), 'http', 'https' => $this->isNonEmptyHostUri(), 'ws', 'wss' => $this->isNonEmptyHostUriWithoutFragment(), default => true, }) { throw new SyntaxError('The uri `'.$this->uri.'` is invalid for the `'.$this->scheme.'` scheme.'); } } /* * URI validation for URI schemes which allows only scheme and path components. / private function isUriWithSchemeAndPathOnly(): bool { return null === $this->authority && null === $this->query && null === $this->fragment; } /* * URI validation for URI schemes which allows only scheme, host and path components. / private function isUriWithSchemeHostAndPathOnly(): bool { return null === $this->userInfo && null === $this->port && null === $this->query && null === $this->fragment && !('' != $this->scheme && null === $this->host); } /* * URI validation for URI schemes which disallow the empty '' host. / private function isNonEmptyHostUri(): bool { return '' !== $this->host && !(null !== $this->scheme && null === $this->host); } /* * URI validation for URIs schemes which disallow the empty '' host * and forbids the fragment component. / private function isNonEmptyHostUriWithoutFragment(): bool { return $this->isNonEmptyHostUri() && null === $this->fragment; } /* * URI validation for URIs schemes which disallow the empty '' host * and forbids fragment and query components. / private function isNonEmptyHostUriWithoutFragmentAndQuery(): bool { return $this->isNonEmptyHostUri() && null === $this->fragment && null === $this->query; } public function toString(): string { return $this->uri; } /* * {@inheritDoc} / public function __toString(): string { return $this->toString(); } /* * {@inheritDoc} / public function jsonSerialize(): string { return $this->toString(); } /* * @return ComponentMap / public function toComponents(): array { return [ 'scheme' => $this->scheme, 'user' => $this->user, 'pass' => $this->pass, 'host' => $this->host, 'port' => $this->port, 'path' => $this->path, 'query' => $this->query, 'fragment' => $this->fragment, ]; } /* * {@inheritDoc} / public function getScheme(): ?string { return $this->scheme; } /* * {@inheritDoc} / public function getAuthority(): ?string { return $this->authority; } /* * {@inheritDoc} / public function getUsername(): ?string { return $this->user; } /* * {@inheritDoc} / public function getPassword(): ?string { return $this->pass; } /* * {@inheritDoc} / public function getUserInfo(): ?string { return $this->userInfo; } /* * {@inheritDoc} / public function getHost(): ?string { return $this->host; } /* * {@inheritDoc} / public function getPort(): ?int { return $this->port; } /* * {@inheritDoc} / public function getPath(): string { return match (true) { str_starts_with($this->path, '//') => '/'.ltrim($this->path, '/'), default => $this->path, }; } /* * {@inheritDoc} / public function getQuery(): ?string { return $this->query; } /* * {@inheritDoc} / public function getFragment(): ?string { return $this->fragment; } /* * {@inheritDoc} / public function withScheme(Stringable\|string\|null $scheme): UriInterface { $scheme = $this->formatScheme($this->filterString($scheme)); return match ($scheme) { $this->scheme => $this, default => new self( $scheme, $this->user, $this->pass, $this->host, $this->port, $this->path, $this->query, $this->fragment, ), }; } /* * Filter a string. * * @throws SyntaxError if the submitted data cannot be converted to string / private function filterString(Stringable\|string\|null $str): ?string { $str = match (true) { $str instanceof UriComponentInterface => $str->value(), null === $str => null, default => (string) $str, }; return match (true) { null === $str => null, 1 === preg_match(self::REGEXP_INVALID_CHARS, $str) => throw new SyntaxError('The component `'.$str.'` contains invalid characters.'), default => $str, }; } public function withUserInfo( Stringable\|string\|null $user, #[SensitiveParameter] Stringable\|string\|null $password = null ): UriInterface { $user = Encoder::encodeUser($this->filterString($user)); $pass = Encoder::encodePassword($this->filterString($password)); $userInfo = ('' !== $user) ? $this->formatUserInfo($user, $pass) : null; return match ($userInfo) { $this->userInfo => $this, default => new self( $this->scheme, $user, $pass, $this->host, $this->port, $this->path, $this->query, $this->fragment, ), }; } public function withHost(Stringable\|string\|null $host): UriInterface { $host = $this->formatHost($this->filterString($host)); return match ($host) { $this->host => $this, default => new self( $this->scheme, $this->user, $this->pass, $host, $this->port, $this->path, $this->query, $this->fragment, ), }; } public function withPort(int\|null $port): UriInterface { $port = $this->formatPort($port); return match ($port) { $this->port => $this, default => new self( $this->scheme, $this->user, $this->pass, $this->host, $port, $this->path, $this->query, $this->fragment, ), }; } public function withPath(Stringable\|string $path): UriInterface { $path = $this->formatPath( $this->filterString($path) ?? throw new SyntaxError('The path component cannot be null.') ); return match ($path) { $this->path => $this, default => new self( $this->scheme, $this->user, $this->pass, $this->host, $this->port, $path, $this->query, $this->fragment, ), }; } public function withQuery(Stringable\|string\|null $query): UriInterface { $query = Encoder::encodeQueryOrFragment($this->filterString($query)); return match ($query) { $this->query => $this, default => new self( $this->scheme, $this->user, $this->pass, $this->host, $this->port, $this->path, $query, $this->fragment, ), }; } public function withFragment(Stringable\|string\|null $fragment): UriInterface { $fragment = Encoder::encodeQueryOrFragment($this->filterString($fragment)); return match ($fragment) { $this->fragment => $this, default => new self( $this->scheme, $this->user, $this->pass, $this->host, $this->port, $this->path, $this->query, $fragment, ), }; } /* * DEPRECATION WARNING! This method will be removed in the next major point release. * * @deprecated Since version 7.5.0 * @codeCoverageIgnore * @see Uri::toComponents() * * @return ComponentMap / #[Deprecated(message:'use League\Uri\Uri::toComponents() instead', since:'league/uri:7.5.0')] public function getComponents(): array { return $this->toComponents(); } /* * DEPRECATION WARNING! This method will be removed in the next major point release. * * @deprecated Since version 7.0.0 * @codeCoverageIgnore * @see Uri::new() / #[Deprecated(message:'use League\Uri\Uri::new() instead', since:'league/uri:7.0.0')] public static function createFromString(Stringable\|string $uri = ''): self { return self::new($uri); } /* * DEPRECATION WARNING! This method will be removed in the next major point release. * * @deprecated Since version 7.0.0 * @codeCoverageIgnore * @see Uri::fromComponents() * * @param InputComponentMap $components a hash representation of the URI similar to PHP parse_url function result / #[Deprecated(message:'use League\Uri\Uri::fromComponents() instead', since:'league/uri:7.0.0')] public static function createFromComponents(array $components = []): self { return self::fromComponents($components); } /* * DEPRECATION WARNING! This method will be removed in the next major point release. * * @param resource\|null $context * * @throws MissingFeature If ext/fileinfo is not installed * @throws SyntaxError If the file does not exist or is not readable * @see Uri::fromFileContents() * * @deprecated Since version 7.0.0 * @codeCoverageIgnore / #[Deprecated(message:'use League\Uri\Uri::fromDataPath() instead', since:'league/uri:7.0.0')] public static function createFromDataPath(string $path, $context = null): self { return self::fromFileContents($path, $context); } /* * DEPRECATION WARNING! This method will be removed in the next major point release. * * @deprecated Since version 7.0.0 * @codeCoverageIgnore * @see Uri::fromBaseUri() * * Creates a new instance from a URI and a Base URI. * * The returned URI must be absolute. / #[Deprecated(message:'use League\Uri\Uri::fromBaseUri() instead', since:'league/uri:7.0.0')] public static function createFromBaseUri( Stringable\|UriInterface\|String $uri, Stringable\|UriInterface\|String\|null $baseUri = null ): UriInterface { return self::fromBaseUri($uri, $baseUri); } /* * DEPRECATION WARNING! This method will be removed in the next major point release. * * @deprecated Since version 7.0.0 * @codeCoverageIgnore * @see Uri::fromUnixPath() * * Create a new instance from a Unix path string. / #[Deprecated(message:'use League\Uri\Uri::fromUnixPath() instead', since:'league/uri:7.0.0')] public static function createFromUnixPath(string $uri = ''): self { return self::fromUnixPath($uri); } /* * DEPRECATION WARNING! This method will be removed in the next major point release. * * @deprecated Since version 7.0.0 * @codeCoverageIgnore * @see Uri::fromWindowsPath() * * Create a new instance from a local Windows path string. / #[Deprecated(message:'use League\Uri\Uri::fromWindowsPath() instead', since:'league/uri:7.0.0')] public static function createFromWindowsPath(string $uri = ''): self { return self::fromWindowsPath($uri); } /* * DEPRECATION WARNING! This method will be removed in the next major point release. * * @deprecated Since version 7.0.0 * @codeCoverageIgnore * @see Uri::new() * * Create a new instance from a URI object. / #[Deprecated(message:'use League\Uri\Uri::new() instead', since:'league/uri:7.0.0')] public static function createFromUri(Psr7UriInterface\|UriInterface $uri): self { return self::new($uri); } /* * DEPRECATION WARNING! This method will be removed in the next major point release. * * @deprecated Since version 7.0.0 * @codeCoverageIgnore * @see Uri::fromServer() * * Create a new instance from the environment. */ #[Deprecated(message:'use League\Uri\Uri::fromServer() instead', since:'league/uri:7.0.0')] public static function createFromServer(array $server): self { return self::fromServer($server); } }

| ver. 1.4 | Github | . | PHP 8.3.30 | Generation time: 1.29 | proxy | phpinfo | Settings