ServerRequest
class ServerRequest extends Request implements ServerRequestInterface (View source)
Représentation d'une requête HTTP entrante, côté serveur.
Properties
protected string | $protocolVersion | Version du protocole (1.0|1.1|2.0|2). | from Message |
protected StreamInterface | $body | Corp du message. | from Message |
protected array | $headers | Les entêtes. | from Message |
protected string[] | $protocols | Protocoles pris en charges. | from Message |
protected string | $method | Méthode de la requête HTTP. | from Request |
protected string | $requestTarget | Cible de la requête. | from Request |
protected UriInterface | $uri | L'URI de la requête. | from Request |
protected string | $methods | Méthodes acceptés par le protocole HTTP. | from Request |
protected array | $serverParams | Paramètres du serveur ($_SERVER). | |
protected type | $cookieParams | Les cookies ($_COOKIE). | |
protected array | $queryParams | Paramètres de la requête ($_GET). | |
protected array | $uploadFiles | Fichiers transmis au serveur ($_FILES). | |
protected array | $attributes | Les attribues. | |
protected null|array|object | $parseBody | Le corps de la requête. |
Methods
Renvoie une instance avec la version du protocole HTTP.
Vérifie si un en-tête existe par le nom (insensible à la casse).
Récupère une chaîne de valeurs séparées par des virgules pour un seul en-tête.
Renvoyer une instance avec la valeur fournie en remplaçant l'en-tête spécifié.
Renvoyer une instance avec la valeur fournie en ajoutant l'en-tête spécifié.
Renvoie une instance avec le corps du message spécifié.
Construit une requête coté serveur.
Récupère la cible de requête telque les utilisateurs la voit.
Renvoie une instance avec la cible de requête spécifique.
Renvoie une instance avec l'URI fourni.
Construit une requête à partir des paramètre du serveur.
Récupérer les paramètres du serveur.
Récupérer les cookies.
Renvoyer une instance avec les cookies spécifiés.
Récupérer les arguments de chaîne de requête.
Renvoie une instance avec les arguments de chaîne de requête spécifiés.
Récupérer les données de téléchargement de fichier normalisées.
Créer une nouvelle instance avec les fichiers téléchargés spécifiés.
Récupérer tous les paramètres fournis dans le corps de la requête.
Renvoie une instance avec les paramètres de corps spécifiés.
Récupérer les attributs dérivés de la requête.
Récupérer un seul attribut de requête dérivé.
Renvoie une instance avec l'attribut de requête dérivé spécifié.
Renvoie une instance qui supprime l'attribut de requête dérivé spécifié.
Parse la variable supergloable $_FILES pour sa représentation PSR7 sans conversion des fichiers en instances de UploadedFileInterface.
Parse la variable supergloable $_FILES pour sa représentation PSR7 avec conversion des fichiers en instances de UploadedFileInterface.
Details
$this
withProtocolVersion(string $version)
Renvoie une instance avec la version du protocole HTTP.
bool
hasHeader($name)
Vérifie si un en-tête existe par le nom (insensible à la casse).
string[]
getHeader($name)
Vérifie si un en-tête existe par le nom (insensible à la casse).
string
getHeaderLine($name)
Récupère une chaîne de valeurs séparées par des virgules pour un seul en-tête.
$this
withHeader(string $name, string|string[] $value)
Renvoyer une instance avec la valeur fournie en remplaçant l'en-tête spécifié.
$this
withAddedHeader(string $name, string|string[] $value)
Renvoyer une instance avec la valeur fournie en ajoutant l'en-tête spécifié.
$this
withoutHeader(string $name)
Renvoie une instance sans l'en-tête spécifié.
$this
withBody(StreamInterface $body)
Renvoie une instance avec le corps du message spécifié.
protected string
filterProtocolVersion(string $version)
Filtre la version du protocole.
at line 80
__construct(string $method, UriInterface $uri, array $headers = [], StreamInterface $body = null, type $version = '1.1', array $serverParams = [], array $cookies = [], array $uploadFiles = [])
Construit une requête coté serveur.
string
getRequestTarget()
Récupère la cible de requête telque les utilisateurs la voit.
Si aucune adresse URI n'est disponible et qu'aucune cible de requête n'a été spécifiée cette méthode DOIT retourner la chaîne "/".
UriInterface
getUri()
Récupère l'instance d'URI.
Cette méthode DOIT retourner une instance d'UriInterface.
Request
withMethod(string $method)
Renvoie une instance avec la méthode HTTP fournie.
Request
withRequestTarget(mixed $requestTarget)
Renvoie une instance avec la cible de requête spécifique.
Request
withUri(UriInterface $uri, bool $preserveHost = false)
Renvoie une instance avec l'URI fourni.
protected string
filterMethod(string $method)
Filtre la méthde HTTP de la requête.
at line 101
static ServerRequest
create()
Construit une requête à partir des paramètre du serveur.
at line 141
array
getServerParams()
Récupérer les paramètres du serveur.
Récupère les données liées à l'environnement de demande entrante, typiquement dérivé de superglobal $_SERVER de PHP. Les données ne sont PAS REQUIS pour provenir de $_SERVER.
at line 156
array
getCookieParams()
Récupérer les cookies.
Récupère les cookies envoyés par le client au serveur.
Les données DOIVENT être compatibles avec la structure du $_COOKIE superglobal.
at line 172
ServerRequest
withCookieParams(array $cookies)
Renvoyer une instance avec les cookies spécifiés.
Les données ne sont PAS OBLIGATOIRES pour provenir de la superglobale $_COOKIE, mais DOIVENT être compatible avec la structure de $_COOKIE. Typiquement, ces données seront être injecté à l'instanciation.
at line 190
array
getQueryParams()
Récupérer les arguments de chaîne de requête.
Remarque: les paramètres de requête peuvent ne pas être synchronisés avec l'URI ou le serveur
params. Si vous devez vous assurer que vous n'obtenez que l'original
valeurs, vous devrez peut-être analyser la chaîne de requête à partir de getUri()->getQuery()
ou à partir du paramètre du serveur QUERY_STRING
.
at line 203
ServerRequest
withQueryParams(array $query)
Renvoie une instance avec les arguments de chaîne de requête spécifiés.
at line 220
array
getUploadedFiles()
Récupérer les données de téléchargement de fichier normalisées.
Ces valeurs PEUVENT être préparées à partir de $_FILES ou du corps du message pendant instanciation, ou PEUT être injecté via withUploadedFiles().
at line 233
ServerRequest
withUploadedFiles(array $uploadedFiles)
Créer une nouvelle instance avec les fichiers téléchargés spécifiés.
at line 247
null|array|object
getParsedBody()
Récupérer tous les paramètres fournis dans le corps de la requête.
at line 265
ServerRequest
withParsedBody(null|array|object $data)
Renvoie une instance avec les paramètres de corps spécifiés.
Si la demande Content-Type est soit application / x-www-form-urlencoded ou multipart / form-data, et la méthode de requête est POST, utilisez cette méthode SEULEMENT pour injecter le contenu de $_POST.
at line 284
array
getAttributes()
Récupérer les attributs dérivés de la requête.
La requête "attributs" peut être utilisée pour permettre l'injection de paramètres dérivés de la requête: par exemple, les résultats du chemin opérations de correspondance; les résultats des cookies décryptés; les résultats de désérialiser des corps de message codés sans forme; etc. Attributs sera spécifique à l'application et à la demande, et peut être mutable.
at line 303
mélangé
getAttribute(string $name, mixed $default = null)
Récupérer un seul attribut de requête dérivé.
Récupère un seul attribut de requête dérivé comme décrit dans getAttributes(). Si l'attribut n'a pas été défini précédemment, renvoie la valeur par défaut fournie.
at line 327
ServerRequest
withAttribute(string $name, mixed $value)
Renvoie une instance avec l'attribut de requête dérivé spécifié.
Cette méthode permet de définir un seul attribut de requête dérivé décrit dans getAttributes().
Cette méthode DOIT être mise en œuvre de manière à conserver les immutabilité du message, et DOIT retourner une instance qui a le attribut mis à jour.
at line 347
ServerRequest
withoutAttribute(string $name)
Renvoie une instance qui supprime l'attribut de requête dérivé spécifié.
Cette méthode permet de supprimer un seul attribut de requête dérivé décrit dans getAttributes().
at line 369
static array
parseFiles(array $files)
Parse la variable supergloable $_FILES pour sa représentation PSR7 sans conversion des fichiers en instances de UploadedFileInterface.
N'appartient pas aux définitions des interfaces PSR7.
at line 403
static UploadedFileInterface[]
parseFilesToUploadFiles(array $files)
Parse la variable supergloable $_FILES pour sa représentation PSR7 avec conversion des fichiers en instances de UploadedFileInterface.
N'appartient pas aux définitions des interfaces PSR7.