PhpStorm 2019.1 Help

Uploading and Downloading Files

Uploading files and folders

PhpStorm provides the following main ways to upload project files and folders to deployment servers:

  • Manually, at any time through a menu command.

  • Automatically, every time a file is updated, or before starting a debugging session, or during commit to your version control system.

Upload a file or folder manually

  • In the Project tool window, select a file or folder, then select Upload to from the context menu, and choose the target deployment server or server group from the list.

    If the default server or server group is appointed, you can also select Upload to <default deployment server or server group>.

Upload application sources automatically before the PHP remote debugging session

  1. Create a PHP Remote Debug run/debug configuration.

  2. In the Before launch area, click Add icon and choose Upload files to Remote Host from the list.

  3. In the Upload to Remote Host dialog that opens:

    • From the Server list, choose the target deployment server or server group.

    • In the Local roots to upload area, create a list of root folders to upload. All the folders and files under the specified roots will be uploaded recursively.

Upload locally changed files

  1. Switch to the Local Changes tab of the Version Control tool window (Alt+9) to view the locally changed files.

  2. Select a file, then select Upload to from the context menu, and choose the target deployment server or server group from the list.

    If the default server or server group group is appointed, you can also select Upload to <default deployment server or server group>.

See Managing Files under Version Control for details.

Upload files after synchronizing with a VCS repository

  1. Synchronize the contents of your local files with the VCS repository by pressing Ctrl+T or selecting VCS | <VCS> | Update from the main menu.

  2. Switch to the Update Info tab of the Version Control tool window (Alt+9).

  3. Select a file, then select Upload to from the context menu, and choose the target deployment server or server group from the list.

    If the default server or server group is appointed, you can also select Upload to <default deployment server or server group>.

See Updating Local Information for details.

Upload checked-in files immediately after commit

  1. Start checking in your changes.

  2. In the After Commit area, choose the target server or server group from the Upload file to list. Choose one of the existing configurations or create a new one: click the Browse button and configure access to the relevant server or set up a server group in the Deployment dialog that opens.

  3. To have your selection applied automatically in the future, select the Always use selected server or group of servers checkbox.

Configure automatic upload of changed files to the default server or server group

  1. Open the Options dialog by doing one of the following:

    • From the main menu, choose Tools | Deployment | Options.

    • In the Settings/Preferences dialog (Ctrl+Alt+S), go to Build, Execution, Deployment | Deployment | Options.

  2. From the Upload changed files automatically to the default server list, choose when you want PhpStorm to upload changed files:

    • To upload any manually or automatically saved file, choose Always.

    • To upload only manually saved files, choose On explicit save action.

    • To suppress automatic upload, choose Never.

Downloading files and folders

Files and folders can be downloaded only manually.

Download a file or folder

  • In the Remote Hosts tool window, select the required file or folder and choose Download from here from the context menu of the selection.

Download a file from the default deployment server or server group

  • From the main menu, choose Tools | Deployment | Download from <default server or server group>.

    PhpStorm will prompt you to overwrite local files, if any.

Last modified: 8 July 2019

See Also