/[gentoo-x86]/eclass/depend.php.eclass
Gentoo

Diff of /eclass/depend.php.eclass

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.3 Revision 1.32
1# Copyright 1999-2005 Gentoo Foundation 1# Copyright 1999-2012 Gentoo Foundation
2# Distributed under the terms of the GNU General Public License v2 2# Distributed under the terms of the GNU General Public License v2
3# $Header: /var/cvsroot/gentoo-x86/eclass/depend.php.eclass,v 1.3 2005/09/11 16:39:10 hollow Exp $ 3# $Header: /var/cvsroot/gentoo-x86/eclass/depend.php.eclass,v 1.32 2012/06/02 19:16:31 zmedico Exp $
4# 4
5# ========================================================================
6#
7# depend.php.eclass 5# @ECLASS: depend.php.eclass
8# functions to allow ebuilds to depend on php4 and/or php5 6# @MAINTAINER:
9# 7# Gentoo PHP team <php-bugs@gentoo.org>
10# Author: Stuart Herbert 8# @AUTHOR:
11# (stuart@gentoo.org) 9# Author: Stuart Herbert <stuart@gentoo.org>
12# 10# Author: Luca Longinotti <chtekk@gentoo.org>
13# ======================================================================== 11# Author: Jakub Moc <jakub@gentoo.org> (documentation)
12# @BLURB: Functions to allow ebuilds to depend on php5 and check for specific features.
13# @DESCRIPTION:
14# This eclass provides functions that allow ebuilds to depend on php5 and check
15# for specific PHP features, SAPIs etc. Also provides dodoc-php wrapper to install
16# documentation for PHP packages to php-specific location.
14 17
15inherit eutils 18inherit eutils multilib phpconfutils
16 19
20# PHP5-only depend functions
21
22# @FUNCTION: need_php5_cli
23# @DESCRIPTION:
24# Set this after setting DEPEND/RDEPEND in your ebuild if the ebuild requires PHP5
25# with cli SAPI.
17need_php4_cli() 26need_php5_cli() {
18{
19 DEPEND="${DEPEND} =virtual/php-4*"
20 RDEPEND="${RDEPEND} =virtual/php-4*"
21 PHP_VERSION=4
22}
23
24need_php4_httpd()
25{
26 DEPEND="${DEPEND} =virtual/httpd-php-4*"
27 RDEPEND="${RDEPEND} =virtual/httpd-php-4*"
28 PHP_VERSION=4
29}
30
31need_php4()
32{
33 DEPEND="${DEPEND} =dev-lang/php-4*" 27 DEPEND="${DEPEND} =dev-lang/php-5*"
34 RDEPEND="${RDEPEND} =dev-lang/php-4*" 28 RDEPEND="${RDEPEND} =dev-lang/php-5*"
35 PHP_VERSION=4
36 PHP_SHARED_CAT="php4"
37}
38
39# common settings go in here
40uses_php4()
41{
42 # cache this
43 libdir=$(get_libdir)
44
45 PHPIZE="/usr/${libdir}/php4/bin/phpize"
46 PHPCONFIG="/usr/${libdir}/php4/bin/php-config"
47 PHPCLI="/usr/${libdir}/php4/bin/php"
48 PHPCGI="/usr/${libdir}/php4/bin/php-cgi"
49 PHP_PKG="`best_version =dev-lang/php-4*`"
50 PHPPREFIX="/usr/${libdir}/php4"
51
52 einfo
53 einfo "Using ${PHP_PKG}"
54 einfo
55}
56
57need_php5_cli()
58{
59 DEPEND="${DEPEND} =virtual/php-5*"
60 RDEPEND="${RDEPEND} =virtual/php-5*"
61 PHP_VERSION=5 29 PHP_VERSION="5"
62} 30}
63 31
32# @FUNCTION: need_php5_httpd
33# @DESCRIPTION:
34# Set this after setting DEPEND/RDEPEND in your ebuild if the ebuild requires PHP5
35# with either cgi or apache2 SAPI.
64need_php5_httpd() 36need_php5_httpd() {
65{
66 DEPEND="${DEPEND} =virtual/httpd-php-5*" 37 DEPEND="${DEPEND} =virtual/httpd-php-5*"
67 RDEPEND="${RDEPEND} =virtual/httpd-php-5*" 38 RDEPEND="${RDEPEND} =virtual/httpd-php-5*"
68 PHP_VERSION=5 39 PHP_VERSION="5"
69} 40}
70 41
42# @FUNCTION: need_php5
43# @DESCRIPTION:
44# Set this after setting DEPEND/RDEPEND in your ebuild if the ebuild requires PHP5
45# (with any SAPI).
71need_php5() 46need_php5() {
72{
73 DEPEND="${DEPEND} =dev-lang/php-5*" 47 DEPEND="${DEPEND} =dev-lang/php-5*"
74 RDEPEND="${RDEPEND} =dev-lang/php-5*" 48 RDEPEND="${RDEPEND} =dev-lang/php-5*"
75 PHP_VERSION=5 49 PHP_VERSION="5"
76 PHP_SHARED_CAT="php5" 50 PHP_SHARED_CAT="php5"
77} 51}
78 52
79# common settings go in here 53# common settings go in here
80uses_php5() 54uses_php5() {
81{
82 # cache this 55 # cache this
83 libdir=$(get_libdir) 56 libdir=$(get_libdir)
84 57
85 PHPIZE="/usr/${libdir}/php5/bin/phpize" 58 PHPIZE="/usr/${libdir}/php5/bin/phpize"
86 PHPCONFIG="/usr/${libdir}/php5/bin/php-config" 59 PHPCONFIG="/usr/${libdir}/php5/bin/php-config"
87 PHPCLI="/usr/${libdir}/php5/bin/php" 60 PHPCLI="/usr/${libdir}/php5/bin/php"
88 PHPCGI="/usr/${libdir}/php5/bin/php-cgi" 61 PHPCGI="/usr/${libdir}/php5/bin/php-cgi"
89 PHP_PKG="`best_version =dev-lang/php-5*`" 62 PHP_PKG="$(best_version =dev-lang/php-5*)"
90 PHPPREFIX="/usr/${libdir}/php5" 63 PHPPREFIX="/usr/${libdir}/php5"
64 EXT_DIR="$(${PHPCONFIG} --extension-dir 2>/dev/null)"
91 65
92 einfo 66 einfo
93 einfo "Using ${PHP_PKG}" 67 einfo "Using ${PHP_PKG}"
94 einfo 68 einfo
95} 69}
96 70
71# general PHP depend functions
72
73# @FUNCTION: need_php_cli
74# @DESCRIPTION:
75# Set this after setting DEPEND/RDEPEND in your ebuild if the ebuild requires PHP
76# (any version) with cli SAPI.
77need_php_cli() {
78 DEPEND="${DEPEND} dev-lang/php"
79 RDEPEND="${RDEPEND} dev-lang/php"
80}
81
82# @FUNCTION: need_php_httpd
83# @DESCRIPTION:
84# Set this after setting DEPEND/RDEPEND in your ebuild if the ebuild requires PHP
85# (any version) with either cgi or apache2 SAPI.
86need_php_httpd() {
87 DEPEND="${DEPEND} virtual/httpd-php"
88 RDEPEND="${RDEPEND} virtual/httpd-php"
89}
90
91# @FUNCTION: need_php
92# @DESCRIPTION:
93# Set this after setting DEPEND/RDEPEND in your ebuild if the ebuild requires PHP
94# (any version with any SAPI).
97need_php() 95need_php() {
98{
99 DEPEND="${DEPEND} dev-lang/php" 96 DEPEND="${DEPEND} dev-lang/php"
100 RDEPEND="${RDEPEND} dev-lang/php" 97 RDEPEND="${RDEPEND} dev-lang/php"
101 PHP_SHARED_CAT="php" 98 PHP_SHARED_CAT="php"
102} 99}
103 100
101# @FUNCTION: need_php_by_category
102# @DESCRIPTION:
103# Set this after setting DEPEND/RDEPEND in your ebuild to depend on PHP version
104# determined by ${CATEGORY} - any PHP version or PHP5 for dev-php or
105# dev-php5, respectively.
104need_php_by_category() 106need_php_by_category() {
105{
106 case "${CATEGORY}" in 107 case "${CATEGORY}" in
107 dev-php) need_php ;; 108 dev-php) need_php ;;
108 dev-php4) need_php4 ;; 109 *) die "Version of PHP required by packages in category ${CATEGORY} unknown"
109 dev-php5) need_php5 ;;
110 *) die "I don't know which version of PHP packages in ${CATEGORY} require"
111 esac 110 esac
112} 111}
113 112
113
114# @FUNCTION: has_php
115# @DESCRIPTION:
116# Call this function from your pkg_setup, src_compile, src_install etc. if you
117# need to know which PHP version is being used and where the PHP binaries/data
118# are installed.
119has_php() {
120 # Detect which PHP version we have installed
121 if has_version '=dev-lang/php-5*' ; then
122 PHP_VERSION="5"
123 else
124 die "Unable to find an installed dev-lang/php package"
125 fi
126
127 # If we get here, then PHP_VERSION tells us which version of PHP we
128 # want to use
129 uses_php${PHP_VERSION}
130}
131
132# @FUNCTION: require_php_sapi_from
133# @USAGE: <list of SAPIs>
134# @DESCRIPTION:
114# call this function from pkg_setup if your PHP extension only works with 135# Call this function from pkg_setup if your package only works with
115# specific SAPIs 136# specific SAPI(s) and specify a list of PHP SAPI USE flags that are
137# required (one or more from cli, cgi, apache2) as arguments.
138# Returns if any of the listed SAPIs have been installed, dies if none
139# of them is available.
116# 140#
117# this function will disappear when USE-based deps are supported by 141# Unfortunately, if you want to be really sure that the required SAPI is
118# Portage 142# provided by PHP, you will have to use this function or similar ones (like
119# 143# require_php_cli or require_php_cgi) in pkg_setup until we are able to
120# $1 ... a list of SAPI USE flags (eg cli, cgi, apache2) 144# depend on USE flags being enabled. The above described need_php[45]_cli
121# 145# and need_php[45]_httpd functions cannot guarantee these requirements.
122# returns if any one of the listed SAPIs has been installed 146# See Bug 2272 for details.
123# dies if none of the listed SAPIs has been installed
124
125require_php_sapi_from() 147require_php_sapi_from() {
126{
127 has_php 148 has_php
128 149
129 local has_sapi=0 150 local has_sapi="0"
130 local x 151 local x
131 152
132 einfo "Checking for compatible SAPI(s)" 153 einfo "Checking for compatible SAPI(s)"
133 154
134 for x in $@ ; do 155 for x in $@ ; do
135 if built_with_use =${PHP_PKG} ${x} ; then 156 if built_with_use =${PHP_PKG} ${x} || phpconfutils_built_with_use =${PHP_PKG} ${x} ; then
136 einfo " Discovered compatible SAPI ${x}" 157 einfo " Discovered compatible SAPI ${x}"
137 has_sapi=1 158 has_sapi="1"
138 fi 159 fi
139 done 160 done
140 161
141 if [[ ${has_sapi} == 1 ]]; then 162 if [[ "${has_sapi}" == "1" ]] ; then
142 return 163 return
143 fi 164 fi
144 165
145 eerror 166 eerror
146 eerror "${PHP_PKG} needs to be re-installed with one of the following" 167 eerror "${PHP_PKG} needs to be re-installed with one of the following"
147 eerror "USE flags enabled:" 168 eerror "USE flags enabled:"
148 eerror 169 eerror
149 eerror " $@" 170 eerror " $@"
150 eerror 171 eerror
151 die "Re-install ${PHP_PKG}" 172 die "No compatible PHP SAPIs found"
152} 173}
153 174
175# @FUNCTION: require_php_with_use
176# @USAGE: <list of USE flags>
177# @DESCRIPTION:
154# call this function from pkg_setup if your package requires PHP compiled 178# Call this function from pkg_setup if your package requires PHP compiled
155# with specific USE flags 179# with specific USE flags. Returns if all of the listed USE flags are enabled.
180# Dies if any of the listed USE flags are disabled.
181
182# @VARIABLE: PHPCHECKNODIE
183# @DESCRIPTION:
184# You can set PHPCHECKNODIE to non-empty value in your ebuild to chain multiple
185# require_php_with_(any)_use checks without making the ebuild die on every failure.
186# This is useful in cases when certain PHP features are only required if specific
187# USE flag(s) are enabled for that ebuild.
188# @CODE
189# Example:
156# 190#
157# this function will disappear when USE-based deps are supported by 191# local flags="pcre session snmp sockets wddx"
158# Portage 192# use mysql && flags="${flags} mysql"
159# 193# use postgres && flags="${flags} postgres"
160# $1 ... a list of USE flags 194# if ! PHPCHECKNODIE="yes" require_php_with_use ${flags} \
161# 195# || ! PHPCHECKNODIE="yes" require_php_with_any_use gd gd-external ; then
162# returns if all of the listed USE flags are set 196# die "Re-install ${PHP_PKG} with ${flags} and either gd or gd-external"
163# dies if any of the listed USE flags are not set 197# fi
164 198# @CODE
165require_php_with_use() 199require_php_with_use() {
166{
167 has_php 200 has_php
168 201
169 local missing_use= 202 local missing_use=""
170 local x 203 local x
171 204
172 einfo "Checking for required PHP feature(s):" 205 einfo "Checking for required PHP feature(s) ..."
173 206
174 for x in $@ ; do 207 for x in $@ ; do
175 if ! built_with_use =${PHP_PKG} ${x} ; then 208 case $x in
209 pcre|spl|reflection|mhash)
210 eqawarn "require_php_with_use MUST NOT check for the pcre, spl, mhash or reflection USE flag."
211 eqawarn "These USE flags are removed from >=dev-lang/php-5.3 and your ebuild will break"
212 eqawarn "if you check the USE flags against PHP 5.3 ebuilds."
213 eqawarn "Please use USE dependencies from EAPI 2 instead"
214 ;;
215 esac
216
217 if ! built_with_use =${PHP_PKG} ${x} && ! phpconfutils_built_with_use =${PHP_PKG} ${x} ; then
176 einfo " Discovered missing USE flag ${x}" 218 einfo " Discovered missing USE flag: ${x}"
177 missing_use="${missing_use} ${x}" 219 missing_use="${missing_use} ${x}"
178 fi 220 fi
179 done 221 done
180 222
181 if [[ -z ${missing_use} ]]; then 223 if [[ -z "${missing_use}" ]] ; then
224 if [[ -z "${PHPCHECKNODIE}" ]] ; then
182 return 225 return
183 fi
184
185 eerror
186 eerror "${PHP_PKG} needs to be re-installed with all of the following"
187 eerror "USE flags enabled:"
188 eerror
189 eerror " $@"
190 eerror
191 die "Re-install ${PHP_PKG}"
192}
193
194# call this function from your pkg_setup, src_compile & src_install methods
195# if you need to know where the PHP binaries are installed and their data
196
197has_php()
198{
199 # if PHP_PKG is set, then we have remembered our PHP settings
200 # from last time
201
202 if [[ -n ${PHP_PKG} ]]; then
203 return
204 fi
205
206 if [[ -z ${PHP_VERSION} ]]; then
207 # detect which PHP version installed
208 if has_version '=dev-lang/php-5*' ; then
209 PHP_VERSION=5
210 elif has_version '=dev-lang/php-4*' ; then
211 PHP_VERSION=4
212 else 226 else
213 die "Unable to find an installed dev-lang/php package" 227 return 0
214 fi
215 fi 228 fi
229 fi
216 230
217 # if we get here, then PHP_VERSION tells us which version of PHP we 231 if [[ -z "${PHPCHECKNODIE}" ]] ; then
218 # want to use 232 eerror
233 eerror "${PHP_PKG} needs to be re-installed with all of the following"
234 eerror "USE flags enabled:"
235 eerror
236 eerror " $@"
237 eerror
238 die "Missing PHP USE flags found"
239 else
240 return 1
241 fi
242}
219 243
220 uses_php${PHP_VERSION} 244# @FUNCTION: require_php_with_any_use
245# @USAGE: <list of USE flags>
246# @DESCRIPTION:
247# Call this function from pkg_setup if your package requires PHP compiled with
248# any of specified USE flags. Returns if any of the listed USE flags are enabled.
249# Dies if all of the listed USE flags are disabled.
250require_php_with_any_use() {
251 has_php
252
253 local missing_use=""
254 local x
255
256 einfo "Checking for required PHP feature(s) ..."
257
258 for x in $@ ; do
259 if built_with_use =${PHP_PKG} ${x} || phpconfutils_built_with_use =${PHP_PKG} ${x} ; then
260 einfo " USE flag ${x} is enabled, ok ..."
261 return
262 else
263 missing_use="${missing_use} ${x}"
264 fi
265 done
266
267 if [[ -z "${missing_use}" ]] ; then
268 if [[ -z "${PHPCHECKNODIE}" ]] ; then
269 return
270 else
271 return 0
272 fi
273 fi
274
275 if [[ -z "${PHPCHECKNODIE}" ]] ; then
276 eerror
277 eerror "${PHP_PKG} needs to be re-installed with any of the following"
278 eerror "USE flags enabled:"
279 eerror
280 eerror " $@"
281 eerror
282 die "Missing PHP USE flags found"
283 else
284 return 1
285 fi
221} 286}
222 287
223# ======================================================================== 288# ========================================================================
224# has_*() functions 289# has_*() functions
225# 290#
226# these functions return 0 if the condition is satisfied, or 1 otherwise 291# These functions return 0 if the condition is satisfied, 1 otherwise
227# ======================================================================== 292# ========================================================================
228 293
294# @FUNCTION: has_zts
295# @DESCRIPTION:
229# check if our PHP was compiled with ZTS (Zend Thread Safety) 296# Check if our PHP was compiled with ZTS (Zend Thread Safety) enabled.
230 297# @RETURN: 0 if true, 1 otherwise
231has_zts() 298has_zts() {
232{
233 has_php 299 has_php
234 300
235 if built_with_use =${PHP_PKG} apache2 threads ; then 301 if built_with_use =${PHP_PKG} apache2 threads || phpconfutils_built_with_use =${PHP_PKG} apache2 threads ; then
236 return 0 302 return 0
237 fi 303 fi
238 304
239 return 1 305 return 1
240} 306}
241 307
242# check if our PHP was built with Hardened-PHP active 308# @FUNCTION: has_debug
243 309# @DESCRIPTION:
244has_hardenedphp() 310# Check if our PHP was built with debug support enabled.
245{ 311# @RETURN: 0 if true, 1 otherwise
312has_debug() {
246 has_php 313 has_php
247 314
248 if built_with_use =${PHP_PKG} hardenedphp ; then 315 if built_with_use =${PHP_PKG} debug || phpconfutils_built_with_use =${PHP_PKG} debug ; then
316 return 0
317 fi
318
319 return 1
320}
321
322# @FUNCTION: has_concurrentmodphp
323# @DESCRIPTION:
324# Check if our PHP was built with the concurrentmodphp support enabled.
325# @RETURN: 0 if true, 1 otherwise
326has_concurrentmodphp() {
327 has_php
328
329 if built_with_use =${PHP_PKG} apache2 concurrentmodphp || phpconfutils_built_with_use =${PHP_PKG} apache2 concurrentmodphp ; then
249 return 0 330 return 0
250 fi 331 fi
251 332
252 return 1 333 return 1
253} 334}
254 335
255# ======================================================================== 336# ========================================================================
256# require_*() functions 337# require_*() functions
257# 338#
258# These functions die() if PHP was built without the required USE flag(s) 339# These functions die() if PHP was built without the required features
259# ======================================================================== 340# ========================================================================
260 341
342# @FUNCTION: require_pdo
343# @DESCRIPTION:
261# require a PHP built with PDO support for PHP5 344# Require a PHP built with PDO support (PHP5 only).
262 345# This function is now redundant and DEPRECATED since
346# pdo-external use flag and pecl-pdo-* ebuilds were removed.
347# You should use require_php_with_use pdo instead now.
348# @RETURN: die if feature is missing
263require_pdo() 349require_pdo() {
264{
265 has_php 350 has_php
266 351
267 # do we have php5.1 installed? 352 # Was PHP5 compiled with internal PDO support?
268 353 if built_with_use =${PHP_PKG} pdo || phpconfutils_built_with_use =${PHP_PKG} pdo ; then
269 if [[ ${PHP_VERSION} == 4 ]] ; then
270 eerror
271 eerror "This package requires PDO."
272 eerror "PDO is only available for PHP 5."
273 eerror "Please install dev-lang/php-5*"
274 eerror
275 die "PHP 5 not installed"
276 fi
277
278 # was php5 compiled w/ pdo support?
279
280 if built_with_use =${PHP_PKG} pdo ; then
281 return 354 return
282 fi 355 else
283
284 # ok, maybe PDO was built as an external extension?
285
286 if built_with_use =${PHP_PKG} pdo-external && has_version dev-php5/pecl-pdo ; then
287 return
288 fi
289
290 # ok, as last resort, it suffices that pecl-pdo was installed to have PDO support
291
292 if has_version dev-php5/pecl-pdo ; then
293 return
294 fi
295
296 # if we get here, then we have no PDO support
297
298 eerror 356 eerror
299 eerror "No PDO extension for PHP found." 357 eerror "No PDO extension for PHP found."
300 eerror "Please note that PDO only exists for PHP 5." 358 eerror "Please note that PDO only exists for PHP 5."
301 eerror "Please install a PDO extension for PHP 5," 359 eerror "Please install a PDO extension for PHP 5."
302 eerror "you must install dev-lang/php-5.0* with" 360 eerror "You must install >=dev-lang/php-5.1 with USE=\"pdo\"."
303 eerror "the 'pdo-external' USE flag or you must"
304 eerror "install dev-lang/php-5.1* with either"
305 eerror "the 'pdo' or the 'pdo-external' USE flags"
306 eerror "turned on."
307 eerror 361 eerror
308 die "No PDO extension found for PHP 5" 362 die "No PDO extension for PHP 5 found"
363 fi
309} 364}
310 365
366# @FUNCTION: require_php_cli
367# @DESCRIPTION:
311# determines which installed PHP version has the CLI sapi 368# Determines which installed PHP version has the CLI SAPI enabled.
312# useful for PEAR eclass, or anything which needs to run PHP 369# Useful for PEAR stuff, or anything which needs to run PHP script
313# scripts depending on the cli sapi 370# depending on the CLI SAPI.
314 371# @RETURN: die if feature is missing
315require_php_cli() 372require_php_cli() {
316{
317 # if PHP_PKG is set, then we have remembered our PHP settings 373 # If PHP_PKG is set, then we have remembered our PHP settings
318 # from last time 374 # from last time
319
320 if [[ -n ${PHP_PKG} ]]; then 375 if [[ -n ${PHP_PKG} ]] ; then
321 return 376 return
322 fi 377 fi
323 378
324 # detect which PHP version installed 379 local PHP_PACKAGE_FOUND=""
380
325 if has_version '=dev-lang/php-5*' ; then 381 if has_version '=dev-lang/php-5*' ; then
382 PHP_PACKAGE_FOUND="1"
326 pkg="`best_version '=dev-lang/php-5*'`" 383 pkg="$(best_version '=dev-lang/php-5*')"
327 if built_with_use =${pkg} cli ; then 384 if built_with_use =${pkg} cli || phpconfutils_built_with_use =${pkg} cli ; then
328 PHP_VERSION=5 385 PHP_VERSION="5"
386 fi
329 fi 387 fi
330 elif has_version '=dev-lang/php-4*' ; then 388
331 pkg="`best_version '=dev-lang/php-4*'`" 389 if [[ -z ${PHP_PACKAGE_FOUND} ]] ; then
332 if built_with_use =${pkg} cli ; then
333 PHP_VERSION=4
334 fi
335 else
336 die "Unable to find an installed dev-lang/php package" 390 die "Unable to find an installed dev-lang/php package"
337 fi 391 fi
338 392
339 if [[ -z ${PHP_VERSION} ]]; then 393 if [[ -z ${PHP_VERSION} ]] ; then
340 die "No PHP CLI installed" 394 die "No PHP CLI installed. Re-emerge dev-lang/php with USE=cli."
341 fi 395 fi
342 396
343 # if we get here, then PHP_VERSION tells us which version of PHP we 397 # If we get here, then PHP_VERSION tells us which version of PHP we
344 # want to use 398 # want to use
345
346 uses_php${PHP_VERSION} 399 uses_php${PHP_VERSION}
347} 400}
348 401
402# @FUNCTION: require_php_cgi
403# @DESCRIPTION:
349# determines which installed PHP version has the CGI sapi 404# Determines which installed PHP version has the CGI SAPI enabled.
350# useful for anything which needs to run PHP scripts 405# Useful for anything which needs to run PHP scripts depending on the CGI SAPI.
351# depending on the cgi sapi 406# @RETURN: die if feature is missing
352
353require_php_cgi() 407require_php_cgi() {
354{
355 # if PHP_PKG is set, then we have remembered our PHP settings 408 # If PHP_PKG is set, then we have remembered our PHP settings
356 # from last time 409 # from last time
357
358 if [[ -n ${PHP_PKG} ]]; then 410 if [[ -n ${PHP_PKG} ]] ; then
359 return 411 return
360 fi 412 fi
361 413
362 # detect which PHP version installed 414 local PHP_PACKAGE_FOUND=""
415
363 if has_version '=dev-lang/php-5*' ; then 416 if has_version '=dev-lang/php-5*' ; then
417 PHP_PACKAGE_FOUND="1"
364 pkg="`best_version '=dev-lang/php-5*'`" 418 pkg="$(best_version '=dev-lang/php-5*')"
365 if built_with_use =${pkg} cgi ; then 419 if built_with_use =${pkg} cgi || phpconfutils_built_with_use =${pkg} cgi ; then
366 PHP_VERSION=5 420 PHP_VERSION="5"
421 fi
367 fi 422 fi
368 elif has_version '=dev-lang/php-4*' ; then 423
369 pkg="`best_version '=dev-lang/php-4*'`" 424 if [[ -z ${PHP_PACKAGE_FOUND} ]] ; then
370 if built_with_use =${pkg} cgi ; then
371 PHP_VERSION=4
372 fi
373 else
374 die "Unable to find an installed dev-lang/php package" 425 die "Unable to find an installed dev-lang/php package"
375 fi 426 fi
376 427
377 if [[ -z ${PHP_VERSION} ]]; then 428 if [[ -z ${PHP_VERSION} ]] ; then
378 die "No PHP CGI installed" 429 die "No PHP CGI installed. Re-emerge dev-lang/php with USE=cgi."
379 fi 430 fi
380 431
381 # if we get here, then PHP_VERSION tells us which version of PHP we 432 # If we get here, then PHP_VERSION tells us which version of PHP we
382 # want to use 433 # want to use
383
384 uses_php${PHP_VERSION} 434 uses_php${PHP_VERSION}
385} 435}
386 436
437# @FUNCTION: require_sqlite
438# @DESCRIPTION:
387# require a PHP built with sqlite support 439# Require a PHP built with SQLite support
388 440# @RETURN: die if feature is missing
389require_sqlite() 441require_sqlite() {
390{
391 has_php 442 has_php
392 443
393 # has our PHP been built with sqlite? 444 # Has our PHP been built with SQLite support?
394 445 if built_with_use =${PHP_PKG} sqlite || phpconfutils_built_with_use =${PHP_PKG} sqlite ; then
395 if built_with_use =${PHP_PKG} sqlite ; then
396 return
397 fi
398
399 # do we have pecl-sqlite installed for PHP 4?
400
401 if [[ ${PHP_VERSION} == 4 ]] ; then
402 if has_version dev-php4/pecl-sqlite ; then
403 return 446 return
404 fi 447 fi
405 fi
406 448
407 # if we get here, then we don't have any sqlite support for PHP installed 449 # If we get here, then we don't have any SQLite support for PHP installed
408
409 eerror 450 eerror
410 eerror "No sqlite extension for PHP found." 451 eerror "No SQLite extension for PHP found."
411 eerror "Please install an sqlite extension for PHP," 452 eerror "Please install an SQLite extension for PHP,"
412 eerror "this is done best by simply adding the" 453 eerror "this is done best by simply adding the"
413 eerror "'sqlite' USE flag when emerging dev-lang/php." 454 eerror "'sqlite' USE flag when emerging dev-lang/php."
414 eerror 455 eerror
415 die "No sqlite extension for PHP found" 456 die "No SQLite extension for PHP found"
416} 457}
417 458
459# @FUNCTION: require_gd
460# @DESCRIPTION:
461# Require a PHP built with GD support
462# @RETURN: die if feature is missing
418require_gd() 463require_gd() {
419{
420 has_php 464 has_php
421 465
422 # do we have the internal GD support installed? 466 # Do we have the internal GD support installed?
423 467 if built_with_use =${PHP_PKG} gd || phpconfutils_built_with_use =${PHP_PKG} gd ; then
424 if built_with_use =${PHP_PKG} gd ; then
425 return 468 return
426 fi 469 fi
427 470
428 # ok, maybe GD was built using the external support? 471 # Ok, maybe GD was built using the external library support?
429 472 if built_with_use =${PHP_PKG} gd-external || phpconfutils_built_with_use =${PHP_PKG} gd-external ; then
430 if built_with_use =${PHP_PKG} gd-external ; then
431 return 473 return
432 fi 474 fi
433 475
434 # if we get here, then we have no GD support 476 # If we get here, then we have no GD support
435
436 eerror 477 eerror
437 eerror "No GD support for PHP found." 478 eerror "No GD support for PHP found."
438 eerror "Please install the GD support for PHP," 479 eerror "Please install the GD support for PHP,"
439 eerror "you must install dev-lang/php with either" 480 eerror "you must install dev-lang/php with either"
440 eerror "the 'gd' or the 'gd-external' USE flags" 481 eerror "the 'gd' or the 'gd-external' USE flags"
441 eerror "turned on." 482 eerror "turned on."
442 eerror 483 eerror
443 die "No GD support found for PHP" 484 die "No GD support found for PHP"
444} 485}
486
487# ========================================================================
488# Misc functions
489#
490# These functions provide miscellaneous checks and functionality.
491# ========================================================================
492
493# @FUNCTION: php_binary_extension
494# @DESCRIPTION:
495# Executes some checks needed when installing a binary PHP extension.
496php_binary_extension() {
497 has_php
498
499 local PUSE_ENABLED=""
500
501 # Binary extensions do not support the change of PHP
502 # API version, so they can't be installed when USE flags
503 # are enabled which change the PHP API version, they also
504 # don't provide correctly versioned symbols for our use
505
506 if has_debug ; then
507 eerror
508 eerror "You cannot install binary PHP extensions"
509 eerror "when the 'debug' USE flag is enabled!"
510 eerror "Please reemerge dev-lang/php with the"
511 eerror "'debug' USE flag turned off."
512 eerror
513 PUSE_ENABLED="1"
514 fi
515
516 if has_concurrentmodphp ; then
517 eerror
518 eerror "You cannot install binary PHP extensions when"
519 eerror "the 'concurrentmodphp' USE flag is enabled!"
520 eerror "Please reemerge dev-lang/php with the"
521 eerror "'concurrentmodphp' USE flag turned off."
522 eerror
523 PUSE_ENABLED="1"
524 fi
525
526 if [[ -n ${PUSE_ENABLED} ]] ; then
527 die "'debug' and/or 'concurrentmodphp' USE flags turned on!"
528 fi
529}
530
531# @FUNCTION: dodoc-php
532# @USAGE: <list of docs>
533# @DESCRIPTION:
534# Alternative to dodoc function for use in our PHP eclasses and ebuilds.
535# Stored here because depend.php gets always sourced everywhere in the PHP
536# ebuilds and eclasses. It simply is dodoc with a changed path to the docs.
537# NOTE: No support for docinto is provided!
538dodoc-php() {
539if [[ $# -lt 1 ]] ; then
540 echo "$0: at least one argument needed" 1>&2
541 exit 1
542fi
543
544phpdocdir="/usr/share/doc/${CATEGORY}/${PF}/"
545
546for x in $@ ; do
547 if [[ -s "${x}" ]] ; then
548 insinto "${phpdocdir}"
549 doins "${x}"
550 gzip -f -9 "${D}/${phpdocdir}/${x##*/}"
551 elif [[ ! -e "${x}" ]] ; then
552 echo "dodoc-php: ${x} does not exist" 1>&2
553 fi
554done
555}
556
557# @FUNCTION: dohtml-php
558# @USAGE: <list of html docs>
559# @DESCRIPTION:
560# Alternative to dohtml function for use in our PHP eclasses and ebuilds.
561# Stored here because depend.php gets always sourced everywhere in the PHP
562# ebuilds and eclasses. It simply is dohtml with a changed path to the docs.
563# NOTE: No support for [-a|-A|-p|-x] options is provided!
564dohtml-php() {
565if [[ $# -lt 1 ]] ; then
566 echo "$0: at least one argument needed" 1>&2
567 exit 1
568fi
569
570phphtmldir="/usr/share/doc/${CATEGORY}/${PF}/html"
571
572for x in $@ ; do
573 if [[ -s "${x}" ]] ; then
574 insinto "${phphtmldir}"
575 doins "${x}"
576 elif [[ ! -e "${x}" ]] ; then
577 echo "dohtml-php: ${x} does not exist" 1>&2
578 fi
579done
580}

Legend:
Removed from v.1.3  
changed lines
  Added in v.1.32

  ViewVC Help
Powered by ViewVC 1.1.20