PRADO is a component-based and event-driven Web programming framework for PHP 5. A PRADO component represents a combination of a PHP class, an HTML template and a specification file (in XML). PRADO components are combined to form larger components or form complete PRADO pages.
Developing PRADO Web applications involves instantiating pre-built and application-specific component types, configuring them by setting their properties, responding to their events by writing handler functions, and composing them into application tasks.
PRADO provides the following benefits to Web application developers:
- Reusability: Code that follows the PRADO component protocol is highly reusable. Everything in PRADO is a reusable component.
- Ease of use: Creating and using components are extremely easy. Usually they simply involve configuring component properties.
- Robustness: PRADO frees developers from writing boring, buggy code. They can code in terms of objects, methods and properties instead of URLs and query parameters. By exploiting the latest PHP5 exception mechanism, PRADO enables line-precise error reporting.
- Performance: PRADO uses a cache technique to ensure the performance of applications based on it. A PRADO-based application’s performance is in fact comparable to that of applications based on common template engines.
- Team integration: PRADO enables the separation of content and presentation. Components, typically pages, have their content (logic) and presentation stored in different files.
This article walks through the initial files and directories you will encounter when first using PRADO in your Web development.
Download and Install PRADO
You can download PRADO from the official website. You will also find very useful documentation in the documentation section.
Installing PRADO is very easy; all you need to do is unpack the PRADO release file to the
prado
subdirectory under the DocumentRoot
of the Web server. With that, your installation of PRADO is done and you can start to play with the demo applications included in the PRADO release via the URL http://web-server-address/prado/demos/
. When you access the
http://hostname/blog/index.php
URL, you should see a web page showing “Welcome to PRADO”. Intial Files for PRADO Development
The sections to follow discuss the intial files for PRADO Web application development.
The Entry Script
Every PRADO application has an entry script, often named
index.php
. In most applications index.php
is the only PHP script that can be directly accessed by Web users. The main scope of the entry script is to initialize the PRADO application and have it handle user requests. A basic entry script can contain the following PHP statements:
<?php
// include prado.php which contains basic PRADO classes
require_once('path/to/prado.php');
// create a PRADO application instance
$application = new TApplication;
// run the application and handle user requests
$application->run();
?>
Homepage
The homepage (
Home.page
) is the only page created by the PRADO command-line tool. The content of this file appears in the browser when you access the http://hostname/blog/index.php
URL. The content of Home.page
uses the PRADO template format, which is like HTML enhanced with a few PRADO-specific tags.The following are two examples of
Home.page
files, one containing pure HTML content and the other containing some basic PRADO components:- Example 1:
Home.page
<html> <head> <title>Welcome to PRADO</title> </head> <body> <h1>Welcome to PRADO!</h1> </body> </html>
- Example 2:
Home.page
<com:TForm> <fieldset><legend>Login</legend> <label>Username: </label> <com:TTextBox ID="username"/> <br /> <label>Password: </label> <com:TTextBox ID="password" TextMode="Password" /> <br /> <com:TButton Text="Login" OnClick="buttonClicked" /> </com:TForm>
Application Configuration
You can set PRADO application configuration in the optional XML file
application.xml
. This file’s purpose is allow you to customize in a configurable fashion the application instance created in the entry script. For example, you may enable the logging feature for your blog system with the help of application configuration.Here is an example of an
application.xml
file:
<?xml version="1.0" encoding="utf-8"?>
<application id="personal" mode="Normal">
<paths>
<using namespace="Application.Common.*" />
</paths>
<!-- modules configured and loaded for all services -->
<modules>
<!-- Remove this comment mark to enable logging
<module id="log" class="System.Util.TLogRouter">
<route class="TBrowserLogRoute" Categories="System" />
<route class="TFileLogRoute" Categories="System"
Levels="Notice,Warning,Error,Alert,Fatal" />
</module>
-->
</modules>
<services>
<!-- page service -->
<service id="page" class="TPageService" BasePath="Application.Pages">
<!-- modules configured and loaded when page service is requested -->
<modules>
<!-- user manager module -->
<module id="users" class="System.Security.TUserManager"
PasswordMode="Clear">
<user name="demo" password="demo" />
</module>
<!-- auth manager module -->
<module id="auth" class="System.Security.TAuthManager"
UserManager="users" LoginPage="UserLogin" />
</modules>
</service>
</services>
</application>