Pyrus system configuration variables
Introduction
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>
bin_dir
Introduction
executable files (files with a script role) are installed
into bin_dir
cfg_dir
Introduction
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.
data_dir
Introduction
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.
doc_dir
Introduction
files with the doc role are installed into
doc_dir.
ext_dir
Introduction
Compiled extension files are installed into the ext_dir,
and files with role ext.
php_bin
Introduction
the php_bin configuration variable refers to the location
of PHP that should be used for installed executable scripts.
php_dir
Introduction
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.
php_ini
Introduction
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.
php_prefix
Introduction
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.
php_suffix
Introduction
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.
src_dir
Introduction
Files with the src role are installed into
src_dir, and building of PECL packages
also happens in this directory.
test_dir
Introduction
Files with test role are installed into this directory.
www_dir
Introduction
Files with www role are installed into this directory.