mirror of
https://github.com/php/doc-es.git
synced 2026-03-24 07:22:16 +01:00
425 lines
14 KiB
XML
425 lines
14 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
<!-- EN-Revision: d4d5216e7a965ca194f6b1c9dee84cecab2674e5 Maintainer: Marqitos Status: ready -->
|
|
<!-- Reviewed: no Maintainer: julionc -->
|
|
|
|
<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 xml:id="mbstring.configuration.list">
|
|
<row>
|
|
<entry><link linkend="ini.mbstring.language">mbstring.language</link></entry>
|
|
<entry>"neutral"</entry>
|
|
<entry><constant>INI_ALL</constant></entry>
|
|
<entry></entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.mbstring.detect-order">mbstring.detect_order</link></entry>
|
|
<entry>NULL</entry>
|
|
<entry><constant>INI_ALL</constant></entry>
|
|
<entry></entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.mbstring.http-input">mbstring.http_input</link></entry>
|
|
<entry>"pass"</entry>
|
|
<entry><constant>INI_ALL</constant></entry>
|
|
<entry>Obsoleta</entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.mbstring.http-output">mbstring.http_output</link></entry>
|
|
<entry>"pass"</entry>
|
|
<entry><constant>INI_ALL</constant></entry>
|
|
<entry>Obsoleta</entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.mbstring.internal-encoding">mbstring.internal_encoding</link></entry>
|
|
<entry>NULL</entry>
|
|
<entry><constant>INI_ALL</constant></entry>
|
|
<entry>Obsoleta</entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.mbstring.substitute-character">mbstring.substitute_character</link></entry>
|
|
<entry>NULL</entry>
|
|
<entry><constant>INI_ALL</constant></entry>
|
|
<entry></entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.mbstring.func-overload">mbstring.func_overload</link></entry>
|
|
<entry>"0"</entry>
|
|
<entry><constant>INI_SYSTEM</constant></entry>
|
|
<entry>
|
|
Obsoleta desde PHP 7.2.0; eliminada desde PHP 8.0.0.
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.mbstring.encoding-translation">mbstring.encoding_translation</link></entry>
|
|
<entry>"0"</entry>
|
|
<entry><constant>INI_PERDIR</constant></entry>
|
|
<entry></entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.mbstring.http-output-conv-mimetypes">mbstring.http_output_conv_mimetypes</link></entry>
|
|
<entry>"^(text/|application/xhtml\+xml)"</entry>
|
|
<entry><constant>INI_ALL</constant></entry>
|
|
<entry></entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.mbstring.strict-detection">mbstring.strict_detection</link></entry>
|
|
<entry>"0"</entry>
|
|
<entry><constant>INI_ALL</constant></entry>
|
|
<entry></entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.mbstring.regex-retry-limit">mbstring.regex_retry_limit</link></entry>
|
|
<entry>"1000000"</entry>
|
|
<entry><constant>INI_ALL</constant></entry>
|
|
<entry>Disponible a partir de PHP 7.4.0.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.mbstring.regex-stack-limit">mbstring.regex_stack_limit</link></entry>
|
|
<entry>"100000"</entry>
|
|
<entry><constant>INI_ALL</constant></entry>
|
|
<entry>Disponible a partir de PHP 7.3.5.</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>bool</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>
|
|
<warning>
|
|
<para>&removed.php.future;</para>
|
|
</warning>
|
|
<para>
|
|
Define la codificación de caracteres interna.
|
|
</para>
|
|
<para>
|
|
Los usuarios 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>
|
|
<warning>
|
|
<para>&removed.php.future;</para>
|
|
</warning>
|
|
<para>
|
|
Define la codificación de caracteres predeterminada de entrada de HTTP.
|
|
</para>
|
|
<para>
|
|
Los usuarios 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>
|
|
<warning>
|
|
<para>&removed.php.future;</para>
|
|
</warning>
|
|
<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 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.
|
|
Véase también <function>mb_substitute_character</function> para valores compatibles.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry xml:id="ini.mbstring.func-overload">
|
|
<term>
|
|
<parameter>mbstring.func_overload</parameter>
|
|
<type>string</type>
|
|
</term>
|
|
<listitem>
|
|
&warn.deprecated.feature-7-2-0.removed-8-0-0;
|
|
<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 fichero &php.ini;
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry xml:id="ini.mbstring.http-output-conv-mimetypes">
|
|
<term>
|
|
<parameter>mbstring.http_output_conv_mimetypes</parameter>
|
|
<type>string</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry xml:id="ini.mbstring.strict-detection">
|
|
<term>
|
|
<parameter>mbstring.strict_detection</parameter>
|
|
<type>bool</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Habilita la detección estricta de codificaciones. Consulte <function>mb_detect_encoding</function>
|
|
para obtener una descripción y ejemplos.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry xml:id="ini.mbstring.regex-retry-limit">
|
|
<term>
|
|
<parameter>mbstring.regex_retry_limit</parameter>
|
|
<type>int</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Limita la cantidad de retroceso que se puede realizar durante una coincidencia
|
|
de mbregex.
|
|
</para>
|
|
<para>
|
|
Esta configuración solo tiene efecto al enlazar con oniguruma >= 6.8.0.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry xml:id="ini.mbstring.regex-stack-limit">
|
|
<term>
|
|
<parameter>mbstring.regex_stack_limit</parameter>
|
|
<type>int</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Limita la profundidad de la pila de las expresiones regulares de mbstring.
|
|
</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
|
|
-->
|