doc:phd:install

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
doc:phd:install [2008/03/13 08:47]
bjori Fix instructions
doc:phd:install [2017/09/22 13:28] (current)
Line 1: Line 1:
 ===== Installing PhD ===== ===== Installing PhD =====
 +The preferred method is using the pear channel, but all methods are documented below.
  
 +==== Using the PEAR Channel ====
 +At the time of this writing the latest version of PhD is in beta so the -beta tag is used below.
 +PhD is chunked into multiple sub-packages (currently "Generic", "PHP" and "PEAR"), the Generic package is installed by default.
  
-==== Using PEAR ====+To install just the PhD core and the Generic package, type:
 <code> <code>
-bjori@lindsay:~$ pear install http://doc.php.net/phd/PhD-0.2.2.tgz +$ pear install doc.php.net/PhD
-downloading PhD-0.2.2.tgz ... +
-Starting to download PhD-0.2.2.tgz (26,418 bytes) +
-.........done: 26,418 bytes +
-install ok: channel://__uri/PhD-0.2.2 +
-bjori@lindsay:~$ mkdir build && cd build +
-bjori@lindsay:~/build$ phd -d /path/to/phpdoc/.manual.xml+
 </code> </code>
 +And for upgrading:
 +<code>
 +$ pear upgrade doc.php.net/PhD
 +</code>
 +If by chance you already installed PhD by other means then be sure to uninstall that version first.
  
-==== Using CVS ==== +To list all available packages:
-Getting the code:+
 <code> <code>
-cvs -d:pserver:cvsread@cvs.php.net/repository co phd+pear remote-list -c doc.php.net 
 +</code> 
 +and to install optional packages: 
 +<code> 
 +$ pear install doc.php.net/PhD_PHP 
 +$ pear install doc.php.net/PhD_IDE
 </code> </code>
  
-Install and run from CVS:+Note that since the optional packages depend on the PhD core package they will pull down and automatically install the required packages if missing. That means it enough to simply write: 
 +<code> 
 +$ pear install doc.php.net/PhD_PHP 
 +</code> 
 +to install everything that is required. 
 + 
 +==== Using PEAR directly ==== 
 +Installing by using a specific tarball is possible too, but is not recommended. 
 +<code> 
 +$ pear install http://doc.php.net/get/PhD-1.1.0.tgz 
 +</code> 
 +==== Using GIT ==== 
 +NOTE: Using PhD from GIT is not recommended. 
 + 
 + 
 +Getting the code (anonymous checkout): 
 +<code> 
 +$ git clone git://git.php.net/phd.git 
 +</code> 
 +For developers: 
 +<code> 
 +$ git clone git@git.php.net:/phd.git 
 +</code> 
 + 
 + 
 +Install and run from GIT. There are several package_*.xml files, but in the very least you'll need:
 <code> <code>
 $ cd phd $ cd phd
-$ pear install -f package.xml +$ pear install package.xml package_generic.xml
-$ phd -d/path/to/phpdoc/.manual.xml+
 </code> </code>
  
-Alternately you can (although not recommended) run PhD directly from CVS, without needing to install it:+To then install the "PHP" package (needed to render the PHP documentations): 
 +<code> 
 +$ pear install package_php.xml 
 +</code> 
 + 
 +Alternately you can run PhD directly from GIT, without needing to install it. The same holds true if using the tarball, because all the phd command really does is execute "php render.php" so:
 <code> <code>
 $ cd phd $ cd phd
-$ php build.php -d/path/to/phpdoc/.manual.xml+$ php render.php --docbook /path/to/phpdoc/.manual.xml
 </code> </code>
  
 +
 +Now go on and read the [[http://doc.php.net/phd/docs/|PhD Documentation]]
doc/phd/install.1205398054.txt.gz · Last modified: 2017/09/22 13:28 (external edit)