PhpStorm
 
2023.2
Shortcuts: Windows
Get PhpStorm
You are viewing the documentation for an earlier version of PhpStorm.
  1. Version control
  2. Enable version control

Enable version control

Last modified: 08 September 2023

PhpStorm supports version control integration at two levels:

  • At the IDE level, VCS integration is provided through a set of bundled plugins enabled by default.

  • At the project level, VCS integration is enabled by associating project folders with one or several version control systems.

Associate a project root with a version control system

PhpStorm allows you to quickly enable your project's integration with a version control system and associate it with the project root. For more information about associating separate project directories with different version control systems, refer to Associate a directory with a version control system.

Associate a directory with a version control system

PhpStorm supports a directory-based versioning model, which means that each project directory can be associated with a different version control system.

Manage unregistered directories

For projects with Git or Mercurial integration enabled, PhpStorm scans project directories to check if there are Git/Mercurial repositories that are not controlled by the IDE. If such repositories are detected, PhpStorm displays a notification.

To add an unregistered root, click the Add roots link in the notification. Alternatively, open the Version Control settings page, select the unregistered root you want to add (they are marked grey), and follow the procedure Associate a directory with a version control system.

If you do not want to be notified about these roots again, click the Ignore link in the notification. Note that if new unregistered repositories are added to the project, PhpStorm will notify you about them.

Change VCS associations

  1. Press CtrlAlt0S to open the IDE settings and then select Version Control | Directory Mappings.

  2. The Directory Mappings page shows a list of project directories and version control systems associated with them (if no directories have been added, the list only contains the project root).

  3. Locate the row that corresponds to the directory which you want to put under another version control system.

  4. Click the VCS column. From the list that appears, select a new version control system.

    note

    If you select None, VCS integration for the selected directory will be disabled.

  5. Click OK to save the mapping and return to the Directory Mappings page.

See also

Procedures

Reference