PhpStorm 2021.2 Help

Exclude files and folders from uploading and downloading

Suppressing uploading, downloading, and synchronization for files or folders with sources ensures that the sources are protected against accidental update. When applied to non-sources, it can save system resources because media, caches, or temporary files are no longer copied unnecessarily.

You may need to suppress upload/download in the following cases:

  1. You are going to work with externally created and uploaded source code. To process these remote sources in PhpStorm, you have to download them and arrange them in a project. However, there are some sources that you should not update at all. On the other hand, the folders on the remote host also may contain huge amounts of media, caches, temporal files, that you actually do not need in your work.

  2. You have already downloaded the data from the server and arranged them in a PhpStorm project. However, for this or that reason, you need to have some files or folders on the server protected against upload/download, for example, to prevent accidental overwriting.

  3. The local copy of an application contains both source code and other data that you do not need to upload. Besides, you want to protect some sources against overwriting by mistake. In this case, you can suppress upload/download for all files and folders that should not be uploaded.

There are two ways to exclude folders from upload/download:

Exclude a folder on server from upload/download during project creation

  1. Initiate creation of a project from existing files by choosing New Project from Existing Files from the main menu. The New Project wizard starts.

  2. On the first, Choose Your Scenario, page of the wizard, specify the method to access the remote host, then follow the wizard.

  3. On the Choose Remote Path page of the wizard, select the folder and click the Project Root icon on the toolbar or choose Project Root from the context menu. PhpStorm marks the selected folder with the the Project Root icon icon.

  4. Under the project root, specify the folders that you do not need downloaded. Select the relevant folder and click the Excluded from Download icon icon exclude from download or choose Exclude Path from the context menu of the selection.

    Exclusion is applied recursively. This means that if the selected folder contains subfolders they are automatically marked as excluded as well.

Exclude a folder on server from upload/download after project creation

Add a folder to the list of excluded paths

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

    • Choose Tools | Deployment | Configuration from the main menu.

    • In the Settings/Preferences dialog Ctrl+Alt+S, select Deployment under Build, Execution, Deployment.

  2. In the Deployment

    dialog, click the Excluded Paths tab. The tab shows the list of the previously excluded local and remote folders.

  3. Click the Add button the Add button and select Deployment path.

  4. Double-click the empty line that is added to the list.

  5. At the end of the added line, click the Browse button the Browse button.

  6. In the Choose remote excluded path dialog, navigate to the folder that you want to exclude.

    You can also type the path manually, but note that only absolute paths are accepted.

  7. When you OK, you return to the Excluded Paths tab, where the selected remote folder is added to the list.

Add a folder to the list of excluded paths in the Remote Host tool window

  1. From the main menu, choose Tools | Deployment | Browse Remote Host or View | Tool Windows | Remote Host.

  2. In the Remote Host tool window that opens, select the relevant server configuration from the list.

  3. Select the folder to exclude and choose Exclude Path from the context menu of the selection.

Exclude a local folder from upload/download

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

    • Choose Tools | Deployment | Configuration from the main menu.

    • In the Settings/Preferences dialog Ctrl+Alt+S, select Deployment under Build, Execution, Deployment.

  2. In the Deployment

    dialog, click the Excluded Paths tab. The tab shows the list of the previously excluded local and remote folders.

  3. Click the Add button the Add button and select Local path.

  4. At the end of the added line, click the Browse button Browse button and navigate to the folder that you want to exclude.

    You can also type the path manually, but note that only absolute paths are accepted.

Exclude files and folders from upload/download by name

  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. In the Options dialog that opens, specify the patterns that define the names of these files and folders in the Exclude items by name field.

    Use semicolons ; as delimiters, asterisks * to match zero or more characters, and question marks ? to match a single character.

    For example, if you have a folder stylesheets with three files style.css, style1.css, and style2.scss, then style* excludes the entire folder, style?.css excludes style.css, and style?.* excludes style1.css and style2.scss.

    Learn more from Regular-Expressions.info.

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

Remove the exclusion mark

  • Select a file or folder to upload/download and choose Remove Path from Excluded from the context menu.

    Returning a folder to upload/download affects all its subfolders and files.

Last modified: 20 October 2021