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

Cas pratique : recherche en direct (live search)

Ce cas pratique construit une recherche en direct qui propose des résultats à chaque frappe, comme les moteurs de recherche. Il comprend la classe PHP de recherche avec requête préparée et limite de r...

0 chapitres 0 QCM Accès gratuit
Cas pratique : recherche en direct (live search)

À propos de ce cours

Ce cas pratique construit une recherche en direct qui propose des résultats à chaque frappe, comme les moteurs de recherche. Il comprend la classe PHP de recherche avec requête préparée et limite de résultats, le point d'accès JSON, puis le code JavaScript avec temporisation des frappes, annulation des requêtes dépassées par AbortController, affichage sécurisé avec surlignage du terme, navigation au clavier et accessibilité. Il aborde enfin les performances côté base de données.

Objectifs de la leçon

  • Écrire une classe de recherche PHP sûre et rapide.
  • Temporiser les frappes (debounce).
  • Annuler les requêtes obsolètes avec AbortController.
  • Afficher et surligner les résultats sans faille XSS.
  • Rendre la liste accessible et navigable au clavier.

1. Mise en situation

Le catalogue compte plus de 300 formations. Les visiteurs veulent taper « dév » et voir immédiatement « Développement Web et Mobile », « Développement d'applications », etc., sans valider de formulaire. Une première version envoyait une requête à chaque touche : le serveur recevait dix requêtes par seconde, et les réponses arrivaient dans le désordre.

Une recherche en direct de qualité professionnelle demande quelques techniques simples : temporiser, annuler, limiter, échapper. Construisons-la étape par étape.

2. Le point d'accès PHP

Une recherche en direct robuste

Une recherche en direct robuste

<?php
// api/recherche-formations.php
$q = trim((string) ($_GET['q'] ?? ''));
if (mb_strlen($q) < 2) {
    ReponseJson::ok([])->envoyer();                         // pas de recherche sur 0 ou 1 caractère
}
$resultats = $recherche->formations($q, limite: 8);
ReponseJson::ok($resultats)->envoyer();

3. Temporiser et annuler

const champ = document.querySelector('#recherche');
const liste = document.querySelector('#suggestions');
let minuteur = null;
let controleur = null;

champ.addEventListener('input', () => {
  clearTimeout(minuteur);
  minuteur = setTimeout(() => chercher(champ.value.trim()), 250);   // debounce : on attend une pause
});

async function chercher(q) {
  controleur?.abort();                                   // annule la requête précédente encore en cours
  controleur = new AbortController();
  if (q.length < 2) { liste.replaceChildren(); return; }
  try {
    const reponse = await fetch(`/api/recherche-formations.php?${new URLSearchParams({ q })}`, { signal: controleur.signal });
    afficher(await reponse.json(), q);
  } catch (e) {
    if (e.name !== 'AbortError') console.error(e);       // une annulation volontaire n'est pas une erreur
  }
}
TechniqueProblème résolu
Debounce (250 ms)Une requête par pause, et non par touche
AbortControllerUne réponse ancienne n'écrase pas une plus récente
Minimum 2 caractèresPas de requêtes inutiles et coûteuses
LIMIT 8Réponses courtes et rapides

4. Afficher sans faille XSS

function afficher(resultats, q) {
  const motif = new RegExp(`(${q.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')})`, 'gi');   // terme échappé pour la RegExp
  liste.replaceChildren(...resultats.map((f, i) => {
    const li = document.createElement('li');
    li.id = `suggestion-${i}`;
    li.setAttribute('role', 'option');
    for (const morceau of f.intitule.split(motif)) {         // découpe autour du terme
      const noeud = morceau.toLowerCase() === q.toLowerCase() ? document.createElement('mark') : document.createElement('span');
      noeud.textContent = morceau;                           // jamais innerHTML avec des données
      li.append(noeud);
    }
    li.addEventListener('click', () => location.href = `/formation/${encodeURIComponent(f.code)}`);
    return li;
  }));
}

Le surlignage est construit avec des éléments <mark> et textContent: même si un intitulé contenait du HTML, il serait affiché comme du texte.

5. Accessibilité et clavier

