Application Root

Note that file folders are relative to application root. This enables the user to put the files in folder outside of the script folder.

Where is the application root? PHP Report Maker scripts looks for the application root in the following sequence:

 

1. Root Relative Path

Root Relative Path is the path relative to destination folder. The destination folder is the folder where the generated scripts reside.

When you generate scripts, you must specify the [Application root folder] and the [Destination folder] correctly based on your folder structure. The relative folder structure on your local computer must be the same as that on your production server.

For example, if you put the generated scripts in a subfolder,

In this case, the Root Relative Path is therefore the parent folder of the script, i.e. "..". The scripts will use this relative path to find the application root.

It is recomended that you set the [Application root folder] to the root folder of your Website where is accessed by http://www.mycompany.com/.

On your testing server, you may work with multiple projects and test your projects one folder level lower at http://localhost/<projectname>/ (cf. http://<projectname>/). In this case you should set the [Application root folder] in each project as the root folder of the project (the folder that is accessed by http://localhost/<projectname>/). After uploading to the production server, the site may be then accessed by http://www.mycompany.com/ (cf. http://localhost/<projectname>/), but as long as the relative location of the two folders (Application Root folder and the script folder) are the same, the scripts will still work properly.

 

2. Custom Path

The above three approaches should handle most cases. If in some special cases they don't return the path you want, you can modify the function ewr_AppRoot() in phprptfn.php (template) or ewrfn*.php (generated script). You can simply customize the template and specify your real server path directly. For example,

Windows:

function ewr_AppRoot() {
    return 'C:\Inetpub\wwwroot\MyWebRoot\'; // replace with your real server path directly, include the trailing path delimiter   
}

Linux/Unix:

function ewr_AppRoot() {
    return '/home/username/public_html/';
// replace with your real server path directly, include the trailing path delimiter   
}

Remember that you must also check the value of the constant $EWR_ROOT_RELATIVE_PATH, make sure it correctly points to your application folder relative to the script folder. Using above example, you specify that the application root is "C:\Inetpub\wwwroot\MyWebRoot", if your scripts are placed in "C:\Inetpub\wwwroot\MyWebRoot\MyScripts\", then $EWR_ROOT_RELATIVE_PATH should be "..".

TIP: You can call the PHP function phpinfo() (i.e. <?php phpinfo(); ?>) to view your server information, including the server paths. Alternatively, in the generated scripts (that includes phpfn<version>.php), you can call the function ewr_WritePaths() (i.e. <?php echo ewr_WritePaths(); ?>) to view the path settings in your project.

 



 ©2007-2017 e.World Technology Ltd. All rights reserved.