コアポイント

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

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

問(wèn)題は何ですか？

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

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

上記のコードを?qū)g行すると、次の出力が取得されます。

<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はエラーを例外に変換するため、エラーは単體テストの例外と同じように動(dòng)作します。テスト中、エラーがトリガーされた後に実行されるコードは実行されません。別の例を挙げてください：

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

<?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の動(dòng)作の副作用

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

<?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()呼び出し（この時(shí)點(diǎn)で、エラーを例外に変換するカスタムエラーハンドラーが有効になっています）がnullを出力します。 2番目のvar_dump()呼び出し（PHPのデフォルトエラーハンドラーが有効になっている）は、トリガーされたエラーに関する情報(bào)を出力します。これは、最初のvar_dump()呼び出し出力nullがカスタムエラーハンドラーの使用によって引き起こされるためではなく、エラーハンドラーが例外をスローするためではないことに注意してください。この例に示されているエラーハンドラーがこれを?qū)g行しない場(chǎng)合、最初のvar_dump()呼び出しの出力は2番目のものと同じになります。

solution

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

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

結(jié)論

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

Fotoliaの寫真

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

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

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

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

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

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

Q3：PHPでのエラー報(bào)告はどのように機(jī)能しますか？

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

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

Q2と同じ。

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

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

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

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

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

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

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

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

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

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

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

データプロバイダーは、異なるデータセットで複數(shù)回テストを?qū)g行できるようにするPHPunitの強(qiáng)力な機(jī)能です。データプロバイダーを使用するには、配列の配列を返すメソッドを作成できます。各內(nèi)部配列は、テストのパラメーターのセットです。次に、データプロバイダー方法の名前を使用して、テスト方法をコメントします。 Phpunitは、パラメーターの各セットに対してテストを1回実行し、パラメーターをテスト方法に渡します。 @dataProvider

以上がPHPマスター| phpunitを使用したエラー狀態(tài)テストの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國(guó)語(yǔ) Web サイトの他の関連記事を參照してください。