PHP Класс GuzzleHttp\Psr7\Uri

См. ссылку: This class is based upon Matthew Weier O'Phinney's URI implementation in phly/http.
Наследование: implements Psr\Http\Message\UriInterface
Показать файл Открыть проект Примеры использования класса

Открытые методы

Метод Описание
__construct ( string $uri = '' )
__toString ( )
composeComponents ( string $scheme, string $authority, string $path, string $query, string $fragment ) : string Composes a URI reference string from its various components.
fromParts ( array $parts ) : Psr\Http\Message\UriInterface Creates a URI from a hash of parse_url components.
getAuthority ( )
getFragment ( )
getHost ( )
getPath ( )
getPort ( )
getQuery ( )
getScheme ( )
getUserInfo ( )
isAbsolute ( Psr\Http\Message\UriInterface $uri ) : boolean Whether the URI is absolute, i.e. it has a scheme.
isAbsolutePathReference ( Psr\Http\Message\UriInterface $uri ) : boolean Whether the URI is a absolute-path reference.
isDefaultPort ( Psr\Http\Message\UriInterface $uri ) : boolean Whether the URI has the default port of the current scheme.
isNetworkPathReference ( Psr\Http\Message\UriInterface $uri ) : boolean Whether the URI is a network-path reference.
isRelativePathReference ( Psr\Http\Message\UriInterface $uri ) : boolean Whether the URI is a relative-path reference.
isSameDocumentReference ( Psr\Http\Message\UriInterface $uri, Psr\Http\Message\UriInterface $base = null ) : boolean Whether the URI is a same-document reference.
removeDotSegments ( string $path ) : string Removes dot segments from a path and returns the new path.
resolve ( Psr\Http\Message\UriInterface $base, string | Psr\Http\Message\UriInterface $rel ) : Psr\Http\Message\UriInterface Converts the relative URI into a new URI that is resolved against the base URI.
withFragment ( $fragment )
withHost ( $host )
withPath ( $path )
withPort ( $port )
withQuery ( $query )
withQueryValue ( Psr\Http\Message\UriInterface $uri, string $key, string | null $value ) : Psr\Http\Message\UriInterface Creates a new URI with a specific query string value.
withScheme ( $scheme )
withUserInfo ( $user, $password = null )
withoutQueryValue ( Psr\Http\Message\UriInterface $uri, string $key ) : Psr\Http\Message\UriInterface Creates a new URI with a specific query string value removed.

Приватные методы

Метод Описание
applyParts ( array $parts ) Apply parse_url parts to a URI.
filterHost ( string $host ) : string
filterPath ( string $path ) : string Filters the path of a URI
filterPort ( integer | null $port ) : integer | null
filterQueryAndFragment ( string $str ) : string Filters the query string or fragment of a URI.
filterScheme ( string $scheme ) : string
rawurlencodeMatchZero ( array $match )
removeDefaultPort ( )
validateState ( )

Описание методов

__construct() публичный Метод

public __construct ( string $uri = '' )
$uri string URI to parse

__toString() публичный Метод

public __toString ( )

composeComponents() публичный статический Метод

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 that format).
См. ссылку: https://tools.ietf.org/html/rfc3986#section-5.3
public static composeComponents ( string $scheme, string $authority, string $path, string $query, string $fragment ) : string
$scheme string
$authority string
$path string
$query string
$fragment string
Результат string

fromParts() публичный статический Метод

Creates a URI from a hash of parse_url components.
См. ссылку: http://php.net/manual/en/function.parse-url.php
public static fromParts ( array $parts ) : Psr\Http\Message\UriInterface
$parts array
Результат Psr\Http\Message\UriInterface

getAuthority() публичный Метод

public getAuthority ( )

getFragment() публичный Метод

public getFragment ( )

getHost() публичный Метод

public getHost ( )

getPath() публичный Метод

public getPath ( )

getPort() публичный Метод

public getPort ( )

getQuery() публичный Метод

public getQuery ( )

getScheme() публичный Метод

public getScheme ( )

getUserInfo() публичный Метод

public getUserInfo ( )

