WP_ERRORクラスの紹介

WordPressの

WP_ERRORクラス：エレガントなエラー処理メカニズム

WordPressのWP_Errorクラスは、アプリケーションのエラーを管理および変更するためのシンプルで強力なエラー処理メカニズムを提供します。アプリケーションに簡単に統合し、WordPressコア関数によって返されるエラーを効果的に処理し、ユーザーエクスペリエンスを改善するためのカスタムエラーメッセージを作成します。さらに、is_wp_errorなどの実用的な関数は、変数または関数の戻り値がWP_Errorのインスタンスであるかどうかを確認でき、それにより問題を効率的にデバッグすることができます。

コードがどれほど熟練していて細かく書かれていても、どの開発プロセスでもエラーを回避することはできません。 WordPress開発者として、すべてのコードエラーがエンドユーザーに影響を与えることなく正しく処理されることを確認することはあなたの責任です。 WordPressには、基本的なエラー処理クラスが付属しており、基本的なエラー処理のためにコードに統合できます。 WP_Error このチュートリアルでは、クラスの基本的な構造と作業原則を調査します。最も重要なことは、アプリケーションにクラスを統合する方法を紹介します。

WP_ErrorWP_Error カテゴリの詳細な説明

クラスには単純な構造がありますが、強力な機能があります。これは、プラグインのエラー処理メカニズムとして使用するのに十分です。そのソースコードは、WP_Errorファイルにあります。その特性と方法を見てみましょう。

プロパティWP_Error wp-includes/class-wp-error.php

プライベート属性は2つしかありません：

と

。

は関連するエラーメッセージを保存するために使用されますが、後でアクセスする関連データを保存するためにWP_Errorはオプションで使用されます。 $errors単純なキーと値のペアを使用して関連するエラーとデータをオブジェクトに保存するため、$error_dataで定義されているキーは、以前に定義されたキーの上書きを避けるために一意でなければなりません。 $errors $error_dataメソッドWP_Error WP_Error

に含まれる2つのプロパティを変更するいくつかの方法を提供します。いくつかを見てみましょう：

• get_error_codes()：利用可能なすべてのエラーコードを特定のWP_Errorインスタンスに対して返します。最初のエラーコードのみが必要な場合、別の個別の関数が利用可能です。 get_error_code()
• ：が提供されていない場合、関数は単に特定のget_error_messages( $code )インスタンスに保存されているすべてのメッセージを返すだけです。同様に、特定のエラーコードを使用してメッセージを返す必要がある場合は、$codeを使用してください。 WP_Error get_error_message( $code )
：この関数は、インスタンス化されたオブジェクトに保存されているエラーを変更する場合に特に役立ちます。
• とadd( $code, $message, $data )が不要であっても、WP_Error変数はまだ入力されることに注意してください。 $message $data$errors：
プロパティのみを変更する場合は、この関数を使用できます。
• パラメーターは2番目の位置にあることに注意してください。 add_data( $data, $code)が提供されていない場合、エラーデータが最初のエラーコードに追加されます。 $error_data $codeadd：これは、最近WordPress 4.1に追加された新しい方法であり、特定のキーに関連付けられたすべてのエラーメッセージとデータを削除します。 $code
• functionremove( $code )
関数によって返される特定の変数またはデータが

のインスタンスであるかどうかをどのようにして知るのですか？指定された変数に基づいてtrueまたはfalseを返すユーティリティ関数を使用して確認できます。

WP_Error：is_wp_error()のインスタンスである場合、trueを返し、それ以外の場合はfalseを返します。

• アプリケーションに実装is_wp_error( $thing )$thing WP_Error内部的にどのように機能するかを理解するだけで、自分のアプリケーションで適切に実装する方法を学ぶ必要があります。いくつかの例を取り、それがどのように機能するかをよりよく理解しましょう。
WordPressコア関数によって返される

処理エラー

WP_ErrorWordPressは、開発プロセスをスピードアップするために使用できる多くの実用的な機能を提供します。ほとんどの関数には、使用できる基本的なエラー処理関数も装備されています。

たとえば、

WP_Errorは、特定のURLへのリモートPOSTリクエストを作成するために使用できる非常に便利な機能です。ただし、リモートURLが常にアクセスできるとは期待できません。または、リクエストが常に成功します。マニュアルページから、この関数が失敗したときに

を返すことがわかります。この知識は、アプリケーションでエラー処理を正しく実装するのに役立ちます。

このコードをご覧ください：

ご覧のとおり、リモートPOSTリクエストを実行しています。ただし、単にwp_remote_postデータを取得するのではなく、以前に導入された便利なWP_Error関数を使用していくつかのチェックを行います。すべてが機能する場合、私たちはやりたいことを

でやり続けることができます。

アプリケーションでカスタムエラーを返します

handle_form_submission

という名前の連絡先フォームの送信を処理するカスタム関数があるとします。どこかでカスタムフォームを設定したとしたら、独自のエラー処理機能を実装することで機能を改善する方法を見てみましょう。

// 向远程 URL $url 发出请求
$response = wp_remote_post( $url, array(
    'timeout' => 30,
    'body' => array( 'foo' => 'bar' )
    )
);

if ( is_wp_error( $response ) ) {
   echo 'ERROR: ' . $response->get_error_message();
} else {
    // 执行某些操作
}

もちろん、これらの機能に独自のクリーニングと検証を実装する必要もありますが、これはこのチュートリアルの範囲内ではありません。これで、エラーベースのときにWP_Errorインスタンスを正しく返すことを知って、それを使用して、より意味のあるエラーメッセージをエンドユーザーに提供できます。

フォームの送信エラーを表示する特定の部分がアプリケーションにあると仮定します。これを行うことができます。

function handle_form_submission() {
    // 在此处执行你的验证、nonce 等操作

    // 实例化 WP_Error 对象
    $error = new WP_Error();

    // 确保用户提供名字
    if ( empty( $_POST['first_name'] ) ) {
        $error->add( 'empty', 'First name is required' );
    }

    // 也需要姓氏
    if ( empty( $_POST['last_name'] ) ) {
        $error->add( 'empty', 'Last name is required' );
    }

    // 检查电子邮件地址
    if ( empty( $_POST['email'] ) ) {
        $error->add( 'empty', 'Email is required' );
    } elseif ( ! is_email( $_POST['email'] ) ) {
        $error->add( 'invalid', 'Email address must be valid' );
    }

    // 最后，检查消息
    if ( empty( $_POST['message'] ) ) {
        $error->add( 'empty', 'Your message is required' );
    }

    // 发送结果
    if ( empty( $error->get_error_codes() ) ) {
        return true; // 没有错误
    }

    // 有错误
    return $error;
}

要約

ソフトウェア開発に秀でようとすることは、コードがすべきことを実行できないときに何をすべきかを知ることを意味し、アプリケーションがそれを優雅に処理できるようにすることを意味します。

WordPressの場合、付属の

クラスを使用すると、アプリケーションに統合できるかなりシンプルだが強力なエラー処理実装が提供されます。

WP_Error

（元のテキストの外部参照とFAQセクションは、元のテキストの直接コピーであり、擬似オリジナリティの要件を満たしていないため、ここでは省略されています。）

以上がWP_ERRORクラスの紹介の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。