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

Legend:
Removed from v.1.5  
changed lines
  Added in v.1.30

  ViewVC Help
Powered by ViewVC 1.1.20