スコープとファイルの色

スコープは、プロジェクトのファイルやフォルダーの命名セットです。スコープを使用すると、異なる IDE ビューでプロジェクト項目を視覚的に区別し、特定の操作の範囲を制限できます。

スコープを使用すると、ファイルを論理的に整理できます。たとえば、テストソースをテストスコープに配置し、本番環境のコードを本番環境スコープに配置することができます。これにより、大きなプロジェクトを扱う作業が容易になります。インスペクションをテストのみで実行すると、コードベース全体で実行するよりも高速になります。

PhpStorm には事前定義されたスコープのセットが用意されていますが、独自のスコープも作成できます。カスタムスコープには、たとえば担当しているプロジェクトの一部分だけなど、任意のファイルセットを含めることができます。

PhpStorm では、スコープはさまざまな機能、たとえばコードインスペクション、一部のリファクタリング、検索、コピーライト設定、各種コード解析機能などで使用されます。

PhpStorm にはローカルスコープと共有スコープの二種類があります。

ローカルスコープは IDE 構成ディレクトリに格納されているため、VCS を通じて共有されず、チームの他のメンバーは使用できません。
共有スコープは VCS に追加されるため、プロジェクトで作業する人々が同じスコープを利用できます。これらのスコープは、プロジェクトと一緒に .idea 配下の scopes フォルダーに保存されます。各スコープは、 .xml 拡張子を持つファイルとして保存されます（例: MyProject/.idea/scopes/shared-scope.xml ）。

プロジェクトがバージョン管理されている場合は、共有スコープの利用が有効です。 VCS を使用しない場合は、ローカルスコープで十分です。

新しいスコープを定義する

PhpStorm には事前定義されたスコープのセットがありますが、独自のスコープを定義することもできます。

Ctrl+Alt+S を押して設定を開き、外観 & 振る舞い | スコープを選択します。
「スコープの追加」ボタン () をクリックし、定義するスコープの種類 (ローカルまたは共有) を選択します。
後で VCS で共有するチェックボックスを使用して、選択したスコープの状態（ローカルまたは共有）を変更できます。
開いたダイアログで、新しいスコープに名前を付け、 OK をクリックします。
新しいスコープにファイルを追加します。プロジェクトツリーで必要な項目を選択し、ツリーの右側にあるいずれかのオプションをクリックします：
- 含める: 選択したアイテムを含めます。フォルダーを含める場合、このアクションはこのフォルダー内にあるファイルのみを追加します。ネストされたすべてのサブフォルダーとその内容は含まれません。
- 再帰的に含める: ネストされたサブフォルダーとその内容とともに、選択したフォルダーを含めます。
- 除外: 選択したアイテムをスコープから除外します。フォルダーを除外する場合、このアクションはこのフォルダー内にあるファイルのみを削除します。ネストされたすべてのサブフォルダーとその内容はスコープに残ります。
- 再帰的に除外する: 選択したフォルダーをネストされたサブフォルダーとその内容と共に除外します。
スコープにファイルを追加すると、PhpStorm が式を作成し、それをパターンフィールドに表示します。
ボタンを使う代わりに、パターンフィールドにスコープ言語構文リファレンスを参考にしてパターンを手動で入力することもできます。
変更を適用して、ダイアログを閉じます。

選択したスコープで表示されるファイルやフォルダーは、含まれているものと含まれていないものを判別しやすいように異なる色で表示されます：

スコープに含まれるファイルとフォルダー。
除外されたファイルとフォルダーと包含されたファイルとフォルダーの両方を含むフォルダー。
選択した範囲から除外されるファイルとフォルダー。

カスタムスコープを作成すると、プロジェクトツールウィンドウと、アクションを適用するファイルの数を制限できるすべてのダイアログでそのスコープを見つけることができます。

定義済みスコープ

PhpStorm には事前定義されたスコープのセットが用意されています。 IDE は、ファイルに関する情報に基づいて、これらのスコープにファイルを自動的に追加します。これらのスコープは変更できないことに注意してください。

