Gentoo Development Guide

PHP-EXT-SOURCE-R2.ECLASS

Section: portage (5)
Updated: Oct 2014
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  

SEE ALSO

ebuild(5)
http://sources.gentoo.org/eclass/php-ext-source-r2.eclass?view=log


 

Index

NAME
DESCRIPTION
FUNCTIONS
ECLASS VARIABLES
AUTHORS
MAINTAINERS
REPORTING BUGS
FILES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 03:25:03 GMT, October 31, 2014