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

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

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

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

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

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

プロジェクトでバージョン管理を有効にすると、PhpStorm は他の開発者の設定との競合を避けるために、個人設定を含む workspace.xml ファイルを .gitignore リストに自動的に移動します。

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

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

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

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

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

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

PhpStorm は、異なる IDE インスタンス間で設定を共有するいくつかの方法も提供します。詳細は、 Karma を参照してください。

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

2026 年 11 月 9 日

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