[Sommaire] [Imprimer]

   1  <refentry id="{@id}"
   2            revision="$Id: PHPonTrax.pkg 199 2006-05-05 01:52:43Z haas $">
   3   <refnamediv>
   4    <refname>PHP On Trax</refname>
   5    <refpurpose>Rapid Application Development Made Easy</refpurpose>
   6   </refnamediv>
   7   <refsynopsisdiv>
   8    <author>
   9     Walt Haas
  10     <authorblurb>
  11      {@link mailto:haas@xmission.com haas@xmission.com}
  12     </authorblurb>
  13    </author>
  14   </refsynopsisdiv>
  15   {@toc}
  16   <refsect1 id="{@id welcome}">
  17    <title>Welcome To Trax!</title>
  18    <refsect2 id="{@id welcome-what}">
  19     <title>What Is Trax?</title>
  20     <para>Trax is an open source software package designed to speed the
  21      development of the type of web site that is built around a
  22      database.  Trax is a {@link http://www.php.net PHP} and 
  23      {@link http://httpd.apache.org Apache} port of
  24      {@link http://www.rubyonrails.org Ruby on Rails},
  25      which is well described in the book
  26      {@link http://www.pragmaticprogrammer.com/title/rails  Agile Web Development with Rails}.
  27     </para>
  28     <para>Trax uses the popular
  29      {@link http://en.wikipedia.org/wiki/Model-View-Controller Model-View-Controller}
  30      design pattern.  It helps you develop web sites faster by
  31      automating the common development steps, and by using naming
  32      conventions instead of explicit configuration.  This is done in a
  33      way that permits you to do further customization by hand where the
  34      standard Trax methods don't meet your needs.</para> 
  35    </refsect2>
  36    <refsect2 id="{@id welcome-who}">
  37     <title>Who Is Trax For?</title>
  38      <para>Trax is designed to be used by programmers who have a good
  39       working knowledge of
  40       {@link http://en.wikipedia.org/wiki/Object-oriented_programming object-oriented programming}
  41       in general and
  42       {@link http://www.php.net/manual/en/language.oop5.php PHP 5}
  43       in particular; of 
  44       {@link http://en.wikipedia.org/wiki/Relational_database_management_systems relational database management systems}
  45       and {@link http://en.wikipedia.org/wiki/SQL SQL}; and of
  46       {@link http://httpd.apache.org Apache server} configuration.
  47       Trax does not attempt to address the needs of unskilled users.
  48      </para>
  49    </refsect2>
  50    <refsect2 id="{@id welcome-platform}">
  51     <title>What Do I Need To Run Trax?</title>
  52      <para>Trax requires {@link http://www.php.net PHP} 5, the
  53      {@link http://httpd.apache.org/ Apache web server} and a relational 
  54      DBMS such as {@link http://www.mysql.com/ MySQL} or another DBMS
  55      supported by the
  56      {@link http://pear.php.net/package/DB PEAR DB class}.  Apache must 
  57      be configured to allow Trax to use
  58      {@link http://httpd.apache.org/docs/2.0/mod/mod_rewrite.html mod_rewrite}
  59      and to support PHP 5 with
  60      {@link http://www.php.net/manual/en/security.apache.php mod_php}.
  61      PHP 5 must also be available from the command line.</para>
  62  
  63      <para>To verify that PHP 5 is available from the command
  64       line, type:
  65       <example>
  66  $ <important>php --version</important>
  67  PHP 5.0.4 (cli) (built: Nov  8 2005 08:27:12)
  68  ...
  69       </example>
  70      The version must be at least 5.0.3</para>
  71  
  72      <para>To verify that PHP 5 is available as an Apache module,
  73       create the one-line program below and install it somewhere in the
  74       Apache document root:
  75       <example>
  76  &lt;?php phpinfo() ?&gt;
  77       </example>
  78       When you browse to this program, you will see a page that
  79       describes the Apache PHP installation (if any).</para>
  80    </refsect2>
  81    <refsect2 id="{@id welcome-how}">
  82     <title>How Do I Install Trax?</title>
  83      <para>Download the Trax
  84      {@link http://www.phpontrax.com/downloads/PHPonTrax-199svn.tgz PEAR-installable package}
  85      into a convenient working directory, then install it with the
  86      command:
  87       <example>
  88  $ <important>pear install -o PHPonTrax-</important><arg choice="tute-comment">release</arg><important>.tgz</important>
  89       </example>
  90      You will probably need to run this command as the superuser.  The
  91      <important>-o</important> switch tells PEAR to also load any
  92      required PEAR modules that are not already installed.  The
  93      <command>pear config-show</command> command will show you where
  94      your PEAR library is installed: 
  95       <example>
  96  $ <important>pear config-show</important>
  97  CONFIGURATION:
  98  ==============
  99  PEAR executables directory     bin_dir   ...
 100  PEAR documentation directory   doc_dir   ...
 101  PEAR directory                 php_dir   ...
 102  PEAR data directory            data_dir  ...
 103  PEAR test directory            test_dir  ...
 104  ...
 105       </example>
 106      </para>
 107      <para>Trax stores its documentation in
 108       <arg choice="tute-comment">doc_dir</arg>/PHPonTrax/doc/ in HTML.
 109       To read the documentation, browse to
 110       file://<arg choice="tute-comment">doc_dir</arg>/PHPonTrax/doc/index.html
 111      </para>
 112  
 113     <para>You should verify correct installation by changing to directory
 114      <arg choice="tute-comment">test_dir</arg>/PHPonTrax/test/ and
 115      running the command <command>php runtests.php</command>.  All
 116      tests should complete without failure.  Also verify that the
 117      <command>trax</command> command is available from the command line.</para>
 118  
 119     <para>If PHP was installed on your system without PEAR, 
 120      {@link http://pear.php.net/manual/en/installation.getting.php install it}.
 121     </para>
 122  
 123     <para>If you are installing Trax on a shared host where you do not
 124      have authorization to install in the system PEAR module library,
 125      the best approach is to build a
 126      {@link http://pear.php.net/manual/en/installation.shared.php local PEAR copy}
 127      and install Trax there.</para>
 128    </refsect2>
 129   </refsect1>
 130  
 131  <!--
 132  Local variables:
 133  mode: xml
 134  c-basic-offset: 1
 135  indent-tabs-mode: nil
 136  End:
 137  -->
 138  </refentry>