À propos de ce cours
Objectifs de la leçon
- Expliquer le principe d'une requête asynchrone.
- Comparer le rechargement complet et AJAX.
- Connaître XMLHttpRequest et fetch.
- Identifier les cas d'usage d'AJAX.
- Comprendre le rôle de PHP dans un échange AJAX.
1. Mise en situation
Sur la page des candidatures, cocher « candidature vue » recharge toute la page : la liste revient en haut, les filtres se réinitialisent, et l'opération prend deux secondes. Pendant ce temps, sur une application mobile, la même action est instantanée.
La différence tient en un mot : AJAX. Au lieu de redemander toute la page, le navigateur envoie une petite requête en arrière-plan, reçoit une réponse courte, et JavaScript ne met à jour que la partie concernée.
2. Le principe
Rechargement complet ou AJAX ?
AJAX (Asynchronous JavaScript And XML) désigne l'envoi de requêtes HTTP par JavaScript, sans quitter la page. « Asynchrone » signifie que le navigateur n'attend pas la réponse en bloquant la page : le code continue de s'exécuter, et une fonction est appelée quand la réponse arrive. Malgré son nom, AJAX échange aujourd'hui presque toujours du JSON plutôt que du XML.
- Un événement survient (clic, saisie, défilement).
- JavaScript envoie une requête HTTP au serveur.
- PHP traite la requête et renvoie des données (JSON).
- JavaScript reçoit la réponse et met à jour une partie de la page (DOM).
3. De XMLHttpRequest à fetch
// Historique : XMLHttpRequest (encore rencontré dans les anciens projets et avec jQuery)
const xhr = new XMLHttpRequest();
xhr.open('GET', '/api/formations');
xhr.onload = () => console.log(JSON.parse(xhr.responseText));
xhr.send();
// Aujourd'hui : fetch, basé sur les promesses
const reponse = await fetch('/api/formations');
const formations = await reponse.json();
fetch est l'API moderne, disponible dans tous les navigateurs. Associée à async/await, elle permet d'écrire du code asynchrone qui se lit comme du code séquentiel. C'est elle que nous utiliserons.
4. Cas d'usage
| Fonctionnalité | Échange |
|---|---|
| Recherche en direct | À chaque frappe, liste de résultats |
| Vérifier qu'un e-mail est libre | Pendant la saisie du formulaire |
| Listes liées | Choisir un gouvernorat charge ses délégations |
| Changer un statut | Clic → mise à jour de la ligne seulement |
| Défilement infini | Chargement de la page suivante en bas de liste |
| Notifications | Interrogation régulière du serveur |
5. Ce que fait PHP
<?php
// api/formations.php — un point d'accès AJAX
header('Content-Type: application/json; charset=UTF-8');
$formations = $depot->ouvertes();
echo json_encode(array_map(fn(Formation $f) => [
'code' => $f->code, 'intitule' => $f->intitule, 'places' => $f->placesRestantes(),
], $formations), JSON_UNESCAPED_UNICODE);
Pour PHP, une requête AJAX est une requête HTTP comme une autre : mêmes sessions, mêmes cookies, mêmes contrôles d'accès et de jeton CSRF. Seule la réponse change : des données au lieu d'une page HTML complète.
6. Les promesses et async / await
// Une promesse représente un résultat qui arrivera plus tard
fetch('/api/formations')
.then((reponse) => reponse.json()) // quand la réponse arrive…
.then((formations) => afficher(formations)) // …puis quand le JSON est décodé
.catch((erreur) => console.error(erreur)); // en cas d'erreur réseau
// Même code avec async / await : plus lisible
async function charger() {
try {
const reponse = await fetch('/api/formations');
afficher(await reponse.json());
} catch (erreur) {
console.error(erreur);
}
}
console.log('Cette ligne s'affiche AVANT la réponse du serveur');
await suspend la fonction async jusqu'à l'arrivée du résultat, sans bloquer la page : l'utilisateur peut continuer à cliquer et à faire défiler pendant ce temps.
7. Observer les échanges
Dans les outils de développement du navigateur (F12), l'onglet Réseau (filtre « Fetch/XHR ») affiche chaque requête AJAX : méthode, URL, code de réponse, en-têtes, données envoyées et réponse reçue. C'est l'outil indispensable pour déboguer un échange entre JavaScript et PHP : vérifiez-y d'abord le code HTTP et le contenu de la réponse.
- Réponse en HTML au lieu de JSON : une erreur PHP s'est affichée avant le
json_encode. - Code 403 : jeton CSRF absent ou session expirée.
- Code 500 : consultez le journal d'erreurs PHP.
8. Vers la POO : un objet réponse JSON
Chaque point d'accès AJAX doit envoyer le bon en-tête, le bon code HTTP et un JSON bien formé. Plutôt que de le répéter, on crée une classe qui représente la réponse : c'est le principe des objets Response de Symfony et de Laravel.
Diagramme de classe UML de ReponseJson
<?php
declare(strict_types=1);
final class ReponseJson
{
private function __construct(private mixed $donnees, private int $statut) {}
public static function ok(mixed $donnees): self { return new self($donnees, 200); }
public static function cree(mixed $donnees): self { return new self($donnees, 201); }
public static function erreur(string $message, int $statut = 400, array $details = []): self
{
return new self(['erreur' => ['message' => $message, 'details' => $details]], $statut);
}
public function envoyer(): never
{
http_response_code($this->statut);
header('Content-Type: application/json; charset=UTF-8');
header('Cache-Control: no-store');
echo json_encode($this->donnees, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);
exit;
}
}
// api/formations.php
ReponseJson::ok(array_map(fn(Formation $f) => $f->versTableau(), $depot->ouvertes()))->envoyer();
// en cas de problème
ReponseJson::erreur('Formation introuvable', 404)->envoyer();
Exercice Activités
- Que signifie « asynchrone » dans AJAX ?
- Citez trois fonctionnalités où AJAX améliore l'expérience utilisateur.
- Une requête AJAX envoie-t-elle le cookie de session ?
- Pourquoi l'en-tête
Content-Type: application/jsonest-il important ? - Ajoutez à
ReponseJsonun constructeur nommévide()pour une réponse 204. - Pourquoi utiliser
JSON_THROW_ON_ERROR?
Correction
- La requête est envoyée sans bloquer la page : le code continue de s'exécuter et une fonction traite la réponse quand elle arrive.
- Recherche en direct, vérification de disponibilité d'un e-mail, listes déroulantes liées, changement de statut, défilement infini…
- Oui, pour une requête vers le même site : PHP retrouve la session, et les contrôles d'accès s'appliquent comme pour une page.
- Il indique au client le format de la réponse ; certains outils et bibliothèques s'en servent pour décoder automatiquement le JSON.
public static function vide(): self { return new self(null, 204); }et dansenvoyer(), ne rien écrire si le statut vaut 204.- Pour qu'une donnée impossible à encoder (UTF-8 invalide) lève une
JsonExceptionau lieu de renvoyer silencieusementfalse.
Résumé
- AJAX échange des données avec le serveur sans recharger la page.
fetch+async/awaitremplacent XMLHttpRequest.- Le format d'échange courant est JSON.
- Côté PHP, un point d'accès AJAX renvoie des données, avec les mêmes contrôles qu'une page.
- Un objet
ReponseJsonstandardise les réponses.
Cet article vous a-t-il aidé ?
Merci pour votre avis sur cet article 🙏
Merci, votre message nous a bien été transmis 🙏
Cette leçon vous a été utile ? Partagez-la !