JavaScript Editor Javascript validator     Web page editor 

Configuring your PEAR setup

PEAR has a number of configuration options that you can change. Getting an overview about them is as easy as issuing a

$ pear config-show

The default settings suffice for novice users, there is rarely a need to change them when getting started. You can go on with installing packages.

Reading single values is accomplished by using config-get. The following command will show you where all the .php files of your installed pear packages reside.

$ pear config-get php_dir

Changing a value is as easy as retrieving it:

$ pear config-set preferred_state beta
config-set succeeded

Note: When changing a config setting, it does not immediately get applied to already installed packages. This is especially true when changing variables like data_dir. Use $ pear upgrade --force to reinstall all packages in such cases.

Config options

Variable NameDescriptionDefault Value
bin_dirDirectory where executables are installed/usr/bin
doc_dirDirectory where documentation is installed/usr/lib/php/docs
ext_dirDirectory where loadable extensions are installed./
php_dirDirectory where PHP files are installed (like PEAR files)/usr/lib/php
cache_dirPEAR installer cache directory, and used by XMLRPC/tmp/pear/cache
data_dirDirectory where data files are installed/usr/lib/php/data
php_binThe PHP CLI or CGI binary for executing scripts/usr/bin/php
test_dirDirectory where regression tests are installed/usr/lib/php/tests
cache_ttkNumber of seconds that the local cache is used, and not updated (Time To Kill)3600
preferred_statePreferred package state: stable, beta, alpha, devel, or snapshotstable
umaskumask used when creating files (Unix-like systems only)22
verboseDebug log level: 0-3 where 3 is full debug mode.1
http_proxyThe optional HTTP proxy address (host:port) used when downloading packages 
remote_configRemote configuration file, used to mirror a local installation on a remote server through ftp. (PEAR 1.4+) 
auto_discoverAuto-discover new channels from command line or dependencies0
default_channelDefault channel (PEAR 1.4+) ( if using the pecl command)
preferred_mirrorPreferred channel mirror (PEAR 1.4+) ( if using the pecl command)
master_serverPEAR server [deprecated in PEAR 1.4+]
passwordPEAR password (used by maintainers) 
sig_binSignature handling program/sw/bin/gpg
sig_keydirSignature key directory/etc/pearkeys
sig_keyidThe key used for signing 
sig_typePackage signature type (only gpg)gpg
usernamePEAR username (used by maintainers) 

JavaScript Editor Javascript validator     Web page editor