Avez-vous une question? (216) 97 656 803 hajjriadh@gmail.com
Les cours de programmation

Introduction à AJAX et à la communication asynchrone

Cette leçon introduit AJAX, la technique qui permet à une page web d'échanger des données avec le serveur sans être rechargée. Elle compare le fonctionnement classique d'un formulaire et le fonctionne...

0 chapitres 0 QCM Accès gratuit
Introduction à AJAX et à la communication asynchrone

À propos de ce cours

Cette leçon introduit AJAX, la technique qui permet à une page web d'échanger des données avec le serveur sans être rechargée. Elle compare le fonctionnement classique d'un formulaire et le fonctionnement asynchrone, présente l'historique de XMLHttpRequest à fetch, les formats échangés, principalement JSON, et les cas d'usage courants. Elle montre que, côté PHP, un point d'accès AJAX est simplement une action qui renvoie des données plutôt qu'une page, ce qui prépare la création d'API.

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 ?

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.

  1. Un événement survient (clic, saisie, défilement).
  2. JavaScript envoie une requête HTTP au serveur.
  3. PHP traite la requête et renvoie des données (JSON).
  4. 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 librePendant la saisie du formulaire
Listes liéesChoisir un gouvernorat charge ses délégations
Changer un statutClic → mise à jour de la ligne seulement
Défilement infiniChargement de la page suivante en bas de liste
NotificationsInterrogation 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.

La classe ReponseJson

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
  1. Que signifie « asynchrone » dans AJAX ?
  2. Citez trois fonctionnalités où AJAX améliore l'expérience utilisateur.
  3. Une requête AJAX envoie-t-elle le cookie de session ?
  4. Pourquoi l'en-tête Content-Type: application/json est-il important ?
  5. Ajoutez à ReponseJson un constructeur nommé vide() pour une réponse 204.
  6. Pourquoi utiliser JSON_THROW_ON_ERROR?
Correction
  1. 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.
  2. Recherche en direct, vérification de disponibilité d'un e-mail, listes déroulantes liées, changement de statut, défilement infini…
  3. 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.
  4. Il indique au client le format de la réponse ; certains outils et bibliothèques s'en servent pour décoder automatiquement le JSON.
  5. public static function vide(): self { return new self(null, 204); } et dans envoyer(), ne rien écrire si le statut vaut 204.
  6. Pour qu'une donnée impossible à encoder (UTF-8 invalide) lève une JsonException au lieu de renvoyer silencieusement false.

Résumé

  • AJAX échange des données avec le serveur sans recharger la page.
  • fetch + async/await remplacent 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 ReponseJson standardise les réponses.

Cet article vous a-t-il aidé ?