WP_Error::get_error_message()

Définition : WP_Error::get_error_message() est une méthode qui récupère le message associé à une erreur stockée dans un objet WP_Error. Elle permet de présenter ou de journaliser une explication textuelle liée à un code d’échec.

Terminologie

Appellation / équivalent : WP_Error::get_error_message — message d’erreur WordPress

Autres appellations : Récupération d’un message d’erreur, Lecture d’erreur WP_Error

Comprendre le fonctionnement

Un objet WP_Error peut contenir plusieurs codes et plusieurs messages. La méthode get_error_message() accepte un code optionnel ; sans code précisé, elle renvoie le premier message du premier code disponible. Elle renvoie une chaîne vide lorsqu’aucun message ne correspond à la demande.

Le message produit n’est pas automatiquement destiné à être affiché aux visiteurs. Il peut contenir des données techniques ou provenir d’un composant tiers. Avant un affichage HTML, le code doit appliquer un échappement adapté et décider si l’information est appropriée pour le public. La méthode ne détermine pas si la valeur reçue est un objet WP_Error : ce rôle revient à is_wp_error().

Exemple concret

Une extension détecte un échec de création de contenu, lit son message et affiche une indication adaptée à l’utilisateur autorisé.

Exemple de code commenté

<?php
// Exemple pédagogique utilisant un objet d'erreur local.
$resultat = new WP_Error( 'atoolpha_demo', 'Donnée indisponible.' );
if ( is_wp_error( $resultat ) ) {
    echo '<p>' . esc_html( $resultat->get_error_message() ) . '</p>';
}