WordPressの

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

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

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

WP_ErrorWP_Error カテゴリの詳細な説明

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

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

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

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

処理エラー

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

たとえば、

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

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

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

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

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

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

handle_form_submission

という名前の連絡(luò)先フォームの送信を処理するカスタム関數(shù)があるとします。どこかでカスタムフォームを設(shè)定したとしたら、獨自のエラー処理機能を?qū)g裝することで機能を改善する方法を見てみましょう。

// 向遠程 URL $url 發(fā)出請求
$response = wp_remote_post( $url, array(
    'timeout' => 30,
    'body' => array( 'foo' => 'bar' )
    )
);

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

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

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

function handle_form_submission() {
    // 在此處執(zhí)行你的驗證、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' );
    }

    // 發(fā)送結(jié)果
    if ( empty( $error->get_error_codes() ) ) {
        return true; // 沒有錯誤
    }

    // 有錯誤
    return $error;
}

要約

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

WordPressの場合、付屬の

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

WP_Error

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

以上がWP_ERRORクラスの紹介の詳細內(nèi)容です。詳細については、PHP 中國語 Web サイトの他の関連記事を參照してください。