定義済みスコープのリスト

プロジェクトファイル: プロジェクトのコンテンツルート内のすべてのファイルが含まれます。詳細については、ディレクトリ構造を参照してください。ライブラリおよびフレームワークはこの範囲に含まれません。
問題: 構文エラーのあるプロジェクトコンテンツルート内のファイルが含まれます。
すべての変更ファイル: 最近変更されたすべてのファイルが含まれます。
すべての変更ファイル: エディターで開いたり変更した最後の 50 個のファイルが含まれます。最近のファイルの数を変更するには、 Ctrl+Alt+S を押して設定を開き、拡張設定を選択して、最近使用したファイルの最大数フィールドを検索し、希望する数を指定します。
Git によって追跡されるプロジェクトファイル: Git でバージョン管理されているすべてのプロジェクトファイルが含まれます。
Git-Ignored を除くプロジェクトファイル: .gitignore で指定されたファイルを除き、Git でバージョン管理されているファイルとバージョン管理されていないファイルの両方を含むすべてのプロジェクトファイルが含まれます。
テスト: このスコープはプロジェクトのテストソースルートに限定されます。
開いているファイル: 現在エディターで開いているファイルが含まれます。
ローカルの変更 (これらのスコープは、 VCS 統合が有効になっているの場合に表示されます)
- すべての変更ファイル: すべての変更リストから VCS にまだ追加されていない変更を含む変更されたファイルが含まれます。
- デフォルト変更リスト: デフォルト変更リストから VCS にまだ追加されていない変更を含む変更されたファイルが含まれます。
- 「変更リスト名」: 特定のカスタム変更リストから VCS にまだ追加されていない変更が加えられた変更済みファイルが含まれます。

スコープを色に関連付ける

異なるスコープに属するファイルは、検索結果、エディタータブ、プロジェクトツールウィンドウ (Alt+1) で異なる色でハイライトできます。

各スコープに、独自の色を割り当てることができます。例: 開いているファイルスコープに色を割り当て、プロジェクトツールウィンドウにこの色を表示するように IDE を構成できます。この場合、エディターで現在作業しているファイルは、プロジェクトツリーで色分けされます。これにより、プロジェクトのナビゲーションがより速く、簡単になります。ファイルの色はスコープに関連してのみ機能することに注意してください。

スコープと同様に、色の関連付けはローカルで共有できます。

ローカル色はあなただけに表示され、VCS を通じて共有されません。
共有色はバージョン管理下に置かれるため、プロジェクトで作業する人々が同じ色の関連付けを利用できます。これらは、 fileColors.xml ファイルの .idea にあるプロジェクトフォルダー内に保存されます（例: Myプロジェクト /.idea/fileColors.xml ）。

新しい色の関連付けを作成する

Ctrl+Alt+S を押して設定を開き、外観 & 振る舞い | ファイルカラーを選択します。
ファイルカラーを有効化するのチェックボックスが選択されていることを確認してから、色を使用する場所を選択します：エディタータブで使用するまたはプロジェクトビューで使用するを選択します。
プロジェクトビューで使用するチェックボックスを選択すると、プロジェクトツールウィンドウ (Alt+1) と検索結果 (たとえば、複数ファイル内検索ダイアログ Ctrl+Shift+F) に色が表示されます。
追加ボタン () をクリックし、色を設定するスコープを選択します。
事前定義されたスコープの 1 つを選択するか、カスタムスコープを使用できます。
必要なスコープの横にある矢印をクリックし、開いたリストから色を選択します。
独自の色を構成するには、カスタムをクリックします。
色を編集するには、色列で必要なスコープに対応するセルをクリックし、リストから新しい色を選択します。
VCS を介して色を共有するには、 VCS で共有する列の対応する行のチェックボックスを選択します。チェックボックスがオフの場合、色はローカルで使用されます。
変更を適用して、ダイアログを閉じます。

