1 # Copyright 1999-2016 Gentoo Foundation
2 # Distributed under the terms of the GNU General Public License v2
5 # @ECLASS: php-ext-source-r3.eclass
7 # Gentoo PHP team <php-bugs@gentoo.org>
8 # @BLURB: Compile and install standalone PHP extensions.
10 # A unified interface for compiling and installing standalone PHP
15 EXPORT_FUNCTIONS src_unpack src_prepare src_configure src_compile src_install
20 die "${ECLASS} is not compatible with EAPI=${EAPI}"
23 # @ECLASS-VARIABLE: PHP_EXT_NAME
26 # The extension name. This must be set, otherwise the eclass dies.
27 # Only automagically set by php-ext-pecl-r3.eclass, so unless your ebuild
28 # inherits that eclass, you must set this manually before inherit.
29 [[ -z "${PHP_EXT_NAME}" ]] && \
30 die "no extension name specified for the php-ext-source-r3 eclass"
32 # @ECLASS-VARIABLE: PHP_EXT_INI
34 # Controls whether or not to add a line to php.ini for the extension.
35 # Defaults to "yes" and should not be changed in most cases.
36 [[ -z "${PHP_EXT_INI}" ]] && PHP_EXT_INI="yes"
38 # @ECLASS-VARIABLE: PHP_EXT_ZENDEXT
40 # Controls whether the extension is a ZendEngine extension or not.
41 # Defaults to "no". If you don't know what this is, you don't need it.
42 [[ -z "${PHP_EXT_ZENDEXT}" ]] && PHP_EXT_ZENDEXT="no"
44 # @ECLASS-VARIABLE: USE_PHP
47 # Lists the PHP slots compatible the extension is compatible with.
50 # USE_PHP="php5-6 php7-0"
52 [[ -z "${USE_PHP}" ]] && \
53 die "USE_PHP is not set for the php-ext-source-r3 eclass"
55 # @ECLASS-VARIABLE: PHP_EXT_OPTIONAL_USE
58 # If set, all of the dependencies added by this eclass will be
59 # conditional on USE=${PHP_EXT_OPTIONAL_USE}. This is needed when
60 # ebuilds have to inherit this eclass unconditionally, but only
61 # actually use it when (for example) the user has USE=php.
63 # @ECLASS-VARIABLE: PHP_EXT_S
65 # The relative location of the temporary build directory for the PHP
66 # extension within the source package. This is useful for packages that
67 # bundle the PHP extension. Defaults to ${S}.
68 [[ -z "${PHP_EXT_S}" ]] && PHP_EXT_S="${S}"
70 # @ECLASS-VARIABLE: PHP_EXT_SAPIS
72 # A list of SAPIs for which we will install this extension. Formerly
73 # called PHPSAPILIST. The default includes every SAPI currently used in
75 [[ -z "${PHP_EXT_SAPIS}" ]] && PHP_EXT_SAPIS="apache2 cli cgi fpm embed phpdbg"
78 # Make sure at least one target is installed. First, start a USE
79 # conditional like "php?", but only when PHP_EXT_OPTIONAL_USE is
80 # non-null. The option group "|| (..." is always started here.
81 REQUIRED_USE="${PHP_EXT_OPTIONAL_USE}${PHP_EXT_OPTIONAL_USE:+? ( }|| ( "
82 for _php_target in ${USE_PHP}; do
83 # Now loop through each USE_PHP target and add the corresponding
84 # dev-lang/php slot to PHPDEPEND.
85 IUSE+=" php_targets_${_php_target}"
86 REQUIRED_USE+="php_targets_${_php_target} "
87 _php_slot=${_php_target/php}
88 _php_slot=${_php_slot/-/.}
89 PHPDEPEND+=" php_targets_${_php_target}? ( dev-lang/php:${_php_slot} )"
92 # Don't pollute the environment with our loop variables.
93 unset _php_slot _php_target
95 # Finally, end the optional group that we started before the loop. Close
96 # the USE-conditional if PHP_EXT_OPTIONAL_USE is non-null.
97 REQUIRED_USE+=") ${PHP_EXT_OPTIONAL_USE:+ )}"
100 ${PHP_EXT_OPTIONAL_USE}${PHP_EXT_OPTIONAL_USE:+? ( }
102 ${PHP_EXT_OPTIONAL_USE:+ )}"
107 ${PHP_EXT_OPTIONAL_USE}${PHP_EXT_OPTIONAL_USE:+? ( }
109 ${PHP_EXT_OPTIONAL_USE:+ )}
112 # @ECLASS-VARIABLE: PHP_EXT_SKIP_PHPIZE
115 # By default, we run "phpize" in php-ext-source-r3_src_unpack(). Set
116 # PHP_EXT_SKIP_PHPIZE="yes" in your ebuild if you do not want to run
117 # phpize (and the autoreconf that becomes necessary afterwards).
119 # @FUNCTION: php-ext-source-r3_src_unpack
121 # Runs the default src_unpack and then makes a copy for each PHP slot.
122 php-ext-source-r3_src_unpack() {
125 local slot orig_s="${PHP_EXT_S}"
126 for slot in $(php_get_slots); do
127 cp --recursive --preserve "${orig_s}" "${WORKDIR}/${slot}" || \
128 die "failed to copy sources from ${orig_s} to ${WORKDIR}/${slot}"
133 # @FUNCTION: php-ext-source-r3_src_prepare
135 # For each PHP slot, we initialize the environment, run the default
136 # src_prepare() for PATCHES/eapply_user support, and then call
137 # php-ext-source-r3_phpize.
138 php-ext-source-r3_src_prepare() {
139 for slot in $(php_get_slots); do
140 php_init_slot_env "${slot}"
142 php-ext-source-r3_phpize
146 # @FUNCTION: php-ext-source-r3_phpize
148 # Subject to PHP_EXT_SKIP_PHPIZE, this function runs phpize and
149 # autoreconf in a manner that avoids warnings.
150 php-ext-source-r3_phpize() {
151 if [[ "${PHP_EXT_SKIP_PHPIZE}" != 'yes' ]] ; then
152 # Create configure out of config.m4. We use autotools_run_tool
153 # to avoid some warnings about WANT_AUTOCONF and
154 # WANT_AUTOMAKE (see bugs #329071 and #549268).
155 autotools_run_tool "${PHPIZE}"
157 # Force libtoolize to run and regenerate autotools files (bug
159 rm aclocal.m4 || die "failed to remove aclocal.m4"
165 # @ECLASS-VARIABLE: PHP_EXT_ECONF_ARGS
168 # Set this in the ebuild to pass additional configure options to
169 # econf. Formerly called my_conf. Either a string or an array of
170 # --flag=value parameters is supported.
172 # @FUNCTION: php-ext-source-r3_src_configure
174 # Takes care of standard configure for PHP extensions (modules).
175 php-ext-source-r3_src_configure() {
176 # net-snmp creates these, bug #385403.
177 addpredict /usr/share/snmp/mibs/.index
178 addpredict /var/lib/net-snmp/mib_indexes
180 # Support either a string or an array for PHP_EXT_ECONF_ARGS.
182 if [[ $(declare -p PHP_EXT_ECONF_ARGS) == "declare -a"* ]]; then
183 econf_args=( "${PHP_EXT_ECONF_ARGS[@]}" )
185 econf_args=( ${PHP_EXT_ECONF_ARGS} )
189 for slot in $(php_get_slots); do
190 php_init_slot_env "${slot}"
191 econf --with-php-config="${PHPCONFIG}" "${econf_args[@]}"
195 # @FUNCTION: php-ext-source-r3_src_compile
197 # Compile a standard standalone PHP extension.
198 php-ext-source-r3_src_compile() {
199 # net-snmp creates these, bug #324739.
200 addpredict /usr/share/snmp/mibs/.index
201 addpredict /var/lib/net-snmp/mib_indexes
203 # shm extension creates a semaphore file, bug #173574.
204 addpredict /session_mm_cli0.sem
206 for slot in $(php_get_slots); do
207 php_init_slot_env "${slot}"
212 # @FUNCTION: php-ext-source-r3_src_install
214 # Install a standard standalone PHP extension. Uses einstalldocs()
215 # to support the DOCS variable/array.
216 php-ext-source-r3_src_install() {
218 for slot in $(php_get_slots); do
219 php_init_slot_env "${slot}"
221 # Strip $EPREFIX from $EXT_DIR before calling doexe (which
222 # handles EPREFIX itself). Shared libs are +x by convention,
223 # although nothing seems to depend on that.
224 exeinto "${EXT_DIR#$EPREFIX}"
225 doexe "modules/${PHP_EXT_NAME}.so"
227 INSTALL_ROOT="${D}" emake install-headers
230 php-ext-source-r3_createinifiles
233 # @FUNCTION: php_get_slots
235 # Get a list of PHP slots contained in both the ebuild's USE_PHP and the
236 # user's PHP_TARGETS.
240 for slot in ${USE_PHP}; do
241 use php_targets_${slot} && s+=" ${slot/-/.}"
246 # @FUNCTION: php_init_slot_env
249 # Takes a slot name, and initializes some global variables to values
250 # corresponding to that slot. For example, it sets the path to the "php"
251 # and "phpize" binaries, which will differ for each slot. This function
252 # is intended to be called while looping through a list of slots
253 # obtained from php_get_slots().
255 # Calling this function will change the working directory to the
256 # temporary build directory for the given slot.
257 php_init_slot_env() {
258 local libdir=$(get_libdir)
261 PHPPREFIX="${EPREFIX}/usr/${libdir}/${slot}"
262 PHPIZE="${PHPPREFIX}/bin/phpize"
263 PHPCONFIG="${PHPPREFIX}/bin/php-config"
264 PHPCLI="${PHPPREFIX}/bin/php"
265 PHPCGI="${PHPPREFIX}/bin/php-cgi"
266 PHP_PKG="$(best_version =dev-lang/php-${1:3}*)"
268 EXT_DIR="$(${PHPCONFIG} --extension-dir 2>/dev/null)"
269 PHP_CURRENTSLOT=${1:3}
271 PHP_EXT_S="${WORKDIR}/${slot}"
272 cd "${PHP_EXT_S}" || die "failed to change directory to ${PHP_EXT_S}"
275 # @FUNCTION: php_slot_ini_files
279 # Output a list of relative paths to INI files for the given
280 # slot. Usually there will be one INI file per SAPI.
281 php_slot_ini_files() {
282 local slot_ini_files=""
284 for x in ${PHP_EXT_SAPIS} ; do
285 if [[ -f "${EPREFIX}/etc/php/${x}-${1}/php.ini" ]] ; then
286 slot_ini_files+=" etc/php/${x}-${1}/ext/${PHP_EXT_NAME}.ini"
290 echo "${slot_ini_files}"
293 # @FUNCTION: php-ext-source-r3_createinifiles
295 # Builds INI files for every enabled slot and SAPI.
296 php-ext-source-r3_createinifiles() {
298 for slot in $(php_get_slots); do
299 php_init_slot_env "${slot}"
302 for file in $(php_slot_ini_files "${slot}") ; do
303 if [[ "${PHP_EXT_INI}" = "yes" ]] ; then
304 # Add the needed lines to the <ext>.ini files
305 php-ext-source-r3_addextension "${PHP_EXT_NAME}.so" "${file}"
308 if [[ -n "${PHP_EXT_INIFILE}" ]] ; then
309 cat "${FILESDIR}/${PHP_EXT_INIFILE}" >> "${ED}/${file}" \
310 || die "failed to append to ${ED}/${file}"
312 einfo "Added contents of ${FILESDIR}/${PHP_EXT_INIFILE}" \
315 inidir="${file/${PHP_EXT_NAME}.ini/}"
316 inidir="${inidir/ext/ext-active}"
318 dosym "/${file}" "/${file/ext/ext-active}"
322 # A location where PHP code for this extension can be stored,
323 # independent of the PHP or extension versions. This will be part of
324 # PHP's include_path, configured in php.ini. For example, pecl-apcu
325 # installs an "apc.php" file which you are supposed to load with
327 # require('apcu/apc.php');
329 PHP_EXT_SHARED_DIR="${EPREFIX}/usr/share/php/${PHP_EXT_NAME}"
332 # @FUNCTION: php-ext-source-r3_addextension
333 # @USAGE: <extension-path> <ini-file>
336 # Add a line to an INI file that will enable the given extension. The
337 # first parameter is the path to the extension (.so) file, and the
338 # second parameter is the name of the INI file in which it should be
339 # loaded. This function determines the setting name (either
340 # "extension=..." or "zend_extension=...") and then calls
341 # php-ext-source-r3_addtoinifile to do the actual work.
342 php-ext-source-r3_addextension() {
343 local ext_type="extension"
344 local ext_file="${1}"
346 if [[ "${PHP_EXT_ZENDEXT}" = "yes" ]] ; then
347 ext_type="zend_extension"
348 ext_file="${EXT_DIR}/${1}" # Zend extensions need the path...
351 php-ext-source-r3_addtoinifile "${2}" "${ext_type}" "${ext_file}"
354 # @FUNCTION: php-ext-source-r3_addtoinifile
355 # @USAGE: <relative-ini-path> <setting-or-section-name> [setting-value]
358 # Add a setting=value to one INI file. The first argument is the
359 # relative path to the INI file. The second argument is the setting
360 # name, and the third argument is its value.
362 # You can also pass "[Section]" as the second parameter, to create a new
363 # section in the INI file. In that case, the third parameter (which
364 # would otherwise be the value of the setting) is ignored.
365 php-ext-source-r3_addtoinifile() {
366 local inifile="${WORKDIR}/${1}"
367 local inidir="${inifile%/*}"
369 mkdir -p "${inidir}" || die "failed to create INI directory ${inidir}"
371 # Are we adding the name of a section? Assume not by default.
372 local my_added="${2}=${3}"
373 if [[ ${2:0:1} == "[" ]] ; then
374 # Ok, it's a section name.
377 echo "${my_added}" >> "${inifile}" || die "failed to append to ${inifile}"
378 einfo "Added '${my_added}' to /${1}"
384 # @FUNCTION: php-ext-source-r3_addtoinifiles
385 # @USAGE: <setting-or-section-name> [setting-value] [message]
387 # Add settings to every php.ini file installed by this extension.
388 # You can also add new [Section]s -- see the example below.
391 # Add some settings for the extension:
393 # php-ext-source-r3_addtoinifiles "zend_optimizer.optimization_level" "15"
394 # php-ext-source-r3_addtoinifiles "zend_optimizer.enable_loader" "0"
395 # php-ext-source-r3_addtoinifiles "zend_optimizer.disable_licensing" "0"
397 # Adding values to a section in php.ini file installed by the extension:
399 # php-ext-source-r3_addtoinifiles "[Debugger]"
400 # php-ext-source-r3_addtoinifiles "debugger.enabled" "on"
401 # php-ext-source-r3_addtoinifiles "debugger.profiler_enabled" "on"
403 php-ext-source-r3_addtoinifiles() {
405 for slot in $(php_get_slots); do
406 for file in $(php_slot_ini_files "${slot}") ; do
407 php-ext-source-r3_addtoinifile "${file}" "${1}" "${2}"