<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Runtime Configuration</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="intl.installation.html">Installation</a></div>
<div class="next" style="text-align: right; float: right;"><a href="intl.resources.html">Resource Types</a></div>
<div class="up"><a href="intl.setup.html">Installing/Configuring</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="intl.configuration" class="section">
<h2 class="title">Runtime Configuration</h2>
<p class="simpara">
The behaviour of these functions is affected by settings in <var class="filename">php.ini</var>.
</p>
<p class="para">
<table class="doctable table">
<caption><strong>Intl Configure Options</strong></caption>
<thead>
<tr>
<th>Name</th>
<th>Default</th>
<th>Changeable</th>
<th>Changelog</th>
</tr>
</thead>
<tbody class="tbody">
<tr>
<td><a href="intl.configuration.html#ini.intl.default-locale" class="link">intl.default_locale</a></td>
<td class="empty"> </td>
<td>PHP_INI_ALL</td>
<td class="empty"> </td>
</tr>
<tr>
<td><a href="intl.configuration.html#ini.intl.error-level" class="link">intl.error_level</a></td>
<td>0</td>
<td>PHP_INI_ALL</td>
<td class="empty"> </td>
</tr>
<tr>
<td><a href="intl.configuration.html#ini.intl.use-exceptions" class="link">intl.use_exceptions</a></td>
<td>0</td>
<td>PHP_INI_ALL</td>
<td>Available since PHP 5.5 and PECL 3.0.0a1</td>
</tr>
</tbody>
</table>
</p>
<p class="para">Here's a short explanation of
the configuration directives.</p>
<p class="para">
<dl>
<dt id="ini.intl.default-locale">
<span class="term">
<em><code class="parameter">intl.default_locale</code></em>
<span class="type"><a href="language.types.string.html" class="type string">string</a></span>
</span>
<dd>
<p class="para">
The locale that will be used in intl functions when none is specified
(either by omitting the corresponding argument or by passing
<em>NULL</em>). These are ICU locales, not system locales.
The built-in ICU locales and their data can be explored at
<a href="http://demo.icu-project.org/icu-bin/locexp" class="link external">» http://demo.icu-project.org/icu-bin/locexp</a>.
</p>
<p class="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.
</p>
</dd>
</dt>
<dt id="ini.intl.error-level">
<span class="term">
<em><code class="parameter">intl.error_level</code></em>
<span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
</span>
<dd>
<p class="para">
The level of the error messages generated when an error occurs in ICU
functions. This is a PHP error level, such as
<strong><code>E_WARNING</code></strong>. It can be set to <em>0</em>
in order to inhibit the messages. This does not affect the return values
indicating error or the values returned by
<span class="function"><a href="function.intl-get-error-code.html" class="function">intl_get_error_code()</a></span> or by the class specific
methods for retrieving error codes and messages.
Choosing <em>E_ERROR</em> will terminate the script whenever
an error condition is found on intl classes.
</p>
<p class="para">
The default value is <em>0</em>.
</p>
</dd>
</dt>
<dt id="ini.intl.use-exceptions">
<span class="term">
<em><code class="parameter">intl.use_exceptions</code></em>
<span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
</span>
<dd>
<p class="para">
If set to true, an exception will be raised whenever an error occurs in
an intl function. The exception will be of type
<a href="class.intlexception.html" class="classname">IntlException</a>. This is possibly in addition to the
error message generated due to <a href="intl.configuration.html#ini.intl.error-level" class="link">intl.error_level</a>.
</p>
<p class="para">The default value is <strong><code>FALSE</code></strong>.</p>
</dd>
</dt>
</dl>
</p>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="intl.installation.html">Installation</a></div>
<div class="next" style="text-align: right; float: right;"><a href="intl.resources.html">Resource Types</a></div>
<div class="up"><a href="intl.setup.html">Installing/Configuring</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
