WordPressの

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

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

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

WP_ErrorWP_Error カテゴリの詳細(xì)な説明

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

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

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

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

処理エラー

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

たとえば、

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

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

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

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

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

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

handle_form_submission

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

// 向遠(yuǎn)程 URL $url 發(fā)出請(qǐng)求
$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í)行某些操作
}

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

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

function handle_form_submission() {
    // 在此處執(zhí)行你的驗(yàn)證、nonce 等操作

    // 實(shí)例化 WP_Error 對(duì)象
    $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; // 沒(méi)有錯(cuò)誤
    }

    // 有錯(cuò)誤
    return $error;
}

要約

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

WordPressの場(chǎng)合、付屬の

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

WP_Error

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

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