isAbsolute() публичный статический Метод

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'
См. также: Uri::isNetworkPathReference
См. также: Uri::isAbsolutePathReference
См. также: Uri::isRelativePathReference
См. ссылку: https://tools.ietf.org/html/rfc3986#section-4
public static isAbsolute ( Psr\Http\Message\UriInterface $uri ) : boolean
$uri Psr\Http\Message\UriInterface
Результат boolean

isAbsolutePathReference() публичный статический Метод

A relative reference that begins with a single slash character is termed an absolute-path reference.
См. ссылку: https://tools.ietf.org/html/rfc3986#section-4.2
public static isAbsolutePathReference ( Psr\Http\Message\UriInterface $uri ) : boolean
$uri Psr\Http\Message\UriInterface
Результат boolean

isDefaultPort() публичный статический Метод

Psr\Http\Message\UriInterface::getPort may return null or the standard port. This method can be used independently of the implementation.
public static isDefaultPort ( Psr\Http\Message\UriInterface $uri ) : boolean
$uri Psr\Http\Message\UriInterface
Результат boolean

isNetworkPathReference() публичный статический Метод

A relative reference that begins with two slash characters is termed an network-path reference.
См. ссылку: https://tools.ietf.org/html/rfc3986#section-4.2
public static isNetworkPathReference ( Psr\Http\Message\UriInterface $uri ) : boolean
$uri Psr\Http\Message\UriInterface
Результат boolean

isRelativePathReference() публичный статический Метод

A relative reference that does not begin with a slash character is termed a relative-path reference.
См. ссылку: https://tools.ietf.org/html/rfc3986#section-4.2
public static isRelativePathReference ( Psr\Http\Message\UriInterface $uri ) : boolean
$uri Psr\Http\Message\UriInterface
Результат boolean

isSameDocumentReference() публичный статический Метод

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.
См. ссылку: https://tools.ietf.org/html/rfc3986#section-4.4
public static isSameDocumentReference ( Psr\Http\Message\UriInterface $uri, Psr\Http\Message\UriInterface $base = null ) : boolean
$uri Psr\Http\Message\UriInterface The URI to check
$base Psr\Http\Message\UriInterface An optional base URI to compare against
Результат boolean

removeDotSegments() публичный статический Метод

Removes dot segments from a path and returns the new path.
См. также: UriResolver::removeDotSegments
Устаревший: since version 1.4. Use UriResolver::removeDotSegments instead.
public static removeDotSegments ( string $path ) : string
$path string
Результат string

resolve() публичный статический Метод

Converts the relative URI into a new URI that is resolved against the base URI.
См. также: UriResolver::resolve
Устаревший: since version 1.4. Use UriResolver::resolve instead.
public static resolve ( Psr\Http\Message\UriInterface $base, string | Psr\Http\Message\UriInterface $rel ) : Psr\Http\Message\UriInterface
$base Psr\Http\Message\UriInterface Base URI
$rel string | Psr\Http\Message\UriInterface Relative URI
Результат Psr\Http\Message\UriInterface

withFragment() публичный Метод

public withFragment ( $fragment )

withHost() публичный Метод

public withHost ( $host )

withPath() публичный Метод

public withPath ( $path )

withPort() публичный Метод

public withPort ( $port )

withQuery() публичный Метод

public withQuery ( $query )

withQueryValue() публичный статический Метод

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".
public static withQueryValue ( Psr\Http\Message\UriInterface $uri, string $key, string | null $value ) : Psr\Http\Message\UriInterface
$uri Psr\Http\Message\UriInterface URI to use as a base.
$key string Key to set.
$value string | null Value to set
Результат Psr\Http\Message\UriInterface

withScheme() публичный Метод

public withScheme ( $scheme )

withUserInfo() публичный Метод

public withUserInfo ( $user, $password = null )

withoutQueryValue() публичный статический Метод

Any existing query string values that exactly match the provided key are removed.
public static withoutQueryValue ( Psr\Http\Message\UriInterface $uri, string $key ) : Psr\Http\Message\UriInterface
$uri Psr\Http\Message\UriInterface URI to use as a base.
$key string Query string key to remove.
Результат Psr\Http\Message\UriInterface