The page is available only when the PHP plugin is enabled. The plugin is bundled with PhpStorm and activated by default. If the plugin is not activated, enable it on the Plugins page of the Settings / Preferences Dialog as described in Enabling and Disabling Plugins.
On this page, configure HTTP access for debugging engines to interact with local and remote Web servers and set correspondence between files on the server and their local copies in the PhpStorm project. The settings from debug server configurations are used when debugging with run/debug configurations of the type PHP Web Application or PHP Remote Debug and during Zero-Configuration Debugging sessions.
Toolbar and common options
Use the toolbar buttons to manage the list of configurations.
|Tooltip and shortcut
|Click this button to define a new configuration.
|Click this button to remove the selected configuration from the list.
| Click this button to open the Import from Deployment Configuration Dialog dialog box. In this dialog box, choose a configuration to access the application on the server and use the host and port settings from it.
The dialog box also shows the path mappings retrieved from the deployment configuration. You need to transform relative paths on the server into absolute paths:
In this area, specify the connection parameters and mappings to be used during debugging sessions. Note that the Validate Remote Environment button has been removed from this page, this functionality is now available through on the main menu.
|In this text box, type the name of the server debug configuration.
|In this text box, type the name of the host where the target application is deployed.
|In this text box, type the port to connect to the specified host through. If you are using localhost on your machine, this setting should correspond with the port specified in the configuration file of the local Web server where the application will be executed or debugged.
|From this drop-down list, select the debug engine to use. The available options are:
|Use path mappings
If you do not specify any path mappings and start debugging an application that is not under the server document root, PhpStorm displays an error message: The Click to set up path mappings link brings up the Resolve Path Mappings Problem dialog box, where you can define the path mappings:
When you click OK and leave the dialog box, PhpStorm selects the Use path mappings check box on the Servers page automatically.
| Select this check box to share the debug server configuration across a team. The host/port settings and the path mappings are stored in the
.idea/php.xml file is available to all team members through a version control system. Note that mappings are shared only for directories inside the project.