Recipe 26.4. Installing PEAR Packages

26.4.1. Problem

You want to install a PEAR package.

26.4.2. Solution

Download and install the package from the appropriate PEAR Channel server using the PEAR installer:

% pear install Package_Name

You can also install from another PEAR Channel:

% pear install channel/Package_Name

You can also install from any location on the Internet:

% pear install

Here's how to install if you have a local copy of a package:

% pear install Package_Name-1.0.0.tgz

26.4.3. Discussion

To install PEAR packages, you need write permission where the packages are stored; this defaults to /usr/local/lib/php/.

You can also request multiple packages at the same time:

% pear install XML_Parser XML_Tree downloading XML_Parser-1.2.7.tgz ... Starting to download XML_Parser-1.2.7.tgz (12,939 bytes) .....done: 12,939 bytes downloading XML_Tree-1.1.tgz ... Starting to download XML_Tree-1.1.tgz (4,826 bytes) ...done: 4,826 bytes install ok: channel:// install ok: channel://

When installing a package, PEAR checks that you have all the necessary PHP functions and PEAR packages that the new package depends on. If this check fails, PEAR reports on the dependencies:

% pear install MDB2_Driver_Mysql  install MDB2_Driver_Mysql Did not download dependencies: pear/MDB2, use --alldeps or --onlyreqdeps to download automatically pear/MDB2_Driver_mysql requires package "pear/MDB2" (version >= 2.0.1) No valid packages found install failed

As you can see from the error message, the PEAR installer made no attempt to download dependencies. This default behavior puts you in control by not assuming that you want to install or upgrade the related dependencies. The most convenient install command switch is -o, which is the shortcut for --onlyreqdeps, which installs all required dependencies.

Using the -o switch, the installation is now successful:

% pear install -o MDB2_Driver_Mysql downloading MDB2_Driver_mysql-1.0.1.tgz ... Starting to download MDB2_Driver_mysql-1.0.1.tgz (22,240 bytes) ........done: 22,240 bytes downloading MDB2-2.0.1.tgz ... Starting to download MDB2-2.0.1.tgz (91,219 bytes) ...done: 91,219 bytes install ok: channel:// install ok: channel://

If you want to ignore the required dependencies, you can use the -n or --nodeps switches to tell the installer to ignore dependencies and install anyway.

26.4.4. See Also

26.7 for information on installing PECL packages; Recipe 26.5 for more on upgrading an existing package; Recipe 26.6 to uninstall a package.

PHP Cookbook, 2nd Edition
PHP Cookbook: Solutions and Examples for PHP Programmers
ISBN: 0596101015
EAN: 2147483647
Year: 2006
Pages: 445

Similar book on Amazon © 2008-2017.
If you may any questions please contact us: