The system configuration file is always saved in a file named .config in the base of the PEAR installation. Thus, if php files are installed in /usr/local/lib/pear/php, then the configuration for that installation is installed in /usr/local/lib/pear/.config. The configuration is stored in XML format, and can be modified by hand if necessary.
The configuration will not be saved if no values are modified from the default values
Here is a sample system configuration file (with line breaks added for readability):
<?xml version="1.0"?> <pearconfig version="1.0"> <ext_dir>/usr/local/lib/php/extensions/debug-non-zts-20090115</ext_dir> <cfg_dir>/home/user/testpear/cfg</cfg_dir> <doc_dir>/home/user/testpear/mydata</doc_dir> <bin_dir>/usr/local/bin</bin_dir> <www_dir>/home/user/testpear/www</www_dir> <test_dir>/home/user/testpear/tests</test_dir> <src_dir>/home/user/testpear/src</src_dir> <php_bin>/usr/local/bin/php</php_bin> <php_ini>/usr/local/lib/php.ini</php_ini> <php_prefix></php_prefix> <php_suffix></php_suffix> </pearconfig>
executable files (files with a script role) are installed into bin_dir
Customizable configuration files (files with cfg role) are installed into this directory. These files are intended to be manipulated by the user, and Pyrus will not overwrite them if any changes have been made.
Files with roles data, customcommand, customrole and customtask are installed into the data_dir configuration variable.
In Pyrus, this is a pseudo-configuration variable: its value cannot be changed without creating an entirely new repository. Data is always stored in the directory data/ relative to the location of the installation.
files with the doc role are installed into doc_dir.
Compiled extension files are installed into the ext_dir, and files with role ext.
the php_bin configuration variable refers to the location of PHP that should be used for installed executable scripts.
Files with roles php are installed into the php_dir configuration variable.
In Pyrus, this is a pseudo-configuration variable: its value cannot be changed without creating an entirely new repository. PHP files are always stored in the directory php/ relative to the location of the installation.
the php_ini variable should be set to the location of php.ini that is used by this installation, and is used to automatically enable extensions on installation.
This variable should be set to the value that --program-prefix was set to when PHP was configured, and is used when building PECL extensions.
This variable should be set to the value that --program-suffix was set to when PHP was configured, and is used when building PECL extensions.
Files with the src role are installed into src_dir, and building of PECL packages also happens in this directory.
Files with test role are installed into this directory.
Files with www role are installed into this directory.