PhpStorm 2023.3 Help

Deployment: Mappings Tab

In this tab, configure mappings, that is, set correspondence between the project folders, the folders on the server to copy project files to, and the URL addresses to access the copied data on the server. The easiest way is to map the entire project root folder to a folder on the server. The project folder structure in this case will be repeated on the server, provided that you have selected the Create Empty directories checkbox in the Options dialog. For more information, refer to Configure synchronization with a server and Customize upload and download.

The following terms are used in the context of synchronization between PhpStorm and servers:

  • In the local server configuration, you do your development, then copy the sources to the server.

    A local server is a server that is running in a local or a mounted folder and whose document root is NOT the parent of the project root.

  • In the remote server configuration, a server runs on another computer (a remote host). To access files on the server, use FTP/SFTP/FTPS/WebDAV protocols.

  • The server configuration root is the highest folder in the file tree on the local or remote server accessible through the server configuration. For in-place servers, it is the project root.

  • A local file/folder is any file or folder under the project root.

  • A remote file/folder is any file or folder on the server.

Item

Description

Local Path

In this field, specify the full path to the desired local folder. In the simplest case it is the project root.

Type the path manually or click Browse button and select the desired location in the Choose Local Path dialog that opens.

Deployment Path

In this field, specify the folder on the server where PhpStorm will upload the data from the folder specified in the Local Path field. Type the path to the folder relative to the server configuration root.

If the folder with the specified name does not exist yet, PhpStorm will create it, provided that you have selected the Create Empty directories checkbox in the Options dialog. For more information, refer to Customize upload and download.

The field is not available for In-place server configurations.

Web Path

In this field, type the path to the folder on the server relative to the server configuration root. Actually, type the relative path you typed in the Deployment Path field.

Add item

Click this button or press Alt+Insert to have a new line added to the list of mappings.

Remove item

Click this button or press Alt+Delete to remove the selected mapping from the list.

Last modified: 25 March 2024