/[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.10 Revision 1.21
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.10 2006/01/21 09:15:08 sebastian Exp $ 3# $Header: /var/cvsroot/gentoo-x86/eclass/depend.php.eclass,v 1.21 2007/09/01 15:58:17 jokey 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 # 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:
134# 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
135# 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.
136# 204#
137# 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
138# Portage 206# provided by PHP, you will have to use this function or similar ones (like
139# 207# 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) 208# depend on USE flags being enabled. The above described need_php[45]_cli
141# 209# and need_php[45]_httpd functions cannot guarantee these requirements.
142# returns if any one of the listed SAPIs has been installed 210# See Bug 2272 for details.
143# dies if none of the listed SAPIs has been installed
144
145require_php_sapi_from() 211require_php_sapi_from() {
146{
147 has_php 212 has_php
148 213
149 local has_sapi=0 214 local has_sapi="0"
150 local x 215 local x
151 216
152 einfo "Checking for compatible SAPI(s)" 217 einfo "Checking for compatible SAPI(s)"
153 218
154 for x in $@ ; do 219 for x in $@ ; do
155 if built_with_use =${PHP_PKG} ${x} ; then 220 if built_with_use =${PHP_PKG} ${x} || phpconfutils_built_with_use =${PHP_PKG} ${x} ; then
156 einfo " Discovered compatible SAPI ${x}" 221 einfo " Discovered compatible SAPI ${x}"
157 has_sapi=1 222 has_sapi="1"
158 fi 223 fi
159 done 224 done
160 225
161 if [[ ${has_sapi} == 1 ]]; then 226 if [[ "${has_sapi}" == "1" ]] ; then
162 return 227 return
163 fi 228 fi
164 229
165 eerror 230 eerror
166 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"
167 eerror "USE flags enabled:" 232 eerror "USE flags enabled:"
168 eerror 233 eerror
169 eerror " $@" 234 eerror " $@"
170 eerror 235 eerror
171 die "Re-install ${PHP_PKG}" 236 die "No compatible PHP SAPIs found"
172} 237}
173 238
239# @FUNCTION: require_php_with_use
240# @USAGE: <list of USE flags>
241# @DESCRIPTION:
174# 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
175# 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:
176# 254#
177# this function will disappear when USE-based deps are supported by 255# local flags="pcre session snmp sockets wddx"
178# Portage 256# use mysql && flags="${flags} mysql"
179# 257# use postgres && flags="${flags} postgres"
180# $1 ... a list of USE flags 258# if ! PHPCHECKNODIE="yes" require_php_with_use ${flags} \
181# 259# || ! PHPCHECKNODIE="yes" require_php_with_any_use gd gd-external ; then
182# returns if all of the listed USE flags are set 260# 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 261# fi
184 262# @CODE
185require_php_with_use() 263require_php_with_use() {
186{
187 has_php 264 has_php
188 265
189 local missing_use= 266 local missing_use=""
190 local x 267 local x
191 268
192 einfo "Checking for required PHP feature(s):" 269 einfo "Checking for required PHP feature(s) ..."
193 270
194 for x in $@ ; do 271 for x in $@ ; do
195 if ! built_with_use =${PHP_PKG} ${x} ; then 272 if ! built_with_use =${PHP_PKG} ${x} && ! phpconfutils_built_with_use =${PHP_PKG} ${x} ; then
196 einfo " Discovered missing USE flag ${x}" 273 einfo " Discovered missing USE flag: ${x}"
197 missing_use="${missing_use} ${x}" 274 missing_use="${missing_use} ${x}"
198 fi 275 fi
199 done 276 done
200 277
201 if [[ -z ${missing_use} ]]; then 278 if [[ -z "${missing_use}" ]] ; then
279 if [[ -z "${PHPCHECKNODIE}" ]] ; then
202 return 280 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-4*' ; then
229 PHP_VERSION=4
230 elif has_version '=dev-lang/php-5*' ; then
231 PHP_VERSION=5
232 else 281 else
233 die "Unable to find an installed dev-lang/php package" 282 return 0
234 fi
235 fi 283 fi
284 fi
236 285
237 # if we get here, then PHP_VERSION tells us which version of PHP we 286 if [[ -z "${PHPCHECKNODIE}" ]] ; then
238 # 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}
239 298
240 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
241} 341}
242 342
243# ======================================================================== 343# ========================================================================
244# has_*() functions 344# has_*() functions
245# 345#
246# these functions return 0 if the condition is satisfied, or 1 otherwise 346# These functions return 0 if the condition is satisfied, 1 otherwise
247# ======================================================================== 347# ========================================================================
248 348
349# @FUNCTION: has_zts
350# @DESCRIPTION:
249# check if our PHP was compiled with ZTS (Zend Thread Safety) 351# Check if our PHP was compiled with ZTS (Zend Thread Safety) enabled.
250 352# @RETURN: 0 if true, 1 otherwise
251has_zts() 353has_zts() {
252{
253 has_php 354 has_php
254 355
255 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
256 return 0 357 return 0
257 fi 358 fi
258 359
259 return 1 360 return 1
260} 361}
261 362
262# check if our PHP was built with Hardened-PHP active 363# @FUNCTION: has_debug
263 364# @DESCRIPTION:
264has_hardenedphp() 365# Check if our PHP was built with debug support enabled.
265{ 366# @RETURN: 0 if true, 1 otherwise
367has_debug() {
266 has_php 368 has_php
267 369
268 if built_with_use =${PHP_PKG} hardenedphp ; then 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
269 return 0 385 return 0
270 fi 386 fi
271 387
272 return 1 388 return 1
273} 389}
274 390
275# ======================================================================== 391# ========================================================================
276# require_*() functions 392# require_*() functions
277# 393#
278# 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
279# ======================================================================== 395# ========================================================================
280 396
397# @FUNCTION: require_pdo
398# @DESCRIPTION:
281# require a PHP built with PDO support for PHP5 399# Require a PHP built with PDO support (PHP5 only).
282 400# @RETURN: die if feature is missing
283require_pdo() 401require_pdo() {
284{
285 has_php 402 has_php
286 403
287 # do we have php5.1 installed? 404 # Do we have PHP5 installed?
288
289 if [[ ${PHP_VERSION} == 4 ]] ; then 405 if [[ "${PHP_VERSION}" == "4" ]] ; then
290 eerror 406 eerror
291 eerror "This package requires PDO." 407 eerror "This package requires PDO."
292 eerror "PDO is only available for PHP 5." 408 eerror "PDO is only available for PHP 5."
293 eerror "Please install dev-lang/php-5*" 409 eerror "You must install >=dev-lang/php-5.1 with"
410 eerror "either the 'pdo' or the 'pdo-external'"
411 eerror "USE flags turned on."
294 eerror 412 eerror
295 die "PHP 5 not installed" 413 die "PHP 5 not installed"
296 fi 414 fi
297 415
298 # was php5 compiled w/ pdo support? 416 # Was PHP5 compiled with internal PDO support?
299 417 if built_with_use =${PHP_PKG} pdo || phpconfutils_built_with_use =${PHP_PKG} pdo ; then
300 if built_with_use =${PHP_PKG} pdo ; then
301 return 418 return
302 fi 419 fi
303 420
304 # ok, maybe PDO was built as an external extension? 421 # Ok, maybe PDO was built as an external extension?
305 422 if ( built_with_use =${PHP_PKG} pdo-external || phpconfutils_built_with_use =${PHP_PKG} pdo-external ) && has_version 'dev-php5/pecl-pdo' ; then
306 if built_with_use =${PHP_PKG} pdo-external && has_version dev-php5/pecl-pdo ; then
307 return 423 return
308 fi 424 fi
309 425
310 # ok, as last resort, it suffices that pecl-pdo was installed to have PDO support 426 # Ok, as last resort, it suffices that pecl-pdo was installed to have PDO support
311
312 if has_version dev-php5/pecl-pdo ; then 427 if has_version 'dev-php5/pecl-pdo' ; then
313 return 428 return
314 fi 429 fi
315 430
316 # if we get here, then we have no PDO support 431 # If we get here, then we don't have PDO support
317
318 eerror 432 eerror
319 eerror "No PDO extension for PHP found." 433 eerror "No PDO extension for PHP found."
320 eerror "Please note that PDO only exists for PHP 5." 434 eerror "Please note that PDO only exists for PHP 5."
321 eerror "Please install a PDO extension for PHP 5," 435 eerror "Please install a PDO extension for PHP 5,"
322 eerror "you must install dev-lang/php-5.0* with" 436 eerror "you must install >=dev-lang/php-5.1 with"
323 eerror "the 'pdo-external' USE flag or you must"
324 eerror "install dev-lang/php-5.1* with either"
325 eerror "the 'pdo' or the 'pdo-external' USE flags" 437 eerror "either the 'pdo' or the 'pdo-external'"
326 eerror "turned on." 438 eerror "USE flags turned on."
327 eerror 439 eerror
328 die "No PDO extension found for PHP 5" 440 die "No PDO extension for PHP 5 found"
329} 441}
330 442
443# @FUNCTION: require_php_cli
444# @DESCRIPTION:
331# determines which installed PHP version has the CLI sapi 445# Determines which installed PHP version has the CLI SAPI enabled.
332# useful for PEAR eclass, or anything which needs to run PHP 446# Useful for PEAR stuff, or anything which needs to run PHP script
333# scripts depending on the cli sapi 447# depending on the CLI SAPI.
334 448# @RETURN: die if feature is missing
335require_php_cli() 449require_php_cli() {
336{
337 # if PHP_PKG is set, then we have remembered our PHP settings 450 # If PHP_PKG is set, then we have remembered our PHP settings
338 # from last time 451 # from last time
339
340 if [[ -n ${PHP_PKG} ]]; then 452 if [[ -n ${PHP_PKG} ]] ; then
341 return 453 return
342 fi 454 fi
343 455
456 local PHP_PACKAGE_FOUND=""
457
344 # detect which PHP version installed 458 # Detect which PHP version we have installed
345 if has_version '=dev-lang/php-4*' ; then 459 if has_version '=dev-lang/php-4*' ; then
346 PHP_PACKAGE_FOUND=1 460 PHP_PACKAGE_FOUND="1"
347 pkg="`best_version '=dev-lang/php-4*'`" 461 pkg="`best_version '=dev-lang/php-4*'`"
348 if built_with_use =${pkg} cli ; then 462 if built_with_use =${pkg} cli || phpconfutils_built_with_use =${pkg} cli ; then
349 PHP_VERSION=4 463 PHP_VERSION="4"
350 fi 464 fi
351 fi 465 fi
352 466
353 if has_version '=dev-lang/php-5*' ; then 467 if has_version '=dev-lang/php-5*' ; then
354 PHP_PACKAGE_FOUND=1 468 PHP_PACKAGE_FOUND="1"
355 pkg="`best_version '=dev-lang/php-5*'`" 469 pkg="`best_version '=dev-lang/php-5*'`"
356 if built_with_use =${pkg} cli ; then 470 if built_with_use =${pkg} cli || phpconfutils_built_with_use =${pkg} cli ; then
357 PHP_VERSION=5 471 PHP_VERSION="5"
358 fi
359 fi 472 fi
473 fi
360 474
361 if [[ -z ${PHP_PACKAGE_FOUND} ]]; then 475 if [[ -z ${PHP_PACKAGE_FOUND} ]] ; then
362 die "Unable to find an installed dev-lang/php package" 476 die "Unable to find an installed dev-lang/php package"
363 fi 477 fi
364 478
365 if [[ -z ${PHP_VERSION} ]]; then 479 if [[ -z ${PHP_VERSION} ]] ; then
366 die "No PHP CLI installed" 480 die "No PHP CLI installed. Re-emerge dev-lang/php with USE=cli."
367 fi 481 fi
368 482
369 # if we get here, then PHP_VERSION tells us which version of PHP we 483 # If we get here, then PHP_VERSION tells us which version of PHP we
370 # want to use 484 # want to use
371
372 uses_php${PHP_VERSION} 485 uses_php${PHP_VERSION}
373} 486}
374 487
488# @FUNCTION: require_php_cgi
489# @DESCRIPTION:
375# determines which installed PHP version has the CGI sapi 490# Determines which installed PHP version has the CGI SAPI enabled.
376# useful for anything which needs to run PHP scripts 491# Useful for anything which needs to run PHP scripts depending on the CGI SAPI.
377# depending on the cgi sapi 492# @RETURN: die if feature is missing
378
379require_php_cgi() 493require_php_cgi() {
380{
381 # if PHP_PKG is set, then we have remembered our PHP settings 494 # If PHP_PKG is set, then we have remembered our PHP settings
382 # from last time 495 # from last time
383
384 if [[ -n ${PHP_PKG} ]]; then 496 if [[ -n ${PHP_PKG} ]] ; then
385 return 497 return
386 fi 498 fi
387 499
500 local PHP_PACKAGE_FOUND=""
501
388 # detect which PHP version installed 502 # Detect which PHP version we have installed
389 if has_version '=dev-lang/php-4*' ; then 503 if has_version '=dev-lang/php-4*' ; then
390 PHP_PACKAGE_FOUND=1 504 PHP_PACKAGE_FOUND="1"
391 pkg="`best_version '=dev-lang/php-4*'`" 505 pkg="`best_version '=dev-lang/php-4*'`"
392 if built_with_use =${pkg} cgi ; then 506 if built_with_use =${pkg} cgi || phpconfutils_built_with_use =${pkg} cgi ; then
393 PHP_VERSION=4 507 PHP_VERSION="4"
394 fi 508 fi
395 fi 509 fi
396 510
397 if has_version '=dev-lang/php-5*' ; then 511 if has_version '=dev-lang/php-5*' ; then
398 PHP_PACKAGE_FOUND=1 512 PHP_PACKAGE_FOUND="1"
399 pkg="`best_version '=dev-lang/php-5*'`" 513 pkg="`best_version '=dev-lang/php-5*'`"
400 if built_with_use =${pkg} cgi ; then 514 if built_with_use =${pkg} cgi || phpconfutils_built_with_use =${pkg} cgi ; then
401 PHP_VERSION=5 515 PHP_VERSION="5"
402 fi
403 fi 516 fi
404 517 fi
518
405 if [[ -z ${PHP_PACKAGE_FOUND} ]]; then 519 if [[ -z ${PHP_PACKAGE_FOUND} ]] ; then
406 die "Unable to find an installed dev-lang/php package" 520 die "Unable to find an installed dev-lang/php package"
407 fi 521 fi
408 522
409 if [[ -z ${PHP_VERSION} ]]; then 523 if [[ -z ${PHP_VERSION} ]] ; then
410 die "No PHP CGI installed" 524 die "No PHP CGI installed. Re-emerge dev-lang/php with USE=cgi."
411 fi 525 fi
412 526
413 # if we get here, then PHP_VERSION tells us which version of PHP we 527 # If we get here, then PHP_VERSION tells us which version of PHP we
414 # want to use 528 # want to use
415
416 uses_php${PHP_VERSION} 529 uses_php${PHP_VERSION}
417} 530}
418 531
532# @FUNCTION: require_sqlite
533# @DESCRIPTION:
419# require a PHP built with sqlite support 534# Require a PHP built with SQLite support
420 535# @RETURN: die if feature is missing
421require_sqlite() 536require_sqlite() {
422{
423 has_php 537 has_php
424 538
425 # has our PHP been built with sqlite? 539 # Has our PHP been built with SQLite support?
426 540 if built_with_use =${PHP_PKG} sqlite || phpconfutils_built_with_use =${PHP_PKG} sqlite ; then
427 if built_with_use =${PHP_PKG} sqlite ; then
428 return 541 return
429 fi 542 fi
430 543
431 # do we have pecl-sqlite installed for PHP 4? 544 # Do we have pecl-sqlite installed for PHP4?
432
433 if [[ ${PHP_VERSION} == 4 ]] ; then 545 if [[ "${PHP_VERSION}" == "4" ]] ; then
434 if has_version dev-php4/pecl-sqlite ; then 546 if has_version 'dev-php4/pecl-sqlite' ; then
435 return 547 return
436 fi 548 fi
437 fi 549 fi
438 550
439 # if we get here, then we don't have any sqlite support for PHP installed 551 # If we get here, then we don't have any SQLite support for PHP installed
440
441 eerror 552 eerror
442 eerror "No sqlite extension for PHP found." 553 eerror "No SQLite extension for PHP found."
443 eerror "Please install an sqlite extension for PHP," 554 eerror "Please install an SQLite extension for PHP,"
444 eerror "this is done best by simply adding the" 555 eerror "this is done best by simply adding the"
445 eerror "'sqlite' USE flag when emerging dev-lang/php." 556 eerror "'sqlite' USE flag when emerging dev-lang/php."
446 eerror 557 eerror
447 die "No sqlite extension for PHP found" 558 die "No SQLite extension for PHP found"
448} 559}
449 560
561# @FUNCTION: require_gd
562# @DESCRIPTION:
450# require a PHP built with GD support 563# Require a PHP built with GD support
451 564# @RETURN: die if feature is missing
452require_gd() 565require_gd() {
453{
454 has_php 566 has_php
455 567
456 # do we have the internal GD support installed? 568 # Do we have the internal GD support installed?
457 569 if built_with_use =${PHP_PKG} gd || phpconfutils_built_with_use =${PHP_PKG} gd ; then
458 if built_with_use =${PHP_PKG} gd ; then
459 return 570 return
460 fi 571 fi
461 572
462 # ok, maybe GD was built using the external support? 573 # Ok, maybe GD was built using the external library support?
463 574 if built_with_use =${PHP_PKG} gd-external || phpconfutils_built_with_use =${PHP_PKG} gd-external ; then
464 if built_with_use =${PHP_PKG} gd-external ; then
465 return 575 return
466 fi 576 fi
467 577
468 # if we get here, then we have no GD support 578 # If we get here, then we have no GD support
469
470 eerror 579 eerror
471 eerror "No GD support for PHP found." 580 eerror "No GD support for PHP found."
472 eerror "Please install the GD support for PHP," 581 eerror "Please install the GD support for PHP,"
473 eerror "you must install dev-lang/php with either" 582 eerror "you must install dev-lang/php with either"
474 eerror "the 'gd' or the 'gd-external' USE flags" 583 eerror "the 'gd' or the 'gd-external' USE flags"
… …
481# Misc functions 590# Misc functions
482# 591#
483# These functions provide miscellaneous checks and functionality. 592# These functions provide miscellaneous checks and functionality.
484# ======================================================================== 593# ========================================================================
485 594
595# @FUNCTION: php_binary_extension
596# @DESCRIPTION:
486# executes some checks needed when installing a binary PHP extension 597# Executes some checks needed when installing a binary PHP extension.
487
488php_binary_extension() { 598php_binary_extension() {
489 has_php 599 has_php
490 600
601 local PUSE_ENABLED=""
602
491 # binary extensions do not support the change of PHP 603 # Binary extensions do not support the change of PHP
492 # API version, so they can't be installed when USE flags 604 # API version, so they can't be installed when USE flags
493 # are enabled wich change the PHP API version 605 # are enabled which change the PHP API version, they also
606 # don't provide correctly versioned symbols for our use
494 607
495 if built_with_use =${PHP_PKG} hardenedphp ; then 608 if has_debug ; then
496 eerror
497 eerror "You cannot install binary PHP extensions"
498 eerror "when the 'hardenedphp' USE flag is enabled!"
499 eerror "Please reemerge dev-lang/php with the"
500 eerror "'hardenedphp' USE flag turned off."
501 eerror
502 die "'hardenedphp' USE flag turned on"
503 fi
504
505 if built_with_use =${PHP_PKG} debug ; then
506 eerror 609 eerror
507 eerror "You cannot install binary PHP extensions" 610 eerror "You cannot install binary PHP extensions"
508 eerror "when the 'debug' USE flag is enabled!" 611 eerror "when the 'debug' USE flag is enabled!"
509 eerror "Please reemerge dev-lang/php with the" 612 eerror "Please reemerge dev-lang/php with the"
510 eerror "'debug' USE flag turned off." 613 eerror "'debug' USE flag turned off."
511 eerror 614 eerror
512 die "'debug' USE flag turned on" 615 PUSE_ENABLED="1"
513 fi 616 fi
514}
515 617
618 if has_concurrentmodphp ; then
619 eerror
620 eerror "You cannot install binary PHP extensions when"
621 eerror "the 'concurrentmodphp' USE flag is enabled!"
622 eerror "Please reemerge dev-lang/php with the"
623 eerror "'concurrentmodphp' USE flag turned off."
624 eerror
625 PUSE_ENABLED="1"
626 fi
627
628 if [[ -n ${PUSE_ENABLED} ]] ; then
629 die "'debug' and/or 'concurrentmodphp' USE flags turned on!"
630 fi
631}
632
633# @FUNCTION: dodoc-php
634# @USAGE: <list of docs>
635# @DESCRIPTION:
516# alternative to dodoc for use in our php eclasses and ebuilds 636# Alternative to dodoc function for use in our PHP eclasses and ebuilds.
517# stored here because depend.php gets always sourced everywhere 637# Stored here because depend.php gets always sourced everywhere in the PHP
518# in the PHP ebuilds and eclasses
519# it simply is dodoc with a changed path to the docs 638# ebuilds and eclasses. It simply is dodoc with a changed path to the docs.
520# no support for docinto is given! 639# NOTE: No support for docinto is provided!
521
522dodoc-php() 640dodoc-php() {
523{
524if [ $# -lt 1 ] ; then 641if [[ $# -lt 1 ]] ; then
525 echo "$0: at least one argument needed" 1>&2 642 echo "$0: at least one argument needed" 1>&2
526 exit 1 643 exit 1
527fi 644fi
528 645
529phpdocdir="${D}/usr/share/doc/${CATEGORY}/${PF}/" 646phpdocdir="${D}/usr/share/doc/${CATEGORY}/${PF}/"
530 647
531if [ ! -d "${phpdocdir}" ] ; then 648if [[ ! -d "${phpdocdir}" ]] ; then
532 install -d "${phpdocdir}" 649 install -d "${phpdocdir}"
533fi 650fi
534 651
535for x in "$@" ; do 652for x in $@ ; do
536 if [ -s "${x}" ] ; then 653 if [[ -s "${x}" ]] ; then
537 install -m0644 "${x}" "${phpdocdir}" 654 install -m0644 "${x}" "${phpdocdir}"
538 gzip -f -9 "${phpdocdir}/${x##*/}" 655 gzip -f -9 "${phpdocdir}/${x##*/}"
539 elif [ ! -e "${x}" ] ; then 656 elif [[ ! -e "${x}" ]] ; then
540 echo "dodoc-php: ${x} does not exist" 1>&2 657 echo "dodoc-php: ${x} does not exist" 1>&2
541 fi 658 fi
542done 659done
543} 660}
Legend:
Removed from v.1.10  
changed lines
  Added in v.1.21
  ViewVC Help
Powered by ViewVC 1.1.13