PhpStorm 2018.2 Help

Advanced Options Dialog

The dialog box opens when you click the Advanced Options button in the Connection tab of the Deployment page. Use this dialog box to customize upload/download by specifying additional protocol-specific options for server configurations of the type FTP/SFTP/FTPS.



Available for

Passive mode

Select this checkbox to set the client on your machine to passive mode, when it connects to the server to inform about being in the passive mode, receives the port number to listen to, and established data connection through the port with the received number. This mode is helpful when your machine is behind a firewall.


Show and process hidden files

When this checkbox is selected:
  1. Hidden files and directories are shown in the Remote Host Tool Window.

  2. Hidden files and directories are involved in diff and synchronization operations.

The name of a hidden file or directory starts with a dot (.).


Compatibility mode

Select this checkbox to ensure compatibility in child file naming with your FTP server.

This option is helpful if the remote FTP server reports the following error:

Invalid descendant file name <file name>
Selecting this option may slow down synchronization with the server.


Retrieve accurate files timestamps

Use this drop-down list to specify the MDTM FTP command calling policy to retrieve the last-modified time of a given file on the remote host. The available options are:
  • Always - select this option to have MDTM called for every file shown in the Remote Host tool window.

  • On copy - select this option to have MDTM called in the following cases:
    • To check whether a file is up to date when the Overwrite up-to-date files checkbox in the Options dialog box is cleared.

    • To preserve the actual time stamp of a file during download.

  • Never - select this option to suppress calling MDTM.


Limit concurrent connections

Select this checkbox to have PhpStorm restrict the number of connections to be supported simultaneously and specify the maximum number of allowed connections in the text box.


Control encoding

In this text box, specify the encoding that matches the encoding used by your server. Accept the default value if you are not sure that it supports UTF-8 encoding.


Always use LIST command

Select this checkbox to use the standard LIST command for listing instead of the MLSD command. This lets you avoid problems, for example, failure during upload with the Invalid descendent file name exception if the FTP server supports MLSD and returns cdir.


Send keep alive message each

In this text box, specify how often you want PhpStorm to send commands to the server to reset the timeout and thus preserve the connection.


Use keep alive command

From this drop-down list, choose the commands to be sent to the server to reset the timeout and thus preserve the connection.


Ignore info messages

On some SFTP servers, the SSH banner may be enabled. Every time a connection is established, a pop-up window with an information message may be shown and to continue you would need to click OK.

To suppress showing the information pop-up window, select the Ignore info messages checkbox.


Last modified: 21 November 2018

See Also


Language and Framework-Specific Guidelines: