PhpStorm 2021.2 Help

Import from Deployment Configuration Dialog

The dialog is available only when the PHP and FTP/SFTP Connectivity plugins are enabled. The plugins are not bundled with PhpStorm, but they can be installed on the Settings/Preferences | Plugins page as described in Installing plugins from JetBrains repository. Once enabled, the plugins are available at the IDE level, that is, you can use them in all your PhpStorm projects.

The dialog opens when you click the Import button on the toolbar of the Servers page.

In this dialog, choose a configuration to access the application on the server and use the host and port settings from it.

Item

Description

Deployment

From this list, choose the server access configuration (deployment configuration) to copy the server access settings from. The list contains all the available deployment configurations. To create a new configuration, click the Browse button and specify new settings in the Deployment: Connection Tab dialog that opens.

In the field below, specify the absolute path to the server deployment root folder, the name of the field depends on the type of the selected server access configuration: Absolute path to the deployment root for FTP/SFTP/FTPS or Remote path to the mounted folder for Local or mounted folder.

This path will be added as a prefix to the path from the Root path field on the Deployment: Connection Tab.

If you are not sure about this absolute path, you can open the Remote Host tool window, choose the required deployment configuration, position the caret at the root folder, and choose Copy Path from the context menu, see Access files on web servers for details. Alternatively, contact your hosting provider.

Absolute path to the deployment root or Remote path to the mounted folder

Depending on the type of the server access configuration chosen from the Deployment list, specify one of the following:

  • For an FTP, SFTP, or FTPS server access configuration, specify the absolute path to the server deployment root.

    This path will be added as a prefix to the path from the Root path field on the Deployment: Connection Tab.

    If you are not sure about this absolute path, you can open the Remote Host tool window, choose the required deployment configuration, position the caret at the root folder, and choose Copy Path from the context menu, see Access files on web servers for details. Alternatively, contact your hosting provider.

  • For Local or mounted folder, type the absolute path to the server root as specified in the Folder field of the Deployment: Connection Tab dialog.

  • For Inplace Server configurations no mappings are required because the local and remote paths are the same in this case.

Preview

The area shows the host/port and the path mappings retrieved from the chosen server access configuration (deployment configuration).

When you choose the deployment configuration to use, the Absolute path on the server field shows relative paths mapped to the project files and folders in the chosen configuration, that is, paths to files and folders relative to the deployment root. As you specify the absolute path to the deployment root (the server root for FTP/SFTP/FTPS or the mounted folder), the contents of the field are updated automatically and finally the field shows absolute paths on the server.

Specify how PhpStorm will set up correspondence between files on the server and their local copies. Based on these mappings, PhpStorm will open local copies of currently processed files.

Path mappings in PHP Debug Server configurations look very similar to the path mappings in server access (deployment configurations. Unfortunately, they cannot be reused, as deployment configurations uses relative paths while PHP Debug Servers configurations rely on absolute paths.

  • Select the Use path mappings checkbox if you are working on a remote Web server, that is, when the Web server is on a physically remote host, or the Web server is installed on your machine but your project is outside the Web server document root. If you are using symlinks, select this checkbox as well.

    Map the absolute paths to the files and folders on the server with absolute paths to your project files in the local file system using the Absolute path on the server and File/Directory fields respectively.

    • File/Directory This read-only field displays the files and folders of the current project. Select a file or a folder to be used as the local copy.

    • Absolute path on the server In this field, specify the absolute path to 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 list.

  • Clear the Use path mappings checkbox if you are working right on your Web server so your project root is under the server document root. In this case the absolute paths to the files on the Web server and the absolute paths to the corresponding files in your project are the same.

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:

Debug mappings not configured error message.png

The Click to set up path mappings link brings up the Resolve Path Mappings Problem dialog, where you can define the path mappings:

Fixing debug mappings configuration.png

When you click OK and leave the dialog, the Use path mappings checkbox on the Servers page gets selected automatically.

Last modified: 20 December 2021