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