<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/mbstring.setup.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'it',
  ),
  'this' => 
  array (
    0 => 'mbstring.configuration.php',
    1 => 'Configurazione di Runtime',
    2 => 'Configurazione di Runtime',
  ),
  'up' => 
  array (
    0 => 'mbstring.setup.php',
    1 => 'Installazione/Configurazione',
  ),
  'prev' => 
  array (
    0 => 'mbstring.installation.php',
    1 => 'Installazione',
  ),
  'next' => 
  array (
    0 => 'mbstring.constants.php',
    1 => 'Costanti predefinite',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'en',
    'path' => 'reference/mbstring/ini.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="mbstring.configuration" class="section">
 <h2 class="title">Configurazione di Runtime</h2>
 <p class="simpara">
Il comportamento di queste funzioni è influenzato dalle impostazioni di <var class="filename">php.ini</var>.
</p>
 <p class="para">
  <table class="doctable table">
   <caption><strong>mbstring configuration options</strong></caption>
   
    <thead>
     <tr>
      <th>Nome</th>
      <th>Default</th>
      <th>Modificabile</th>
      <th>Storico dei cambiamenti</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td><a href="mbstring.configuration.php#ini.mbstring.language" class="link">mbstring.language</a></td>
      <td>&quot;neutral&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td><a href="mbstring.configuration.php#ini.mbstring.detect-order" class="link">mbstring.detect_order</a></td>
      <td>NULL</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td><a href="mbstring.configuration.php#ini.mbstring.http-input" class="link">mbstring.http_input</a></td>
      <td>&quot;pass&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td>Deprecated</td>
     </tr>

     <tr>
      <td><a href="mbstring.configuration.php#ini.mbstring.http-output" class="link">mbstring.http_output</a></td>
      <td>&quot;pass&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td>Deprecated</td>
     </tr>

     <tr>
      <td><a href="mbstring.configuration.php#ini.mbstring.internal-encoding" class="link">mbstring.internal_encoding</a></td>
      <td>NULL</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td>Deprecated</td>
     </tr>

     <tr>
      <td><a href="mbstring.configuration.php#ini.mbstring.substitute-character" class="link">mbstring.substitute_character</a></td>
      <td>NULL</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td><a href="mbstring.configuration.php#ini.mbstring.func-overload" class="link">mbstring.func_overload</a></td>
      <td>&quot;0&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-system">INI_SYSTEM</a></code></strong></td>
      <td>
       Deprecated as of PHP 7.2.0; removed as of PHP 8.0.0.
      </td>
     </tr>

     <tr>
      <td><a href="mbstring.configuration.php#ini.mbstring.encoding-translation" class="link">mbstring.encoding_translation</a></td>
      <td>&quot;0&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-perdir">INI_PERDIR</a></code></strong></td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td><a href="mbstring.configuration.php#ini.mbstring.http-output-conv-mimetypes" class="link">mbstring.http_output_conv_mimetypes</a></td>
      <td>&quot;^(text/|application/xhtml\+xml)&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td><a href="mbstring.configuration.php#ini.mbstring.strict-detection" class="link">mbstring.strict_detection</a></td>
      <td>&quot;0&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td><a href="mbstring.configuration.php#ini.mbstring.regex-retry-limit" class="link">mbstring.regex_retry_limit</a></td>
      <td>&quot;1000000&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td>Available as of PHP 7.4.0.</td>
     </tr>

     <tr>
      <td><a href="mbstring.configuration.php#ini.mbstring.regex-stack-limit" class="link">mbstring.regex_stack_limit</a></td>
      <td>&quot;100000&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td>Available as of PHP 7.3.5.</td>
     </tr>

    </tbody>
   
  </table>

  Per maggiori dettagli e definizioni sui 
modi INI_*, vedere <a href="configuration.changes.modes.php" class="xref">Where a configuration setting may be set</a>.
 </p>
 
 <p class="para">Breve descrizione dei parametri
di configurazione.</p>
 
 <p class="para">
  <dl>
   
    <dt id="ini.mbstring.language">
     <code class="parameter">mbstring.language</code>
     <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
    </dt>
    <dd>
     <p class="para">
      The default national language setting (NLS) used in mbstring. Note that this option
      automagically defines <code class="literal">mbstring.internal_encoding</code> and
      <code class="literal">mbstring.internal_encoding</code> should be placed
      after <code class="literal">mbstring.language</code> in <var class="filename">php.ini</var>
     </p>
    </dd>
   
   
    <dt id="ini.mbstring.encoding-translation">
     <code class="parameter">mbstring.encoding_translation</code>
     <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>
    </dt>
    <dd>
     <p class="para">
      Enables the transparent character encoding filter for the incoming HTTP queries,
      which performs detection and conversion of the input encoding to the
      internal character encoding. 
     </p>
    </dd>
   
   
    <dt id="ini.mbstring.internal-encoding">
     <code class="parameter">mbstring.internal_encoding</code>
     <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
    </dt>
    <dd>
     <div class="warning"><strong class="warning">Avviso</strong>
      <p class="para">Questa funzione deprecata <em>sarà</em>
sicuramente <em>rimossa</em> in futuro.</p>
     </div>
     <p class="para">
      Defines the default internal character encoding.
     </p>
     <p class="para">
      Users should leave this empty and set
      <a href="ini.core.php#ini.default-charset" class="link"><code class="parameter">default_charset</code></a>
      instead.
     </p>
    </dd>
   
   
    <dt id="ini.mbstring.http-input">
     <code class="parameter">mbstring.http_input</code>
     <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
    </dt>
    <dd>
     <div class="warning"><strong class="warning">Avviso</strong>
      <p class="para">Questa funzione deprecata <em>sarà</em>
sicuramente <em>rimossa</em> in futuro.</p>
     </div>
     <p class="para">
      Defines the default HTTP input character encoding.
     </p>
     <p class="para">
      Users should leave this empty and set
      <a href="ini.core.php#ini.default-charset" class="link"><code class="parameter">default_charset</code></a>
      instead.
     </p>
    </dd>
   
   
    <dt id="ini.mbstring.http-output">
     <code class="parameter">mbstring.http_output</code>
     <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
    </dt>
    <dd>
     <div class="warning"><strong class="warning">Avviso</strong>
      <p class="para">Questa funzione deprecata <em>sarà</em>
sicuramente <em>rimossa</em> in futuro.</p>
     </div>
     <p class="para">
      Defines the default HTTP output character encoding (output will be converted from the internal encoding to the HTTP output encoding upon output).
     </p>
     <p class="para">
      Users should leave this empty and set
      <a href="ini.core.php#ini.default-charset" class="link"><code class="parameter">default_charset</code></a>
      instead.
     </p>
    </dd>
   
   
    <dt id="ini.mbstring.detect-order">
     <code class="parameter">mbstring.detect_order</code>
     <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
    </dt>
    <dd>
     <p class="para">
      Defines default character code detection order. See also
      <span class="function"><a href="function.mb-detect-order.php" class="function">mb_detect_order()</a></span>. 
     </p>
    </dd>
   
   
    <dt id="ini.mbstring.substitute-character">
     <code class="parameter">mbstring.substitute_character</code>
     <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
    </dt>
    <dd>
     <p class="para">
      Defines character to substitute for invalid character encoding.
      See <span class="function"><a href="function.mb-substitute-character.php" class="function">mb_substitute_character()</a></span> for supported values.
     </p>
    </dd>
   
   
    <dt id="ini.mbstring.func-overload">
     <code class="parameter">mbstring.func_overload</code>
     <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
    </dt>
    <dd>
     <div class="warning"><strong class="warning">Avviso</strong><p class="simpara">This feature has been
<em>DEPRECATED</em> as of PHP 7.2.0, and <em>REMOVED</em> as of PHP 8.0.0. Relying on this feature
is highly discouraged.</p></div>
     <p class="para">
      Overloads a set of single byte functions by the mbstring counterparts. See
      <a href="mbstring.overload.php" class="link">Function overloading</a> for more
      information.
     </p>
     <p class="para">
      This setting can only be changed from the <var class="filename">php.ini</var> file.
     </p>
    </dd>
   
   
    <dt id="ini.mbstring.http-output-conv-mimetypes">
     <code class="parameter">mbstring.http_output_conv_mimetypes</code>
     <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
    </dt>
    <dd>
     <p class="para">
     </p>
    </dd>
   
   
    <dt id="ini.mbstring.strict-detection">
     <code class="parameter">mbstring.strict_detection</code>
     <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>
    </dt>
    <dd>
     <p class="para">
      Enables strict encoding detection. See <span class="function"><a href="function.mb-detect-encoding.php" class="function">mb_detect_encoding()</a></span>
      for a description and examples.
     </p>
    </dd>
   
   
    <dt id="ini.mbstring.regex-retry-limit">
     <code class="parameter">mbstring.regex_retry_limit</code>
     <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>
    </dt>
    <dd>
     <p class="para">
      Limits the amount of backtracking that may be performed during one mbregex
      match.
     </p>
     <p class="para">
      This setting only takes effect when linking against oniguruma &gt;= 6.8.0.
     </p>
    </dd>
   
   
    <dt id="ini.mbstring.regex-stack-limit">
     <code class="parameter">mbstring.regex_stack_limit</code>
     <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>
    </dt>
    <dd>
     <p class="para">
      Limits the stack depth of mbstring regular expressions.
     </p>
    </dd>
   
  </dl>
 </p>

 <p class="para">
  According to the <a href="http://www.w3.org/TR/REC-html40/interact/forms.html#adef-accept-charset" class="link external">&raquo;&nbsp;HTML 4.01 specification</a>,
  Web browsers are allowed to encode a form being submitted with a character
  encoding different from the one used for the page.
  See <span class="function"><a href="function.mb-http-input.php" class="function">mb_http_input()</a></span> to detect character encoding
  used by browsers.
 </p>
 <p class="para">
  Although popular browsers are capable of giving a reasonably accurate guess
  to the character encoding of a given HTML document, it would be better to
  set the <code class="literal">charset</code> parameter in the
  <code class="literal">Content-Type</code> HTTP header to the appropriate value by
  <span class="function"><a href="function.header.php" class="function">header()</a></span> or
  <a href="ini.core.php#ini.sect.data-handling" class="link">default_charset</a> ini setting.
 </p>
 <p class="para">
  <div class="example" id="example-1">
  <p><strong>Example #1 <var class="filename">php.ini</var> setting examples</strong></p>
   <div class="example-contents">
<div class="annotation-interactive cdata"><pre>
; Set default language
mbstring.language        = Neutral; Set default language to Neutral(UTF-8) (default)
mbstring.language        = English; Set default language to English 
mbstring.language        = Japanese; Set default language to Japanese

;; Set default internal encoding
;; Note: Make sure to use character encoding works with PHP
mbstring.internal_encoding    = UTF-8  ; Set internal encoding to UTF-8

;; HTTP input encoding translation is enabled.
mbstring.encoding_translation = On

;; Set default HTTP input character encoding
;; Note: Script cannot change http_input setting.
mbstring.http_input           = pass    ; No conversion. 
mbstring.http_input           = auto    ; Set HTTP input to auto
                                ; &quot;auto&quot; is expanded according to mbstring.language
mbstring.http_input           = SJIS    ; Set HTTP input to SJIS
mbstring.http_input           = UTF-8,SJIS,EUC-JP ; Specify order

;; Set default HTTP output character encoding 
mbstring.http_output          = pass    ; No conversion
mbstring.http_output          = UTF-8   ; Set HTTP output encoding to UTF-8

;; Set default character encoding detection order
mbstring.detect_order         = auto    ; Set detect order to auto
mbstring.detect_order         = ASCII,JIS,UTF-8,SJIS,EUC-JP ; Specify order

;; Set default substitute character
mbstring.substitute_character = 12307   ; Specify Unicode value
mbstring.substitute_character = none    ; Do not print character
mbstring.substitute_character = long    ; Long Example: U+3000,JIS+7E7E
</pre></div>
   </div>

  </div>
 </p>
 <p class="para">
  <div class="example" id="example-2">
   <p><strong>Example #2 <var class="filename">php.ini</var> setting for <code class="literal">EUC-JP</code> users</strong></p>
   <div class="example-contents">
<div class="annotation-interactive cdata"><pre>
;; Disable Output Buffering
output_buffering      = Off

;; Set HTTP header charset
default_charset       = EUC-JP    

;; Set default language to Japanese
mbstring.language = Japanese

;; HTTP input encoding translation is enabled.
mbstring.encoding_translation = On

;; Set HTTP input encoding conversion to auto
mbstring.http_input   = auto 

;; Convert HTTP output to EUC-JP
mbstring.http_output  = EUC-JP    

;; Set internal encoding to EUC-JP
mbstring.internal_encoding = EUC-JP    

;; Do not print invalid characters
mbstring.substitute_character = none   
</pre></div>
   </div>

  </div>
 </p>
 <p class="para">
  <div class="example" id="example-3">
   <p><strong>Example #3 <var class="filename">php.ini</var> setting for <code class="literal">SJIS</code> users</strong></p>
   <div class="example-contents">
<div class="annotation-interactive cdata"><pre>
;; Enable Output Buffering
output_buffering     = On

;; Set mb_output_handler to enable output conversion
output_handler       = mb_output_handler

;; Set HTTP header charset
default_charset      = Shift_JIS

;; Set default language to Japanese
mbstring.language = Japanese

;; Set http input encoding conversion to auto
mbstring.http_input  = auto 

;; Convert to SJIS
mbstring.http_output = SJIS    

;; Set internal encoding to EUC-JP
mbstring.internal_encoding = EUC-JP    

;; Do not print invalid characters
mbstring.substitute_character = none   
</pre></div>
   </div>

  </div>
 </p>

</div><?php manual_footer($setup); ?>