PhpStorm 2016.3 Help

Configuring Scopes and File Colors

This section describes how to configure scopes and coloring of the files belonging to these scopes:

Creating a new custom scope

Project scopes are configured in the Scopes page of the Settings/Preferences dialog box.

To create a new custom scope

  1. In the Scopes settings page, click Add scope /help/img/idea/2016.3/new.png.
  2. Select Local Changes or Shared from the drop-down list. Shared scopes are defined for the current project and accessible for the team members via VCS, while Local scopes are intended for personal use only and are stored in your workspace.
  3. Specify the name for the new scope.
  4. Apply changes.

Configuring the list of items in a custom scope

To configure the list of items in a custom scope

  1. In the Scopes settings page, select the scope that you want to configure.
  2. Do one of the following:
    • Choose files and folders to be included in the scope and use buttons on the right. Based on the inclusion/exclusion, PhpStorm creates an expression and displays it in the Pattern field.
    • Specify pattern in the Pattern field manually, using the scope language syntax.
  3. Apply changes.

Associating file color with a scope

Files belonging to different scopes can be highlighted in different colors throughout the PhpStorm's user interface: in navigation lists, in the editor tabs, in the Project window . This allows much faster and easier navigation in large projects.

To associate file color with a scope

  1. Open the File Colors settings page.
  2. Decide whether you want the scope-color association to be only available to you or to be shared with the team. Depending on that, select or clear the check box Share colors section of the page.
  3. Click Add /help/img/idea/2016.3/new.png.
  4. In the dialog box that opens, select a scope and pick a color for it.
  5. If necessary, use the check boxes on top of the page to define where in the user interface files belonging to the scopes are highlighted.
  6. Apply changes.

Arranging the order of scopes

If some file is included into several scopes, the order of the scopes becomes important: PhpStorm uses the color of the uppermost scope (shown in the Scopes settings page) to highlight such file. Of course, you can change the order of the scopes, and thus the resulted highlighting.

To arrange the order of scopes

  1. Open the Scopes settings page.
  2. Select a scope whose position in the order you want to change.
  3. Click Move Up /help/img/idea/2016.3/arrowUp.png / Move Down /help/img/idea/2016.3/arrowDown.png
  4. Apply the changes.

See Also

Last modified: 1 December 2016