creates your project. But you can at any time add new files, folders or source wildcards to your list manually; or better let ExeOutput for PHP do this task itself thanks to the powerful Source File List Update option.
You can manage your files thanks to the button bar below or using the mouse's context menu (right click on the file list):
Each operation is described more below:
To add files to the list, press the Add button and select an option: you may add single or multiple files, entire folders, virtual folders and custom wild cards. Just select the appropriate action when you have just clicked the Add button:
Add Source Wildcard
Add Virtual Folder
For example, selecting "Add Wildcard" will open this window:
You can enter a path and specify which files should be added using a mask: in the situation shown on the screenshot only .html files from c: my documents heexample will be added.
Or you may rather add entire folders (including their sub-folders or not) using the "Add Folder" command.
When added files are not in the source folder or one of its children, you need to specify the application path (called virtual path) which should be used to access these files once they are compiled in the application. ExeOutput for PHP lets you determine these "virtual" directories thanks to the following window (which is automatically shown when adding files):
The real paths appear on the left; on the right you can determine the related virtual path (a.k.a application path).
By default, ExeOutput for PHP automatically tries to find the best virtual paths. But you can change this yourself: just select one or more files, then click "Modify Path". You will be prompted to enter the new virtual path and confirm your changes.
Once you have clicked OK, ExeOutput for PHP adds them to the application's file list and this is the result:
You can see that the virtual paths "moreinfo" and "headers" appear as children of the application Root, although the files that were added do not belong to the source folder.
This option is powerful because you can actually add files from any folder and determine virtual paths yourself. The main advantage is that you do not need to copy the different source files to the source folder first in order to have them be compiled.
ExeOutput for PHP supports drag/drop operations:
from Windows Explorer and other shell windows. Select all the files in the explorer, drag them onto the manager's file list and they are automatically added to the list. You can launch Windows Explorer by clicking the Explorer button. You can be prompted to enter the virtual path for the dropped files as explained above.
in the File Manager itself: you can move files from a virtual folder to another (thus their virtual paths can be changed the way you want). Highlight the file(s) you want to move in the list, then drag and drop them onto the destination folder in the Folder Tree. Note that real paths are not modified (source files are not physically moved).
To remove one or more files from the list, select it/them and press the Remove button.
You can select multiple files by pressing Ctrl+Click or Shift+Click. You may also use the Select All menu command from the context menu.
Finally, the Clear button lets you remove the entire folder currently selected in the Folder Tree. This includes all files and subfolders which are children of that selected folder. This operation cannot be undone, so be careful! It is also useful to remove empty folders.
you cannot remove the index page from the application.
you cannot clear the application root: use the Remove operation instead.
removing files does not delete files from your hard disk. This only "removes" files from the application.
ExeOutput for PHP displays information about each file: filename (or file path/virtual path), file type, size... If you need to sort your files according to a specific data (for example, file types), just click the associated column. You may also resize the different columns.
Generally source files need to be updated: you can add new files to the source folder, update existing ones or even remove non-used ones. In other words, the contents of the source folder may vary and consequently the file list kept by ExeOutput for PHP may be outdated.
You can therefore use the File List Update action. This action forces ExeOutput for PHP to scan the source folder (and its subfolders) and to detect all changes that happened. It then compares results and determines the appropriate actions to take:
if new files are found (not in the file lists), they are added. You can optionally be prompted to specify the new virtual paths (see the Environment Options).
if some source files are newer, ExeOutput for PHP updates its file lists.
if some source files are not found (you could have deleted them), they are removed from the file lists. You can also be prompted to confirm the operation (see the Environment Options).
You consequently do not need to manage the file lists yourself manually.
There are several ways to cause a File List update:
click the Update button in the File Manager.
configure automatic File List updates using the Environment Options (when a project is loaded, compiled; or enable source folder monitoring...).
You can manually indicate which subfolders should be excluded from the File List update by clicking "Exclude Folders" and adding full paths to the folders you want to exclude to the dedicated list. You can also exclude some files from being added to the file list based on their extension: go to the Environment Options.
Note: File List Update only takes account of files in the source folder (or subfolders)! If you have files from other folders, the operation will ignore them.
Select a file in the list and click the Edit button.
If the selected file is a PHP or HTML compatible page, then the internal PHP/HTML editor will be displayed.
Otherwise the program registered with the file will be opened to edit it (this is exactly as if you were double-clicking the file in Windows Explorer).
More information about the internal PHP/HTML editor
You can configure some options regarding compression, security for the source files (and even entire folders). Select a folder or file in the list and click the Properties button (or double-click it). The file properties editor will then be displayed.
More information about the file properties.
All of the previous commands are also available from the context menu: click the list with the mouse's right button to display it. It contains additional commands not directly available such as "Select All" or "File Information". The last command gives you global information about the application files of the selected folder (total size, number of files...). Finally the "Shell Properties" command will display the "Properties" dialog available in Windows Explorer (lets you access to the properties of the selected file).