Функция is_wp_error() используется для проверки, является ли переданный аргумент объектом класса WP_Error. Этот класс используется для обработки ошибок в WordPress, предоставляя методы для установки и получения сообщений об ошибках. Функция is_wp_error() возвращает true, если аргумент является объектом WP_Error, и false в противном случае.
bool is_wp_error( mixed $thing )Параметры
- $thing (mixed): Значение для проверки. Может быть любой тип данных.
Возвращаемое значение
- (bool): Возвращает
true, если значение является объектомWP_Error, иfalseв противном случае.
Пример 1: Проверка результата функции
Этот пример демонстрирует, как использовать is_wp_error() для проверки результата функции, которая может возвращать объект WP_Error.
$result = wp_insert_post( $post_data );
if ( is_wp_error( $result ) ) {
echo 'Ошибка: ' . $result->get_error_message();
} else {
echo 'Запись успешно создана с ID: ' . $result;
}
Пример 2: Обработка ошибок при загрузке файла
Этот пример показывает, как проверить наличие ошибок при загрузке файла с использованием функции media_handle_upload.
if ( ! empty( $_FILES['my_file']['name'] ) ) {
$file = $_FILES['my_file'];
$upload_result = media_handle_upload( 'my_file', 0 );
if ( is_wp_error( $upload_result ) ) {
echo 'Ошибка загрузки файла: ' . $upload_result->get_error_message();
} else {
echo 'Файл успешно загружен. ID файла: ' . $upload_result;
}
}
Пример 3: Проверка ошибок при подключении к базе данных
Этот пример демонстрирует, как использовать is_wp_error() для проверки ошибок при подключении к базе данных.
$wpdb = new wpdb( DB_USER, DB_PASSWORD, DB_NAME, DB_HOST );
if ( is_wp_error( $wpdb ) ) {
wp_die( 'Ошибка подключения к базе данных: ' . $wpdb->get_error_message() );
} else {
echo 'Успешное подключение к базе данных.';
}
Пример 4: Использование с функцией get_user_by()
Этот пример показывает, как проверить результат функции get_user_by, которая возвращает объект WP_User или WP_Error.
$user = get_user_by( 'email', '[email protected]' );
if ( is_wp_error( $user ) ) {
echo 'Ошибка: ' . $user->get_error_message();
} elseif ( $user ) {
echo 'Пользователь найден: ' . $user->display_name;
} else {
echo 'Пользователь не найден.';
}Заключение
Функция is_wp_error() является важным инструментом для обработки и проверки ошибок в WordPress. Она помогает разработчикам эффективно управлять ошибками, улучшая стабильность и надежность кода.