Add a bit more documentation about USES=php and extensions.

Reviewed by:	bcr
Sponsored by:	Absolight
Differential Revision:	https://reviews.freebsd.org/D7284
This commit is contained in:
Mathieu Arnold 2016-08-03 12:54:53 +00:00
parent 01250c045f
commit b9d95057e7
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=49209

View file

@ -1846,6 +1846,57 @@ USE_MATE= menus:build intlhack</programlisting>
</listitem>
</varlistentry>
</variablelist>
<para>When building a <application>PHP</application> or
<application>Zend</application> extension with
<literal>:ext</literal> or <literal>:zend</literal>, these
variables can be set:</para>
<variablelist>
<varlistentry>
<term><varname>PHP_MODNAME</varname></term>
<listitem>
<para>The name of the <application>PHP</application> or
<application>Zend</application> extension. Default value
is <literal>${PORTNAME}</literal>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>PHP_HEADER_DIRS</varname></term>
<listitem>
<para>A list of subdirectories from which to install header
files. The framework will always install the header files
that are present in the same directory as the
extension.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>PHP_MOD_PRIO</varname></term>
<listitem>
<para>The priority at which to load the extension. It is a
number between <literal>00</literal> and
<literal>99</literal>.</para>
<para>For extensions that do not depend on any extension,
the priority is automatically set to
<literal>20</literal>, for extensions that depend on
another extension, the priority is automatically set to
<literal>30</literal>. Some extensions may need to be
loaded before every other extension, for example <package
role="port">www/php56-opcache</package>. Some may need
to be loaded after an extension with a priority of
<literal>30</literal>. In that case, add
<literal>PHP_MOD_PRIO=<replaceable>XX</replaceable></literal>
in the port's Makefile. For example:</para>
<programlisting>USES= php:ext
USE_PHP= wddx
PHP_MOD_PRIO= 40</programlisting>
</listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 xml:id="uses-pkgconfig">