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