| 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 makepkg.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 |
|---|
