WEB-INF/lib/pear/INSTALL

   1 PEAR - The PEAR Installer
   2 =========================
   3 Installing the PEAR Installer.
   4
   5 You should install PEAR on a local development machine first.  Installing
   6 PEAR on a remote production machine should only be done after you are
   7 familiar with PEAR and have tested code using PEAR on your development
   8 machine.
   9
  10 There are two methods of installing PEAR
  11  - PEAR bundled in PHP
  12  - go-pear
  13
  14 We will first examine how to install PEAR that is bundled with PHP.
  15
  16 Microsoft Windows
  17 =================
  18 If you are running PHP 5.2.0 or newer, simply download and
  19 run the windows installer (.msi) and PEAR can be automatically
  20 installed.
  21
  22 Otherwise, for older PHP versions, download the .zip of windows,
  23 there is a script included with your PHP distribution that is called
  24 "go-pear".  You must open a command box in order to run it.  Click
  25 "start" then click "Run..." and type "cmd.exe" to open a command box.
  26 Use "cd" to change directory to the location of PHP where you unzipped it,
  27 and run the go-pear command.
  28
  29 Unix
  30 ====
  31 When compiling PHP from source, you simply need to include the
  32 --with-pear directive on the "./configure" command.  This is "on"
  33 by default in most PHP versions, but it doesn't hurt to list it
  34 explicitly.  You should also consider enabling the zlib extension via
  35 --enable-zlib, so that the PEAR installer will be able to handle gzipped
  36 files (i.e. smaller package files for faster downloads).  Later, when you
  37 run "make install" to install PHP itself, part of the process will be
  38 prompts that ask you where you want PEAR to be installed.
  39
  40 go-pear
  41 =======
  42 For users who cannot perform the above steps, or who wish to obtain the
  43 latest PEAR with a slightly higher risk of failure, use go-pear.  go-pear
  44 is obtained by downloading http://pear.php.net/go-pear and saving it as go-pear.php.
  45 After downloading, simply run "php go-pear.php" or open it in a web browser
  46 (windows only) to download and install PEAR.
  47
  48 You can always ask general installation questions on pear-general@lists.php.net,
  49 a public mailing list devoted to support for PEAR packages and installation-
  50 related issues.
  51
  52 Happy PHPing, we hope PEAR will be a great tool for your development work!