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.