gentoo-x86/eclass/depend.php.eclass

# Copyright 1999-2005 Gentoo Foundation
# Distributed under the terms of the GNU General Public License v2
# $Header: /var/cvsroot/gentoo-x86/eclass/depend.php.eclass,v 1.10 2006/01/21 09:15:08 sebastian Exp $
#
# ========================================================================
#
# depend.php.eclass
#               functions to allow ebuilds to depend on php4 and/or php5
#
# Author:       Stuart Herbert
#                       <stuart@gentoo.org>
#
# Author:       Luca Longinotti
#                       <chtekk@gentoo.org>
#
# Maintained by the PHP Herd <php-bugs@gentoo.org>
#
# ========================================================================

inherit eutils

# PHP4-only depend functions
need_php4_cli()
{
        DEPEND="${DEPEND} =virtual/php-4*"
        RDEPEND="${RDEPEND} =virtual/php-4*"
        PHP_VERSION=4
}

need_php4_httpd()
{
        DEPEND="${DEPEND} =virtual/httpd-php-4*"
        RDEPEND="${RDEPEND} =virtual/httpd-php-4*"
        PHP_VERSION=4
}

need_php4()
{
        DEPEND="${DEPEND} =dev-lang/php-4*"
        RDEPEND="${RDEPEND} =dev-lang/php-4*"
        PHP_VERSION=4
        PHP_SHARED_CAT="php4"
}

# common settings go in here
uses_php4()
{
        # cache this
        libdir=$(get_libdir)

        PHPIZE="/usr/${libdir}/php4/bin/phpize"
        PHPCONFIG="/usr/${libdir}/php4/bin/php-config"
        PHPCLI="/usr/${libdir}/php4/bin/php"
        PHPCGI="/usr/${libdir}/php4/bin/php-cgi"
        PHP_PKG="`best_version =dev-lang/php-4*`"
        PHPPREFIX="/usr/${libdir}/php4"

        einfo
        einfo "Using ${PHP_PKG}"
        einfo
}

# PHP5-only depend functions
need_php5_cli()
{
        DEPEND="${DEPEND} =virtual/php-5*"
        RDEPEND="${RDEPEND} =virtual/php-5*"
        PHP_VERSION=5
}

need_php5_httpd()
{
        DEPEND="${DEPEND} =virtual/httpd-php-5*"
        RDEPEND="${RDEPEND} =virtual/httpd-php-5*"
        PHP_VERSION=5
}

need_php5()
{
        DEPEND="${DEPEND} =dev-lang/php-5*"
        RDEPEND="${RDEPEND} =dev-lang/php-5*"
        PHP_VERSION=5
        PHP_SHARED_CAT="php5"
}

# common settings go in here
uses_php5()
{
        # cache this
        libdir=$(get_libdir)

        PHPIZE="/usr/${libdir}/php5/bin/phpize"
        PHPCONFIG="/usr/${libdir}/php5/bin/php-config"
        PHPCLI="/usr/${libdir}/php5/bin/php"
        PHPCGI="/usr/${libdir}/php5/bin/php-cgi"
        PHP_PKG="`best_version =dev-lang/php-5*`"
        PHPPREFIX="/usr/${libdir}/php5"

        einfo
        einfo "Using ${PHP_PKG}"
        einfo
}

# general PHP depend functions
need_php_cli()
{
        DEPEND="${DEPEND} virtual/php"
        RDEPEND="${RDEPEND} virtual/php"
}

need_php_httpd()
{
        DEPEND="${DEPEND} virtual/httpd-php"
        RDEPEND="${RDEPEND} virtual/httpd-php"
}

need_php()
{
        DEPEND="${DEPEND} dev-lang/php"
        RDEPEND="${RDEPEND} dev-lang/php"
        PHP_SHARED_CAT="php"
}

need_php_by_category()
{
        case "${CATEGORY}" in
                dev-php) need_php ;;
                dev-php4) need_php4 ;;
                dev-php5) need_php5 ;;
                *) die "I don't know which version of PHP packages in ${CATEGORY} require"
        esac
}

# call this function from pkg_setup if your PHP extension only works with
# specific SAPIs
#
# this function will disappear when USE-based deps are supported by
# Portage
#
# $1 ... a list of SAPI USE flags (eg cli, cgi, apache2)
#
# returns if any one of the listed SAPIs has been installed
# dies if none of the listed SAPIs has been installed

require_php_sapi_from()
{
        has_php

        local has_sapi=0
        local x

        einfo "Checking for compatible SAPI(s)"

        for x in $@ ; do
                if built_with_use =${PHP_PKG} ${x} ; then
                        einfo "  Discovered compatible SAPI ${x}"
                        has_sapi=1
                fi
        done

        if [[ ${has_sapi} == 1 ]]; then
                return
        fi

        eerror
        eerror "${PHP_PKG} needs to be re-installed with one of the following"
        eerror "USE flags enabled:"
        eerror
        eerror "  $@"
        eerror
        die "Re-install ${PHP_PKG}"
}

