Table des matières
Mis à jour le 12 octobre 2026
wp_usermeta est la table WordPress qui stocke les métadonnées de chaque utilisateur sous forme de lignes clé/valeur. Sur un site à membres, elle ralentit dès que l’on filtre sur la colonne meta_value, qui n’est pas indexée. Les parades : une clé par donnée, pas de tableaux sérialisés filtrables, un cache d’objets persistant et, au besoin, une table dédiée. Je reviens plus en détail sur Agents IA autonomes dans un autre article.
Comment fonctionne la table wp_usermeta ?
La table wp_usermeta applique le modèle entité-attribut-valeur : une ligne par couple (utilisateur, clé). Elle compte quatre colonnes, umeta_id, user_id, meta_key et meta_value (de type longtext), et seuls user_id et meta_key sont indexés, comme le montre le schéma du code source de WordPress.
Pour un utilisateur donné, on trouve par exemple :
- user_id 50, meta_key first_name, meta_value Jane
- user_id 50, meta_key last_name, meta_value Doe
- user_id 50, meta_key membership_level, meta_value Gold
Ce modèle est souple : un plugin peut ajouter n’importe quelle donnée sans modifier le schéma. Le revers est arithmétique. Avec 50 000 membres et 20 champs personnalisés chacun, on dépasse le million de lignes (c’est un calcul, pas une mesure). Chaque recherche sur une valeur doit alors parcourir une partie de cet ensemble.
Pourquoi les tableaux sérialisés posent-ils problème ?
Stocker un tableau sérialisé dans une seule méta réduit le nombre de lignes, mais rend la donnée impossible à filtrer proprement en SQL. Comme meta_value n’a pas d’index, une recherche dans le texte sérialisé passe par un LIKE et un parcours complet des lignes de la clé concernée.
Exemple typique :
$preferences = array(
'email' => true,
'sms' => false,
'tier' => 'premium'
);
update_user_meta( $user_id, 'member_preferences', $preferences );
Pour lire les préférences d’un membre, c’est parfait. Pour retrouver tous les membres dont le SMS est activé, la base ne peut pas s’appuyer sur un index. Je recommande donc une règle simple : tout ce qui sert de critère de tri ou de filtre reçoit sa propre clé (member_sms_optin, member_tier), le tableau sérialisé étant réservé aux données que l’on ne fait que relire. Je reviens plus en détail sur Construire une knowledge base façon Karpathy dans un autre article.
Pourquoi get_users() avec meta_query devient-il lent ?
Une meta_query dans get_users() ajoute une jointure sur wp_usermeta, puis compare la valeur sans index. Plus la table grossit, plus cette comparaison coûte cher. La documentation de WP_User_Query donne d’ailleurs plusieurs leviers concrets.
- Passer
count_totalàfalsequand la pagination n’est pas nécessaire : la requête de comptage disparaît. - Éviter
number = -1sur un gros site, la documentation recommande elle-même la prudence. - Demander uniquement les champs utiles (
fields=ID) plutôt que des objets WP_User complets. - Se méfier des relations
ORentre plusieurs clauses : elles forcent unDISTINCT. - Pour comparer des nombres, préciser
type=NUMERIC, car le type par défaut estCHAR.
Un filtre combinant une date d’inscription et un rôle personnalisé stocké en méta fait vite grimper le coût. Dans ce cas, mieux vaut utiliser le paramètre natif role et date_query sur wp_users que de recréer l’information en méta.
Un cache d’objets persistant aide-t-il pour wp_usermeta ?
Oui, pour les lectures répétées. WordPress charge déjà les métadonnées d’un utilisateur en une fois et les garde dans son cache d’objets (groupe user_meta), mais ce cache est par défaut limité à une seule requête, comme le précise la documentation de WP_Object_Cache. Avec Redis ou Memcached, il survit d’une page à l’autre.
L’effet se voit surtout sur :
- la connexion, qui lit identifiants et rôles ;
- l’espace « Mon compte », qui relit les mêmes champs à chaque affichage ;
- l’écran Utilisateurs du back-office.
Sur les sites que je gère, je mets en place ce cache côté serveur (LiteSpeed propose une intégration Redis/Memcached), avec une réserve : il ne rend pas une requête filtrée plus rapide la première fois, il évite seulement de la rejouer. Je détaille le contexte serveur dans ma page sur WordPress en production.
Comment gérer un site de plus de 100 000 membres ?
Au-delà de quelques dizaines de milliers de membres, il faut revoir la structure des données plutôt que d’ajouter du matériel. Trois pistes, par ordre d’effort croissant :
- Une clé par donnée filtrable. Sortez des tableaux sérialisés tout ce qui sert dans une recherche.
- Surveiller wp_options. Certains plugins y stockent des données utilisateur avec l’autoload activé : elles sont alors chargées à chaque page, ce qui alourdit la mémoire et le démarrage.
- Une table personnalisée. Pour des données de reporting ou de recherche intensive, une table SQL dédiée avec ses propres index permet de concevoir le schéma autour de vos requêtes réelles.
| Approche | Filtrable en SQL | Effort | Cas d’usage |
|---|---|---|---|
| Tableau sérialisé | Non (LIKE sur texte) | Faible | Données relues uniquement |
| Une clé par donnée | Oui, sans index sur la valeur | Faible | Filtres occasionnels |
| Table personnalisée | Oui, avec index dédiés | Élevé | Gros volumes, reporting |
Je ne recommande la table personnalisée qu’une fois les deux premières étapes faites et mesurées : elle ajoute du code à maintenir (création, migration, suppression à la désinscription d’un membre).
Questions fréquentes
À quoi sert la table wp_usermeta ?
wp_usermeta stocke les métadonnées des utilisateurs sous forme de lignes clé/valeur : prénom, nom, niveau d’adhésion, préférences et données propres aux extensions. C’est la table de référence pour tout ce qui dépasse les champs de base de wp_users.
Pourquoi les données sérialisées posent-elles problème ?
La colonne meta_value n’est pas indexée. Une recherche à l’intérieur d’un tableau sérialisé passe donc par un LIKE et un parcours des lignes, ce qui pénalise les sites avec beaucoup de membres. Mieux vaut une clé dédiée pour chaque donnée filtrable.
Comment accélérer get_users() avec une meta_query ?
Désactivez count_total si la pagination est inutile, limitez les champs retournés, évitez number = -1 et les relations OR, et utilisez les paramètres natifs (role, date_query) plutôt qu’une méta quand c’est possible.
Faut-il un cache d’objets persistant pour un site à membres ?
C’est utile dès que les mêmes métadonnées sont relues à chaque page (connexion, espace membre). Redis ou Memcached conservent le cache entre les requêtes, alors que le cache natif de WordPress ne dure que le temps d’une requête.