PhpStorm 2016.1 Help

Version Control

File | Settings | Version Control for Windows and Linux
PhpStorm | Preferences | Version Control for OS X

The settings under this node allow configuring integration with different version control systems.

Common settings that are applied to the project files regardless of which version control system is used:

The settings for configuring integration with a specific version control system are located under the following nodes:

Specify which version control systems will be used for specific directories, or the entire project.

DirectoryThis field shows the path to project directories or the project root(s).

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 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 add.

PhpStorm also checks if registered roots are valid, i.e. that a Git /Mercurial repository exists at the specified path. If invalid repositories are detected, they are marked with red.

VCSSelect a version control system for the specified directory.

The list only displays the version control systems for which the corresponding plugins are enabled (SeeManaging Plugins).

ellypsis Click this button to open the Version Control Configurations dialog and update the configuration settings for the selected VCS.
add Click this button to add a directory mapping to the list. The Add VCS Directory Mapping dialog box opens where you can specify the required directory, select a VCS for it, and open the Version Control Configurations dialog box to configure the specified VCS, if necessary.
edit1 Click this button to edit the selected directory mapping. The Edit VCS Directory Mapping dialog box opens where you can update the selected mapping and configure the specified VCS, if necessary.
delete Click this button to remove the selected directory mapping from the list.
Limit history toSelect this check box to specify the number of history rows. If this check box is selected, the text box of history depth, and the spin box become enabled.
Show directories with changed descendants If this check box is selected, the directories that contain changes, are color-marked.

The colors are configurable in the Colors and Fonts pages of the Editor settings (File Status - Have immediate changed children, Have changed descendants).

Store on shelf base revision texts of files under DVCS Select this check box to have PhpStorm always shelve the base revisions of files that are under Git or Mercurial version control.

By default, PhpStorm always "remembers" the last commit hash. However, this information is not sufficient if the history has been changed since the last commit as a result of running the Rebase operation. In this case, having a copy of the base revision may help.

This check box is relevant only for integration with distributed version control systems, such as Git and Mercurial.

Show changed in last <number> days Select this check box to have color indication of file status applied during stacktrace analysis and debugging. The names of the files that have been changed within a certain period will be highlighted accordingly.

Specify the number of days.

Filter Update Project information by scope If this option is enabled and a scope is selected, the files that belong to this scope will be marked in bold in the Update Project Info tab of the Version Control Tool Window. If you click the Filter button filter in the toolbar in the Update Project Info tab, the files will be filtered by scope, i.e. only the files that belong to the selected scope will be displayed.

Click the Manage Scopes link to open the Scopes settings dialog and configure a scope.

Commit message right margin (columns) In this field, specify the number of symbols that can fit into the right margin of the Commit Changes dialog.

Select the Wrap when typing reaches right margin option if you want the text to be transferred to the next line when the maximum number of characters has been reached.

See Also

Last modified: 12 July 2016