WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

it:Riferimento classi/WP Error

Contents

Descrizione

WP_Error è una classe che rende la gestione degli errori nei plugin e nello stesso WordPress molto più semplice.

Le istanze di WP_Error memorizzano codici e messaggi di errori che rappresentano uno o più errori; per determinare se una variabile è un'istanza di WP_Error si può usare la funzione is_wp_error().

Proprietà e metodi

Proprietà

$errors
Array contenente la lista di errori.
$error_data
Array contenente la lista di dati per i codici di errore.

Metodi

WP_Error($code, $message, $data)
Costruttore. Imposta il messaggio di errore. Se il parametro $code è vuoto non verrà eseguita alcuna azione. È possibile aggiungere molteplici messaggi allo stesso codice, ma con altri metodi nella classe. Tutti i parametri sono opzionali, ma se il parametro $code è impostato, allora il parametro $data è opzionale.
get_error_codes()
Recupera tutti i codici di errore. Di pubblico accesso, restituisce un array con la lista dei codici di errore, se disponibile.
get_error_code()
Recupera il primo codice di errore disponibile. Di pubblico accesso, restituisce una stringa, un intero o un valore vuoto se non ci sono codici di errore.
get_error_messages($code)
Recupera tutti i messaggi di errore o i messaggi di errore corrispondenti al codice passato. Di pubblico accesso, restituisce un array di stringhe con gli errori in caso di successo, oppure un array vuoto in caso di falimento (se si usa il parametro $code)
get_error_message($code)
Recupera un singolo messaggio di errore. Recupera il primo messaggio disponibile per il codice passato. Se nessun codice è passato allora il primo codice disponibile verrà usato. Restituisce una stringa di errore.
get_error_data($code)
Recupera i dati di errore per un determinato codice. Restituisce mixed o null, se non ci sono errori.
add($code, $message, $data)
Appende ulteriori messaggi di errore alla lista. Non restituisce nulla.
add_data($data, $code)
Aggiunge dati per il codice di errore indicato. Il codice di errore può contenere solo un dato di errore. Non restituisce nulla.

Esempi

function doer_of_stuff() {
  return  new WP_Error('broke', __("Sono caduto e non riesco ad alzarmi"));
}

$return = doer_of_stuff();
if ( is_wp_error($return) )
   echo $return->get_error_message();

File sorgente

WP_Error si trova in wp-includes/class-wp-error.php

Log delle modifiche

Correlati

  • Si veda is_wp_error() per maggiori informazioni sulla cattura degli errori (particolarmente utile quando ci si trova di fronte al temuto 'Catchable fatal error: Object of class WP_Error could not be converted to string')
Si veda anche l'indice di Riferimento classi e l'indice di Riferimento funzioni.