PHPマスター| phpunitを使用したエラー状態テスト

コアポイント

• PHPunitは、PHPネイティブエラー処理を例外に変換します。これにより、テスト中のコード実行のフローが変更される場合があります。これは、trigger_error()関数を使用してコードをテストするときに問題を引き起こす可能性があります。
• phpunitはエラーを例外に変換します。これにより、コードの動作は、生産環境とは異なる動作とテストが異なります。これは、エラーが発生したときに実行プロセスが変更されるためです。
• trigger_error()を使用してコードを正確にテストするには、カスタムエラーハンドラーを使用して、アサーションを使用して後の分析のためにエラー情報をキャプチャできます。これにより、コードは実行を続けることができますが、エラー条件を確認することを許可します。
• ユニットのデフォルト動作は、正確なテストに重要です。トリガー後のロジックが発生した場合、Phpunitの機能を補完することで、できるだけ生産環境に近い正確なテストを容易にすることができます。

PHPネイティブtrigger_error()関数を使用してエラーメッセージを記録するコードを維持していると仮定します。一方、Phpunitを使用してそのコードの単体テストを作成しています。 Phpunitマニュアルを参照する場合、エラー条件をテストする方法専用のセクションがあります。これは、エラー、警告、通知を例外に変換する独自のエラーハンドラーをどのように実装するかを説明し、これらの例外をキャッチすることは、そのようなエラーテストを処理する方法です。ただし、コードの外観に応じて、PHPunitでのこのアプローチに問題がある場合があります。この記事では、この問題が何であるか、それがあなたのコードをテストする能力にどのように影響するか、そしてそれを解決する方法を詳細に説明します。

問題は何ですか？

エラーと例外は、根本的に異なる方法で動作します。特に、この記事に関連して、エラーレベルが渡された場合、致命的なエラーが示されていない場合、コードの実行はtrigger_error()直後に継続できます。例外がスローされると、その例外クラスに対応するcatchブロックの開始時に実行が続きます。これらの行動の例を見てみましょう。まず第一に、それはエラーです。

<?php
error_reporting(E_ALL | E_STRICT);
echo "Before warning\n";
trigger_error("Danger Will Robinson!", E_USER_WARNING);
echo "After warning\n";
?>

上記のコードを実行すると、次の出力が取得されます。

<code>Before warning
PHP Warning:  Danger Will Robinson! in /home/matt/error_handler.php on line 4
After warning</code>

これから、

の後のtrigger_error()ステートメントが実行されたことがわかります。今、例外。 echo

<?php
try {
    echo "Before exception\n";
    throw new Exception("Danger Will Robinson!");
    echo "After exception\n";
}
catch (Exception $e) {
    echo "In catch block\n";
}
?>

output：

<code>Before exception
In catch block</code>

エラーの例とは対照的に、例外がスローされた後のコードは実行されません。 phpunitはエラーを例外に変換するため、エラーは単体テストの例外と同じように動作します。テスト中、エラーがトリガーされた後に実行されるコードは実行されません。別の例を挙げてください：

エラーからのエラーへの変換により、エラーが例外に変換された場合、コードは実行されないため、

<?php
function foo($param) {
    if (is_string($param)) {
        trigger_error(__FUNCTION__ . " no longer supports strings, pass an array", E_USER_NOTICE);
    }
    // do useful stuff with $param
    ...
}
?>

が有用に処理されるかどうかをテストすることは不可能です。

phpunitの動作の副作用

このエラーからのエラーへの変換により、コードは生産環境とは開発とテストで動作が異なります。例は次のとおりです。

<?php
error_reporting(E_ALL | E_STRICT);
echo "Before warning\n";
trigger_error("Danger Will Robinson!", E_USER_WARNING);
echo "After warning\n";
?>

output：

<code>Before warning
PHP Warning:  Danger Will Robinson! in /home/matt/error_handler.php on line 4
After warning</code>

最初のvar_dump()呼び出し（この時点で、エラーを例外に変換するカスタムエラーハンドラーが有効になっています）がnullを出力します。 2番目のvar_dump()呼び出し（PHPのデフォルトエラーハンドラーが有効になっている）は、トリガーされたエラーに関する情報を出力します。これは、最初のvar_dump()呼び出し出力nullがカスタムエラーハンドラーの使用によって引き起こされるためではなく、エラーハンドラーが例外をスローするためではないことに注意してください。この例に示されているエラーハンドラーがこれを実行しない場合、最初のvar_dump()呼び出しの出力は2番目のものと同じになります。

solution

テストされているコードを実行し続けることを可能にしながら、エラー条件が発生したかどうかを確認できるソリューションが必要です。上記の例に示すように、エラーを例外に変換しないカスタムエラーハンドラーを使用して、コードの実行を続行することができます。このエラーハンドラーがすべきことは、エラーメッセージをキャプチャして、アサーションを使用して後で分析できるようにすることです。これがどのように見えるかです：

<?php
try {
    echo "Before exception\n";
    throw new Exception("Danger Will Robinson!");
    echo "After exception\n";
}
catch (Exception $e) {
    echo "In catch block\n";
}
?>

