vendredi 25 septembre 2026

À propos

Contact

Lexique · Cœur de WordPress

Variable de requête

En anglais : « Query var »

Une variable de requête est un paramètre interne, comme p, cat ou s, que WordPress utilise pour construire la requête WP_Query correspondant à une URL.

Derrière chaque permalien élégant se cache, une fois traduit par les règles de réécriture, un ensemble de paramètres bruts que WordPress comprend nativement — c’est cette forme interne qui alimente réellement la construction de la requête.

Fonctionnement dans WordPress

Des variables comme p (identifiant d’article), page_id, cat, author_name ou s (recherche) sont reconnues nativement ; une extension peut en ajouter de nouvelles via le filtre query_vars, généralement combinées à une règle de réécriture personnalisée pour qu’elles soient accessibles via une URL propre. On les récupère dans un gabarit avec get_query_var().

Exemple

add_filter( 'query_vars', function( $vars ) {
    $vars[] = 'region';
    return $vars;
} );

$region = get_query_var( 'region' );

Bon à savoir

Une variable de requête ajoutée sans règle de réécriture associée reste accessible uniquement sous forme de paramètre GET classique (?region=paca) et non comme segment d’un permalien propre ; les deux mécanismes doivent être pensés ensemble.

Bon à savoir

Certaines variables de requête, comme preview ou embed, sont réservées à des usages internes précis de WordPress ; les réutiliser pour un besoin personnalisé peut entraîner des comportements inattendus difficiles à retracer.

Une même variable de requête peut aussi être transmise à un WP_Query personnalisé sous forme d’argument de tableau, ce qui explique pourquoi les noms des arguments acceptés par cette classe recoupent largement ceux des variables de requête reconnues par le cœur de WordPress.