<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->

<section xml:id="intl.configuration" xmlns="http://docbook.org/ns/docbook"
 xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  <table>
   <title>Intl &ConfigureOptions;</title>
   <tgroup cols="4">
    <thead>
     <row>
      <entry>&Name;</entry>
      <entry>&Default;</entry>
      <entry>&Changeable;</entry>
      <entry>&Changelog;</entry>
     </row>
    </thead>
    <tbody xml:id="intl.configuration.list">
     <row>
      <entry><link linkend="ini.intl.default-locale">intl.default_locale</link></entry>
      <entry></entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.intl.error-level">intl.error_level</link></entry>
      <entry>0</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.intl.use-exceptions">intl.use_exceptions</link></entry>
      <entry>0</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Available since PECL 3.0.0a1</entry>
     </row>
    </tbody>
   </tgroup>
  </table>
 </para>

 &ini.descriptions.title;

 <para>
  <variablelist>
   <varlistentry xml:id="ini.intl.default-locale">
     <term>
      <parameter>intl.default_locale</parameter>
      <type>string</type>
     </term>
     <listitem>
      <para>
       The locale that will be used in intl functions when none is specified
       (either by omitting the corresponding argument or by passing
       <literal>NULL</literal>). These are ICU locales, not system locales.
       The built-in ICU locales and their data can be explored at
       <link xlink:href="&url.icu.locales;"/>.
      </para>
      <para>
       The default value is empty, which forces the usage of ICU's default
       locale. Once set, the ini setting cannot be reset to this default value.
       It is not recommended that this default be relied on, as its effective
       value depends on the server's environment.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="ini.intl.error-level">
     <term>
      <parameter>intl.error_level</parameter>
      <type>int</type>
     </term>
     <listitem>
      <para>
       The type of the error messages generated when an error occurs in ICU
       functions. This is a
       <link linkend="errorfunc.constants">PHP error level</link>, such as
       <constant>E_WARNING</constant>. It can be set to <literal>0</literal>
       in order to inhibit the messages. This does not affect the return values
       indicating error or the values returned by
       <function>intl_get_error_code</function> or by the class specific
       methods for retrieving error codes and messages.
      </para>
      <para>
       The default value is <literal>0</literal>.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="ini.intl.use-exceptions">
     <term>
      <parameter>intl.use_exceptions</parameter>
      <type>int</type>
     </term>
     <listitem>
      <para>
       If set to true, an exception will be raised whenever an error occurs in
       an intl function. The exception will be of type
       <classname>IntlException</classname>. This is possibly in addition to the
       error message generated due to <link
        linkend="ini.intl.error-level">intl.error_level</link>.
      </para>
      <para>The default value is &false;.</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
-->
