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.