setUp()（各テスト方法の前に実行）エラーハンドラーのセットアップを処理します。これは、アレイに各エラーに関する情報を保存する同じクラスの別のメソッドです。その後、このエラーメッセージと出力関連のデバッグ情報のアサーションを実行するために、他のメソッド（assertError()など）がテスト方法（testDoStuff()など）で使用されます。他の有用なアサーションタイプには、論理的反転（つまり、アサーションは特定のエラーをトリガーしない）、メッセージをチェックするエラーが正規表現と一致するエラー、またはトリガーされるエラーの数が含まれます。

結論

エラーがまだ実行されているテストの背後にあるロジックがまだ実行されているかどうかは気にしない場合、PHPunitのデフォルトの動作はあなたのニーズに完全に適しています。ただし、動作の意味を理解することが重要です。このようなロジックの実行に関心がある場合は、できるだけ生産環境に近いコードの正確なテストを容易にするために、PHPunitの機能を補完する方法を知っていることも重要です。

Fotoliaの写真

（以下はFAQです。形式と式は元のコンテンツに従って調整されており、いくつかの問題がマージまたは簡素化されています）

phpunitを使用してエラー条件をテストするための

FAQ（FAQ）Q1：なぜPHPunitがコンソールにエラーが表示されないのですか？

phpunitは、エラーや例外の効果的なテストを可能にする方法で設計されています。コンソールにエラーが表示されない場合、Phpunitはそれらをキャプチャし、それらを失敗したテストとして扱う可能性があります。これらのエラーの詳細を表示するには、テストを実行するときに--debugオプションを使用できます。これにより、テスト中にキャッチされたエラーや例外を含む、より詳細な出力が提供されます。

Q2：例外がphpunitでスローされたと主張する方法は？

phpunitは、例外を処理するために特別に使用される一連のアサーションを提供します。最も一般的に使用されるのはexpectException()です。これは、スローする予定の例外のタイプを指定するために使用できます。テスト中に指定された例外がスローされた場合、テストは渡されます。そうでない場合、テストは失敗します。これにより、エラー条件の正しい処理を特に確認するテストを作成できます。

Q3：PHPでのエラー報告はどのように機能しますか？

PHPのエラーレポート機能により、どのエラーが報告されているか、どのエラーに対処するかを制御できます。デフォルトでは、すべてのエラーが報告および表示されます。ただし、これらの設定は、error_reporting()関数とdisplay_errorsINIディレクティブを使用して変更できます。これにより、特定の種類のエラーを表示したり、ログエラーを表示したりすることができます。

Q4：phpunitで例外をテストする方法は？

Q2と同じ。

Q5：phpunitのテストを作成する方法は？

phpunitのテストの作成には、phpunitframeworktestcaseクラスを拡張する新しいテストケースクラスの作成が含まれます。各テストは、「テスト」という単語から始まるこのクラスの公開方法です。各テスト方法内で、Phpunitのアサーションを使用して、コードが予想どおりに実行されているかどうかを確認できます。たとえば、assertEquals()メソッドを使用して、関数が期待される結果を返すかどうかを確認できます。

q6：phpunitのエラーを処理する方法は？

phpunitは、エラーを処理するために特別に使用される一連のアサーションを提供します。最も一般的に使用されるのはexpectError()です。これは、トリガーが予想されるエラーのタイプを指定するために使用できます。テスト中に指定されたエラーがトリガーされた場合、テストは合格します。そうでない場合、テストは失敗します。これにより、エラー条件の正しい処理を特に確認するテストを作成できます。

q7：phpunitでテストをデバッグする方法は？

phpunitは、テストをデバッグするためのいくつかのオプションを提供します。 --debugオプションは、テスト中にキャッチされたエラーや例外を含む、より詳細な出力を提供します。何らかのタイプのエラーが発生したときに、--stop-on-error、--stop-on-failure、および--stop-on-riskyオプションを使用して、テストの実行を停止できます。これにより、問題を識別して修正しやすくなります。

Q8：phpunitでエラー条件をテストする方法は？

phpunitは、エラー条件をテストするいくつかの方法を提供します。 expectError()メソッドを使用すると、トリガーが予想されるエラーのタイプを指定できます。 expectWarning()メソッドを使用すると、トリガーが予想される警告のタイプを指定できます。テスト中に指定されたエラーまたは警告がトリガーされた場合、テストは渡されます。そうでない場合、テストは失敗します。

q9：phpunitで警告を処理する方法は？

phpunitは、警告を処理するために特別に使用される一連のアサーションを提供します。最も一般的に使用されるのはexpectWarning()です。これは、トリガーが予想される警告のタイプを指定するために使用できます。テスト中に指定された警告がトリガーされた場合、テストは合格します。そうでない場合、テストは失敗します。これにより、警告条件の正しい取り扱いを具体的に確認するテストを作成できます。

q10：phpunitでデータプロバイダーを使用する方法は？

データプロバイダーは、異なるデータセットで複数回テストを実行できるようにするPHPunitの強力な機能です。データプロバイダーを使用するには、配列の配列を返すメソッドを作成できます。各内部配列は、テストのパラメーターのセットです。次に、データプロバイダー方法の名前を使用して、テスト方法をコメントします。 Phpunitは、パラメーターの各セットに対してテストを1回実行し、パラメーターをテスト方法に渡します。 @dataProvider

以上がPHPマスター| phpunitを使用したエラー状態テストの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。