You are here: User Guide > Tasks > Working with Remote Server Support > Uploading Folders/Files to a Remote Server

Uploading Folders/Files to a Remote Server

Working with an enabled remote project allows you to upload folders, and the files contained within them, to the remote server specified in the associated Remote Connection Profile . This functionality allows you to ensure that your local project corresponds to the remote copy. Uploading data can be done manually (Manual mode) or automatically (On Save mode and On Run mode) according to your settings in the Remote Server Support Properties page.

Uploading to a Remote Server in Manual Mode

Manual mode allows you to upload data to the remote server only when you manually select to perform a data upload. If your project is set to Manual mode, data will never be transferred without you manually uploading the folders/files. This option is useful when you do not want your local and remote projects to always be synchronized.

Before beginning this procedure you must create a new project with Remote Server Support or enable your project as a remote project.

Instructions on how to complete a procedure

To upload folders and files in Manual mode:

From the Right Click Menu of your project select Properties | Remote Server Support -OR- go to Project | Properties | Remote Server Support.
The Remote Server Support Properties page opens.

Select Manually from the Upload Files dropdown menu and click OK.
Your project is set to Manual mode.
From the Right Click Menu of your project select Remote Servers | Upload from Server.
The Data Upload Selection dialog opens.

Expand the Project Directory to see all the folders within it that will also be uploaded.
Select the folders you want to upload to the remote server by selecting the check-box next to the folder name.
By default all folders are selected.
Click on a selected folder to view the included files.
The individual files can also be selected/unselected to upload to the remote server. By default, all files within a folder are selected.
On this page you can also:

Filter Types - Opens the Inclusion and Exclusion Patterns dialog. Defining exclusion/inclusion patterns allows you to filter which folders/files will be uploaded. For more information see Working with Inclusion and Exclusion Patterns.
Select All - Selects all the folders and files.
Deselect All - Deselects all the folders and files.

Click Finish.
The selected files are uploaded to the server.

To keep your local project in sync with the remote copy on the remote server, you can also download folders/files from the remote server or change the remote server associated with your project. For more information see Enabling a Project as a Remote Project or Managing Remote Connections Profiles.

All tasks you perform while working with Remote Server Support will appear in the Console view. Checking the Console view is the most efficient way to ensure that the action has been completed as you have requested. It will also show any problems that occurred during the task.

Uploading to a Remote Server in On Save Mode

Setting your project to On Save mode allows you to know that every time you save your project (or folder/file), or perform a change event, it will be uploaded to the remote server. This option is useful when you want to ensure that your local and remote project are always synchronized.

Important Note:

Deleting folders/files when in On Save mode automatically deletes them from the remote server. This will occur even if you have not saved the file.

Instructions on how to complete a procedure

To upload folders and files in On Save mode:

1. From the Right Click Menu of your project select Properties | Remote Server Support -OR- go to Project | Properties | Remote Server Support.
The Remote Server Support Properties page opens.

Select On Save from the Upload Files dropdown menu and click OK.
Your project is set to On Save mode.
Your project will be automatically uploaded to the remote server every time you save your project, or when a change event occurs. A change event is when:

An event is changed
A folder/file is changed
A new folder/file is created
A folder/file is deleted

Important Note:

Deleting folders/files when in On Save mode automatically deletes them from the remote server. This will occur even if you have not saved the file.

If you save only a specific file instead of the entire project, only the saved file will be uploaded to the remote server. To save the entire project click the save all icon from the menu bar.

Note:

The On Save mode does not allow you to filter which folders/files you are uploading.

To keep your local project in sync with the remote copy on the remote server, you can also download folders/files from the remote server.

Uploading to a Remote Server in On Run Mode

Setting your project to On Run mode allows you to know that your project is always uploaded to the remote server before you execute it. This option is useful when you do not want the project to always be automatically synced, but you would like an updated version of your project to be transferred to the remote server before you execute it.

When using On Run, Zend Studio will upload your selected project resources when you choose to execute your project, allowing you to remotely execute an updated copy of your project.

Your project specific debug settings can be configured in the PHP Debug Properties page.

Instructions on how to complete a procedure

To upload folders and files in On Run mode:

1. From the Right Click Menu of your project select Properties | Remote Server Support -OR- go to Project | Properties | Remote Server Support.
The Remote Server Support Properties page opens.

Select On Run from the Upload Files dropdown menu and click OK.
Your project is set to On Run mode.
Select one of the available methods to debug or run your project. See Debugging Files and Applications or Running Files and Applications for more information.
The Data Upload Selection dialog opens.

Expand the Target folder to see all the folders within it that will also be uploaded.
Select the folders you want to upload to the remote server by selecting the check-box next to the folder name.
Click on a selected folder to view the included files.
The individual files can also be selected/unselected to upload to the remote server. By default, all files within a folder are selected.
On this page you can also:

Filter Types - Opens the Inclusion and Exclusion Patterns dialog. Defining exclusion/inclusion patterns allows you to filter which folders/files will be uploaded For more information see Working with Inclusion and Exclusion Patterns.
Select All - Selects all the folders and files.
Deselect All - Deselects all the folders and files.

Click Finish.
The selected files are uploaded to the remote server and your run/debug session starts.

To keep your local project in sync with the remote copy on the remote server, you can also download folders/files from the remote server.