Work in progress integrating IP audit info in reports.
[timetracker.git] / 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!