WP_Error::has_errors()

Définition : WP_Error::has_errors() est une méthode qui indique si un objet WP_Error contient au moins une erreur enregistrée. Elle renvoie un booléen, contrairement à is_wp_error() qui vérifie uniquement le type de valeur.

Terminologie

Appellation officielle : WP_Error::has_errors()

Autres appellations : Présence d’erreurs dans WP_Error, has_errors

Comprendre le fonctionnement

Un WP_Error peut être créé sans message initial, puis enrichi progressivement avec add(). La méthode has_errors() consulte son contenu pour savoir si un ou plusieurs codes d’erreur sont présents. Elle permet de distinguer un conteneur d’erreurs vide d’un conteneur qui signale effectivement un problème.

L’usage suppose que la valeur examinée soit déjà un WP_Error, car on invoque une méthode de cet objet. Une API qui peut renvoyer d’autres types nécessite donc d’abord un contrôle de type. L’existence d’erreurs ne définit pas automatiquement leur traitement : affichage, journalisation, propagation ou retour HTTP sont des responsabilités du code appelant.

Exemple concret

Une validation ajoute plusieurs anomalies à un conteneur, puis contrôle si le formulaire peut poursuivre son traitement.

Exemple de code commenté

<?php
$erreurs = new WP_Error();
$erreurs->add( 'champ_vide', 'Un champ est requis.' );
if ( $erreurs->has_errors() ) {
    echo esc_html( $erreurs->get_error_message() );
}