is_wp_error()


関数 WordPressis_wp_error()は、指定された値がWP_Errorオブジェクトであるかどうかを判定するために使用されます。

構文

is_wp_error( mixed $thing );
  • $thing (mixed) — 判定する値。

使用例 1: データのエラーチェック

次の例では、関数がエラーオブジェクトを返すかどうかを確認します。

<?php
$result = wp_remote_get( 'https://example.com/api' );
if ( is_wp_error($result) ) {
    echo $result->get_error_message();
}
?>

使用例 2: ファイルアップロードのエラー処理

ファイルアップロード中のエラーを処理します。

<?php
$file = wp_handle_upload( $_FILES['uploaded_file'], array('test_form' => false) );
if ( is_wp_error($file) ) {
    echo $file->get_error_message();
}
?>

使用例 3: プラグインのアクティベーションチェック

プラグインアクティベーション中のエラーを判定します。

<?php
$result = activate_plugin( 'plugin-directory/plugin-file.php' );
if ( is_wp_error($result) ) {
    echo $result->get_error_message();
}
?>

使用例 4: カスタム投稿タイプのエラー確認

カスタム投稿タイプの登録が失敗した場合にエラーを確認します。

<?php
$result = register_post_type( 'custom_type', array() );
if ( is_wp_error($result) ) {
    echo $result->get_error_message();
}
?>

使用例 5: サイドバーの登録チェック

サイドバー登録中のエラーを判定します。

<?php
$result = register_sidebar( array() );
if ( is_wp_error($result) ) {
    echo $result->get_error_message();
}
?>

注意事項

この関数を使用する際は、常にis_wp_error()を使ってエラーチェックを行うようにしてください。エラーが返される可能性のある関数やメソッドを使用する場合には特に重要です。

関連機能：