is_wp_error( mixed $thing )

Vérifie si la variable est une erreur WordPress.

Paramètre

$thing(mixed)requis

La variable à vérifier.

Retourne

(bool) True si la variable est une instance de la class WP_Error.

Déclaration et structure de la fonction is_wp_error()

function is_wp_error( $thing ) {
    $is_wp_error = ( $thing instanceof WP_Error );

    if ( $is_wp_error ) {
        /**
         * Fires when `is_wp_error()` is called and its parameter is an instance of `WP_Error`.
         *
         * @since 5.6.0
         *
         * @param WP_Error $thing The error object passed to `is_wp_error()`.
         */
        do_action( 'is_wp_error_instance', $thing );
    }

    return $is_wp_error;
}
do_action()

Exécute des fonctions attachées à un hook spécifique.

is_wp_error_instance

Appelé si la variable est une instance de WP_Error.

Où est utilisée la fonction is_wp_error() dans le CMS WordPress

Exemples

if ( is_wp_error( $result ) ) {
    $error_string = $result->get_error_message();
}
$email = 'test@test.com';
$userdata = array(
    'user_login'    => $email,
    'user_email'    => $email,
);
 
$user_id = wp_insert_user( $userdata );
 
if ( is_wp_error( $user_id ) ) {
    $error_code = array_key_first( $user_id->errors );
    $error_message = $user_id->errors[$error_code][0];
}

Sources

Codex WordPress : is_wp_error()

Autres fonctions dans le même fichier : wp-includes/load.php

Retour