Manipulation des requêtes HTTP

Manipulation des requêtes HTTP | Med Learning

Leçon 1

Introduction

La classe Illuminate\Http\Request représente la requête HTTP courante sous forme d'objet. Elle donne accès aux données envoyées (champs de formulaire, paramètres d'URL, JSON), aux fichiers, aux cookies, aux en-têtes et à des informations comme l'adresse IP du client. Elle étend la classe Request du composant Symfony HttpFoundation.

Leçon 2

Interagir avec la requête

Accéder à la requête

On type le paramètre Request dans une méthode de contrôleur ou une closure de route : le conteneur de services l'injecte automatiquement.

app/Http/Controllers/AuteurController.php (extrait)

php

use Illuminate\Http\Request;

public function store(Request $request)
{
    $nom = $request->input('nom');
    // ...
}

php

Route::get('/recherche', function (Request $request) {
    return $request->query('q');
});

Si la méthode reçoit aussi des paramètres de route, ils viennent après les dépendances : public function update(Request $request, string $id). On peut aussi obtenir la requête n'importe où avec l'assistant request() (par exemple dans une vue).

Le chemin, l'URL et l'hôte

Pour une requête vers https://kitab.ma/livres/le-petit-prince?ref=accueil :

Méthode	Résultat
`$request->path()`	`livres/le-petit-prince`
`$request->is('livres/*')`	`true` (le `*` est un joker)
`$request->routeIs('livres.*')`	`true` si la route a un nom qui commence par `livres.`
`$request->url()`	`https://kitab.ma/livres/le-petit-prince` (sans la chaîne de requête)
`$request->fullUrl()`	`https://kitab.ma/livres/le-petit-prince?ref=accueil`
`$request->fullUrlWithQuery(['page' => 2])`	`…?ref=accueil&page=2`
`$request->fullUrlWithoutQuery(['ref'])`	`…/le-petit-prince`
`$request->host()`	`kitab.ma`
`$request->httpHost()`	`kitab.ma` (avec le port s'il n'est pas standard)
`$request->schemeAndHttpHost()`	`https://kitab.ma`

Leçon 3

Les données d'entrée (input)

Méthode	Exemple	Résultat
`string`	`$request->string('nom')->trim()`	un objet `Stringable` (méthodes `trim`, `upper`, `slug`…)
`integer`	`$request->integer('page', 1)`	un entier (`'3'` → `3`)
`float`	`$request->float('prix')`	un nombre décimal
`boolean`

Leçon 4

Valider les données

Règle	Vérifie que la valeur…
`required`	est présente et non vide
`nullable`	peut être vide (`null`) ; à mettre pour un champ facultatif
`string`, `integer`, `numeric`, `boolean`, `array`	est du bon type
`email`	est une adresse e-mail valide
`min:3`, `max:255`	a une longueur (texte), une valeur (nombre) ou une taille en Ko (fichier) minimale ou maximale

Leçon 5

Les fichiers envoyés

Disque	Dossier	Accessible depuis le web ?
`local` (par défaut)	`storage/app/private`	non : factures, pièces d'identité
`public`	`storage/app/public`	oui, après `php artisan storage:link` (URL `/storage/...`)
`s3`	un espace de stockage Amazon S3 (ou compatible)	selon la configuration

Leçon 6

Les proxys de confiance

Leçon 7

Les hôtes de confiance

Leçon 8

Les vidéos du chapitre

Vidéo · À regarder

30 Days to Learn Laravel - Complete 8 Hour Course

Laracasts (Jeffrey Way) · YouTube

Regarde de 3:39:05 à 3:52:5513 min 50 s

Ouvrir sur YouTube à 3:39:05

Travaux pratiques

TP fil rouge · Le formulaire d'ajout d'un livre

Exercices

Exercice 7.1

Choisis la bonne réponse

1$request->query('tri') lit…
2$request->boolean('newsletter') avec la valeur "on" renvoie…
3$request->filled('nom') est vrai si le champ est…
4old('titre') sert à…
5Si validate() échoue sur un formulaire classique, Laravel…
6La règle qui vérifie qu'une catégorie existe est…
7Un formulaire d'envoi de fichier doit avoir…
8Pour qu'une image stockée soit visible sur le site, on utilise le disque…

0/8 répondues

Exercice 7.2

Quelle méthode ?

Exercice 7.3

L'essentiel du chapitre

À retenir

Request injectée (ou request()) : path, is, routeIs, url, fullUrl, fullUrlWithQuery, host, method, isMethod, header, hasHeader, bearerToken, ip, accepts, prefers, expectsJson.
Données : all, collect, input (défaut, notation point, JSON), query, propriétés dynamiques ; typées : string, integer, float, boolean (1, true, on, yes), date, enum, array ; only, except ; présence : has, hasAny, filled, isNotFilled, missing, whenHas, whenFilled ; merge, mergeIfMissing ; ancienne saisie : flash, withInput, old() ; cookie() (chiffrés).
Normalisation : TrimStrings, ConvertEmptyStringsToNull (globaux) ; trimStrings(except:) dans bootstrap/app.php.
Validation : $request->validate([...]) → données validées ; échec = redirection + $errors + ancienne saisie (ou 422 JSON). Règles : required, nullable, types, min, max, in, unique, exists, confirmed, date, image, mimes ; Rule::enum, Rule::unique()->ignore(), Password::min(8). Vue : $errors->any(), @error('champ') {{ $message }} @enderror. Form Request : make:request, authorize(), rules(), messages(), attributes(), $request->validated(). Jamais create($request->all()).

