こんにちは！チーム開発で「あれ？ローカルだと動くのに、本番や他の人の環境だとフォーマットが崩れる…」「Gitの差分に変な個人設定が混ざる…」なんて悩んだ経験はありませんか？
今回は、世界最高峰のPHP統合開発環境「PhpStorm」を使いこなし、チーム開発の生産性を爆発的に向上させるための極意をお伝えします。
テーマは、PhpStormがプロジェクト直下に自動生成する `.idea` ディレクトリのGit管理戦略 です。
「全部Gitに入れたらいいの？それとも全部無視（`.gitignore`）すべき？」
この永遠の問いに、今日で終止符を打ちましょう。これをマスターすれば、明日からチーム全員のコーディング環境が完全に同期され、無駄なコンフリクトや設定ミスに悩まされる日々から解放されますよ。
—
1. PhpStormとは？そしてなぜ `.idea` が重要なのか
PhpStormは、ただのテキストエディタではありません。PHPのコード構造を深く解析し、型推論やリファクタリング、データベース接続、テスト実行までをシームレスに行える「インテリジェントな開発プラットフォーム」です。
プロジェクトをPhpStormで開くと、必ず `.idea` という隠しディレクトリが作られます。ここには以下のような情報が詰まっています。
- コードの整形ルール（PSR-12に準拠させるか等）
- 静的解析（Inspections）のルール
- デバッグ（Xdebug）の設定
- 個人のウィンドウ配置やカーソル位置
ここで大きな問題が生じます。
「チームで共有すべきプロジェクトの設定」と、「開発者個人の好みに依存する設定」が、この `.idea` の中に混ざって存在しているのです。
これを適当に管理していると、「誰かが設定ファイルを上書きしてしまい、全員のコードスタイルが勝手に変わる」といった悲劇が起きます。だからこそ、「どれを共有し、どれをローカルに留めるか」の明確な分離戦略が必要なのです。
—
2. 基礎セットアップ：チーム開発の土台を作る
まずは、プロジェクトの初期セットアップとして、PhpStormが正しくチーム共有用の設定ファイルを生成できるようにするための第一歩を踏み出しましょう。
PhpStormでは、デフォルトで多くの設定が `.idea` 内のXMLファイルとして保存されます。プロジェクトを新しく作成したら、まずはGitのバージョン管理対象にする前に、適切なファイル構造を理解することが重要です。
共有すべき「正義」の設定たち
チーム全員で強制的に統一すべきなのは以下の要素です。
1. Code Style（コードスタイル）: インデントの幅、改行の位置など
2. Inspections（コード解析ルール）: 未使用変数やバグの予兆を検知するルール
3. Project Scopes / Dictionary: 共同で使う単語辞書や検索範囲
これらは `.idea/codeStyles/` や `.idea/inspectionProfiles/` ディレクトリに保存されます。これらは必ずGit管理に含めるべきです。
—
3. 黄金の `.gitignore` 設定：共有と分離の境界線
それでは、実務でそのまま使える、極上の `.gitignore` 設定を公開します。
プロジェクトのルートディレクトリにある `.gitignore` に、以下の設定を追加してください。
==========================================
ティック・トック：PhpStorm .idea ディレクトリ分離戦略
==========================================
1. まず、.ideaディレクトリ全体を一旦Gitの追跡から除外します
.idea/
2. ただし、チーム全員で共有すべき重要設定ファイルは「強制追跡（例外許可）」します
!.idea/codeStyles/
!.idea/codeStyles/project.xml
!.idea/inspectionProfiles/
!.idea/inspectionProfiles/Project_Default.xml
!.idea/modules.xml
!.idea/php.xml
!.idea/php-test-framework.xml
!.idea/workspace.xml のような個人用ファイルは絶対に除外！
なぜこの設定が神がかっているのか？
個人のローカル環境に依存する以下のファイルは、絶対にGitに入れない（上の設定で弾かれる）ようにしています。
- `workspace.xml`: 最後に開いていたファイル、カーソル位置、タブの状態、実行履歴など（人によって変わり、コンフリクトの元凶になる）
- `usage.statistics.xml`: 使用統計データ
- `shelf/`: 一時的な変更退避（シェルフ）のデータ
逆に、`php.xml` や `php-test-framework.xml` は、プロジェクトのPHPバージョン（例: PHP 8.2）やPHPUnitのパスなどをチームで統一するためにあえて共有するのが、プロの現場の鉄則です。
—
4. 精度高い「動作確認」：設定が正しくチーム共有されているかテストする
設定ファイルを書いたら、それが正しく機能しているかを検証（HelloWorld的な動作確認）しましょう。
手順1: コードスタイルの共有を確認する
1. PhpStormの Settings (Windows) / Preferences (macOS) を開きます。
2. `Editor` > `Code Style` > `PHP` を選択します。
3. 「Scheme」のプルダウンで 「Project」 が選択されていることを確認します。ここで設定したインデントや布石ルールが、`.idea/codeStyles/project.xml` に書き込まれます。
4. 試しに適当なPHPファイルを開き、意図的に汚いインデントでコードを書きます。
実行ログのイメージ:
On branch main
Changes to be committed:
(use “git restore –staged
new file: .gitignore
new file: .idea/codeStyles/project.xml
new file: .idea/inspectionProfiles/Project_Default.xml
new file: .idea/php.xml
このように、個人用の `workspace.xml` が綺麗に除外され、純粋なプロジェクト設定のみがGitの管理下に入っていることが、プロフェッショナルなリポジトリの証です。
—
5. 先輩エンジニアからのアドバイス：チームに導入する際の声かけ
この設定をチームに導入する際は、メンバー全員に以下の手順を共有してください。
1. リポジトリをクローンする。
2. PhpStormでプロジェクトを開く。
3. `Settings > Editor > Code Style` で、スキームが「Project」になっていることを確認する。
これだけで、新しく参画したジュニアエンジニアであっても、ベテランと同じ最高峰のコーディング規約・静的解析の恩恵を初日から受けることができます。「コードレビューでインデントの指摘をする」という不毛な時間が一切消え去り、本質的なロジックのレビューに集中できるようになりますよ。
これをマスターすれば、毎日のコーディングが劇的に楽になります。ぜひ、今日のプロジェクトから導入してみてくださいね！