PhpStorm 2016.1 Help

Customizing Upload/Download

In addition to the mandatory settings that ensure successful upload and download in various project - server set-ups, you can choose additional options to customize interaction with the server. Most of these options apply to all types of server access configuration. For FTP/FTPS/SFTP server configurations, you can specify additional protocol-specific options.

On this page:

Setting Common Upload/Download Options

  1. Open the Options dialog box by doing one of the following:
    • On the main menu, choose Tools | Deployment | Options.
    • Open the Settings / Preferences Dialog by choosing File | Settings for Windows and Linux or PhpStorm | Preferences for OS X. Expand the Build, Execution, Deployment node, and then click Options under Deployment.
  2. In the Options dialog box that opens, specify additional settings:
    • To have PhpStorm skip specific files or entire folders during upload/download, in the Exclude items by name text box, specify the patterns that define the names of these files and folders. Use semicolons as delimiters. Wildcards are welcome.

      The exclusion is applied recursively. This means that if a matching folder has subfolders, the contents of these subfolders are not deployed either.

      For more details about excluding files and folders from upload/download, see Excluding Files and Folders from Upload/Download.
    • Specify the details of the upload/download procedure by selecting or clearing the corresponding check boxes.

Specifying additional protocol-specific customization options for FTP/SFTP/FTPS servers

  1. Open the Deployment dialog box by doing one of the following:
    • Choose Tools | Deployment | Configuration on the main menu.
    • Open the Settings / Preferences Dialog by choosing File | Settings for Windows and Linux or PhpStorm | Preferences for OS X, and click Deployment under Build, Execution, Deployment.
  2. In the Deployment dialog box, click the Advanced Options button and specify additional uploading settings in the Advanced Options dialog box that opens:
    • To set the client to the passive mode, select the Passive mode check box. In this mode, the client on your machine 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.
    • To have the hidden files and directories (those with names that start with a dot .) shown in the Server Browser Tool Window, select the Show Hidden Files check box.
    • To ensure compatibility in child file naming with your FTP server, select the Compatibility mode check box. This 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.

See Also

Last modified: 12 July 2016