Configuring folders within a content root

Mark directories under the content root

1. In the Settings dialog (Ctrl+Alt+S), select Directories.

2. On the Directories page, click the desired content root. Directories under this content root are displayed as a tree view in the right-hand pane.

3. Select the directory and use its context menu or the Mark as toolbar to mark it as one of the following:

   • Tests: PhpStorm considers the contents of a Tests folder to be unit tests.

   • Sources: PhpStorm considers a Sources folder to be the root for namespaces used in your project.

     Based on this setting, PhpStorm suggests the proper folder name when you want to create a new namespace under another parent namespace during creation or moving a PHP class, that is, when you are actually creating or moving a PHP class to a non-existing namespace under another parent namespace. If no Sources folder is specified, you will have to type the proper folder manually.

     Appointing a Sources folder is not mandatory but this helps you keep your project structure in compliance with the PSR0 and PSR4 standards. See Configure PHP namespaces in a project for details.

   • Excluded: PhpStorm ignores Excluded folders during indexing, parsing, code completion, and so on.

     note

     Make sure that the folders in your vendor directory are Excluded, but added to the project via include path as External Libraries. Such folders are marked as library directories, or just libraries, by PhpStorm. Unlike other Excluded directories, library directories are indexed and therefore subject to the related IDE features such as code completion or refactoring. At the same time, libraries are protected with a warning pop-up upon every modification attempt, be it direct intentional editing or update result from refactoring.

   • Resource Root: PhpStorm completes relative paths to resources under the Resource Root folder.

   

Mark directories in the Project tool window

1. Right-click the desired directory in the Project tool window.

2. From the context menu, point to Mark Directory As node.

3. Choose Mark as <directory status>.

To return a folder to its regular status, you need to unmark it.

• On the Directories page of the Settings, do any of the following:

  • Select the directory in the list of folders under the content root, and click :

    

  • Click the folder's status icon once more.

  • Choose the corresponding command from the context menu of the directory.

• In the Project tool window, right-click the desired directory, point to Mark Directory As node, and then choose Unmark as <directory status>.