PhpStorm 2018.1 Help

VCS Integration with issue trackers

With PhpStorm, you can connect your commit messages with a bug tracker or an issues data base, and navigate from commits in your VCS log to issues related to these commits.

To enable navigation from commit messages to issues

  1. In the Settings/Preferences dialog (Ctrl+Alt+S), select Version Control | Issue Navigation on the left.
  2. Configure a list of issue navigation patterns by mapping issue patterns in commit messages with URL addresses of the referenced issues.
    • If you are using JIRA or YouTrack, click Add JIRA pattern add pattern jira or Add YouTrack Pattern add pattern youtrack on the toolbar, and type the URL to the installation of the bug tracking system.
      PhpStorm will automatically add a regular expression that defines the navigation pattern.
    • For other issue tracking systems, click the Add button new to create a new entry or select an existing entry and click the Edit button. In the Add Issue Navigation Link dialog box that opens, specify the following:
      • The regular expression that defines the issue pattern in a commit message.
      • The replacement expression that defines the URL to access the corresponding referenced issue.


Issue ID pattern The regular expression that defines the format in which issues are referenced in commit messages.

This regular expressions matches all character strings that consist of two substrings separated by an n-dash character:
  1. Substring 1: An unlimited number of upper case alphabetic characters.
  2. Substring 2: An unlimited number of digital characters.

Issue link pattern A combination of the URL address of your issue tracking system and a regular expression that identifies issues in it.

Here $0 indicates a back reference to the entire match. This means that as soon as PhpStorm detects a match in a commit message, it is added to the URL address of the tracker as is.

Matching issue ID PhpStorm detects the following reference to an issue in the commit message of interest:


Composed issue link In accordance with the above issue navigation pattern, the detected matching reference is added to the URL of the tracker as is, so the link to the referenced issue is composed as follows:


Last modified: 27 July 2018

See Also