====== PEAR ======

  * [[PHP]]

  * [[http://pear.php.net/go-pear.phar|Download PEAR]]

PEAR is a collection of modules that make life easier.

==== Installation ====

Use ''pear install <pkg>'' to install PEAR modules.  Don't use Gentoo's portage.

If you need to install a program that has PEAR dependencies from portage, and it's installed locally through pear, then you can add the atom for the dependency to the ''package.provided'' file in ''/etc/portage/profile''.  See [[http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=5|this doc]] for technical details.

==== Modules ====

<code>
Archive_Tar
Auth_SASL
Console_Color
Console_Getopt
Console_Table
Crypt_HMAC
DB
DB_DataObject
DB_Table
Date
File
HTML_Common
HTML_QuickForm
HTML_Table
HTML_TreeMenu
HTTP_Request
Log
MDB
MDB2
MDB2_Driver_mssql
Mail
Mail_Mime
Mail_mimeDecode
Net_DIME
Net_FTP
Net_IDNA
Net_SMTP
Net_Socket
Net_URL
Net_URL_Mapper
OLE
PEAR
PHPUnit
PHP_CodeSniffer
PHP_Compat
Pager
PhpDocumentor
SOAP
Spreadsheet_Excel_Writer
Structures_DataGrid
Structures_DataGrid_DataSource_Array
Structures_DataGrid_DataSource_CSV
Structures_DataGrid_DataSource_DB
Structures_DataGrid_DataSource_DBQuery
Structures_DataGrid_DataSource_DBTable
Structures_DataGrid_DataSource_DataObject
Structures_DataGrid_DataSource_MDB2
Structures_DataGrid_DataSource_PDO
Structures_DataGrid_DataSource_RSS
Structures_DataGrid_DataSource_XML
Structures_DataGrid_Renderer_CSV
Structures_DataGrid_Renderer_Console
Structures_DataGrid_Renderer_HTMLSortForm
Structures_DataGrid_Renderer_HTMLTable
Structures_DataGrid_Renderer_Pager
Structures_DataGrid_Renderer_Smarty
Structures_DataGrid_Renderer_XLS
Structures_DataGrid_Renderer_XML
Structures_DataGrid_Renderer_XUL
Structures_Graph
Validate
Validate_Finance_CreditCard
Var_Dump
XML_Parser
XML_RSS
XML_Util
</code>

==== Configuration ====

<code>

CONFIGURATION (CHANNEL PEAR.PHP.NET):
=====================================
Auto-discover new Channels     auto_discover    <not set>
Default Channel                default_channel  pear.php.net
HTTP Proxy Server Address      http_proxy       <not set>
PEAR server [DEPRECATED]       master_server    pear.php.net
Default Channel Mirror         preferred_mirror pear.php.net
Remote Configuration File      remote_config    <not set>
PEAR executables directory     bin_dir          /usr/bin
PEAR documentation directory   doc_dir          /usr/share/php/docs
PHP extension directory        ext_dir          /usr/lib64/php5.3/lib/extensions/no-debug-zts-20090626
PEAR directory                 php_dir          /usr/share/php
PEAR Installer cache directory cache_dir        /tmp/pear/cache
PEAR configuration file        cfg_dir          /usr/share/php/cfg
directory
PEAR data directory            data_dir         /usr/share/php/data
PEAR Installer download        download_dir     /tmp/pear/install
directory
PHP CLI/CGI binary             php_bin          /usr/lib64/php5.3/bin/php
php.ini location               php_ini          <not set>
--program-prefix passed to     php_prefix       <not set>
PHP's ./configure
--program-suffix passed to     php_suffix       <not set>
PHP's ./configure
PEAR Installer temp directory  temp_dir         /tmp/pear/install
PEAR test directory            test_dir         /usr/share/php/tests
PEAR www files directory       www_dir          /usr/share/php/www
Cache TimeToLive               cache_ttl        3600
Preferred Package State        preferred_state  stable
Unix file mask                 umask            22
Debug Log Level                verbose          1
PEAR password (for             password         <not set>
maintainers)
Signature Handling Program     sig_bin          /usr/bin/gpg
Signature Key Directory        sig_keydir       /etc/pearkeys
Signature Key Id               sig_keyid        <not set>
Package Signature Type         sig_type         gpg
PEAR username (for             username         <not set>
maintainers)
User Configuration File        Filename         /root/.pearrc
System Configuration File      Filename         /etc/pear.conf
</code>

==== Setup ====

When installing using ''go-pear.phar'', change option 1 to ''/usr'' and the other defaults will be fine.  The goal is to have PEAR installed in ''/usr/share/pear''

<code>
 1. Installation base ($prefix)                   : /usr
 2. Temporary directory for processing            : /tmp/pear/install
 3. Temporary directory for downloads             : /tmp/pear/install
 4. Binaries directory                            : /usr/bin
 5. PHP code directory ($php_dir)                 : /usr/share/pear
 6. Documentation directory                       : /usr/docs
 7. Data directory                                : /usr/data
 8. User-modifiable configuration files directory : /usr/share/pear/cfg
 9. Public Web Files directory                    : /usr/www
10. Tests directory                               : /usr/tests
11. Name of configuration file                    : /etc/pear.conf
</code>