Scopes

Main toolbar

Item	Tooltip	Description
	Add scope	Click this button to add a new local or shared scope.
	Delete	Click this button to delete the selected scope from the list.
	Copy configuration	Click this button to create a copy of the selected scope.
	Save as	Click this button to have the selected local scope saved as shared or a selected shared scope as local.
	Move Up/Move Down	Use these buttons to move the scopes up and down in the list.

Scopes configuration controls

Scopes are defined in the following modes:

• Manually, by specifying file masks in the Pattern text box.
• By selecting files and folders and clicking the buttons Include, Include Recursively, Exclude, and Exclude Recursively. Based on the inclusion/exclusion, PhpStorm creates an expression and displays it in the Pattern. However, this approach does not allow for including/excluding specific files within folders based on file masks.

Item	Description
Name	In this text box, specify the scope name.
Pattern	In this text box, specify the pattern to define the current scope using the script-like language described in the Scope Language Syntax Reference subsection. The following elements and structures are used: The file: modifier. The element is mandatory. The * asterisk to denote any symbol in a file name or file extension. Logical operators AND (&&), OR (||), and NOT (!). Type or edit the pattern manually or choose the desired files in the Project Tree View - PhpStorm will generate the corresponding pattern. Warning Storing empty or incorrect patterns is not allowed. In such cases, you will be prompted with the Syntax Error warning. Examples: file:*.php||file:*.twig - include all PHP and Twig files. file^*php&&!file:*test*.php - include all PHP files except those that contain the character string test in their names. 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 - include all .PHP, .CSS, and .JS files from the theme and plugin of the WordPress website. file:*.js||file:*.coffee - include all JavaScript and CoffeeScript files. file:*js&&!file:*.min.* - include all JavaScript files except those that were generated through minification, which is indicated by the min extension.
Include	Click this button to have the selected element included in the scope. The corresponding expression is automatically generated and added to the expression in the Pattern text box. Tip If the current element is a folder, the nested subfolders are ignored.
Include Recursively	Click this button to have the selected folder included in the scope, together with the nested subfolders. The corresponding expression is automatically generated and added to the expression in the Pattern text box.
Exclude	Click this button to have the selected element excluded from the scope. The corresponding expression is automatically added to the Pattern. If the current element is a folder, the nested subfolders are ignored.
Exclude Recursively	Click this button to have the selected folder excluded from the scope, together with the nested subfolders. The corresponding expression is automatically added to the Pattern field.

Scope toolbar

Item	Tooltip	Description
Project tree view		The tree view contains all the files available in your project. In the view, select the desired files to be included in the current scope and have the scope definition pattern generated automatically. The message on the toolbar shows the total number of available files and the number of files included in the scope. See also the color legend below. Use the toolbar buttons described below to change the view presentation.
	Show Files	If this button is pressed, source files are displayed explicitly in the tree view. Otherwise they are hidden.
	Show Included Only	When the button is pressed, the tree shows only the elements that are included in the scope.

Legend of the project tree view

Item	Description
Green	Folders and files included in scope.
Black	Folders and files excluded from scope.
Blue	Folders that contain both excluded and included files and subfolders.