スコープとファイルの色
スコープ 
は、プロジェクト のファイルやフォルダーの命名セットです。 スコープを使用すると、異なる IDE ビューで プロジェクト 項目を 視覚的に区別し 、特定の操作の範囲を制限できます。
スコープを使用すると、ファイルを論理的に整理できます。 たとえば、テストソースをテストスコープに配置し、本番環境のコードを本番環境スコープに配置することができます。 これにより、大きな プロジェクト を扱う作業が容易になります。 インスペクションをテストのみで実行すると、コードベース全体で実行するよりも高速になります。
PhpStorm には 事前定義されたスコープのセットが用意されていますが、独自のスコープも作成できます。 カスタムスコープには、たとえば担当している プロジェクト の一部分だけなど、任意のファイルセットを含めることができます。
PhpStorm では、スコープは さまざまな機能 、たとえばコードインスペクション、一部のリファクタリング、検索、コピーライト設定、各種コード解析機能などで使用されます。
PhpStorm にはローカルスコープと共有スコープの二種類があります。
ローカルスコープ は IDE 構成ディレクトリに格納されているため、VCS を通じて共有されず、チームの他のメンバーは使用できません。
プロジェクト が バージョン管理されている場合は、共有スコープの利用が有効です。 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 を通じて共有されません。
新しい色の関連付けを作成する
Ctrl+Alt+S を押して設定を開き、 を選択します。
ファイルカラーを有効化する のチェックボックスが選択されていることを確認してから、色を使用する場所を選択します： エディタータブで使用する または プロジェクトビューで使用する を選択します。
プロジェクトビューで使用する チェックボックスを選択すると、 プロジェクト ツールウィンドウ (Alt+1) と検索結果 (たとえば、 複数ファイル内検索 ダイアログ Ctrl+Shift+F) に色が表示されます。
追加 ボタン (
) をクリックし、色を設定するスコープを選択します。事前定義されたスコープの 1 つを選択するか、 カスタムスコープを使用できます。
必要なスコープの横にある矢印
をクリックし、開いたリストから色を選択します。独自の色を構成するには、 カスタム をクリックします。
色を編集するには、 色 列で必要なスコープに対応するセルをクリックし、リストから新しい色を選択します。
VCS を介して色を 共有するには、 VCS で共有する 列の対応する行のチェックボックスを選択します。 チェックボックスがオフの場合、色は ローカルで使用されます。
変更を適用して、ダイアログを閉じます。
ファイルが複数のスコープに含まれている場合、スコープの順序が重要になります。PhpStorm はローカルスコープから順に上から下へ処理します。 つまり、IDE は該当ファイルにはリスト内で最後にあるスコープの色を適用します。
PhpStorm で色の関連付けを別の順序で処理したい場合は、スコープの順序を変更できます。
スコープの順序を変更する
Ctrl+Alt+S を押して設定を開き、 を選択します。
移動するスコープを選択し、 上へ移動 (
) または 下へ移動 (
) ボタンをクリックします。 または、 Alt+Up または Alt+Down を押してください。変更を適用して、ダイアログを閉じます。
スコープ言語構文リファレンス
説明 | パターン | サンプル |
|---|---|---|
名前で単一のファイルを含める |
|
|
サブディレクトリなしで、ディレクトリ内のすべてのファイルのセットを含める |
|
|
サブディレクトリを持つディレクトリにすべてのファイルのセットを含める |
|
|
特定のプロジェクトからの名前でファイルを含める |
|
|
使用可能な論理演算子：&&（AND）、||（OR）、!（NOT）。 |
|
|
サンプル
file:*.php||file:*.twig: すべての PHP と Twig ファイルを含みます。file:*php&&!file:*test*.php: 名前に文字列テストを含むものを除くすべての 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拡張機能で識別して含めます。