Buskara
Centre d'aide

Réindexer le catalogue

Quand il vaut la peine de forcer une indexation complète, où cela se fait, et quoi faire quand le bouton n'arrive pas au bout.

3 min Mis à jour le 11 août 2026

La plupart des jours, ce n'est pas nécessaire. Le prix et le stock arrivent en quelques secondes par le temps réel, et la synchronisation périodique revoit le catalogue de son côté. Ce guide est pour les fois où beaucoup de choses ont changé d'un coup et où vous ne voulez pas attendre.

Quand cela vaut la peine

  • Un gros import de produits, fait par CSV ou directement dans la base de données.
  • Un changement structurel : renommer des catégories, refaire des caractéristiques, changer la structure des déclinaisons.
  • Après avoir activé ou désactivé le partage des ventes ou du prix de revient dans le module.
  • Après avoir changé les poids des champs, si vous voulez en voir l'effet immédiatement au lieu d'attendre la reconstruction que l'enregistrement a déjà demandée.

Quand cela n'en vaut pas la peine Les changements de prix, de stock et d'état arrivent par le temps réel en quelques secondes. Réindexer pour cela prend du temps et ne change rien.

Où se trouve le bouton

Dans le back-office de la boutique, dans la configuration du module Buskara : Tout réindexer. Ce n'est pas dans le panneau, et c'est fait exprès : c'est la boutique qui a le catalogue, et c'est d'elle que part l'export.

Dans le panneau, dans Recherche → Boutiques, vous suivez ce qui se passe : En attente, Indexation… (envoyés / total) et enfin À jour, avec le total de documents. Une indexation lancée depuis le bouton du module y apparaît de la même façon.

Ce que l'on voit pendant l'opération

Le catalogue part par lots : la page demande un morceau à la fois, affiche la barre qui avance avec les éléments déjà envoyés, et recharge à la fin avec le résultat. C'est ainsi parce qu'une seule requête envoyant des dizaines de milliers de produits se heurtait à la limite de temps du serveur, et ce qui s'affichait était un Request Timeout sans la moindre explication.

Gardez l'onglet ouvert jusqu'à la fin. Si vous le fermez à mi-chemin, ce qui est déjà parti reste en place et le reste entre dans l'indexation suivante, que ce soit un autre clic sur le bouton ou la synchronisation périodique.

Sans navigateur, en ligne de commande

Pour les boutiques avec beaucoup de références, ou pour laisser tourner en dehors des heures, le module fournit le même travail en ligne de commande :

php modules/buskara/cli/reindex.php

Elle n'a aucune limite de temps et n'a besoin de personne devant l'écran.

Ce qui arrive à la recherche pendant ce temps

Elle continue de répondre, avec l'index précédent. Le remplacement se fait à la fin : les visiteurs n'attrapent jamais de résultats au milieu d'une reconstruction, ni un catalogue à moitié.

Si le total ne colle pas

Comparez le total de documents du moteur avec le nombre de produits actifs de la boutique. Un écart est presque toujours l'un de ceux-ci : des produits inactifs ou non visibles dans la boutique, l'option produits en rupture de stock : masquer qui fait exactement ce qu'on lui a demandé, ou une indexation qui n'est pas encore terminée.

La liste complète des causes, par ordre de probabilité, est dans produits qui n'apparaissent pas.

Ce guide vous a-t-il été utile ?

Non, j'ai encore des questions