PHPUnit での assertSame vs assertEquals
違いの核心
assertEquals |
assertSame |
|
|---|---|---|
| 比較方法 |
==(緩やかな比較) |
===(厳密な比較) |
| 型変換 | あり | なし |
| 用途 | 値が等しいか | 値も型も同一か |
PHPではJavaと異なり、assertSame = ===比較(値+型)になります。
assertSame を使うメリット
1. 型の不一致を検出できる
// assertEquals は通過してしまう
assertEquals(0, false); // ✅ 通過(0 == false)
assertEquals(0, ""); // ✅ 通過(0 == "")
assertEquals(1, "1"); // ✅ 通過
// assertSame は型まで検査する
assertSame(0, false); // ❌ 失敗(int !== bool)
assertSame(1, "1"); // ❌ 失敗(int !== string)
2. 意図しない型変換のバグを早期発見
// DBから取得した値が文字列になっていないか確認
assertSame(42, $user->getId()); // intで返るべき
assertSame(true, $result->isValid()); // boolで返るべき
3. null チェックが厳密になる
assertEquals(null, false); // ✅ 通過してしまう
assertSame(null, false); // ❌ 正しく失敗する
4. テストの信頼性向上
== による暗黙の型変換はPHPの有名な落とし穴のため、assertSame を基本にすることでテスト自体の品質が上がる。
推奨される使い分け
// ✅ assertSame を使うべきケース(基本的にこちらを推奨)
assertSame(1, $count); // 型も含めて保証したい
assertSame('foo', $str); // 文字列の厳密一致
assertSame(true, $flag); // bool の確認
// ✅ assertEquals が適切なケース
assertEquals(1.0, 1); // 数値の緩やかな比較が必要
assertEquals($objA, $objB); // オブジェクトのプロパティ値比較
基本方針: 迷ったら
assertSameを使う。緩やかな比較が必要な理由があるときだけassertEqualsを使う、というスタイルが主流です。
参考記事
-
PHPUnit 公式ドキュメント(日本語)
https://phpunit.readthedocs.io/ja/latest/assertions.html -
Baeldung的な立ち位置のPHP版 — PHPUnit Assertions まとめ(英語)
https://phpunit.de/manual/current/en/appendixes.assertions.html