ファイルが複数のスコープに含まれている場合、スコープの順序が重要になります。PhpStorm はローカルスコープから順に上から下へ処理します。つまり、IDE は該当ファイルにはリスト内で最後にあるスコープの色を適用します。

PhpStorm で色の関連付けを別の順序で処理したい場合は、スコープの順序を変更できます。

スコープの順序を変更する

Ctrl+Alt+S を押して設定を開き、外観 & 振る舞い | スコープを選択します。
移動するスコープを選択し、上へ移動 () または下へ移動 () ボタンをクリックします。または、 Alt+Up または Alt+Down を押してください。
変更を適用して、ダイアログを閉じます。

スコープ言語構文リファレンス

説明	パターン	サンプル
名前で単一のファイルを含める	`file:<directory>/<file>`	`file:databases/create_schema.sql`
サブディレクトリなしで、ディレクトリ内のすべてのファイルのセットを含める	`file:<directory>/*`	`file:databases/mysql-db/*`
サブディレクトリを持つディレクトリにすべてのファイルのセットを含める	`file:<directory>//*`	`file:databases/mysql-db//*`
特定のプロジェクトからの名前でファイルを含める	`file[project_name]:<directory>/<file>`	`file[default]:databases/create_schema.sql`
使用可能な論理演算子：&&（AND）、\|\|（OR）、!（NOT）。	`file[project_name]:<directory>&&!file:<directory>`	`file[default]:databases/*&&!file:databases/create_schema.sql`

サンプル

file:*.php||file:*.twig: すべての PHP と Twig ファイルを含みます。
file:*php&&!file:*test*.php: 名前に文字列 test を含むものを除くすべての PHP ファイルを含めます。
file:www/wp-content/themes/my-site-child//*.php||file:www/wp-content/themes/my-site-child//*.css||file:www/wp-content/themes/my-site-child//*.js||file:www/wp-content/plugins/my-site//*.php||file:www/wp-content/plugins/my-site//*.css||file:www/wp-content/plugins/my-site//*.js: WordPress Web サイトのテーマとプラグインからのすべての .PHP、.CSS、.JS ファイルを含めます。
file:*.js||file:*.coffee: すべての JavaScript と CoffeeScript ファイルを含みます。
file:*js&&!file:*.min.*: 最小化によって生成されたものを除くすべての JavaScript ファイルを、 min 拡張機能で識別して含めます。

スコープのユースケース

次の例は、日常業務でスコープを使用する方法を示しています：

特定のファイルグループのみをインスペクトします。
スコープを使うことで、コードベースの特定部分をインスペクトできます。たとえば、本番コードとテストコードを分けてインスペクトできます。さらに、最近変更されたファイルに異なるインスペクション設定を適用して、新しい変更部分がより厳密にチェックされるようにできます。
詳細についてはインスペクションを実行するを参照してください。
検索と置換の結果を制限します。
スコープは複数ファイル内検索機能や複数ファイル内置換機能と組み合わせることで、無関係な結果を減らし、リファクタリングの速度を向上させられます。
詳細についてはプロジェクト内ターゲットの検索を参照してください。
ナビゲーションにスコープを利用します。
プロジェクトツールウィンドウで、スコープによりナビゲーションも簡略化できます。必要なスコープを選択すれば、今必要な項目だけを含んだ簡易ツリーを作成できます。
詳細についてはプロジェクトツールウィンドウを参照してください。
特定のファイルのみを整形します。
スコープを使うことで、現在のファイルやコードベース全体だけでなく、特定のファイルを整形できます。たとえば、コードを変更した後、最近変更されたファイルを整形してコードスタイルの要件に適合させられます。
詳細についてはコードの整形を参照してください。
異なるファイルセットごとに異なるコピーライト通知を設定できます。
これは、プロジェクト内のファイルの著作権者が異なる場合や、サードパーティ・オープンソースプロジェクト由来のファイルで元のコピーライトを維持したい場合など、様々な状況で役立ちます。
詳細についてはコピーライトを参照してください。

2026 年 8 月 5 日