Split big file

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@322056 c90b9560-bf6c-de11-be94-00142212c4b1

appendices/ini.sections.xml

@@ -0,0 +1,121 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+
+ <section xml:id="ini.sections" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <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>
+   These sections are used only in CGI/FastCGI mode and they can not set
+   <link linkend="ini.extension">extension</link> and <link
+   linkend="ini.zend-extension">zend_extension</link> directives.
+  </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>
+ 
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->