# call this function from pkg_setup if your package requires PHP compiled
# with specific USE flags
#
# this function will disappear when USE-based deps are supported by
# Portage
#
# $1 ... a list of USE flags
#
# returns if all of the listed USE flags are set
# dies if any of the listed USE flags are not set

require_php_with_use()
{
        has_php

        local missing_use=""
        local x

        einfo "Checking for required PHP feature(s):"

        for x in $@ ; do
                if ! built_with_use =${PHP_PKG} ${x} ; then
                        einfo "  Discovered missing USE flag ${x}"
                        missing_use="${missing_use} ${x}"
                fi
        done

        if [[ -z ${missing_use} ]] ; then
                return
        fi

        eerror
        eerror "${PHP_PKG} needs to be re-installed with all of the following"
        eerror "USE flags enabled:"
        eerror
        eerror "  $@"
        eerror
        die "Re-install ${PHP_PKG}"
}

# call this function from your pkg_setup, src_compile & src_install methods
# if you need to know where the PHP binaries are installed and their data

has_php()
{
        # if PHP_PKG is set, then we have remembered our PHP settings
        # from last time

        if [[ -n ${PHP_PKG} ]] ; then
                return
        fi

        if [[ -z ${PHP_VERSION} ]] ; then
                # detect which PHP version installed
                if has_version '=dev-lang/php-5*' ; then
                        PHP_VERSION=5
                elif has_version '=dev-lang/php-4*' ; then
                        PHP_VERSION=4
                else
                        die "Unable to find an installed dev-lang/php package"
                fi
        fi

        # if we get here, then PHP_VERSION tells us which version of PHP we
        # want to use

        uses_php${PHP_VERSION}
}

# ========================================================================
# has_*() functions
#
# these functions return 0 if the condition is satisfied, or 1 otherwise
# ========================================================================

# check if our PHP was compiled with ZTS (Zend Thread Safety)

has_zts()
{
        has_php

        if built_with_use =${PHP_PKG} apache2 threads ; then
                return 0
        fi

        return 1
}

# check if our PHP was built with Hardened-PHP active

has_hardenedphp()
{
        has_php

        if built_with_use =${PHP_PKG} hardenedphp ; then
                return 0
        fi

        return 1
}

# ========================================================================
# require_*() functions
#
# These functions die() if PHP was built without the required USE flag(s)
# ========================================================================

# require a PHP built with PDO support for PHP5

require_pdo()
{
        has_php

        # do we have php5 installed?

        if [[ ${PHP_VERSION} == 4 ]] ; then
                eerror
                eerror "This package requires PDO."
                eerror "PDO is only available for PHP 5."
                eerror "You must install =dev-lang/php-5.0* with"
                eerror "the 'pdo-external' USE flag or you must"
                eerror "install >=dev-lang/php-5.1 with either"
                eerror "the 'pdo' or the 'pdo-external' USE flags"
                eerror "turned on."
                eerror
                die "PHP 5 not installed"
        fi

        # was php5 compiled w/ pdo support?

        if built_with_use =${PHP_PKG} pdo ; then
                return
        fi

        # ok, maybe PDO was built as an external extension?

        if built_with_use =${PHP_PKG} pdo-external && has_version dev-php5/pecl-pdo ; then
                return
        fi

        # ok, as last resort, it suffices that pecl-pdo was installed to have PDO support

        if has_version dev-php5/pecl-pdo ; then
                return
        fi

        # if we get here, then we have no PDO support

        eerror
        eerror "No PDO extension for PHP found."
        eerror "Please note that PDO only exists for PHP 5."
        eerror "Please install a PDO extension for PHP 5,"
        eerror "you must install =dev-lang/php-5.0* with"
        eerror "the 'pdo-external' USE flag or you must"
        eerror "install >=dev-lang/php-5.1 with either"
        eerror "the 'pdo' or the 'pdo-external' USE flags"
        eerror "turned on."
        eerror
        die "No PDO extension found for PHP 5"
}

# determines which installed PHP version has the CLI sapi
# useful for PEAR eclass, or anything which needs to run PHP
# scripts depending on the cli sapi

