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