PhpStorm 2023.3 Help

Directory Mappings

In this page, specify which version control systems will be used for specific directories or the entire project.

Item

Description

Directory

This field shows the path to project directories or the project roots.

For projects with Git or Mercurial integration enabled, PhpStorm scans project directories to check if there are Git or Mercurial repositories that are not controlled by the IDE. If such repositories are found, they are listed here under Unregistered roots and are marked grey. To add an unregistered root, select it in the list and click the Add button the Add button.

PhpStorm also checks if registered roots are valid, in other words, that a Gitor Mercurial repository exists at the specified path. If invalid repositories are detected, they are marked with red.

VCS

Select a version control system for the specified directory.

VCS integration in PhpStorm is provided through a set of bundled plugins enabled by default. So the list only displays the version control systems which plugins are enabled.

Add

Click this button to add a directory mapping to the list. The Add VCS Directory Mapping dialog opens where you can specify the required directory, select a VCS for it, and open the Version Control Configurations dialog to configure the specified VCS, if necessary.

Edit

Click this button to edit the selected directory mapping. The Edit VCS Directory Mapping dialog opens where you can update the selected mapping and configure the specified VCS, if necessary.

Remove

Click this button to remove the selected directory mapping from the list.

Last modified: 25 March 2024