PhpStorm 2019.1 Help


File | Settings | Languages and Frameworks | PHP for Windows and Linux
PhpStorm | Preferences | Languages and Frameworks | PHP for macOS
Settings icon

The page and all the pages under this node are available only when the PHP plugin is enabled. The plugin is activated by default. If the plugin is disabled, enable it on the Plugins page as described in Managing plugins.

Use this page to configure PHP development and unit testing support in the project by choosing one of the available PHP interpreters, see Configuring Local PHP Interpreters and Configuring Remote PHP Interpreters.


Tooltip /


PHP language level

In this list, specify the PHP functionality scope to get coding assistance for. Each functionality scope is associated with the PHP version that supports this functionality. Currently PHP 5.3, PHP 5.4, PHP 5.5, PHP 5.6, PHP 7, PHP 7.1, PHP 7.2, PHP 7.3, and PHP 7.4 levels are supported.

No correlation between the PHP version used in the project and the language level is enforced. Although the language version of each interpreter is detected automatically, you can still tell PhpStorm to provide you with coding assistance that corresponds to a different language level. However, if you attempt to use a code construct that is not supported by the specified language level, PhpStorm suggests a Switch to PHP <version> quick-fix.

CLI Interpreter

In this list, choose the PHP interpreter to use in the current project by default. The list contains all the currently configured local and remote PHP interpreters. See Configuring Local PHP Interpreters and Configuring Remote PHP Interpreters for details.

the Browse button Shift+Enter

Click this button next to the CLI Interpreter list to create a new PhpStorm-wide PHP installation configuration in the CLI Interpreters dialog that opens.

See Configuring Local PHP Interpreters and Configuring Remote PHP Interpreters for details.

Path mappings

When you configure a remote interpreter accessible through SFTP, Vagrant, or Docker, this read-only field shows the path mappings retrieved from the corresponding deployment configuration, Vagrantfile, or Dockerfile. These mappings are read-only.

To provide the custom mappings, click the Browse button next to the field and specify them in the Edit Project Path Mappings Dialog dialog that opens:

  • To add a custom mapping, click the Add button and specify the path in the project and the corresponding path on the remote runtime environment in the Local Path and Remote Path fields respectively. Type the paths manually or click the Browse button and select the relevant files or folders in the dialog that opens.

  • To remove a custom mapping, select it in the list and click the Remove button.

Include Path Tab

The area displays the list of configured include paths. Include paths are used for holding third-party code that is used for completion and reference resolution in some functions/methods that use file paths as arguments, for example, require() or include().

  • Use Add and Remove to add and remove paths.

  • Use Move up and Move down to reorder the items in the list.

  • Click the Sort Alphabetically button to have the paths sorted alphabetically in the ascending order.

PHP Runtime Tab

The area lists the available PHP stubs, which are normal, syntactically correct PHP files containing annotated function, method, and class signatures, constant definitions, and so on. PHP stubs are added to PhpStorm's internal knowledge to enhance coding assistance for all the Standard PHP Library components as well as for common extensions.

  • Use the checkboxes next to each item to enable/disable the corresponding stub.

  • To load the set of stubs that matches the set of loaded extensions for the currently configured CLI interpreter, click the Sync Extensions with Interpreter button. For details on configuring interpreters, see Configuring Local PHP Interpreters and Configuring Remote PHP Interpreters.

In the Project Tool Window, the currently loaded stubs are displayed under the External Libraries node.

Advanced Settings Area

If necessary, you can load a set of custom PHP stubs to be used by PhpStorm. Click the Browse button next to the Default stubs path field and provide the stubs folder location in the dialog that opens. This way, you can load additional stubs as well as override the bundled ones.

Analysis Tab

Use this tab to configure the behavior of certain PhpStorm inspections.

Exception Analysis

Use this section to configure exception analysis, which alters the behavior of the Unhandled exception, Redundant catch clause, Missing @throws tag(s), and Redundant @throws tag(s) inspections.


Tooltip /


Call tree analysis depth

Use this list to set the desired exception analysis depth level. By default, 1 is selected, in which case PhpStorm reports the unhandled exceptions for the parent method throwing an exception, as well as the methods directly calling it. Selecting larger values allows you to drill down deeper into the calls hierarchy.

If 0 is selected, the exception analysis is limited to the parent method.

Skip calls with constant params

Select this checkbox to have PhpStorm skip certain method calls in the instance creation expressions during exception analysis:

  • Method calls only having strings or constants as parameters are skipped:

    $date = new DateTime('2019-01-01');
  • Method calls having variables, integers, arrays, and so on as parameters are not skipped:

    $date = new DateTime($myDate);

Unchecked Exceptions

Use this list to specify the exceptions that are treated as unchecked by PhpStorm. Such exceptions are skipped during exception analysis.

Add classAlt+Insert

Click this button to add a class to the Unchecked Exceptions list. In the Choose Class dialog that opens, locate the desired class by using the Search by Name tab or the Project tab.

Remove button Delete

Click this button to remove a selected class from the Unchecked Exceptions list.

Custom Format Functions

Use this section to include your custom string formatting functions into the Format function parameters mismatch inspection analysis scope. This inspection reports the mismatches between format function parameters and specification conversion entries and by default analyzes the usages of the standard PHP printf and sprintf functions.


Tooltip /


Add button Alt+Insert

Click this button to add a new function record to the custom format functions list. In the Add Custom Format Function dialog that opens, provide the name of a class method or function and specify the index of the argument where your formatting template resides.

Remove button Delete

Click this button to remove a function record from the custom format functions list.

Edit button Enter

Click this button to edit the selected function record.

Include Analysis

Use this section to define a custom folder the $_SERVER['DOCUMENT_ROOT'] expression should resolve to, which alters the behavior of the Unresolved include inspection.

The specified path will be used in code completion for the functions/methods that use file paths as arguments (for example, require() or include()). If the path is left blank, code completion will suggest the paths relative to the project root.

Commonly, this setting should be modified in case the document root folder defined by your web server configuration is different from the PhpStorm project root folder.




In this field, provide the folder the $_SERVER['DOCUMENT_ROOT'] expression should resolve to.

The default value is blank: the $_SERVER['DOCUMENT_ROOT'] expression in this case resolves to the project root folder. To have it resolve to a different folder, type the desired folder path relative to the project root, or click Open from disk and select the desired folder in the dialog that opens.

Last modified: 26 July 2019

See Also