From 14dac9caa63b88152a6c57e2ea918a78fc2661cc Mon Sep 17 00:00:00 2001
From: Richard Quadling <rquadling@php.net>
Date: Tue, 17 Jun 2008 09:38:16 +0000
Subject: [PATCH] [HOST=] and [PATH=]

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@261268 c90b9560-bf6c-de11-be94-00142212c4b1
---
 appendices/ini.xml | 95 +++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 94 insertions(+), 1 deletion(-)

diff --git a/appendices/ini.xml b/appendices/ini.xml
index 79d4a20e61..4dcb40f8ab 100644
--- a/appendices/ini.xml
+++ b/appendices/ini.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.69 $ -->
+<!-- $Revision: 1.70 $ -->
 
 <appendix xml:id="ini" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>&php.ini; directives</title>
@@ -3541,6 +3541,99 @@
   </para>
  </section>
 
+ <section xml:id="ini.sections">
+  <title>List of &php.ini; sections</title>
+   <para>
+   This list includes the &php.ini; sections you can set to configure your
+   PHP setup on a per Host or Path basis. These sections are optional.
+  </para>
+  <para>
+   These sections don't directly affect PHP. They are used to group other
+   &php.ini; directives together and to get them to act upon a particular host
+   or on a particular path.
+  </para>
+  <para>
+   <table>
+    <title>Sections</title>
+    <tgroup cols="3">
+     <thead>
+      <row>
+       <entry>Name</entry>
+       <entry>Changeable</entry>
+       <entry>Changelog</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry><link linkend="ini.per-host">[HOST=]</link></entry>
+       <entry>PHP_INI_SYSTEM</entry>
+       <entry>Added in PHP 5.3.0.</entry>
+      </row>
+      <row>
+       <entry><link linkend="ini.per-path">[PATH=]</link></entry>
+       <entry>PHP_INI_SYSTEM</entry>
+       <entry>Added in PHP 5.3.0.</entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </table>
+  </para>
+
+  &ini.descriptions.title;
+
+  <para>
+   <variablelist>
+    <varlistentry xml:id="ini.per-host">
+     <term>
+      <parameter>[HOST=&lt;host&gt;]</parameter>
+     </term>
+     <listitem>
+      <para>
+       This section allows you to define a set of &php.ini; directives that
+       will take effect on the named host.
+      </para>
+      <para>
+       <example>
+        <title>Activate full on-screen error reporting for dev. domain</title>
+        <programlisting role="php.ini">
+<![CDATA[
+[HOST=dev.site.com]
+error_reporting = E_ALL
+display_errors = On
+]]>
+        </programlisting>
+       </example>
+      </para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="ini.per-path">
+     <term>
+       <parameter>[PATH=&lt;path&gt;]</parameter>
+      </term>
+     <listitem>
+      <para>
+       This section allows you to define a set of &php.ini; directives that
+       will take effect when a script runs from the named path.
+      </para>
+      <para>
+       <example>
+        <title>Add security script for protected areas</title>
+        <programlisting role="php.ini">
+<![CDATA[
+[PATH=/home/site/public/secure]
+auto_prepend_file=security.php
+]]>
+        </programlisting>
+       </example>
+      </para>
+     </listitem>
+    </varlistentry>
+
+   </variablelist>
+  </para>
+ </section>
+
  <section xml:id="ini.core">
   <title>Description of core &php.ini; directives</title>
   <para>