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