こんにちは！開発現場を渡り歩いてきた、あなたの専属シニアアーキテクトです。
新しいプロジェクトに参入したとき、あるいは自分が書いたコードに改修を加えたとき、こんな不安に襲われたことはありませんか？
「この変更、本当に他の機能に悪影響を与えていないだろうか……？」
シニアエンジニアがなぜ平然と大規模なリファクタリングをこなせるのか。その秘密は「テストコードによる網羅性の担保（カバレッジ）」にあります。そして、最強のIDEである PhpStorm と PHPUnit を組み合わせれば、その不安は「確信」へと変わります。
今回は、PhpStormのカバレッジ機能をフル活用し、コードの「どこがテストされていて、どこが放置されているのか」をガター（行番号の横）に美しく可視化する方法を、基礎から徹底的に解説します。これをマスターすれば、あなたのコーディングスピードと品質への自信は劇的に変わりますよ。
—
1. なぜ「テストカバレッジ」がデグレ防衛の切り札なのか？
開発現場で最も恐れられるのが「デグレ（デグレッション：改修によって既存機能が壊れること）」です。
よくある誤解として「テストが通れば（All Greenなら）安心」というものがありますが、それは半分間違いです。「どんなテストを書いたか」が抜けていれば、コードの重要な分岐（if文や例外処理など）が一度も実行されないまま「テスト合格」になってしまうからです。
PhpStormのコードカバレッジ機能は、テストスイートを実行した際に「どの行のコードが実際に通過したか（Hit）」をリアルタイムで追跡し、エディタ上に色分けして教えてくれます。
- 緑色: テストによって完全に実行されたコード
- 赤色: 一度もテストされていない（＝デグレの爆弾が眠っている）コード
- 黄色: 条件分岐の一部しかテストされていないコード（片側のルートが未検証）
この視覚的フィードバックがあるだけで、「次はどのテストケースを追加すべきか」が一目瞭然になります。
—
2. 開発環境のセットアップ：PHPUnitとXdebugの連携
カバレッジ計測を行うには、背後でPHPのコード解析エンジン（通常は Xdebug または PCOV）が稼働している必要があります。今回は、最も普及している Xdebug を使った堅牢なセットアップを行います。
ステップ1: Xdebugの有効化と設定
`php.ini` に以下の設定を追加し、コードのカバレッジ情報を収集できるようにします（Xdebug 3の構文を前提としています）。
[xdebug]
; Xdebugのモードを「coverage（カバレッジ計測用）」に設定する
xdebug.mode = coverage
; IDE（PhpStorm）からのデバッグ・プロファイリング要求を受け付ける設定
xdebug.start_with_request = yes
設定後、CLIで `php -v` を実行し、Xdebugが正しくロードされていることを確認してください。
ステップ2: PhpStormとPHPUnitの接続
プロジェクトにPHPUnitが導入されている前提で、PhpStormにPHPUnitの実行環境を教えます。
1. メニューから `Settings` (Windows/Linux) または `Preferences` (macOS) を開きます。
2. [Languages & Frameworks] -> [PHP] -> [Test Frameworks] に移動します。
3. 左上の「＋」ボタンを押し、[Remote Interpreter]（Docker等を使う場合）または [Local Interpreter] を選択します。
4. プロジェクト内の `vendor/autoload.php` と、`vendor/bin/phpunit`（PHPUnitの実行ファイル）のパスを正しく紐付けます。
これで、PhpStormからワンクリックでPHPUnitを操る準備が整いました。
—
3. 実践！HelloWorld的テストコードとカバレッジ計測
百聞は一見にしかず。実際に簡単なクラスとテストコードを書いて、カバレッジを可視化してみましょう。
対象クラスの作成
まずは、ユーザーの年齢に応じて割引率を計算するシンプルなサービスクラス `DiscountCalculator.php` を作成します。
/
public function calculate(int $age): float
{
// 20歳未満は学割適用
if ($age < 20) {
return 0.20;
}
// 60歳以上はシニア割引適用
if ($age >= 60) {
return 0.15;
}
// 一般料金
return 0.0;
}
}
テストコードの作成
次に、このクラスに対するテストコード `DiscountCalculatorTest.php` を書きます。
あえて「シニア割引（60歳以上）」のテストケースを書き忘れた状態にして、カバレッジがどう反応するかを見てみましょう。
calculate(15);
$this->assertEquals(0.20, $result);
}
// 注意：ここではあえて 60歳以上のテストケースを書き忘れています！
}
—
4. ガターを赤く染めろ！カバレッジ付き実行のやり方
準備は整いました。いよいよPhpStormの真骨頂を発揮させます。
実行手順
1. プロジェクトツリーから `DiscountCalculatorTest.php` を右クリックします。
2. コンテキストメニューから [Run ‘DiscountCalculatorTest’ with Coverage]（カバレッジ付きで実行）を選択します。
(※ 捷道キー: `Ctrl + Shift + F10` の代わりに、カバレッジ付き実行のアイコンやショートカットを活用します)
結果の分析（ガターの視覚化）
テストが緑色でパスした（成功した）後、エディタの画面を見てください。`DiscountCalculator.php` の行番号の横（ガター）に、鮮やかな色がついているはずです。
- `if ($age < 20)` の行とその中身 ＝ 緑（テスト通過）
- `if ($age >= 60)` の行とその中身 ＝ 赤（テスト未通過）
> 「ここにテストが足りていない！」
>
> ガターの赤色を見るだけで、開発者は「あ、60歳以上のバリデーションが放置されているな」と直感的に気づくことができます。この「視覚的なプレッシャー」こそが、テストの抜け漏れを防ぐ最強の防壁なのです。
—
5. テストを追加して100%のカバレッジを目指す
赤く染まった箇所を潰すために、先ほどのテストコードに60歳以上のケースを追加しましょう。
public function test_senior_gets_senior_discount(): void
{
$calculator = new DiscountCalculator();
// 60歳以上のケースを追加
$result = $calculator->calculate(65);
$this->assertEquals(0.15, $result);
}
もう一度 [Run with Coverage] を実行します。
どうでしょう？ `DiscountCalculator.php` のすべてのロジック行が美しい緑色に変わり、下部の「Coverage」パネルには Code Coverage: 100% の文字が誇らしく表示されたはずです。
さらに、プロジェクト全体のカバレッジレポート（HTML形式など）をエクスポートすることも可能です。マネージャーやチームメンバーへ「我がプロジェクトの網羅率は85%を維持しています」と、客観的なメトリクスとして提示できるようになります。
—
まとめ：PhpStormのカバレッジは「未来への投資」
今回マスターした PhpStorm × PHPUnit のカバレッジ機能は、単なる「お化粧」ではありません。
- どこがテストされていないかを一目で暴き出し、
- 未テストのコードによるデグレを未然に防ぎ、
- 「動くかどうか分からない恐怖」からあなたを解放する
ための、現代の開発現場に不可欠な羅針盤です。
明日からのコーディングでは、コードを書くだけでなく、ぜひ [Run with Coverage] を日常のルーティンに組み込んでみてください。コードの質が変わるだけでなく、あなたのエンジニアとしての「安心感」が劇的に向上することを約束します。
それでは、快適なPhpStormライフを！