Gentoo Development Guide

↑ Eclass Reference ↑

PHP-EXT-SOURCE-R2.ECLASS

Section: portage (5)
Updated: May 2013
Index Return to Main Contents

NAME

php-ext-source-r2.eclass - A unified interface for compiling and installing standalone PHP extensions.

DESCRIPTION

This eclass provides a unified interface for compiling and installing standalone PHP extensions (modules).

FUNCTIONS

php-ext-source-r2_src_unpack

runs standard src_unpack + _phpize

PHP_EXT_SKIP_PHPIZE

phpize will be run by default for all ebuilds that use php-ext-source-r2_src_unpack Set PHP_EXT_SKIP_PHPIZE="yes" in your ebuild if you do not want to run phpize.

php-ext-source-r2_phpize

Runs phpize and autotools in addition to the standard src_unpack

php-ext-source-r2_src_configure

Takes care of standard configure for PHP extensions (modules).

my_conf

Set this in the ebuild to pass configure options to econf.

php-ext-source-r2_src_compile

Takes care of standard compile for PHP extensions (modules).

php-ext-source-r2_src_install

Takes care of standard install for PHP extensions (modules).

DOCS

Set in ebuild if you wish to install additional, package-specific documentation.

php-ext-source-r2_createinifiles

Builds ini files for every enabled slot and SAPI

php-ext-source-r2_addtoinifiles <setting name> <setting value> [message to output]; or just [section name]

Add value settings to php.ini file installed by the extension (module). You can also add a [section], see examples below.

Add some settings for the extension:

php-ext-source-r2_addtoinifiles "zend_optimizer.optimization_level" "15"
php-ext-source-r2_addtoinifiles "zend_optimizer.enable_loader" "0"
php-ext-source-r2_addtoinifiles "zend_optimizer.disable_licensing" "0"

Adding values to a section in php.ini file installed by the extension:

php-ext-source-r2_addtoinifiles "[Debugger]"
php-ext-source-r2_addtoinifiles "debugger.enabled" "on"
php-ext-source-r2_addtoinifiles "debugger.profiler_enabled" "on"

ECLASS VARIABLES

PHP_EXT_NAME: The extension name. This must be set, otherwise the eclass dies. Only automagically set by php-ext-pecl-r2.eclass, so unless your ebuild inherits that eclass, you must set this manually before inherit.
PHP_EXT_INI = "yes": Controls whether or not to add a line to php.ini for the extension. Defaults to "yes" and should not be changed in most cases.
PHP_EXT_ZENDEXT = "no": Controls whether the extension is a ZendEngine extension or not. Defaults to "no" and if you don't know what is it, you don't need it.
USE_PHP = "php5-3": Lists the PHP slots compatibile the extension is compatibile with
PHP_EXT_OPTIONAL_USE: If set, this is the USE flag that the PHP dependencies are behind Most commonly set as PHP_EXT_OPTIONAL_USE=php to get the dependencies behind USE=php.
PHP_EXT_S = "${S}": The relative location of the temporary build directory for the PHP extension within the source package. This is useful for packages that bundle the PHP extension. Defaults to ${S}

AUTHORS

Author: Tal Peer <coredumb@gentoo.org>
Author: Stuart Herbert <stuart@gentoo.org>
Author: Luca Longinotti <chtekk@gentoo.org>
Author: Jakub Moc <jakub@gentoo.org> (documentation)
Author: Ole Markus With <olemarkus@gentoo.org>

MAINTAINERS

Gentoo PHP team <php-bugs@gentoo.org>

REPORTING BUGS

Please report bugs via http://bugs.gentoo.org/

FILES

/usr/portage/eclass/php-ext-source-r2.eclass

This document was created by man2html, using the manual pages.
Time: 03:25:01 GMT, May 25, 2013