<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<section xml:id="filter.configuration" xmlns="http://docbook.org/ns/docbook">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  <table>
   <title>Filter Configuration Options</title>
   <tgroup cols="4">
    <thead>
     <row>
      <entry>&Name;</entry>
      <entry>&Default;</entry>
      <entry>&Changeable;</entry>
      <entry>&Changelog;</entry>
     </row>
    </thead>
    <tbody xml:id="filter.configuration.list">
     <row>
      <entry><link linkend="ini.filter.default">filter.default</link></entry>
      <entry>"unsafe_raw"</entry>
      <entry>PHP_INI_PERDIR</entry>
      <entry>Deprecated as of PHP 8.1.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.filter.default-flags">filter.default_flags</link></entry>
      <entry>NULL</entry>
      <entry>PHP_INI_PERDIR</entry>
      <entry></entry>
     </row>
    </tbody>
   </tgroup>
  </table>
  &ini.php.constants;
</para>

&ini.descriptions.title;

<para>
 <variablelist>
  <varlistentry xml:id="ini.filter.default">
   <term>
    <parameter>filter.default</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     Filter all <varname>$_GET</varname>, <varname>$_POST</varname>,
     <varname>$_COOKIE</varname>,  <varname>$_REQUEST</varname> and
     <varname>$_SERVER</varname> data by this filter.
     Original data can be accessed through <function>filter_input</function>.
    </para>
    <para>
     Accepts the name of the filter you like to use by default. See the
     existing <link linkend="filter.filters">filter list</link> for the list
     of the filter names.
    </para>
    <note>
      <para>
        Be careful about the default flags for the default filters. You should explicitly 
        set them to the value you want. For example, to configure the default filter to
        behave exactly like <function>htmlspecialchars</function> you need to set them
        default flags to 0 as shown below.
      </para>
      <para>
        <example>
          <title>Configuring the default filter to act like htmlspecialchars</title>
          <programlisting role="php">
<![CDATA[
filter.default = full_special_chars
filter.default_flags = 0
]]>
          </programlisting>
        </example>
      </para>
   </note>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ini.filter.default-flags">
   <term>
    <parameter>filter.default_flags</parameter>
    <type>int</type>
   </term>
   <listitem>
    <para>
     Default flags to apply when the default filter is set. This is set to 
     <constant>FILTER_FLAG_NO_ENCODE_QUOTES</constant> by default for backwards
     compatibility reasons.  See the <link linkend="filter.filters.flags">flag list</link>
     for the list of all the flag names.
    </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
-->
