À propos de ce cours
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
<?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
}
}
| Technique | Problème résolu |
|---|---|
| Debounce (250 ms) | Une requête par pause, et non par touche |
AbortController | Une réponse ancienne n'écrase pas une plus récente |
| Minimum 2 caractères | Pas de requêtes inutiles et coûteuses |
LIMIT 8 | Ré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();
}
}
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
- Qu'est-ce que le debounce et pourquoi l'utiliser ici ?
- Quel problème résout
AbortController? - Pourquoi échapper
%et_avecaddcslashes? - Pourquoi construire le surlignage avec
textContentplutôt qu'avecinnerHTMLetreplace? - Ajoutez la navigation au clavier : flèche bas, flèche haut, Entrée.
- Ajoutez un paramètre facultatif
niveau(BTS, BTP…) à la recherche.
Correction
- 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.
- 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.
- Ce sont des jokers de LIKE : sans échappement, une saisie « _ » correspondrait à n'importe quel caractère.
- Pour éviter qu'un intitulé contenant du HTML ou du script soit interprété (XSS).
- Écouter
keydownsur le champ ; gérer un index courant, ajouter la classeactiveetaria-activedescendantà l'élément sélectionné ; sur Entrée, déclencher sonclick(). - Ajouter
AND (:niveau IS NULL OR niveau = :niveau)à la requête etbindValue('niveau', $niveau); côté JavaScript, ajouter le niveau choisi aux paramètres.
Résumé
- Debounce : une requête par pause de frappe.
AbortControllerannule les requêtes dépassées.- Requête préparée, jokers échappés, LIMIT, minimum de caractères.
- Affichage avec
textContentet<mark>. - Une classe de recherche réutilisable par la page, AJAX et l'API.
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 !