current_action()

Définition : current_action() retourne le nom de l’action WordPress actuellement en cours d’exécution. Elle sert surtout au diagnostic des callbacks et renvoie false lorsqu’aucune action ne figure comme contexte courant.

Terminologie

Terme : current_action()

Autres appellations : Action courante

À quoi cela sert

La fonction utilise le contexte des hooks actifs pour exposer le nom du plus récent hook exécuté. En présence de hooks imbriqués, le résultat peut donc être différent de celui de l’action extérieure qui a initialement conduit au callback.

Dans quel contexte l’utiliser

Elle est utile pour instrumenter un composant branché sur plusieurs hooks ou pour repérer le point de passage courant pendant un débogage. Ce contexte ne fournit pas une autorisation ni la preuve que le hook s’exécute une seule fois.

Exemple concret

Un callback commun à deux actions peut afficher dans le journal technique le nom du hook qui l’a déclenché.

Exemple de code commenté

<?php
$atoolpha_trace = function () {
    if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
        error_log( 'Hook actif : ' . (string) current_action() );
    }
};
add_action( 'init', $atoolpha_trace );
add_action( 'wp_loaded', $atoolpha_trace );

Explication de l’exemple

Le même callback est inscrit deux fois ; à l’intérieur, current_action() révèle le nom du hook de la pile d’exécution. L’écriture du journal est conditionnée au débogage pour éviter les traces inutiles en production.