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