PhpStorm 8.0.2 Web Help

Issue Navigation

File | Settings | Version Control | Issue Navigation


Use this page to create a list of so called issue navigation patterns. An issue navigation pattern maps an issue ID pattern in commit messages and URL addresses of referenced issues. This enables you to navigate from committed changes to the issues related to these changes. As soon as PhpStorm encounters a match to the issue ID pattern in a commit message, the match is displayed as a link in the Changes and Version Control tool windows. If you mention several issues, all of them will show up as links. Clicking such link opens the matching issue in the browser according to the defined link.

Item Description
Issue This read-only field shows an issue pattern.
Link This read-only field shows the link to navigate from the issue pattern in the current row to the issue in the bug tracking system.
add Click this button to create a new issue navigation pattern and link. The Add Issue Navigation Link dialog box opens where you can specify:
  • A regular expression to define the issue ID.
  • A regular expression to define the navigation link to the issue.
add-pattern-jira Click this button to create a new JIRA pattern. The Create JIRA Issue Navigation Pattern dialog box is opened where you can specify the URL to your JIRA installation. The regular expression that defines the pattern is added automatically.
add-pattern-youtrack Click this button to create a new pattern for our bug tracking system YouTrack. In the dialog box that is opened, specify the URL to your YouTrack installation. The regular expression that defines the pattern is added automatically.
edit1 Click this button to update the selected issue navigation link.
delete Click this button to remove the selected issue navigation link from the list.

Example

The example shows how PhpStorm applies the above rules to detect a reference to an issue in a commit message and compose a link to it in the tracking system.

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

[A-Z]+\-\d+
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.

http://mytracker/issue/$0
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:

MYPROJECT-110

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:

http://mytracker/issue/MYPROJECT-110

See Also

Last modified: 10 December 2014