| 1 |
== Welcome to Trax |
|---|
| 2 |
|
|---|
| 3 |
Trax is a web-application and persistance framework that includes everything |
|---|
| 4 |
needed to create database-backed web-applications according to the |
|---|
| 5 |
Model-View-Control pattern of separation. This pattern splits the view (also |
|---|
| 6 |
called the presentation) into "dumb" templates that are primarily responsible |
|---|
| 7 |
for inserting pre-build data in between HTML tags. The model contains the |
|---|
| 8 |
"smart" domain objects (such as Account, Product, Person, Post) that holds all |
|---|
| 9 |
the business logic and knows how to persist themselves to a database. The |
|---|
| 10 |
controller handles the incoming requests (such as Save New Account, Update |
|---|
| 11 |
Product, Show Post) by manipulating the model and directing data to the view. |
|---|
| 12 |
|
|---|
| 13 |
In Trax, the model is handled by what's called a object-relational mapping |
|---|
| 14 |
layer entitled Active Record. This layer allows you to present the data from |
|---|
| 15 |
database rows as objects and embellish these data objects with business logic |
|---|
| 16 |
methods. |
|---|
| 17 |
|
|---|
| 18 |
The controller and view is handled by the Action Controller |
|---|
| 19 |
|
|---|
| 20 |
== Requirements |
|---|
| 21 |
|
|---|
| 22 |
* Database (MySQL, PostgreSQL, etc) (uses Pear::MDB2) |
|---|
| 23 |
* PHP 5.x |
|---|
| 24 |
* PEAR::MDB2, PEAR::Mail, PEAR::Mail_mime |
|---|
| 25 |
* Apache 1.3.x or 2.x |
|---|
| 26 |
* FreeBSD, Unix, Linux, MacOSX, Windows |
|---|
| 27 |
|
|---|
| 28 |
== Building & Installing PHPonTrax PEAR Module |
|---|
| 29 |
From the commandline run the following command: |
|---|
| 30 |
php make-pkg.php |
|---|
| 31 |
(Disregard any warning messages that say "not prefixed with package name "PHPonTrax"") |
|---|
| 32 |
After that runs it will make a build folder with the PEAR module called: |
|---|
| 33 |
PHPonTrax-<version>.tgz |
|---|
| 34 |
To install this newly generated PEAR module run the following command: |
|---|
| 35 |
pear install -a PHPonTrax-<version>.tgz |
|---|
| 36 |
If you have a previously installed version exists first run: |
|---|
| 37 |
pear uninstall trax/PHPonTrax |
|---|
| 38 |
|
|---|
| 39 |
== Getting Started |
|---|
| 40 |
http://wiki.phpontrax.com/How_do_I_install/upgrade_Trax%3F |
|---|
| 41 |
http://wiki.phpontrax.com/How_do_I_create_a_Trax_application%3F |
|---|
| 42 |
http://wiki.phpontrax.com/How_Tos |
|---|
