Incoming Connection dialog

The dialog is available only when the PHP plugin is enabled. The PHP plugin is bundled with PhpStorm and activated by default. If the plugin is disabled, enable it on the Installed tab of the Settings | Plugins page, as described in Managing plugins.

The dialog opens when you initiate a Zero-Configuration debugging session without previously configuring a Debug Server with path mappings, so the debugger cannot set correspondence between the scripts in the running application and the files in your PhpStorm project.

The upper part of the dialog is read-only and shows the host and port where the script is executed, the path to the script relative to the server document root, and the absolute path to the script on the server.

In this dialog, either specify the path mappings manually or import them from the relevant deployment configuration.

To continue debugging with the imported or manually specified configuration settings, click Accept.

Item	Description
Import mappings from deployment	Choose this option to use the mappings specified in a server access configuration (deployment configuration.). Project: this read-only field shows the name of the current PhpStorm project. Deployment: from this list, choose the deployment configuration to import the mappings from. If PhpStorm detects a deployment configuration which seems relevant, the configuration is preselected in the Deployment list. If PhpStorm does not detect a relevant configuration: Choose the most suitable configuration from the list or click and create a new configuration in the Deployment dialog that opens, whereupon the new configuration is added to the list. In the Deployment root field, type the absolute path to the server root folder. Preview: this area shows the absolute path to the project file, which corresponds to the currently executed script according to the mappings from the selected configuration.
Manually choose local file or project	When you select this option, PhpStorm displays the project tree view where you can select a project file and map the currently executed script to it. You can also select and map the entire project. Path mappings cannot be set for project files or folders that are marked as excluded.

Item

Description

Import mappings from deployment

Choose this option to use the mappings specified in a server access configuration (deployment configuration.).

Project: this read-only field shows the name of the current PhpStorm project.
Deployment: from this list, choose the deployment configuration to import the mappings from. If PhpStorm detects a deployment configuration which seems relevant, the configuration is preselected in the Deployment list.
If PhpStorm does not detect a relevant configuration:
1. Choose the most suitable configuration from the list or click and create a new configuration in the Deployment dialog that opens, whereupon the new configuration is added to the list.
2. In the Deployment root field, type the absolute path to the server root folder.
Preview: this area shows the absolute path to the project file, which corresponds to the currently executed script according to the mappings from the selected configuration.

Manually choose local file or project

When you select this option, PhpStorm displays the project tree view where you can select a project file and map the currently executed script to it. You can also select and map the entire project.

Last modified: 27 October 2023