did_action()

Définition : did_action() renvoie combien de fois une action WordPress a déjà été déclenchée pendant la requête courante. Elle aide à comprendre l’ordre d’exécution du Core et à vérifier si une étape précise a eu lieu.

Terminologie

Terme : did_action()

Autres appellations : Compteur d’action

À quoi cela sert

WordPress conserve, pour chaque nom d’action, un compteur des déclenchements sur la requête PHP en cours. did_action() lit ce compteur sans invoquer le hook. Le résultat est un entier ; zéro signifie que l’action n’a pas encore été déclenchée dans ce contexte.

Dans quel contexte l’utiliser

L’utiliser dans un diagnostic du cycle d’initialisation ou pour conditionner un enregistrement tardif. Ne pas employer ce compteur comme stockage persistant ni comme preuve qu’une opération métier a réussi.

Exemple concret

Un composant souhaite savoir si le hook init a déjà été exécuté lorsque son fichier est chargé.

Exemple de code commenté

<?php
if ( did_action( 'init' ) > 0 ) {
    // WordPress a déjà déclenché l’action init dans cette requête.
} else {
    // init n’a pas encore été déclenchée.
}

Explication de l’exemple

Le contrôle distingue un chargement effectué avant init d’un chargement tardif. La vérification indique uniquement que l’événement a été déclenché, pas si les callbacks l’ont terminé avec succès.