1
0
mirror of https://github.com/php/doc-es.git synced 2026-03-26 00:12:06 +01:00
Files
archived-doc-es/reference/mbstring/ini.xml
Pedro Antonio Gil Rodríguez e5a7dadb5d Actualización a la última versión
git-svn-id: https://svn.php.net/repository/phpdoc/es/trunk@334674 c90b9560-bf6c-de11-be94-00142212c4b1
2014-08-30 21:14:12 +00:00

370 lines
12 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b58a71d289a8257a8cefc693a0dfdbaf952a8f93 Maintainer: seros Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->
<section xml:id="mbstring.configuration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.runtime;
&extension.runtime;
<para>
<table>
<title>Opciones de configuración de mbstring</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.mbstring.language">mbstring.language</link></entry>
<entry>"neutral"</entry>
<entry>PHP_INI_ALL</entry>
<entry>
Disponible desde PHP 4.3.0. PHP_INI_PERDIR en PHP &lt;= 5.2.6
</entry>
</row>
<row>
<entry><link linkend="ini.mbstring.detect-order">mbstring.detect_order</link></entry>
<entry>NULL</entry>
<entry>PHP_INI_ALL</entry>
<entry>Disponible desde PHP 4.0.6.</entry>
</row>
<row>
<entry><link linkend="ini.mbstring.http-input">mbstring.http_input</link></entry>
<entry>"pass"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Disponible desde PHP 4.0.6. Obsoleta en PHP 5.6.0.</entry>
</row>
<row>
<entry><link linkend="ini.mbstring.http-output">mbstring.http_output</link></entry>
<entry>"pass"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Disponible desde PHP 4.0.6. Obsoleta en PHP 5.6.0.</entry>
</row>
<row>
<entry><link linkend="ini.mbstring.internal-encoding">mbstring.internal_encoding</link></entry>
<entry>NULL</entry>
<entry>PHP_INI_ALL</entry>
<entry>Disponible desde PHP 4.0.6. Obsoleta en PHP 5.6.0.</entry>
</row>
<row>
<entry>mbstring.script_encoding</entry>
<entry>NULL</entry>
<entry>PHP_INI_ALL</entry>
<entry>Disponible desde PHP 4.3.0. Eliminado en PHP 5.4.0. Use <link linkend="ini.zend.script-encoding">zend.script_encoding</link> en su lugar.</entry>
</row>
<row>
<entry><link linkend="ini.mbstring.substitute-character">mbstring.substitute_character</link></entry>
<entry>NULL</entry>
<entry>PHP_INI_ALL</entry>
<entry>Disponible desde PHP 4.0.6.</entry>
</row>
<row>
<entry><link linkend="ini.mbstring.func-overload">mbstring.func_overload</link></entry>
<entry>"0"</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>
PHP_INI_PERDIR desde PHP 4.3 a 5.2.6, en versiones distintas PHP_INI_SYSTEM.
Disponible desde PHP 4.2.0.
</entry>
</row>
<row>
<entry><link linkend="ini.mbstring.encoding-translation">mbstring.encoding_translation</link></entry>
<entry>"0"</entry>
<entry>PHP_INI_PERDIR</entry>
<entry>Disponible desde PHP 4.3.0.</entry>
</row>
<row>
<entry><link linkend="ini.mbstring.strict-detection">mbstring.strict_detection</link></entry>
<entry>"0"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Disponible desde PHP 5.1.2.</entry>
</row>
</tbody>
</tgroup>
</table>
&ini.php.constants;
</para>
&ini.descriptions.title;
<para>
<variablelist>
<varlistentry xml:id="ini.mbstring.language">
<term>
<parameter>mbstring.language</parameter>
<type>string</type>
</term>
<listitem>
<para>
El ajuste de lenguaje nacional predeterminado (NLS) usado en mbstring. Se ha de observar que esta opción
define automágicamente <literal>mbstring.internal_encoding</literal>, por lo que
se debe colocar <literal>mbstring.internal_encoding</literal>
tras <literal>mbstring.language</literal> en &php.ini;
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mbstring.encoding-translation">
<term>
<parameter>mbstring.encoding_translation</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Habilita el filtro de codificación de caracteres transparente para las consultas HTTP entrantes,
la cual lleva a cabo la detección y la conversión de la codificación de entrada
a la codificación de caracteres interna.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mbstring.internal-encoding">
<term>
<parameter>mbstring.internal_encoding</parameter>
<type>string</type>
</term>
<listitem>
&warn.deprecated.feature-5-6-0;
<para>
Define la codificación de caracteres interna.
</para>
<para>
Los usuarios de PHP 5.6 y posterior deberían dejarla vacía y establecer
<link linkend="ini.default-charset"><parameter>default_charset</parameter></link>
en su lugar.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mbstring.http-input">
<term>
<parameter>mbstring.http_input</parameter>
<type>string</type>
</term>
<listitem>
&warn.deprecated.feature-5-6-0;
<para>
Define la codificación de caracteres predeterminada de entrada de HTTP.
</para>
<para>
Los usuarios de PHP 5.6 y posterior deberían dejarla vacía y establecer
<link linkend="ini.default-charset"><parameter>default_charset</parameter></link>
en su lugar.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mbstring.http-output">
<term>
<parameter>mbstring.http_output</parameter>
<type>string</type>
</term>
<listitem>
&warn.deprecated.feature-5-6-0;
<para>
Define la codificación de caracteres predeterminada de salida de HTTP (la salida será convertida de la codificación interna a la codificación de salida de HTTP).
</para>
<para>
Los usuarios de PHP 5.6 y posterior deberían dejarla vacía y establecer
<link linkend="ini.default-charset"><parameter>default_charset</parameter></link>
en su lugar.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mbstring.detect-order">
<term>
<parameter>mbstring.detect_order</parameter>
<type>string</type>
</term>
<listitem>
<para>
Define el orden de detección de códigos de caracteres predeterminado. Véase también
<function>mb_detect_order</function>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mbstring.substitute-character">
<term>
<parameter>mbstring.substitute_character</parameter>
<type>string</type>
</term>
<listitem>
<para>
Define el caracter de sustitución para juegos de caracteres inválidos.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mbstring.func-overload">
<term>
<parameter>mbstring.func_overload</parameter>
<type>string</type>
</term>
<listitem>
<para>
Reemplaza determinadas funciones de único byte por sus equivalentes en mbstring. Véase
la sección <link linkend="mbstring.overload">Sobrecarga de funciones</link> para más
información.
</para>
<para>
Este ajuste sólo puede ser cambiado en el archivo &php.ini;
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mbstring.strict-detection">
<term>
<parameter>mbstring.strict_detection</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Habilita la detección estricta de codificaciones.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
De acuerdo a la <link xlink:href="&url.spec.html401.accept-charset;">especificación de HTML 4.01</link>,
se permite que los navegadores envíen un formulario con una codificación
diferente a la utilizada por la página.
Véase <function>mb_http_input</function> para consultar los juegos de caracteres
utilizados por los navegadores.
</para>
<para>
Pese a que la mayoría de navegadores son capaces de averiguar la codificación
de un determinado documento HTML, es aconsejable utilizar el
parámetro <literal>charset</literal> en la cabecera
<literal>Content-Type</literal> de HTTP con un valor apropiado, mediante
<function>header</function> o mediante el ajuste ini
<link linkend="ini.sect.data-handling">default_charset</link>.
</para>
<para>
<example>
<title>Ejemplos de ajustes de &php.ini;</title>
<programlisting>
<![CDATA[
; Establecer el lenguaje predeterminado
mbstring.language = Neutral; Establecer el lenguaje neutral(UTF-8) (predeterminado)
mbstring.language = English; Establecer como lenguaje el inglés
mbstring.language = Japanese; Establecer como lenguaje el japonés
;; Establecer la codificación interna predeterminada
;; Nota: Asegúrese de usar una codificación que funcione con PHP
mbstring.internal_encoding = UTF-8 ; Establecer la codificación interna a UTF-8
;; Traducción de codificación HTTP entrante habilitada
mbstring.encoding_translation = On
;; Establecer la codificación de caracteres predeterminada de HTTP entrante
;; Nota: Un script no podrá cambiar el ajuste http_input.
mbstring.http_input = pass ; Sin conversión.
mbstring.http_input = auto ; Establecer la entrada HTTP en automático
; "auto" se expande de acuerdo a mbstring.language
mbstring.http_input = SJIS ; Establecer la entrada HTTP a SJIS
mbstring.http_input = UTF-8,SJIS,EUC-JP ; Especificar el orden
;; Establecer la codificación de caracteres predeterminada de HTTP saliente
mbstring.http_output = pass ; Sin conversión
mbstring.http_output = UTF-8 ; Establecer la codificación de salida HTTP a UTF-8
;; Establecer el orden predeterminado de la detección de juegos de caracteres
mbstring.detect_order = auto ; Orden de detección automático
mbstring.detect_order = ASCII,JIS,UTF-8,SJIS,EUC-JP ; Especificar el orden
;; Establecer el carácter de sustitución predeterminado
mbstring.substitute_character = 12307 ; Especificar un valor Unicode
mbstring.substitute_character = none ; No imprimir el carácter
mbstring.substitute_character = long ; Ejemplo de long: U+3000,JIS+7E7E
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title>Ajustes de &php.ini; para usuarios de <literal>EUC-JP</literal></title>
<programlisting>
<![CDATA[
;; Deshabilitar el almacenamiento en el búfer de salida
output_buffering = Off
;; Establecer el juego de caracteres de las cabeceras HTTP
default_charset = EUC-JP
;; Establecer como lenguaje predeterminado el japonés
mbstring.language = Japanese
;; Habilitar la traducción de la codificación del HTTP entrante.
mbstring.encoding_translation = On
;; Establecer en automática la conversión de la codificación de HTTP entrante
mbstring.http_input = auto
;; Convertir la salida de HTTP a EUC-JP
mbstring.http_output = EUC-JP
;; Establecer EUC-JP como codificación interna
mbstring.internal_encoding = EUC-JP
;; No imprimir caracteres inválidos
mbstring.substitute_character = none
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title>Ajustes de &php.ini; para usuarios de <literal>SJIS</literal></title>
<programlisting>
<![CDATA[
;; Habilitar el almacenamiento en el búfer de salida
output_buffering = On
;; Establecer mb_output_handler para habilitar la conversión de los datos de salida
output_handler = mb_output_handler
;; Establecer el juego de caracteres de las cabeceras HTTP
default_charset = Shift_JIS
;; Establecer como lenguaje predeterminado el japonés
mbstring.language = Japanese
;; Establecer en automático la conversión del juego de caracteres http entrante
mbstring.http_input = auto
;; Convertir a SJIS
mbstring.http_output = SJIS
;; Establecer EUC-JP como codificación interna
mbstring.internal_encoding = EUC-JP
;; No imprimir caracteres inválidos
mbstring.substitute_character = none
]]>
</programlisting>
</example>
</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
-->