プロフェッショナルがPhpStormの「Context Configurations」で実現する、マルチプロジェクトの完全分離と高速化
こんにちは。大規模Webアプリケーションからモダンなマイクロサービス群まで、日夜コードベースの海を泳ぎ回る開発チームのテックリードの皆さん。
ふと気づけば、あなたのPhpStormにはこんなカオスが広がっていないだろうか？
「Laravel Sailのコンテナに入るためのRun Configuration」と「ローカルのMAMP/Valet環境用のPHPUnit」、さらには「AWS ECSにデプロイするためのAWS CLIラッパー」が1つのドロップダウンメニューにごちゃ混ぜになり、スクロールしなければ目的のタスクに辿り着かない。別プロジェクトを開けば、データベースの接続先やPHPのインタープリターパスが前回のプロジェクトの残骸を引きずってエラーを吐く――。
単一のIDEインスタンスやグローバル設定に依存した開発スタイルは、プロジェクト間を往復する現代のエンジニアにとって「開発スピードを削ぎ落とす最大のボトルネック」だ。
今回は、JetBrains製IDEの真骨頂である「実行構成（Run Configurations）」の深層を暴き、プロジェクトごとのコンテキストを完全に分離・共有化し、チーム全体の開発体験（DX）を極限まで引き上げるアーキテクト流の裏技を伝授する。
—
1. 内部構造の理解：PhpStormが「コンテキスト」を管理するメカニズム
なぜ、プロジェクトごとに実行環境が混ざり合うのか？ それはデフォルトのPhpStormが、プロジェクト固有の設定を `.idea/` ディレクトリ配下に隠蔽し、かつそれらの多くをバージョン管理（Git）から除外する（あるいは逆にすべてを巻き込んでチームメンバーのローカルパスを破壊する）という二者択一の罠に陥りやすいためだ。
PhpStormの実行設定（Run/Debug Configurations）は、内部的にはXMLファイルとしてシリアライズされている。これらはかつて `.idea/workspace.xml` という単一の巨大なゴミ箱ファイルにすべて書き込まれていた。そのため、チームメンバーの一人がちょっとしたリモートデバッグ設定を追加しただけで、Gitのコンフリクトが起きるか、あるいは他人のワークスペース環境を破壊するという悪夢が起きていた。
これを根本から解決するのが、「.runフォルダーによる実行構成のモジュール化（共有化）」と「ローカル専用設定の完全分離」である。
—
2. 実行構成を「共有用」と「ローカル用」に完全に分離する戦略
チーム全体で共有すべきインフラストラクチャの実行タスク（例：テストスイートの実行、静的解析、Docker Composeの起動）と、個人のローカル環境に依存する設定（例：特定のポートフォワード、Xdebugの個別ポート、ローカルのデバッグ用スクリプト）は、配置場所を変えることで完全に共存させられる。
実践：`.run` フォルダーの活用
PhpStorm 2020.1以降、`.idea/workspace.xml` の呪縛から逃れ、プロジェクトルート直下に `.run/` ディレクトリを作成して、個別のXMLとして実行構成を管理できるようになった。
ここに配置されたファイルはGitの管理下に置くことができ、チームメンバー全員で「同一のテスト実行コマンド」をワンクリックで共有できる。
共有用設定のベストプラクティス（`.run/PHPUnit_Feature_Tests.xml`）
次のXMLをプロジェクトルートの `.run/` ディレクトリ内に配置してほしい。これにより、チーム全員が同じコンテナ環境、同じ引数で機能テストを即座に実行できるようになる。
ローカル専用設定の隠蔽
一方、開発者個人のマシンに依存する設定（例えば、M1/M2 MacのネイティブPHPパスや、個人用デバッグポート）は、`.idea/workspace.xml` に自動保存されるか、あるいは `.gitignore` に `.run/local_` を指定してローカル専用のXMLとして退避させる。
これにより、「共有すべき抽象化されたタスク」と「ローカル固有の具象的なパス」が完璧に分離され、Gitコンフリクトのストレスから解放される。
—
3. 開発スピードを異次元に高める「隠れたショートカット」とナビゲーション
コンテキストを分離したら、それを極限の速度で呼び出す必要がある。マウスでドロップダウンメニューをクリックしているようでは、一流のエンジニアとは言えない。
1. 実行構成の高速ランチャー（`Control + Option + R` / `Shift + Alt + F10`）
- ショートカット: Mac: `Control + Option + R` / Win/Linux: `Shift + Alt + F10`
- プロの技: このショートカットを押すと、プロジェクト内のすべての実行構成（`.run` 配下含む）がポップアップする。名前のインクリメンタルサーチが効くため、「test」と打つだけでFeature TestやUnit Testに即座にジャンプし、Enterで実行できる。マウスは一切不要。
2. 直前に実行したコンテキストの再実行（`Control + R` / `Shift + F10`）
- ショートカット: Mac: `Control + R` / Win/Linux: `Shift + F10`
- プロの技: コードを修正し、即座に直前のテストやスクリプトを再実行する。TDD（テスト駆動開発）において、指をホームポジションから動かさずにフィードバックループを回すための必須キーストローク。
3. 「どこでも検索」でコンテキストの定義ファイルを直撃（`Double Shift`）
- ショートカット: `Shift` を2回連続打鍵
- プロの技: 実行構成のXMLファイルを直接修正したい時、プロジェクトツリーから `.run/` を探す必要はない。『Double Shift』で設定名（例：`PHPUnit`）を入力すれば、該当のXMLファイルや設定画面へダイレクトにアクセスできる。
—
4. チーム全体の生産性を底上げする「神プラグイン」
PhpStormのデフォルト機能だけでも強力だが、マルチプロジェクト環境におけるコンテキスト管理をさらに自動化・効率化するため、以下のプラグインの導入を強く推奨する。
1. `.envfiles`
- 概要: プロジェクトや実行構成ごとに異なる環境変数ファイル（`.env.testing`, `.env.staging` など）をシームレスに切り替えて実行するためのプラグイン。
- なぜ必要か: コンテキスト（実行設定）ごとに「どの `.env` を読み込ませるか」を明示的に紐づけられるため、ローカル開発中に誤って本番・ステージング用の環境変数を読み込んでデータを破壊する事故を根絶できる。
2. Rainbow Brackets
- 概要: 複雑な設定ファイル（XML, JSON, YAML）のネストを色分けして視覚化するプラグイン。
- なぜ必要か: 大規模な `workspace.xml` やDocker Compose、Kubernetesのマニフェスト、PhpStormの複雑なデバッグ設定ファイルを直接編集する際、構文ミスの発見スピードが劇的に向上する。
—
5. 【実務直結】マルチプロジェクト運用を支える設定テンプレート構成例
複数のマイクロサービスや、バックエンド（Laravel/Symfony）とフロントエンド（Next.js）が混在するモノレポ/マルチポロジェクト環境において、PhpStorm内で環境を綺麗に切り分けるためのディレクトリ構造とファイル配置のベストプラクティスを提示する。
my-enterprise-project/
├── .idea/ # IDE固有設定（workspace.xmlなどは原則Git除外）
├── .run/ # ★ここにチーム共有の実行構成を集約する
│ ├── Backend_PHPUnit.xml # バックエンドのテスト実行構成
│ ├── Frontend_Jest.xml # フロントエンドの単体テスト実行構成
│ └── Docker_Up.xml # インフラ全体起動スクリプト
├── backend/ # PHP / Laravel アプリケーション
│ └── phpunit.xml
├── frontend/ # TypeScript / Next.js アプリケーション
│ └── package.json
└── docker-compose.yml
チーム共有用：インフラ一括起動の実行構成（`.run/Docker_Up.xml`）
複数のDocker Composeサービスを、PhpStormのUIからワンクリックで、かつ適切な環境変数セットで起動するためのXML設定の模範解答だ。
これを `.run/` に入れておくだけで、新しくプロジェクトに参加したメンバーがリポジトリをクローンしてPhpStormで開いた瞬間から、一切の手間なしで「Dockerを立ち上げるボタン」が画面右上に出現する。これがプロのチーム開発環境構築だ。
—
6. まとめ：環境構築のコストを「ゼロ」に近づけ、コードに集中せよ
開発環境の整備は、エンジニアリングの「付加価値」ではなく「インフラ」である。
新しいプロジェクトに参加するたびに「PHPのパスが通らない」「テストが走らない」「誰かのローカル設定とコンフリクトした」と嘆く時間は、ビジネスにとって1円の利益も生まない無駄なコストでしかない。
PhpStormの `.run` フォルダーを活用した「Context Configurationsのモジュール化と共有」をチームのスタンダードとして導入し、プロジェクト固有の環境差異をコード（設定ファイル）としてGitでバージョン管理せよ。
あなたのチームの開発スピードは、今日から見違えるほど加速するはずだ。