5.3. Target Settings

The following shows the Target tab of the Project Settings dialog:

Project target

The Target folder name is the name of the folder in which encoded files will be saved. The path to the folder containing the target folder should be entered in Location of project target folder.

If the Replace option is selected, the target folder will be erased and recreated during the encoding process. If Merge is selected the target folder will not be deleted, and processed files will over-write any files existing in the target. If Rename is selected, the target folder will be renamed by appending a unique number before the encoding process is started. The Update option is similar to Merge, except that a file will only be processed if the modified time of the source file is more recent than the modified time of the target file. The Update option can greatly speed processing of large projects where few changes have taken place since the last encoding.

It can be dangerous for the target folder to lie within the source tree, especially if Replace is selected. This behaviour is therefore disabled by default, but can be allowed by checking the Allow target to be within the source tree box.

If the Exclude non-encoded files option is set then the Encoder will only copy files to the target if they have been encoded as PHP files during that Encoder run.

Loaders found in the Loaders sub-folder of the Encoder installation folder can be bundled into the target folder by checking the boxes for the appropriate platform. An alternative method is to include Loaders in an ioncube folder in your source tree and these will be copied.

Target packaging (Special Edition only)

Once the encoding step is completed, the target folder can be automatically archived in various formats. Check the Create package from target folder to enable this feature. The target folder can be compressed as a ZIP or tar.gz archive, and if the ionCube Package Foundry (IPF) is installed, a 'setup.exe' installer or installer archive can be created using the integrated ionCube Package Foundry tool. Please see the Package Foundry documentation for details of that product.

After the target has been archived, the target folder will be deleted if the Delete target folder after packaging box is checked.

FTP parameters (Special Edition only)

If the Upload target to remote FTP server box is checked, the target directory, archive, or setup.exe can be uploaded automatically to an FTP server. Enter the settings for the desired server in the FTP parameters option group.

Note: The default FTP transfer mode is passive. If a transfer fails with an error switching to passive mode, change the settings to active and try again.