Upgrade guide from PHPRunner 3.0 (ASPRunnerPro 4.0) and older

Overview

This article will be helpful if you upgrade to the latest version from PHPRunner 3.0 (ASPRunnerPro 4.0) and older.

PHPRunner 3.1 (ASPRunnerPro 4.1) comes with WYSIWYG editor. To enable drag-n-drop editing of generated pages HTML part was separated from the code. Each page now consists of .htm file (visual template) which defines appearance of the page and .php (.asp) file that provides page functionality.

PHPRunner uses Smarty template engine for this purpose. To get more information about Smarty templates please visit: http://smarty.php.net

ASPRunnerPro uses very basic template engine that was written from scratch for this project. It uses syntax similar to original Smarty syntax.

Project structure has changed

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

1. visual - Contains modified visual templates.
2. tmp - Temporary storage of visual templates.
3. output - Directory with output files. Can be changed on Output directory step to point to any other directory.

Default directory for a new project is PHPRunner/projects/project_name. Project file will be saved under project directory as project_name.phpr.

When you open projects created with previous versions of PHPRunner you are prompted to choose project directory. After you select a directory your project file is copied there. Next time open your project from the folder you selected, not from the original location.

If you upload files to the Web server using third party FTP client you need to upload the whole content of the output directory.

When you make a backup of your project you may backup the whole project directory with subdirectories. As a minimum backup the project file itself along with visual directory.

Save Project As option appears. If you want to save current project as other one for development purposes or to create a backup, for example, you should choose Save Project As option. In this case new project directory with project file and all necessary files will be created.

No hidden fields

In new version we recommend to use readonly fields with default values or assign default values via events. Here is the sample code for Before record added event.

PHPRunner example function BeforeAdd(&$values) { // Parameters: // $values - Array object. // Each field on the Add form represented as 'Field name'-'Field value' pair $values["Field1"]="default value for Field1"; $values["UpdatedDate"]=now(); $values["UpdatedBy"]=$_SESSION["UserID"]; return true; // return true if you like to proceed with adding new record // return false in other case }

ASPRunner example Function BeforeAdd(dict) ' Parameters: ' dict - Scripting.Dictionary object. ' Each field on the Add form represented as 'Field name'-'Field value' pair dict("Field1") = "default value for Field1" dict("UpdatedDate") = dbvalue(now()) dict("UpdatedBy") = SESSION("UserID") BeforeAdd = True ' set BeforeAdd to True if you like to proceed with adding new record ' set it to False in other case End Function

There are no arguments in OnLoad events

OnLoad event handlers don't have parameters anymore. The events code is converted automatically when you open old project.

Events - $values[ ] array data don't contain quotes (PHPRunner only)

You don't need to remove quotes when using $values data. However you need to add them when using $values data in your custom SQL commands, i.e. you don't need to remove or add quotes here:

echo $values["FirstName"]; $values["LastName"]="Johnson";

But must add them here:

$strSQL = "select * from users where username='".$values["Username"]."'";

Template editor is gone

In new version there is no template editor anymore. It was replaced by WYSIWYG visual editor.

Custom templates created in older versions

You cannot use custom templates created in older versions of ASPRunnerPro/PHPRunner

Supertop, superbottom files names are changed (PHPRunner only)

In PHPRunner 3.1 supertop.php and superbottom.php files are correspondingly named header.php and footer.php. Files still need to reside in include directory.

Old URL of search results won't work

Now to obtain new search URLs you should run search once again and copy URL from browser's address box.

Passing master key value to another page

Obtaining the current master table key value.

PHPRunner example //Use: $_SESSION[strTableName & "_masterkey1"] //Instead of: $_SESSION[strTableName & "_masterkey"]

ASPRunner example 'Use SESSION(strTableName & "_masterkey1") 'instead of: GetRequestForm("masterkey")

Permissions on templates_c directory (PHPRunner only)

Smarty engine requires templates_c directory in the output directory to be writable by web server user.

Back to top