1. class
  2. Soosyze
  3. \
  4. Components
  5. \
  6. Http
  7. \
  8. Uri

Uri

class Uri implements UriInterface (View source)

Implementation de l'interface UriInterface. Classe Représentant les adresses URI selon RFC 3986 et à fournir des méthodes pour la plupart des opérations courantes.

Properties

protected string $scheme Schéma de l'URI (http(s)|ftp|mailto|file.
protected string $user Utilisateur (partie de l'authority).
protected string $password Mot de passe (partie de l'authority).
protected string $host Nom d'hôte, nom enregistré ou une adresse IP (partie de l'authority).
protected int $port Port (80 pour le http, 443 pour le https).
protected string $path Chemin de l'URI.
protected string $query Requête encodée.
protected string $fragment Fragment (ou ancre) encodée.
protected array $ports Les ports supportés.

Methods

__construct(string $scheme = '', string $host = '', string $path = '/', int|null $port = null, string $query = '', string $fragment = '', string $user = '', string $password = '')

Construit une URI à partir de chacun de ses attributs.

string
__toString()

Renvoie la représentation sous forme de chaîne en tant que référence d'URI.

string
getScheme()

Retourne le schéma de l'URI normalisé en minuscule sans le caractère ":".

string
getAuthority()

Retourne l'autorité de l'URI ou une chaine vide si l'information d'autorité n'est pas présente.

string
getUserInfo()

Retourne les informations utilisateur de l'URI ou une chaine vide s'il n'y a aucune information.

string
getHost()

Retourne l'hôte de l'URI normalisé en minuscule ou une chaine vide si l'hôte est absent.

null|int
getPort()

Retourne le port de l'URI si il présent et non standard pour le schéma actuel, sinon retourne null.

string
getPath()

Retourne le chemin de l'URI encodé.

string
getQuery()

Retourne la chaîne de requête de l'URI encodé.

string
getFragment()

Retourne le fragment de l'URI encodée en pourcentage sans le caractère "#" principale, sinon une chaine vide.

Uri
withScheme(string $scheme)

Renvoie une instance avec le schéma spécifié, doit soutenir les schémas "http" et "https".

Uri
withUserInfo(string $user, null|string $password = null)

Renvoyer une instance avec les informations utilisateur spécifiées.

Uri
withHost(string $host)

Renvoie une instance avec l'hôte spécifié.

Uri
withPort(null|int $port)

Renvoie une instance avec le port spécifié.

Uri
withPath(string $path)

Renvoie une instance avec le chemin spécifié.

Uri
withQuery(string $query)

Renvoie une instance avec la chaîne de requête spécifiée.

Uri
withFragment(string $fragment)

Renvoie une instance avec le fragment URI spécifié.

string
getBasePath()

Retourne l'URL contenu dans l'URI.

static bool
validePort(int $port)

Retourne si le port est dans la gamme des ports TCP / UDP.

static Uri
create(string $uri)

Créer une URI.

string
filterScheme(string|null $sch = '')

Filtre un schéma.

int|null
filterPort(string|int|null $port)

Filtre un port.

string
filterQuery(string|null $query)

Filtre une requête.

string
filterFragment(string|null $fragment)

Filtre une ancre.

string
filterPath(string|null $path)

Filtre un chemin.

string
filterString(string $value)

Filtre une chaine de caractère.

string
filterStringToLower(string $value)

Filtre une chaine de caractère et la renvoie en minuscule.

bool
validPortStandard(int $port)

Si le port est prise en charge.

string
rawurldecodeValue(string $query)

Analyse une requête HTTP et génère une chaîne de requête en encodage URL.

Details

at line 106
__construct(string $scheme = '', string $host = '', string $path = '/', int|null $port = null, string $query = '', string $fragment = '', string $user = '', string $password = '')

Construit une URI à partir de chacun de ses attributs.

Parameters

string $scheme $_SERVER['REQUEST_SCHEME']
string $host $_SERVER['HTTP_HOST']
string $path $_SERVER['PHP_SELF']
int|null $port $_SERVER['SERVER_PORT']
string $query $_SERVER['QUERY_STRING']
string $fragment
string $user
string $password

at line 133
string __toString()

Renvoie la représentation sous forme de chaîne en tant que référence d'URI.

Return Value

string L'URI.

See also

http://tools.ietf.org/html/rfc3986#section-4.1

at line 161
string getScheme()

Retourne le schéma de l'URI normalisé en minuscule sans le caractère ":".

Return Value

string Schéma de l'URI ou une chaine vide.

See also

https://tools.ietf.org/html/rfc3986#section-3.1

at line 174
string getAuthority()

Retourne l'autorité de l'URI ou une chaine vide si l'information d'autorité n'est pas présente.

Return Value

string Autorité de l'URI, au format "[user-info@]host[:port]".

See also

https://tools.ietf.org/html/rfc3986#section-3.2*

at line 194
string getUserInfo()

Retourne les informations utilisateur de l'URI ou une chaine vide s'il n'y a aucune information.

Return Value

string Informations de l'utilisateur de l'URI, au format "nom d'utilisateur[:mot de passe]".

at line 213
string getHost()

Retourne l'hôte de l'URI normalisé en minuscule ou une chaine vide si l'hôte est absent.

Return Value

string Hôte de l'URI.

See also

http://tools.ietf.org/html/rfc3986#section-3.2.2

at line 224
null|int getPort()

Retourne le port de l'URI si il présent et non standard pour le schéma actuel, sinon retourne null.

Return Value

null|int Port de l'URI.

at line 237
string getPath()

Retourne le chemin de l'URI encodé.

Return Value

string Chemin de l'URI.

See also

https://tools.ietf.org/html/rfc3986#section-2
https://tools.ietf.org/html/rfc3986#section-3.3

at line 250
string getQuery()

Retourne la chaîne de requête de l'URI encodé.

Return Value

string Chaîne de requête de l'URI.

See also

https://tools.ietf.org/html/rfc3986#section-2
https://tools.ietf.org/html/rfc3986#section-3.4

at line 264
string getFragment()

Retourne le fragment de l'URI encodée en pourcentage sans le caractère "#" principale, sinon une chaine vide.

Return Value

string Fragment de requête de l'URI.

See also

https://tools.ietf.org/html/rfc3986#section-2
https://tools.ietf.org/html/rfc3986#section-3.5

at line 278
Uri withScheme(string $scheme)

Renvoie une instance avec le schéma spécifié, doit soutenir les schémas "http" et "https".

Parameters

string $scheme Schéma à utiliser avec la nouvelle instance.

Return Value

Uri Nouvelle instance avec le schéma spécifié.

Exceptions

InvalidArgumentException pour les schémas invalides ou non pris en charge.

at line 294
Uri withUserInfo(string $user, null|string $password = null)

Renvoyer une instance avec les informations utilisateur spécifiées.

Parameters

string $user Nom d'utilisateur à utiliser pour l'autorité.
null|string $password Mot de passe associé à $user.

Return Value

Uri Nouvelle instance avec les informations utilisateur spécifiées.

at line 314
Uri withHost(string $host)

Renvoie une instance avec l'hôte spécifié.

Une valeur d'hôte vide équivaut à supprimer l'hôte.

Parameters

string $host Nom d'hôte à utiliser avec la nouvelle instance.

Return Value

Uri Nouvelle instance avec l'hôte spécifié.

Exceptions

InvalidArgumentException Noms d'hôtes non valides.

at line 333
Uri withPort(null|int $port)

Renvoie une instance avec le port spécifié.

Les implémentations DOIVENT soulever une exception pour les ports en dehors de la Les gammes de ports TCP et UDP établies.

Parameters

null|int $port Port à utiliser avec la nouvelle instance; Une valeur nulle Supprime les informations du port.

Return Value

Uri Nouvelle instance avec le port spécifié.

Exceptions

InvalidArgumentException Ports non valides.

at line 349
Uri withPath(string $path)

Renvoie une instance avec le chemin spécifié.

Parameters

string $path Chemin d'accès à utiliser avec la nouvelle instance.

Return Value

Uri Nouvelle instance avec le chemin spécifié.

Exceptions

InvalidArgumentException Chemins d'accès non valides.

at line 365
Uri withQuery(string $query)

Renvoie une instance avec la chaîne de requête spécifiée.

Parameters

string $query Chaîne de requête à utiliser avec la nouvelle instance.

Return Value

Uri Nouvelle instance avec la chaîne de requête spécifiée.

Exceptions

InvalidArgumentException Chaînes de requêtes non valides.

at line 380
Uri withFragment(string $fragment)

Renvoie une instance avec le fragment URI spécifié.

Parameters

string $fragment Le fragment à utiliser avec la nouvelle instance.

Return Value

Uri Une nouvelle instance avec le fragment spécifié.

at line 395
string getBasePath()

Retourne l'URL contenu dans l'URI.

Cette méthode ne fait pas partie de la norme PSR-7

Return Value

string L'URL.

at line 410
static bool validePort(int $port)

Retourne si le port est dans la gamme des ports TCP / UDP.

Cette méthode ne fait pas partie de la norme PSR-7

Parameters

int $port Port à tester.

Return Value

bool

at line 425
static Uri create(string $uri)

Créer une URI.

Cette méthode ne fait pas partie de la norme PSR-7

Parameters

string $uri

Return Value

Uri Nouvelle instance d'URI.

Exceptions

InvalidArgumentException

at line 467
protected string filterScheme(string|null $sch = '')

Filtre un schéma.

Parameters

string|null $sch Schéma à filtrer.

Return Value

string Schéma normalisé.

Exceptions

InvalidArgumentException Le schéma n'est pas pris en compte.

at line 492
protected int|null filterPort(string|int|null $port)

Filtre un port.

Parameters

string|int|null $port Port à filtrer.

Return Value

int|null Port normalisé.

Exceptions

InvalidArgumentException Le port n'est pas dans la gamme des ports TCP/UDP.

at line 514
protected string filterQuery(string|null $query)

Filtre une requête.

Parameters

string|null $query Requête à filtrer.

Return Value

string Requête normalisée.

at line 529
protected string filterFragment(string|null $fragment)

Filtre une ancre.

Parameters

string|null $fragment Ancre à filtrer.

Return Value

string Ancre normalisée.

at line 544
protected string filterPath(string|null $path)

Filtre un chemin.

Parameters

string|null $path Chemin à filtrer.

Return Value

string Chemin normalisé.

at line 566
protected string filterString(string $value)

Filtre une chaine de caractère.

Parameters

string $value Chaine de caractère à filtrer.

Return Value

string Chaine de caractère normalisée.

at line 585
protected string filterStringToLower(string $value)

Filtre une chaine de caractère et la renvoie en minuscule.

Parameters

string $value Chaine de caractère à filtrer.

Return Value

string Chaine de caractère filtré.

at line 597
protected bool validPortStandard(int $port)

Si le port est prise en charge.

Parameters

int $port

Return Value

bool

at line 612
protected string rawurldecodeValue(string $query)

Analyse une requête HTTP et génère une chaîne de requête en encodage URL.

Parameters

string $query Requête HTTP.

Return Value

string Chaine de requête en encodage URL.