yii2/docs/guide-fr/runtime-requests.md

Requêtes

Les requêtes faites à l'application sont représentées en terme d'objets yii\web\Request qui fournissent des informations telles que les paramètres de requête, les entêtes HTTP, les cookies, etc. Pour une requête donnée, vous avez accès au composant d'applicationrequest qui, par défaut, est une instance de yii\web\Request. Dans cette section, nous décrivons comment utiliser ce composant dans vos applications.

Paramètres de requête

Pour obtenir les paramètres de requête, vous pouvez appeler les méthodes yii\web\Request::get() et yii\web\Request::post() du composant request component. Elles retournent les valeurs de $_GET et $_POST, respectivement. Pas exemple :

$request = Yii::$app->request;

$get = $request->get(); 
// équivalent à : $get = $_GET;

$id = $request->get('id');   
// équivalent à : $id = isset($_GET['id']) ? $_GET['id'] : null;

$id = $request->get('id', 1);   
// équivalent à : $id = isset($_GET['id']) ? $_GET['id'] : 1;

$post = $request->post(); 
// équivalent à : $post = $_POST;

$name = $request->post('name');   
// equivalent to: $name = isset($_POST['name']) ? $_POST['name'] : null;

$name = $request->post('name', '');   
// équivalent à : $name = isset($_POST['name']) ? $_POST['name'] : '';

Info: plutôt que d'accéder directement à $_GET et $_POST pour récupérer les paramètres de requête, il est recommandé de les obtenir via le composant request comme indiqué ci-dessus. Cela rend l'écriture des tests plus facile parce que vous pouvez créer un simulacre de composant request avec des données de requête factices.

Lorsque vous mettez en œuvre des API pleinement REST, vous avez souvent besoin de récupérer les paramètres qui sont soumis via les méthodes de requête PUT, PATCH ou autre . Vous pouvez obtenir ces paramètres en appelant la méthode yii\web\Request::getBodyParam(). par exemple :

$request = Yii::$app->request;

// retourne tous les paramètres
$params = $request->bodyParams;

// retourne le paramètre  "id"
$param = $request->getBodyParam('id');

Info: à la différence des paramètres de GET, les paramètres soumis via POST, PUT, PATCH etc. sont envoyés dans le corps de la requête. Le composant request analyse ces paramètres lorsque vous y accédez via les méthodes décrites ci-dessus. Vous pouvez personnaliser la manière dont ces paramètres sont analysés en configurant la propriété yii\web\Request::parsers.

Méthodes de requête

Vous pouvez obtenir la méthode HTTP utilisée par la requête courante via l'expression Yii::$app->request->method. Un jeu entier de propriétés booléennes est également fourni pour que vous puissiez déterminer le type de la méthode courante. Par exemple : For example,

$request = Yii::$app->request;

if ($request->isAjax) { /* la méthode de requête est requête AJAX */ }
if ($request->isGet)  { /* la méthode de requête est requête GET */ }
if ($request->isPost) { /* la méthode de requête est requête POST */ }
if ($request->isPut)  { /* la méthode de requête est requête PUT */ }

URL de requête

Le composant request fournit plusieurs manières d'inspecter l'URL couramment requise.

En supposant que l'URL requise soit http://example.com/admin/index.php/product?id=100, vous pouvez obtenir différentes parties de cette URL comme c'est résumé ci-dessous :

• yii\web\Request::url: retourne/admin/index.php/product?id=100, qui est l'URL sans la partie hôte.
• yii\web\Request::absoluteUrl: retourne http://example.com/admin/index.php/product?id=100, qui est l'URL complète y compris la partie hôte.
• yii\web\Request::hostInfo: retourne http://example.com, qui est la partie hôte de l'URL.
• yii\web\Request::pathInfo: retourne /product, qui est la partie après le script d'entrée et avant le point d'interrogation (chaîne de requête).
• yii\web\Request::queryString: retourne id=100, qui est la partie après le point d'interrogation.
• yii\web\Request::baseUrl: retourne /admin, qui est la partie après l'hôte et avant le nom du script d'entrée.
• yii\web\Request::scriptUrl: retourne /admin/index.php, qui set l'URL sans le chemin et la chaîne de requête.
• yii\web\Request::serverName: retourne example.com, qui est le nom d'hôte dans l'URL.
• yii\web\Request::serverPort: retourne 80, qui est le numéro de port utilisé par le serveur Web.

Enntêtes HTTP

Vous pouvez obtenir les entêtes HTTP via la yii\web\HeaderCollection qui est retournée par la propriété yii\web\Request::headers. Par exemple :

// $headers est un objet   yii\web\HeaderCollection 
$headers = Yii::$app->request->headers;

// retourne la valeur de l'entête  Accept
$accept = $headers->get('Accept');

if ($headers->has('User-Agent')) { /* il existe un entête User-Agent  */ }

Le composant request fournit aussi la prise en charge de l'accès rapide à quelques entêtes couramment utilisés. Cela inclut :

• yii\web\Request::userAgent: retourne la valeur de l'entête User-Agent.
• yii\web\Request::contentType: retourne la valeur de l'entête Content-Type qui indique le type MIME des données dans le corps de la requête.
• yii\web\Request::acceptableContentTypes: retourne les types MIME acceptés par l'utilisateur. Les types retournés sont classés par ordre de score de qualité. Les types avec les plus hauts scores sont retournés en premier.
• yii\web\Request::acceptableLanguages: retourne les langues acceptées par l'utilisateur. Les langues retournées sont classées par niveau de préférence. Le premier élément représente la langue préférée. Si votre application prend en charge plusieurs langues et que vous voulez afficher des pages dans la langue préférée de l'utilisateur, vous pouvez utiliser la méthode de négociation de la langue yii\web\Request::getPreferredLanguage(). Cette méthode accepte une liste des langues prises en charge par votre application, la compare avec les yii\web\Request::acceptableLanguages (langues acceptées), et retourne la langue la plus appropriée.

Tip: vous pouvez également utiliser le filtre yii\filters\ContentNegotiator pour déterminer dynamiquement quel type de contenu et quelle langue utiliser dans la réponse. Le filtre met en œuvre la négociation de contenu en plus des propriétés et méthodes décrites ci-dessus.

Informations sur le client

Vous pouvez obtenir le nom d'hôte et l'adresse IP de la machine cliente via yii\web\Request::userHost et yii\web\Request::userIP, respectivement. Par exemple :

$userHost = Yii::$app->request->userHost;
$userIP = Yii::$app->request->userIP;