PhpStorm 2016.2 Help

Uploading and Downloading Files

On this page:

Basics

There are the following main ways to synchronize project files with their copies on the local or remote server:

Besides uploading files, you can also have PhpStorm download files that were deployed according to the default server configuration.

Uploading files and folders manually

  1. Choose Tools | Deployment on the main menu.
  2. Do one of the following:
    • To run the upload according to the default configuration, choose Upload to <default server configuration>.
    • To run the upload according to a specific configuration, choose Upload to. Then from the pop-up menu, select the server configuration that defines access to the required server.

Uploading application sources automatically before application start

When working on a PHP application, you can have its sources automatically uploaded to a server every time you run the application or initiate a debugging session from PhpStorm.

  1. During creation of a run/debug configuration, click the Add button add.png and choose the Upload Files to Remote Host task from the list.
  2. In the Upload to Remote Host dialog box that opens, specify the following:
    • The server configuration to access the required server.
    • The local root folders to upload. All the folders and files under the specified roots will be uploaded.

Uploading changed files automatically

PhpStorm considers a local file changed as soon as it is saved either automatically or manually. PhpStorm performs automatic save on a regular scheduled basis. Manual save is invoked by choosing File | Save All on the main menu or pressing Ctrl+S.

  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 Upload changed files automatically to the default server drop-down list, specify when you want PhpStorm to upload changed files:
    • To have PhpStorm upload any saved file no matter whether the save was invoked manually or automatically, choose Always.
    • To have PhpStorm upload only files that were saved manually, choose On explicit save action.

Uploading checked-in files immediately after commit

  1. Start checking in your changes.
  2. In the After Commit area, choose the target server from the Upload file to drop-down list. Choose one of the existing server access configurations or create a new one: click the Browse button browseButton.png and configure access to the relevant server in the Deployment dialog box that opens.
  3. To have PhpStorm automatically upload checked in files to the chosen server, select the Always use selected server check box.

Suppressing automatic upload

  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. From the Upload changed files automatically to the default server drop-down list, choose Never.

Downloading files

Choose Tools | Deployment | Download from <default server configuration> on the main menu. Note that this functionality is available only if you have previously appointed a configuration as default.

See Also

Last modified: 20 July 2016