Méthode	Renvoie `true` si…
`has('nom')`	la clé est présente (même vide)
`has(['nom', 'email'])`	toutes les clés sont présentes
`hasAny(['nom', 'email'])`	au moins une est présente
`filled('nom')`	la clé est présente et non vide
`isNotFilled('nom')`	la clé est absente ou vide
`anyFilled(['nom', 'email'])`	au moins une est remplie
`missing('nom')`	la clé est absente

php

$valeur = $request->header('X-Magasin');              // null si absent
$valeur = $request->header('X-Magasin', 'casablanca');  // valeur par défaut
if ($request->hasHeader('X-Magasin')) { /* ... */ }

$jeton = $request->bearerToken();   // le jeton de l'en-tête "Authorization: Bearer xxx" ("" si absent)
$ip = $request->ip();               // l'adresse IP du client
$navigateur = $request->userAgent();

php

$types = $request->getAcceptableContentTypes();          // ['text/html', ...]
if ($request->accepts(['text/html', 'application/json'])) { /* ... */ }
$prefere = $request->prefers(['text/html', 'application/json']);  // le type préféré ou null

if ($request->expectsJson()) {
    return response()->json(['message' => 'Ajouté au panier']);   // appel JavaScript
}
return back()->with('status', 'Ajouté au panier');                // formulaire classique

php

$donnees = $request->all();          // tableau de toutes les données (formulaire + chaîne de requête + JSON)
$donnees = $request->collect();      // la même chose sous forme de collection
$request->collect('livres')->each(function (array $livre) {
    // parcourir un sous-ensemble
});
$donnees = $request->input();        // tableau associatif, comme all() mais sans les fichiers

php

$titre = $request->input('titre');
$titre = $request->input('titre', 'Sans titre');          // valeur par défaut
$premier = $request->input('livres.0.titre');             // notation « point » pour les tableaux
$tous = $request->input('livres.*.titre');                // tous les titres
$ville = $request->input('client.adresse.ville');         // JSON imbriqué (Content-Type: application/json)

app/Http/Controllers/Admin/AuteurController.php (extrait)

php

public function store(Request $request): RedirectResponse
{
    $valide = $request->validate([
        'nom' => ['required', 'string', 'max:120'],
        'nationalite' => ['nullable', 'string', 'max:60'],
        'email' => ['nullable', 'email', 'unique:auteurs,email'],
        'date_naissance' => ['nullable', 'date', 'before:today'],
    ]);

    Auteur::create($valide);   // seulement les champs validés

    return redirect()->route('admin.auteurs.index')->with('status', 'Auteur ajouté.');
}

blade

<form method="POST" action="{{ route('admin.livres.store') }}" enctype="multipart/form-data">
    @csrf
    <input type="file" name="couverture" accept="image/*">
    @error('couverture') <p class="message-erreur">{{ $message }}</p> @enderror
    <button type="submit">Envoyer</button>
</form>

php

$fichier = $request->file('couverture');     // un objet Illuminate\Http\UploadedFile (ou null)
$fichier = $request->couverture;             // même chose (propriété dynamique)

if ($request->hasFile('couverture') && $request->file('couverture')->isValid()) {
    $chemin = $fichier->path();                       // chemin temporaire sur le serveur
    $extension = $fichier->extension();               // devinée d'après le CONTENU ("jpg")
    $nomOriginal = $fichier->getClientOriginalName(); // nom donné par le client (à ne pas croire)
    $taille = $fichier->getSize();                    // en octets
    $type = $fichier->getMimeType();                  // "image/jpeg"
}

php

$chemin = $request->file('couverture')->store('couvertures', 'public');
// "couvertures/Xk2b9Qm4...jpg" sur le disque public (storage/app/public)

$chemin = $request->file('couverture')->storeAs('couvertures', "{$livre->isbn}.jpg", 'public');
// nom choisi : couvertures/9782070612758.jpg

$chemin = $request->file('facture')->store('factures');   // disque par défaut "local" : storage/app/private

bootstrap/app.php (extrait)

php

->withMiddleware(function (Middleware $middleware): void {
    $middleware->trustProxies(at: [
        '192.168.1.1',
        '10.0.0.0/8',
    ]);
    // derrière un service cloud dont on ne connaît pas les adresses :
    // $middleware->trustProxies(at: '*');
})

bootstrap/app.php (extrait)

php

