svn commit: r49209 - head/en_US.ISO8859-1/books/porters-handbook/uses

[Mathieu Arnold]

Author: mat
Date: Wed Aug  3 12:54:53 2016
New Revision: 49209
URL: https://svnweb.freebsd.org/changeset/doc/49209

Log:
  Add a bit more documentation about USES=php and extensions.
  
  Reviewed by:	bcr
  Sponsored by:	Absolight
  Differential Revision:	https://reviews.freebsd.org/D7284

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Tue Aug  2 21:53:12 2016	(r49208)
+++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Wed Aug  3 12:54:53 2016	(r49209)
@@ -1846,6 +1846,57 @@ USE_MATE=	menus:build intlhack</programl
 	</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">