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

Legend:
Removed from v.1.11  
changed lines
  Added in v.1.25

  ViewVC Help
Powered by ViewVC 1.1.20