$middleware->trustHosts(at: ['^kitab\.ma$']);                 // expression régulière
$middleware->trustHosts(at: ['^kitab\.ma$'], subdomains: false); // refuser aussi les sous-domaines

php

$publie = $request->date('publie_le');                          // null si absent
$heure = $request->date('ouverture', '!H:i', 'Africa/Casablanca');  // format et fuseau horaire
$langue = $request->enum('langue', Langue::class, Langue::Francais); // avec une valeur par défaut

php

$request->whenHas('code_promo', function (string $code) {
    // exécuté si code_promo est présent
}, function () {
    // exécuté sinon
});

$request->whenFilled('recherche', function (string $texte) use (&$requete) {
    // exécuté si recherche est remplie
});

php

$request->flash();                          // toute la saisie
$request->flashOnly(['nom', 'email']);
$request->flashExcept('password');          // jamais les mots de passe

return redirect('/inscription')->withInput();                         // flasher puis rediriger
return redirect()->route('inscription')->withInput($request->except('password'));
return back()->withInput();                                           // revenir à la page précédente

bootstrap/app.php (extrait)

php

use Illuminate\Http\Request;

->withMiddleware(function (Middleware $middleware): void {
    $middleware->trimStrings(except: [
        fn (Request $request) => $request->is('admin/editeur/*'),   // garder les espaces ici
    ]);
    $middleware->convertEmptyStringsToNull(except: [
        fn (Request $request) => $request->is('api/*'),
    ]);
})

php

use App\Enums\Langue;
use Illuminate\Validation\Rule;
use Illuminate\Validation\Rules\Password;

$request->validate([
    'langue' => ['required', Rule::enum(Langue::class)],
    'isbn' => ['required', Rule::unique('livres', 'isbn')->ignore($livre->id)],  // modification : ignorer le livre lui-même
    'password' => ['required', 'confirmed', Password::min(8)->letters()->numbers()],
    'categorie_id' => ['required', Rule::exists('categories', 'id')],
]);

resources/views/admin/auteurs/create.blade.php (extrait)

blade

@if ($errors->any())
    <div class="alerte erreur">
        <p>Le formulaire contient {{ $errors->count() }} erreur(s) :</p>
        <ul>
            @foreach ($errors->all() as $message)
                <li>{{ $message }}</li>
            @endforeach
        </ul>
    </div>
@endif

<form method="POST" action="{{ route('admin.auteurs.store') }}">
    @csrf
    <label for="nom">Nom</label>
    <input id="nom" type="text" name="nom" value="{{ old('nom') }}" @class(['invalide' => $errors->has('nom')])>
    @error('nom')
        <p class="message-erreur">{{ $message }}</p>
    @enderror

    <button type="submit">Enregistrer</button>
</form>

php

$request->validate(
    ['nom' => ['required', 'max:120']],
    ['nom.required' => 'Le nom de l\'auteur est obligatoire.', 'max' => 'Le champ :attribute dépasse :max caractères.'],
    ['nom' => 'nom de l\'auteur'],
);

app/Http/Requests/StoreLivreRequest.php

php

<?php

namespace App\Http\Requests;

use App\Enums\Langue;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rule;

class StoreLivreRequest extends FormRequest
{
    /** L'utilisateur a-t-il le droit d'envoyer ce formulaire ? */
    public function authorize(): bool
    {
        return in_array($this->user()?->role, ['admin', 'libraire'], true);
    }

    /** Les règles de validation. */
    public function rules(): array
    {
        return [
            'isbn' => ['required', 'regex:/^97[89][0-9]{10}$/', 'unique:livres,isbn'],
            'titre' => ['required', 'string', 'max:200'],
            'resume' => ['nullable', 'string', 'max:5000'],
            'prix' => ['required', 'numeric', 'min:0', 'max:9999.99'],
            'stock' => ['required', 'integer', 'min:0'],
            'langue' => ['required', Rule::enum(Langue::class)],
            'categorie_id' => ['required', 'exists:categories,id'],
            'auteurs' => ['required', 'array', 'min:1'],
            'auteurs.*' => ['integer', 'exists:auteurs,id'],
            'couverture' => ['nullable', 'image', 'mimes:jpg,jpeg,png,webp', 'max:2048'],
        ];
    }

    /** Les messages personnalisés. */
    public function messages(): array
    {
        return [
            'isbn.regex' => 'L\'ISBN doit compter 13 chiffres et commencer par 978 ou 979.',
            'auteurs.required' => 'Choisis au moins un auteur.',
        ];
    }

    /** Les noms des champs dans les messages. */
    public function attributes(): array
    {
        return ['categorie_id' => 'catégorie', 'couverture' => 'image de couverture'];
    }
}

app/Http/Controllers/Admin/LivreController.php (extrait)

php

use App\Http\Requests\StoreLivreRequest;

public function store(StoreLivreRequest $request): RedirectResponse
{
    $donnees = $request->validated();     // seulement les champs validés
    // ... enregistrer (chapitre 11)
    return redirect()->route('admin.livres.index')->with('status', 'Livre ajouté.');
}