こんにちは！開発現場を渡り歩く中で、幾度となく環境構築やツールのクセに頭を悩ませてきた先輩エンジニアです。
今回は、Web開発の現場で絶大な支持を集める最強のIDE「PhpStorm」をテーマに、「Context Configurations（実行構成）」をプロジェクトごとに美しく使いこなし、開発効率を極限まで引き上げる裏技をお伝えします。
「複数のプロジェクトを並行して進めていたら、実行設定（Run/Debug Configurations）がごちゃ混ぜになって誤爆した…」
「チームメンバーと設定を共有したいのに、自分のローカル環境のパスワードや固有のポート番号まで混ざってしまい、コミットするたびにコンフリクトが起きる…」
そんな絶望を味わったことはありませんか？これをマスターすれば、毎日のコーディングとテストのストレスが劇的に消え去りますよ。さあ、一緒に深掘りしていきましょう！
—
1. なぜPhpStormの「実行構成」で現場のエンジニアは疲弊するのか？
まず、PhpStorm内部で何が起きているのかという「データと挙動の仕組み」を少しだけお話しします。
PhpStormはデフォルトの状態だと、プロジェクトごとの実行設定（「テストを実行する」「内蔵Webサーバーを起動する」「Docker Compose経由でコマンドを叩く」といった設定）を、ユーザーのホームディレクトリ配下にあるグローバルな隠しフォルダや、プロジェクト内の `.idea/` ディレクトリに保存します。
ここで発生するのが以下の2大トラブルです。
1. ローカル環境の汚染: 自分のPCにしかないパス（例: `/Users/hoge/bin/php`）や個人用のデバッグポートが含まれた設定が `.idea/` に入り込み、Gitで管理するとチームメンバーの環境を壊す。
2. コンフリクトの多発: 複数人で同じプロジェクトを触る際、誰かが実行設定を追加・変更するたびに `.idea/runConfigurations/` 内のXMLファイルがコンフリクトを起こす。
これをスマートに解決するのが、「チーム共有用」と「ローカル専用」の実行設定を物理的・論理的に完全に分離するテクニックです。
—
2. 現場の平和を守る！ `.run` フォルダによる実行設定の分離術
PhpStorm（2020.3以降）では、プロジェクトルートに `.run` という専用のディレクトリを作成することで、そこに配置したXMLファイルを自動的に「共有可能な実行構成」として認識してくれます。
さらに、Gitの管理対象にするもの・しないものを明確に分けることで、チーム開発の調和を保ちながら、自分のローカル環境に最適化された裏設定を共存させることができます。
具体的なディレクトリ構造の設計
プロジェクトのルートディレクトリを以下のように構成します。
my-php-project/
├── .idea/ <-- IDE全体の隠し設定（基本はGitから除外を推奨）
├── .run/ <-- 【共有用】チーム全員で使い回す実行設定置き場
│ ├── PHPUnit_All.xml <-- 全体テスト実行（Git管理する）
│ └── PHP_CS_Fixer.xml <-- コーディング規約チェック（Git管理する）
├── .local_runs/ <-- 【ローカル専用】自分だけが使う実行設定（Gitから完全除外）
│ └── My_Local_Debug.xml <-- 個人のXdebug用ポート設定など
├── src/
└── composer.json
---
3. 実践：プロジェクト固有の実行設定を構築する手順
それでは、実際にプロジェクトごとの実行設定を作り、美しく分離する手順をステップ・バイ・ステップで見ていきましょう。
Step 1: チーム共有用の実行設定を `.run` に吐き出す
まずは、全メンバーが共通して使う「PHPUnitのテスト実行構成」を作ります。
1. PhpStormのメニューから [Run] > [Edit Configurations…] を開きます。
2. `+` ボタンを押して [PHPUnit] を選択します。
3. 以下のように設定を流し込みます。
[設定例]
Name: PHPUnit (Core Tests)
Test runner: Defined in configuration file (phpunit.xml.dist)
Use alternative CLI interpreter: (Dockerなどの共通インターフェースを指定)
4. ここが最大のポイントです！
設定画面の右上あたりにある 「Store as project file」 のチェックボックスを有効にし、保存先をプロジェクトルートの `.run/` ディレクトリを指定します。
これで、プロジェクト直下に `.run/PHPUnit_Core_Tests.xml` が生成されます。このファイルの中身を覗いてみましょう。
このXMLファイルは極めてクリーンです。個人のローカル環境に依存するパスが含まれていないため、そのままGitにコミットしてチームメイトと共有できます。
—
Step 2: ローカル専用の設定を隔離する（裏技）
次に、「自分だけが使うデバッグ設定や、ローカルの特定コンテナにアタッチする設定」を作ります。これらは他の人に共有してはいけません。
しかし、PhpStormのデフォルトでは、すべての設定がプロジェクト内の `.idea` や `.run` に保存されがちです。ここで裏技を使います。
1. 通常通り、自分用の実行設定（例: `Local Xdebug Session`）を作成します。
2. 保存先を `.idea/runConfigurations/` ではなく、あえて自分で掘った専用フォルダ（例: プロジェクト外、または `.gitignore` に指定した `.local_runs/`）に手動で配置するか、PhpStormの設定で共有対象外にします。
3. そして、プロジェクトの `.gitignore` に以下の記述を追加します。
.ideaの中身は基本的に共有しない（個人設定の混入を防ぐ）
.idea/
ただし、どうしても共有したいチーム用設定があれば .run/ のみ許可する
!.idea/runConfigurations/
.run/
!.run/PHPUnit_Core_Tests.xml # 特定のものだけ許可するアプローチも可能
完全なローカル専用フォルダはGitの管理外へ
.local_runs/
これにより、チームメンバーが `git pull` した際に、あなたのローカル環境固有のデバッグ設定が混入してエラーを引き起こす事故を100%防ぐことができます。
—
4. 実行構成を別プロジェクトへ「秒速」で移植するコツ
「さっき別のプロジェクトで作った抜群に使いやすいDocker連携の実行設定を、今回の新しいプロジェクトでも使い回したい！」
そんな場面、よくありますよねいちいち手動で再設定するのはエンジニアの時間の無駄です。
移植のスマートな手順
1. 移植元のプロジェクトにある `.run/` フォルダ（または `.idea/runConfigurations/`）を開きます。
2. 使いたい設定のXMLファイルをコピーします。
3. 移植先の新しいプロジェクトのルートに `.run/` フォルダを作り、そこにファイルをペーストします。
4. PhpStorm上でプロジェクトをリロード（あるいは数秒待つ）、またはメニューの [File] > [Reload All from Disk] を実行します。
たったこれだけで、新しいプロジェクトの実行メニュー（画面右上の再生ボタン横）に、瞬時にその設定がポップアップします。設定の中身のパス（`$PROJECT_DIR$` 変数など）はPhpStormが賢く相対パスとして解釈して換算してくれるため、プロジェクトが変わってもそのまま動きます。
—
5. 動作確認：すべてが噛み合った瞬間を体感する
設定が正しく機能しているか、簡単な動作確認（HelloWorld的なテスト）を行いましょう。
1. プロジェクト内にテストファイル（例: `tests/SampleTest.php`）を配置します。
assertEquals(“PhpStorm Context Configurations is working!”, $message);
}
}
2. 画面右上の実行構成ドロップダウンから、先ほど作成した共有設定 「PHPUnit (Core Tests)」 を選択します。
3. そのまま緑色の再生ボタン（Run）または虫のアイコン（Debug）をクリックします。
下部の「Run」ツールウィンドウにテスト結果が緑色で美しく表示されれば成功です！
Testing started at 12:00:00 …
PHPUnit 9.5.0 by Sebastian Bergmann and contributors.
Runtime: PHP 8.2.0
Configuration: /path/to/my-php-project/phpunit.xml.dist
. 1 / 1 (100%)
Time: 00.01 seconds, Memory: 6.00 MB
OK (1 test, 1 assertion)
この瞬間、あなたの開発環境は、チーム全体の協調性と個人のカスタマイズ性が完璧に調和した、極めて洗練されたアーキテクチャへと進化しています。
—
おわりに
今回はPhpStormの「Context Configurations（実行構成）」の裏側と、プロジェクト間での共有・分離のテクニックを徹底解説しました。
こうした細かなIDEの設計思想を理解し、コントロールできるようになると、毎日のコーディング開始時の「環境差異によるイライラ」が嘘のように消え去ります。浮いた集中力と時間は、もっとクリエイティブなコードを書くために使いましょう。
あなたのPHPライフが、今日からさらに快適で素晴らしいものになりますように！