Project structure

With PHPRunner, you can save all your settings in a single project file and do not have to go through individual files if you simply need to change a single label or field format.

Each project in PHPRunner saves to its own directory, which contains the following subdirectories:

tmp\backup directory stores backup copies of your project. Project backup name (i.e. Project4.2011-11-09 10_08_00.w.zip) contains date and time of when backup was created.

The Default directory for a new project is C:\Users\<username>\Documents\PHPRunnerProjects\project_name. The Project file will be saved in the project directory as project_name.phpr.

When you open a project created with PHPRunner 4.x or older, you are prompted to choose a project directory. After you select a directory, your project file is copied to it. Then the next time you open your project it will be from the folder you selected, not from the original location.

If you upload files to the Web server using third party FTP client software, you must upload the entire contents of the output directory.

When you make a backup of your project, you should include all files in the project directory together with all subdirectories. At a minimum, you should backup the project file itself along with all files in the visual directory.

Click the Project button and select from the drop down list to open an existing project or to save the current one.

Creating new project

When you create a new project you have two options:

For more information about templates that are shipped with PHPRunner, see What are templates.

Opening an existing project

To open existing project or save a current one, click the Project button any time.

Saving a project

If you want to save the current project under a different name - for example, development purposes or to create a backup - select the Save Project As option. A new project directory will be created and all necessary project files will be copied to it.

Note: PHPRunner creates a new project automatically upon startup.

Saving your project as a Template

You can save your project as a template.

In this case, your database along with your project file and all files you have edited with the visual editor will be saved.

Note: 'Save Project As Template' option is available for MySql projects.

While saving Project As Template you need to type in the template name you wish your project to be saved under. The template will be saved in the Business Templates Directory (by default in C:\Users\<username>\Documents\PHPRunnerTemplats\project_name).

Note: After your template is saved, you can add files that are not generated by PHPRunner to the template directory.

After that saved Template will be available on the list of templates when you create a new project.

You can also add a thumbnail image to the template that will be displayed on templates list. Place an image named preview.gif (JPG and PNG formats are supported also) to template folder. Image size should be 130x97.

Add template to project

You can create new project using two templates or add a template to existing project. To avoid replacing template tables with existing all PHPRunner business templates (tables and files) have prefix.

If you have added several templates to the project you can choose one to inherit security settings from in Security template dropdown box.

Project settings

Use the option Create human-readable labels for the database fields to convert field names into the more human readable format. For example, if this option is enabled, the field name id will be displayed as Id, last_name as Last Name, FirstName as First Name etc.

Use the option Synchronize the database on each project load to enable/disable automatic database synchronization. We recommend to use this option for small or local databases. For more information about database synchronization, see Datasource tables: Synchronize database.

To increase or decrease the files upload speed, change the number of FTP upload connections.