<input id="recherche" type="search" role="combobox" aria-autocomplete="list"
       aria-controls="suggestions" aria-expanded="false" autocomplete="off" placeholder="Rechercher une formation">
<ul id="suggestions" role="listbox" class="list-group"></ul>

Les flèches haut et bas déplacent la sélection (mise à jour de aria-activedescendant), Entrée ouvre la formation, Échap ferme la liste. Un utilisateur de lecteur d'écran sait ainsi que des suggestions sont disponibles.

6. Fermer la liste et gérer le vide

document.addEventListener('click', (e) => {
  if (!e.target.closest('.recherche')) liste.replaceChildren();     // clic à l'extérieur : on ferme
});

function afficherAucunResultat(q) {
  const li = document.createElement('li');
  li.className = 'list-group-item text-muted';
  li.textContent = `Aucune formation ne correspond à « ${q} »`;
  liste.replaceChildren(li);
}

Un message « aucun résultat » rassure l'utilisateur : sans lui, une liste vide ressemble à une panne.

7. Mise en pratique : une classe de recherche réutilisable

<?php
declare(strict_types=1);

final class RechercheCatalogue
{
    public function __construct(private PDO $pdo) {}

    /** @return list<array{code: string, intitule: string, niveau: string}> */
    public function formations(string $q, int $limite = 8): array
    {
        $limite = max(1, min(20, $limite));
        $motif = '%' . addcslashes($q, '%_\\') . '%';          // % et _ saisis sont cherchés littéralement
        $debut = addcslashes($q, '%_\\') . '%';
        $stmt = $this->pdo->prepare(
            'SELECT code, intitule, niveau FROM formation
             WHERE intitule LIKE :motif OR code LIKE :debut
             ORDER BY (intitule LIKE :debut2) DESC, intitule      -- les intitulés qui COMMENCENT par q d\'abord
             LIMIT :limite'
        );
        $stmt->bindValue('motif', $motif);
        $stmt->bindValue('debut', $debut);
        $stmt->bindValue('debut2', $debut);
        $stmt->bindValue('limite', $limite, PDO::PARAM_INT);
        $stmt->execute();
        return $stmt->fetchAll();
    }
}

La classe RechercheCatalogue

Diagramme de classe UML de RechercheCatalogue

La classe est indépendante d'AJAX : la même méthode sert la recherche en direct, la page de résultats classique et l'API mobile. Pour un catalogue de plusieurs dizaines de milliers de lignes, on passera à un index FULLTEXT (MATCH … AGAINST), sans rien changer à l'interface de la classe.

Exercice Activités
  1. Qu'est-ce que le debounce et pourquoi l'utiliser ici ?
  2. Quel problème résout AbortController?
  3. Pourquoi échapper % et _ avec addcslashes?
  4. Pourquoi construire le surlignage avec textContent plutôt qu'avec innerHTML et replace?
  5. Ajoutez la navigation au clavier : flèche bas, flèche haut, Entrée.
  6. Ajoutez un paramètre facultatif niveau (BTS, BTP…) à la recherche.
Correction
  1. Attendre une pause dans la saisie avant d'envoyer la requête : on envoie une requête par pause au lieu d'une par touche.
  2. Une réponse lente à une requête ancienne pourrait arriver après la réponse à la requête récente et afficher de mauvais résultats ; on annule la précédente.
  3. Ce sont des jokers de LIKE : sans échappement, une saisie « _ » correspondrait à n'importe quel caractère.
  4. Pour éviter qu'un intitulé contenant du HTML ou du script soit interprété (XSS).
  5. Écouter keydown sur le champ ; gérer un index courant, ajouter la classe active et aria-activedescendant à l'élément sélectionné ; sur Entrée, déclencher son click().
  6. Ajouter AND (:niveau IS NULL OR niveau = :niveau) à la requête et bindValue('niveau', $niveau); côté JavaScript, ajouter le niveau choisi aux paramètres.

Résumé

  • Debounce : une requête par pause de frappe.
  • AbortController annule les requêtes dépassées.
  • Requête préparée, jokers échappés, LIMIT, minimum de caractères.
  • Affichage avec textContent et <mark>.
  • Une classe de recherche réutilisable par la page, AJAX et l'API.

Cet article vous a-t-il aidé ?