PhpStorm 2017.1 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.

ItemDescriptionAvailable for
Passive mode Select this check box to set the client on your machine to the 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. FTP, FTPS
Show and process hidden filesWhen this check box 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 modeSelect this check box 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 check box 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 check box to have PhpStorm restrict the number of connections to be supported simultaneously and specify the maximum number of allowed connections in the text box. FTP, FTPS, SFTP
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. FTP, FTPS, SFTP
Always use LIST command Select this check box 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. FTP, FTPS
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. FTP, FTPS, SFTP
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. FTP, FTPS
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 check box.


See Also


Language and Framework-Specific Guidelines:

Last modified: 31 March 2017