PhpStorm 9.0.0 Help


File | Settings | Languages and Frameworks | PHP | Servers

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 dialog box as described in Enabling and Disabling Plugins.

On this page, configure HTTP access for debugging engines to interact with local and remote Web servers, see Working with Web Servers: Copying Files.

Toolbar and common options

Use the toolbar buttons to manage the list of configurations.

ItemTooltip and shortcutDescription
add.png Add
Click this button to define a new configuration.
delete.png Delete
Click this button to remove the selected configuration from the list.
icon_injection_move_to_project_make_global Import Click this button to open the Import from Deployment Configuration Dialog dialog box. In this dialog box you can choose the deployment configuration to access the application to debug and use the host and port settings from it. Additionally, all relative path mappings from the deployment configuration are converted into absolute paths on the remote host, by adding the absolute path to the deployment root as a prefix.

Configuration details

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 Run | Web Server Debug Validation on the main menu.

Name In this text box, type the name of the server debug configuration.
Host In this text box, type the name of the host where the target application is deployed.
Port 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.
Debugger From this drop-down list, select the debug engine to use. The available options are:
  • Xdebug
  • Zend Debugger
Use path mappings
  • Select this check box, to specify correspondence between files on the server and their local copies manually. Then map files and folders on the server to their local copies using the Path on server and File/Directory fields respectively.
    • File / Directory: This read-only field displays the local folders of the current project in a tree view. Select a file ot a folder to be used as the local copy.
    • Path on server: In this filed, specify the file or folder on the target server to which the selected local file or folder corresponds. Type the path manually or select it from the drop-down list. When this file or a file from this folder is being processed during a debugging session, PhpStorm opens its local copy chosen in the File / Directory field.
  • If this check box is cleared, upon a debugging session start PhpStorm tries to detect the local copies of the application files on the server itself. The suggestions are displayed in a dialog box where PhpStorm asks you to confirm or edit the suggested mappings.
Shared 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.

See Also

Last modified: 2 July 2015