Définition simple
Les rewrite rules traduisent des URLs lisibles vers des requêtes WordPress.
Définition technique
WordPress stocke des règles de réécriture générées par le core, les CPT, taxonomies et plugins.
À quoi cela sert ?
faire fonctionner permaliens, archives et routes personnalisées.
Exemple concret
réenregistrer les permaliens peut reconstruire les règles après ajout d’un CPT.
Problèmes fréquents
- 404 après migration
- flush trop fréquent
- conflit de slug
À retenir : adaptez toujours le diagnostic à la version du produit et à l’architecture réellement déployée.
Repères et contexte
Les rewrite rules de WordPress associent des formes d’URL publiques à des requêtes internes comprises par WordPress. Elles sont générées à partir de la structure des permaliens et des règles ajoutées par le cœur, les extensions, les thèmes ou du code personnalisé.
Une règle absente ou obsolète peut produire des 404 alors que le contenu existe. Le flush des règles est une opération de reconstruction, pas une correction universelle : l’exécuter à chaque requête dégrade les performances et masque souvent la cause réelle d’un enregistrement de route incorrect.
Exemple concret
Après l’ajout d’un nouveau type de contenu ou endpoint, une régénération ponctuelle peut être nécessaire. Si la route retombe ensuite en erreur, il faut contrôler le code qui déclare la règle plutôt que répéter le flush en permanence.
Concepts liés
Référence primaire : WP_Rewrite — WordPress Developer Resources.