# Variable de requête

> 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.

- Auteur : Clément Hadrot
- Publié le : 2026-09-25
- Mis à jour le : 2026-09-25
- URL : https://wpmoderne.dev.wordpress-developpement.fr/lexique/variable-de-requete/

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.