Aller au contenu principal
Version: 26.0.10.0

forms.csrf_nonce()

Génère un champ nonce WordPress pour la protection CSRF des formulaires.

Signature​

{{ forms.csrf_nonce() }}

Description​

Cette macro appelle la fonction WordPress wp_nonce_field() qui génère :

  • Un champ hidden contenant le nonce
  • Un champ hidden contenant l'_wp_http_referer

Elle est essentielle pour sécuriser vos formulaires contre les attaques CSRF (Cross-Site Request Forgery).

Paramètres​

Aucun paramètre. La macro utilise les valeurs par défaut de WordPress.

Exemples​

Utilisation de base​

{{ forms.csrf_nonce() }}

Rendu HTML :

<input type="hidden" id="_wpnonce" name="_wpnonce" value="abc123def456" />
<input type="hidden" name="_wp_http_referer" value="/admin-page" />

Dans un formulaire complet​

{% import "@elementum/macros/forms.html.twig" as forms %}

<form method="post" action="/admin-post.php">
    {{ forms.csrf_nonce() }}

    {{ forms.input('Titre', 'title', '', { required: true }) }}
    {{ forms.input('Contenu', 'content', '', 'text') }}

    {{ forms.submit('Enregistrer') }}
</form>

Cas d'usage​

Formulaire d'administration​

{% import "@elementum/macros/forms.html.twig" as forms %}

<form method="post" action="options.php">
    {{ forms.csrf_nonce() }}

    {{ forms.input('Nom du site', 'blogname', get_option('blogname'), { required: true }) }}
    {{ forms.input('Description', 'blogdescription', get_option('blogdescription')) }}

    {{ forms.submit('Enregistrer les options') }}
</form>

Formulaire de profil utilisateur​

{% import "@elementum/macros/forms.html.twig" as forms %}

<form method="post" action="{{ admin_url('profile.php') }}">
    {{ forms.csrf_nonce() }}

    {{ forms.input('Prénom', 'first_name', user.first_name) }}
    {{ forms.input('Nom', 'last_name', user.last_name) }}
    {{ forms.input('Email', 'email', user.user_email, 'email', { required: true }) }}

    {{ forms.submit('Mettre à jour le profil') }}
</form>
Vérification

Le nonce est automatiquement vérifié lorsqu'il est utiliser sur une page administrateur

Bonnes pratiques​

1. Toujours inclure le nonce​

✅ À faire :

<form method="post">
    {{ forms.csrf_nonce() }}
    {# Champs du formulaire #}
</form>

2. Un nonce par formulaire​

Chaque formulaire doit avoir son propre nonce :

{# Formulaire 1 #}
<form method="post" action="/action-1">
    {{ forms.csrf_nonce() }}
    {# Champs... #}
</form>

{# Formulaire 2 #}
<form method="post" action="/action-2">
    {{ forms.csrf_nonce() }}
    {# Champs... #}
</form>

Notes techniques​

Fonction WordPress sous-jacente​

La macro forms.csrf_nonce() appelle la fonction WordPress wp_nonce_field() sans paramètres, ce qui équivaut à :

wp_nonce_field(-1, '_wpnonce', false, true);

Où :

  • -1 : Action non spécifiée (utilise l'URL actuelle)
  • '_wpnonce' : Nom du champ nonce
  • false : Ne pas utiliser le referer personnalisé
  • true : Ajouter le champ _wp_http_referer

Durée de vie du nonce​

Par défaut, un nonce WordPress est valide pendant 24 heures. Après cette période, il doit être régénéré.

Nonce et cache​

Si vous utilisez un système de cache (object cache, page cache), assurez-vous que le nonce est généré dynamiquement et non mis en cache.

Voir aussi​