<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 297557 $ -->
<section xml:id="info.configuration" xmlns="http://docbook.org/ns/docbook">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  <table>
   <title>PHP Options/Inf Configuration Options</title>
   <tgroup cols="4">
    <thead>
     <row>
      <entry>Name</entry>
      <entry>Default</entry>
      <entry>Changeable</entry>
      <entry>Changelog</entry>
     </row>
    </thead>
    <tbody>
    <row>
     <entry><link linkend="ini.assert.active">assert.active</link></entry>
     <entry>"1"</entry>
     <entry>PHP_INI_ALL</entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.assert.bail">assert.bail</link></entry>
     <entry>"0"</entry>
     <entry>PHP_INI_ALL</entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.assert.warning">assert.warning</link></entry>
     <entry>"1"</entry>
     <entry>PHP_INI_ALL</entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.assert.callback">assert.callback</link></entry>
     <entry>NULL</entry>
     <entry>PHP_INI_ALL</entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.assert.quiet-eval">assert.quiet_eval</link></entry>
     <entry>"0"</entry>
     <entry>PHP_INI_ALL</entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.enable-dl">enable_dl</link></entry>
     <entry>"1"</entry>
     <entry>PHP_INI_SYSTEM</entry>
     <entry>&removed.php.future;</entry>
    </row>
    <row>
     <entry><link linkend="ini.max-execution-time">max_execution_time</link></entry>
     <entry>"30"</entry>
     <entry>PHP_INI_ALL</entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.max-input-time">max_input_time</link></entry>
     <entry>"-1"</entry>
     <entry>PHP_INI_PERDIR</entry>
     <entry>Available since PHP 4.3.0.</entry>
    </row>
    <row>
     <entry><link linkend="ini.max-input-nesting-level">max_input_nesting_level</link></entry>
     <entry>"64"</entry>
     <entry>PHP_INI_PERDIR</entry>
     <entry>Available since PHP 4.4.8. Removed in PHP 5.0.0.</entry>
    </row>
    <row>
     <entry><link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link></entry>
     <entry>"1"</entry>
     <entry>PHP_INI_PERDIR</entry>
     <entry>PHP_INI_ALL in PHP &lt;= 4.2.3. &removed.php.future;</entry>
    </row>
    <row>
     <entry><link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link></entry>
     <entry>"0"</entry>
     <entry>PHP_INI_ALL</entry>
     <entry>&removed.php.future;</entry>
    </row>
    <row>
     <entry><link linkend="ini.zend.enable-gc">zend.enable_gc</link></entry>
     <entry>"1"</entry>
     <entry>PHP_INI_ALL</entry>
     <entry>Available since PHP 5.3.0.</entry>
    </row>
    </tbody>
   </tgroup>
  </table>
  &ini.php.constants;
 </para>
 
 &ini.descriptions.title;
 
 <para>
  <variablelist>
   <varlistentry xml:id="ini.assert.active">
    <term>
     <parameter>assert.active</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Enable <function>assert</function> evaluation.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.assert.bail">
    <term>
     <parameter>assert.bail</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Terminate script execution on failed assertions.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.assert.warning">
    <term>
     <parameter>assert.warning</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Issue a PHP warning for each failed assertion.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.assert.callback">
    <term>
     <parameter>assert.callback</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      user function to call on failed assertions
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.assert.quiet-eval">
    <term>
     <parameter>assert.quiet_eval</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Use the current setting of <function>error_reporting</function> during
      assertion expression evaluation. If enabled, no errors are shown
      (implicit error_reporting(0)) while evaluation. If disabled, errors are
      shown according to the settings of <function>error_reporting</function>
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.enable-dl">
    <term>
      <parameter>enable_dl</parameter>
      <type>boolean</type>
    </term>
    <listitem>
     <para>
      This directive is really only useful in the Apache module
      version of PHP. You can turn dynamic loading of
      PHP extensions with <function>dl</function> on and
      off per virtual server or per directory.
     </para>
     <para>
      The main reason for turning dynamic loading off is
      security. With dynamic loading, it's possible to ignore all
      <link linkend="ini.open-basedir">open_basedir</link> restrictions.
      The default is to allow dynamic loading, except when using
      &safemode;. In &safemode;, it's 
      always impossible to use <function>dl</function>.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.max-execution-time">
    <term>
     <parameter>max_execution_time</parameter>
      <type>integer</type>
    </term>
    <listitem>
     <para>
      This sets the maximum time in seconds a script is allowed to
      run before it is terminated by the parser.  This helps
      prevent poorly written scripts from tying up the server. The
      default setting is <literal>30</literal>.  When running PHP
      from the <link linkend="features.commandline">command
      line</link> the default setting is <literal>0</literal>.
     </para>
     <para>
      The maximum execution time is not affected by system calls,
      stream operations etc.  Please see the
      <function>set_time_limit</function> function for more
      details.
     </para>
     <para>
      You can not change this setting with <function>ini_set</function> when
      running in &safemode;. The only workaround is to turn off safe mode or
      by changing the time limit in the &php.ini;.
     </para>
     <para>
      Your web server can have other timeout configurations that may 
      also interrupt PHP execution. Apache has a 
      <literal>Timeout</literal> directive and IIS has a CGI timeout 
      function. Both default to 300 seconds. See your web server 
      documentation for specific details.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.max-input-time">
    <term>
     <parameter>max_input_time</parameter>
      <type>integer</type>
    </term>
    <listitem>
     <para>
      This sets the maximum time in seconds a script is allowed to
      parse input data, like POST, GET and file uploads.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.max-input-nesting-level">
    <term>
     <parameter>max_input_nesting_level</parameter>
     <type>integer</type>
    </term>
    <listitem>
     <para>
      Sets the max nesting depth of
      <link linkend="language.variables.external">input variables</link> (i.e.
      <varname>$_GET</varname>, <varname>$_POST</varname>..)
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.magic-quotes-gpc">
    <term>
     <parameter>magic_quotes_gpc</parameter>
     <type>boolean</type>
    </term>
     <listitem>
     &warn.deprecated.feature-5-3-0.removed-6-0-0;
     <para>
      Sets the magic_quotes state for GPC (Get/Post/Cookie)
      operations.  When magic_quotes are on, all ' (single-quote),
      &quot; (double quote), \ (backslash) and NUL's are escaped
      with a backslash automatically.
     </para>
     <note>
      <para>
       In PHP 4, also <varname>$_ENV</varname>
       variables are escaped.
      </para>
     </note>
     <note>
      <para>
       If the <link linkend="ini.magic-quotes-sybase">
       magic_quotes_sybase</link> directive is also ON it will
       completely override magic_quotes_gpc.  Having both directives
       enabled means only single quotes are escaped as 
       <emphasis>''</emphasis>.  Double quotes, backslashes and 
       NUL's will remain untouched and unescaped.
      </para>
     </note>
     <para>
      See also <function>get_magic_quotes_gpc</function>
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.magic-quotes-runtime">
    <term>
     <parameter>magic_quotes_runtime</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     &warn.deprecated.feature-5-3-0.removed-6-0-0;
     <para>
      If <parameter>magic_quotes_runtime</parameter> is enabled,
      most functions that return data from any sort of external
      source including databases and text files will have quotes
      escaped with a backslash. If
      <link linkend="ini.magic-quotes-sybase">magic_quotes_sybase</link>
      is also on, a single-quote is escaped with a single-quote instead
      of a backslash.
     </para>
     <para>
      Functions affected by <parameter>magic_quotes_runtime</parameter>
      (does not include functions from PECL):
      <simplelist>
       <member><function>get_meta_tags</function></member>
       <member><function>file_get_contents</function></member>
       <member><function>file</function></member>
       <member><function>fgets</function></member>
       <member><function>fwrite</function></member>
       <member><function>fread</function></member>
       <member><function>fputcsv</function></member>
       <member><function>stream_socket_recvfrom</function></member>
       <member><function>exec</function></member>
       <member><function>system</function></member>
       <member><function>passthru</function></member>
       <member><function>stream_get_contents</function></member>
       <member><function>bzread</function></member>
       <member><function>gzfile</function></member>
       <member><function>gzgets</function></member>
       <member><function>gzwrite</function></member>
       <member><function>gzread</function></member>
       <member><function>phar_file_get_contents</function></member>
       <member><function>exif_read_data</function></member>
       <member><function>dba_insert</function></member>
       <member><function>dba_replace</function></member>
       <member><function>dba_fetch</function></member>
       <member><function>ibase_fetch_row</function></member>
       <member><function>ibase_fetch_assoc</function></member>
       <member><function>ibase_fetch_object</function></member>
       <member><function>mssql_fetch_row</function></member>
       <member><function>mssql_fetch_object</function></member>
       <member><function>mssql_fetch_array</function></member>
       <member><function>mssql_fetch_assoc</function></member>
       <member><function>mysqli_fetch_row</function></member>
       <member><function>mysqli_fetch_array</function></member>
       <member><function>mysqli_fetch_assoc</function></member>
       <member><function>mysqli_fetch_object</function></member>
       <member><function>pg_fetch_row</function></member>
       <member><function>pg_fetch_assoc</function></member>
       <member><function>pg_fetch_array</function></member>
       <member><function>pg_fetch_object</function></member>
       <member><function>pg_fetch_all</function></member>
       <member><function>pg_select</function></member>
       <member><function>sybase_fetch_object</function></member>
       <member><function>sybase_fetch_array</function></member>
       <member><function>sybase_fetch_assoc</function></member>
       <member><function>SplFileObject::fgets</function></member>
       <member><function>SplFileObject::fgetcsv</function></member>
       <member><function>SplFileObject::fwrite</function></member>
      </simplelist>
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.zend.enable-gc">
    <term>
     <parameter>zend.enable_gc</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Enables or disables the circular reference collector.
     </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
-->