プロジェクトの作成と管理

PhpStorm での操作はすべてプロジェクトのコンテキスト内で行われます。プロジェクトは、完全なソフトウェアソリューションを表す組織単位です。これは、コーディング支援、一括リファクタリング、コーディングスタイルの一貫性などの基盤として機能します。

PhpStorm のプロジェクトはディレクトリベースフォーマットで表現されます。ルートプロジェクトディレクトリには、 .idea ディレクトリと次のファイルが含まれています。

プロジェクト構造を記述する .iml ファイル。
ワークスペース設定を含む workspace.xml ファイル。
多数の xml ファイル。各 xml ファイルは、 projectCodeStyle.xml 、 encodings.xml 、 vcs.xml という名前で認識できる、独自の設定セットを担当します。
たとえば、新しい実行 / デバッグ構成を追加してエンコーディングを変更すると、2 つの異なる xml ファイルに影響します。これにより、プロジェクト設定がバージョン管理システムに格納され、異なるチームメンバーによって変更されたときのマージの競合を回避できます。

.idea ディレクトリは、プロジェクトツールウィンドウ Alt+1 のプロジェクトビューには表示されません。

プロジェクト設定は、プロジェクトディレクトリ内の .idea フォルダー配下の XML ファイルセットに保存されます。このフォルダーには、バージョン管理下に置かないユーザー固有の設定と、コードスタイル設定など、チームで作業する開発者間で通常共有されるプロジェクト設定の両方が含まれます。

プロジェクトでバージョン管理を有効化すると、PhpStorm は個人設定の入った workspace.xml ファイルを、他の開発者の設定と競合しないよう .gitignore リストに自動で移動します。

設定ファイルは選択に応じて処理されます。プロジェクト設定を変更して新しい設定ファイルが作成されると、IDE は画面の下部にこのプロジェクトの設定ファイルの扱い方を選択するように促す通知を表示します。

ファイルを表示: 作成された設定ファイルのリストを確認し、バージョン管理下に置くファイルを選択します。その後、選択したファイルが VCS に追加されるようスケジュールされます。
常に追加: VCS に追加するために .idea ディレクトリに作成されたすべての設定ファイルをサイレントにスケジュールします（現在のプロジェクトにのみ適用されます）。
今後このメッセージを表示しない：構成ファイルを VCS への追加対象にしないよう常にスケジューリングしません。手動で VCS に追加するまで、バージョン管理されていないステータスになります（現在のプロジェクトにのみ適用されます）。

オプションを選択せずに通知を閉じると、新しい設定ファイルが作成された後に再び表示されます。 IDE を再起動しても、新しいファイルはオプションの 1 つを選択するまでそこにあるリストにも移動します。

PhpStorm は構成ファイルを識別し、自動的に無視するファイルリストに追加します。ただし、プロジェクトを手動で共有している場合は、これらのファイルとフォルダーをバージョン管理下に置かないことをお勧めします。

グローバル (IDE) 設定はプロジェクトとは別に保存されます。このため、これらの設定はバージョン管理を通じてプロジェクトとともに共有されません。

ただし、一部の設定はプロジェクトレベルにコピーできます。例: またはインスペクションプロファイルのコピーを作成できます。これを行うと、IDE は対応する構成ファイルを .idea ディレクトリに作成し、VCS を介してプロジェクトと共有できるようにします。

PhpStorm では、異なる IDE インスタンス間で設定を共有するためのいくつかの方法も提供されています。詳細は IDE 設定のバックアップと同期を参照してください。

PhpStorm でフォルダーを開くと、 .idea サブフォルダーが追加されます。ここに PhpStorm の内部構成設定（プロジェクトのコードスタイルやバージョン管理システムなど）が保存されます。

2026 年 5 月 22 日

VCS を介してプロジェクト設定を共有する