require_php_cli()
{
        # if PHP_PKG is set, then we have remembered our PHP settings
        # from last time

        if [[ -n ${PHP_PKG} ]] ; then
                return
        fi

        # detect which PHP version installed
        if has_version '=dev-lang/php-4*' ; then
                PHP_PACKAGE_FOUND=1
                pkg="`best_version '=dev-lang/php-4*'`"
                if built_with_use =${pkg} cli ; then
                        PHP_VERSION=4
                fi
        fi

        if has_version '=dev-lang/php-5*' ; then
                PHP_PACKAGE_FOUND=1
                pkg="`best_version '=dev-lang/php-5*'`"
                if built_with_use =${pkg} cli ; then
                        PHP_VERSION=5
                fi
        fi

        if [[ -z ${PHP_PACKAGE_FOUND} ]] ; then
                die "Unable to find an installed dev-lang/php package"
        fi

        if [[ -z ${PHP_VERSION} ]] ; then
                die "No PHP CLI installed"
        fi

        # if we get here, then PHP_VERSION tells us which version of PHP we
        # want to use

        uses_php${PHP_VERSION}
}

# determines which installed PHP version has the CGI sapi
# useful for anything which needs to run PHP scripts
# depending on the cgi sapi

require_php_cgi()
{
        # if PHP_PKG is set, then we have remembered our PHP settings
        # from last time

        if [[ -n ${PHP_PKG} ]] ; then
                return
        fi

        # detect which PHP version installed
        if has_version '=dev-lang/php-4*' ; then
                PHP_PACKAGE_FOUND=1
                pkg="`best_version '=dev-lang/php-4*'`"
                if built_with_use =${pkg} cgi ; then
                        PHP_VERSION=4
                fi
        fi

        if has_version '=dev-lang/php-5*' ; then
                PHP_PACKAGE_FOUND=1
                pkg="`best_version '=dev-lang/php-5*'`"
                if built_with_use =${pkg} cgi ; then
                        PHP_VERSION=5
                fi
        fi

        if [[ -z ${PHP_PACKAGE_FOUND} ]] ; then
                die "Unable to find an installed dev-lang/php package"
        fi

        if [[ -z ${PHP_VERSION} ]] ; then
                die "No PHP CGI installed"
        fi

        # if we get here, then PHP_VERSION tells us which version of PHP we
        # want to use

        uses_php${PHP_VERSION}
}

# require a PHP built with sqlite support

require_sqlite()
{
        has_php

        # has our PHP been built with sqlite?

        if built_with_use =${PHP_PKG} sqlite ; then
                return
        fi

        # do we have pecl-sqlite installed for PHP 4?

        if [[ ${PHP_VERSION} == 4 ]] ; then
                if has_version dev-php4/pecl-sqlite ; then
                        return
                fi
        fi

        # if we get here, then we don't have any sqlite support for PHP installed

        eerror
        eerror "No sqlite extension for PHP found."
        eerror "Please install an sqlite extension for PHP,"
        eerror "this is done best by simply adding the"
        eerror "'sqlite' USE flag when emerging dev-lang/php."
        eerror
        die "No sqlite extension for PHP found"
}

# require a PHP built with GD support

require_gd()
{
        has_php

        # do we have the internal GD support installed?

        if built_with_use =${PHP_PKG} gd ; then
                return
        fi

        # ok, maybe GD was built using the external support?

        if built_with_use =${PHP_PKG} gd-external ; then
                return
        fi

        # if we get here, then we have no GD support

        eerror
        eerror "No GD support for PHP found."
        eerror "Please install the GD support for PHP,"
        eerror "you must install dev-lang/php with either"
        eerror "the 'gd' or the 'gd-external' USE flags"
        eerror "turned on."
        eerror
        die "No GD support found for PHP"
}

# ========================================================================
# Misc functions
#
# These functions provide miscellaneous checks and functionality.
# ========================================================================

# executes some checks needed when installing a binary PHP extension

php_binary_extension() {
        has_php

        # binary extensions do not support the change of PHP
        # API version, so they can't be installed when USE flags
        # are enabled wich change the PHP API version

        if built_with_use =${PHP_PKG} hardenedphp ; then
                eerror
                eerror "You cannot install binary PHP extensions"
                eerror "when the 'hardenedphp' USE flag is enabled!"
                eerror "Please reemerge dev-lang/php with the"
                eerror "'hardenedphp' USE flag turned off."
                eerror
                die "'hardenedphp' USE flag turned on"
        fi

        if built_with_use =${PHP_PKG} debug ; then
                eerror
                eerror "You cannot install binary PHP extensions"
                eerror "when the 'debug' USE flag is enabled!"
                eerror "Please reemerge dev-lang/php with the"
                eerror "'debug' USE flag turned off."
                eerror
                die "'debug' USE flag turned on"
        fi
}

# alternative to dodoc for use in our php eclasses and ebuilds
# stored here because depend.php gets always sourced everywhere
# in the PHP ebuilds and eclasses
# it simply is dodoc with a changed path to the docs
# no support for docinto is given!

dodoc-php()
{
if [ $# -lt 1 ] ; then
        echo "$0: at least one argument needed" 1>&2
        exit 1
fi

phpdocdir="${D}/usr/share/doc/${CATEGORY}/${PF}/"

if [ ! -d "${phpdocdir}" ] ; then
        install -d "${phpdocdir}"
fi

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