スコープとファイルの色

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

スコープは、プロジェクト内のファイルを論理的に編成するように設計されています。テストソースはテスト関連のスコープに移動でき、製品コードは製品ファイルのスコープに関連付けることができます。これらの論理チャンクにより、プロジェクトの管理が容易になります。例: テスト関連のインスペクションをテストクラスでのみ実行すると、アプリケーション内のすべてのファイルで実行する場合よりも時間がかかりません。

PhpStorm には一連の定義済みスコープが付属していますが、カスタムスコープを作成することもできます。そこで、任意のファイルとフォルダーを含めることができます。例: カスタムスコープに含めることができるのは、自分が担当するプロジェクト内のファイルのみです。

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

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

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

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

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

PhpStorm には一連の定義済みスコープがありますが、独自のスコープを定義することもできます。

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

選択した範囲で表示されるファイルとフォルダーは、含まれているものと含まれていないものを理解するのに役立つように、さまざまな色で表示されます。

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

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

The new scope shown in the Project tool window

定義済みのスコープ

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

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

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

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

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

Scope highlighting in the editor tabs and search results

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

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

ローカル色はあなただけに表示され、VCS を通じて共有されません。
共有色はバージョン管理下に置かれるため、プロジェクトで作業する人々は同じ色の関連付けを使用できます。これらは、fileColors.xml ファイルの .idea のプロジェクトフォルダーに格納されます（例: MyProject/.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.* : min 拡張子で示される最小化によって生成されたものを除くすべての JavaScript ファイルを含めます。

最終更新日: 2025 年 2 月 18 日

関連ページ：

IDE で使用されるディレクトリ

デフォルトでは、PhpStorm は、各 IDE インスタンスのユーザー固有のファイル（構成、キャッシュ、プラグイン、ログなど）をユーザーのホームディレクトリに保存します。ただし、必要に応じて、これらのファイルを保存する場所を変更できます。IDE ディレクトリの場所を変更するたとえば、ユーザープロファイルドライブの容量が不足している場合や低速ディスクにある場合、ホームディレクトリが暗号化されている（IDE の速度が低下している）場合、またはネットワークドライブにある場合は、デフォルトの IDE...

ディレクトリ構造

PhpStorm は、プロジェクトディレクトリ構造内のさまざまなフォルダータイプを区別できます。フォルダータイプによって、PhpStorm がフォルダーの内容を処理する方法が決まります。たとえば、ソースフォルダーは名前空間の自動補完のルートとして使用され、除外フォルダーはインデックス作成から除外されます。IDE は、ファイルの内容に基づいて、PHP プロジェクト内のフォルダーに自動的にタイプをマークします。設定 () | ディレクトリまたはプロジェクトからツールウィンドウで手動でマークすることもでき...

バージョン管理統合サポート

PhpStorm は 2 つのレベルでバージョン管理統合をサポートします。IDE レベルでは、VCS 統合は、デフォルトで有効になっているバンドルされたプラグインのセットを通じて提供されます。プロジェクトレベルでは、プロジェクトフォルダーを 1 つまたは複数のバージョン管理システムと関連付けることで、VCS 統合が有効になります。プロジェクトルートをバージョン管理システムに関連付ける：PhpStorm を使用すると、プロジェクトとバージョン管理システムの統合を迅速に有効にし、それをプロジェクト...

JavaScript の最小化

縮小または圧縮とは、ソースコードの機能を変更せずに、スペース、新しい行、コメントなどの不要な文字をすべて削除することを意味します。開発およびデバッグ中、これらの文字によりコードが読みやすくなります。実稼働段階では、転送されるコードのサイズを増やすだけです。ほとんどの場合、圧縮はビルドプロセスのステップとして、webpack などのビルドツールを使用して実行されます。ビルドツールを使用していない場合は、terser などのスタンドアロンツールを使用できます。コードを自動的に縮小するには、縮小ツールをイ...

メニューおよびツールバー

IDE を操作するとき、いくつかのアクションを他のアクションより頻繁に実行します。生産性を最大化するには、お気に入りのアクションのデフォルトのショートカットを学ぶか、それらにショートカットを割り当てます。メニューとツールバーをカスタマイズして、必要なアクションのみを含め、再グループ化し、アイコンを構成することもできます。メニューおよびツールバーをカスタマイズを押して設定を開き、を選択します。使用可能なメニューとツールバーのリストで、カスタマイズするノードを展開し、目的の項目を選択します。選択した...

外部ツール

サードパーティのコマンドラインアプリケーションを外部ツールとして構成して、PhpStorm から実行します。例: ワークフローでは、特定のスクリプト、コードジェネレーター、アナライザー、プリプロセッサーまたはポストプロセッサー、データベースユーティリティなどの実行が必要になる場合があります。外部ツールとして構成することにより、PhpStorm は専用のアクションを提供します。これは、メインメニューや特定のコンテキストメニューから実行したり、ショートカットを割り当てたり、特定の実行構成を起動すると...