language-snippets.ent

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8648d1cda141537b5dbd403a0bf0e6eb8c086e9d Maintainer: argosback Status: ready -->

<!ENTITY installation.enabled.disable 'Esta extensión está activada por defecto. Puede ser desactivada utilizando la opción de configuración: '>

<!ENTITY changelog.class-constants-typed '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  Las constantes de clase ahora son tipadas.
 </entry>
</row>'>

<!-- Cautions -->
<!ENTITY caution.cryptographically-insecure '<caution xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Esta función no genera valores criptográficamente seguros, y <emphasis>no debe</emphasis>
  ser utilizada con fines criptográficos, o con fines que requieran que los valores devueltos sean indescifrables.
 </simpara>
 <simpara>
  Si se requiere aleatoriedad criptográficamente segura, el <classname>Random\Randomizer</classname> puede ser
  utilizado con el motor <classname>Random\Engine\Secure</classname>. Para casos de uso simples, las funciones <function>random_int</function>
  y <function>random_bytes</function> proporcionan una <acronym>API</acronym> práctica y segura que es
  soportada por el <acronym>CSPRNG</acronym> del sistema operativo.
 </simpara>
</caution>'>

<!ENTITY caution.mt19937-global-state '<caution xmlns="http://docbook.org/ns/docbook">
 <simpara>
    Esta función utiliza la instancia global Mt19937 ("Mersenne Twister") como fuente de aleatoriedad y por lo tanto comparte su estado con todas las demás funciones que usan el Mt19937 global. El
    uso de cualquiera de estas funciones avanza la secuencia para <emphasis>todas</emphasis> las demás funciones, independientemente del ámbito.
  </simpara>
  <simpara>
    Generar secuencias repetibles inicializando <function>mt_srand</function> o <function>srand</function> con un valor conocido también producirá una salida repetible de esta función.
  </simpara>
  <simpara>
    Prefiera utilizar los métodos de <classname>Random\Randomizer</classname> en todo el código nuevo.
 </simpara>
</caution>'>

<!ENTITY caution.mt19937-tiny-seed '<caution xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Dado que el motor Mt19937 ("Mersenne Twister") toma un solo entero de 32 bits como
  semilla, el número de secuencias aleatorias posibles está limitado a solo 2<superscript>32</superscript>
  (por ejemplo 4 294 967 296), a pesar de la enorme período de Mt19937 de 2<superscript>19937</superscript>-1.
 </simpara>
 <simpara>
  Cuando se confía en una semilla aleatoria implícita o explícita, las duplicaciones aparecerán mucho antes.
  Las semillas duplicadas son esperadas con una probabilidad del 50&#37; después de menos de 80
  000 semillas generadas aleatoriamente según el problema del cumpleaños. Una probabilidad del 10&#37; de una
  semilla duplicada ocurre después de haber generado aproximadamente 30 000 semillas de manera aleatoria.
 </simpara>
 <simpara>
  Esto hace que Mt19937 sea inadecuado para aplicaciones donde las secuencias duplicadas no deben ocurrir con
  más que una probabilidad despreciable. Si se requiere una semilla reproducible, tanto el motor
  <classname>Random\Engine\Xoshiro256StarStar</classname> como <classname>Random\Engine\PcgOneseq128XslRr64</classname>
  soportan semillas mucho más grandes que son poco propensas a colisionar aleatoriamente. Si la reproductibilidad
  no es requerida, el motor <classname>Random\Engine\Secure</classname> proporciona datos aleatorios
  criptográficamente seguros.
 </simpara>
</caution>'>

<!-- Notes -->

<!ENTITY note.bin-safe '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta función es segura para
sistemas binarios.</simpara></note>'>

<!ENTITY note.clearstatcache '<note xmlns="http://docbook.org/ns/docbook"><simpara>Los resultados de esta función se
almacenan en caché. Véase la función <function>clearstatcache</function> para
más detalles.</simpara></note>'>

<!ENTITY note.context-support '<simpara xmlns="http://docbook.org/ns/docbook">Un <link linkend="stream.contexts">contexto de flujo</link> de
tipo <type>resource</type>.</simpara>'>

<!ENTITY note.exec-bg '<note xmlns="http://docbook.org/ns/docbook"><simpara>Si un programa es iniciado con esta
función y se ejecuta en segundo plano, la salida del programa debe ser
redirigida a un fichero, o a otro flujo de salida. De lo contrario,
PHP se bloqueará hasta el final de la ejecución del programa.</simpara></note>'>

<!ENTITY note.exec-bypass-shell '<note xmlns="http://docbook.org/ns/docbook"><simpara>En Windows <function>exec</function>
iniciará primero cmd.exe para ejecutar el comando. Si se desea iniciar un programa externo sin ejecutar cmd.exe
utilice <function>proc_open</function> definiendo la opción <parameter>bypass_shell</parameter>.</simpara></note>'>

<!ENTITY note.extractto-windows '<note xmlns="http://docbook.org/ns/docbook"><simpara>Los sistemas de archivos NTFS de
Windows no soportan ciertos caracteres en los nombres de fichero, como <literal>&lt;|&gt;*?":</literal>. Los nombres de fichero con un
punto final no son soportados. A diferencia de algunas herramientas de extracción, este método no reemplaza estos caracteres con
un guión bajo, sino que falla al extraer tales ficheros.</simpara></note>'>

<!ENTITY note.func-callback-exceptions '<note xmlns="http://docbook.org/ns/docbook"><simpara>Las devoluciónes de
llamada registradas con funciones como <function>call_user_func</function> y <function>call_user_func_array</function> no serán llamadas si
una excepción no es interceptada cuando ha sido lanzada en una función de devolución de llamada anterior.</simpara></note>'>

<!ENTITY note.funcbyref '<note xmlns="http://docbook.org/ns/docbook"><simpara>Si los argumentos son pasados por referencia,
todas sus modificaciones serán reflejadas en los valores devueltos por esta función. A partir de PHP 7, los
valores actuales también serán devueltos si los argumentos son pasados por su valor.</simpara></note>'>

<!ENTITY note.func-named-params '<note xmlns="http://docbook.org/ns/docbook"><simpara> A partir de PHP 8.0.0, la familia de funciones
func_*() está diseñada para ser esencialmente transparente con respecto a los argumentos nombrados,
tratando los argumentos como si fueran todos pasados de manera posicional,
y los argumentos faltantes son reemplazados con sus valores
por defecto. Esta función ignora la colección de argumentos variádicos nombrados
desconocidos. Los argumentos nombrados que son recolectados solo son accesibles a través del parámetro variádico.</simpara></note>'>

<!ENTITY note.line-endings '<note xmlns="http://docbook.org/ns/docbook"><simpara>Antes de PHP 8.1.0, la
opción de configuración en tiempo de ejecución
<link linkend="ini.auto-detect-line-endings">auto_detect_line_endings</link>
se podía activar para ayudar a PHP a reconocer correctamente los finales de línea
al leer ficheros creados en sistemas Macintosh. Esta opción está obsoleta a partir
de PHP 8.1.0. Si es necesario, en su lugar se deben gestionar manualmente los saltos
de línea <literal>"\r"</literal>.</simpara></note>'>

<!ENTITY note.no-remote '<note xmlns="http://docbook.org/ns/docbook"><simpara> Esta función no funciona con los
<link linkend="features.remote-files">archivos remotos</link>, ya que el archivo
examinado debe ser accesible en el sistema de archivos del servidor.</simpara></note>'>

<!ENTITY note.not-bin-safe '<warning xmlns="http://docbook.org/ns/docbook"><simpara> Esta función no
es capaz de manejar strings binarios (aún)!</simpara></warning>'>

<!ENTITY note.no-key-association '<note xmlns="http://docbook.org/ns/docbook"><simpara> Esta función
asigna nuevas claves a los elementos en <parameter>array</parameter>.
Eliminará todas las claves existentes que hayan podido ser asignadas, en
lugar de reordenar las claves.</simpara></note>'>

<!ENTITY note.no-windows '<note xmlns="http://docbook.org/ns/docbook"><simpara> Esta función no está
implementada en las plataformas Windows.</simpara></note>'>

<!ENTITY note.no-windows.extension '<note xmlns="http://docbook.org/ns/docbook"><simpara> Esta extensión no está
disponible en las plataformas Windows.</simpara></note>'>

<!ENTITY note.no-zts '<note xmlns="http://docbook.org/ns/docbook"><simpara> Esta función no está
disponible en los intérpretes PHP compilados con ZTS (Zend Thread Safety) activado. Para verificar si su copia de PHP ha sido compilada con ZTS activado, utilice <command>php -i</command> o pruebe la constante incluida <constant>PHP_ZTS</constant>.</simpara></note>'>

<!ENTITY note.randomseed '<note xmlns="http://docbook.org/ns/docbook"><simpara> No es necesario inicializar
el generador de números aleatorios con <function>srand</function> o
<function>mt_srand</function>, esto se hace automáticamente.
</simpara></note>'>

<!ENTITY note.is-superglobal "<note xmlns='http://docbook.org/ns/docbook'><simpara> Esto es una 'superglobal', o
variable global automática. Esto significa simplemente que esta variable está
disponible en todos los contextos del script. No es necesario hacer
<command>global $variable;</command> para acceder a ella en las funciones o los métodos.
</simpara></note>">

<!ENTITY note.uses-ob '<note xmlns="http://docbook.org/ns/docbook"><simpara> Cuando el parámetro <parameter>return</parameter> es utilizado,
esta función utiliza el buffer interno de salida, por lo tanto no puede ser utilizado en la función de devolución de llamada de
<function>ob_start</function>.</simpara></note>'>

<!ENTITY note.uses-ob-php70 '<note xmlns="http://docbook.org/ns/docbook"><simpara> Cuando el parámetro <parameter>return</parameter> es utilizado,
esta función utilizaba el buffer interno de salida anterior a PHP 7.1.0, y por lo tanto no puede ser utilizado en la función de devolución de llamada de
<function>ob_start</function>.</simpara></note>'>

<!ENTITY note.filesystem-time-res '<note xmlns="http://docbook.org/ns/docbook"><simpara> Tenga en cuenta que la precisión temporal puede
variar según el sistema de archivos utilizado.</simpara></note>'>

<!ENTITY note.uses-autoload '<note xmlns="http://docbook.org/ns/docbook">
<simpara> El uso de esta función utilizará todos los
<link linkend="language.oop5.autoload">autoloaders</link> registrados si la clase no es conocida aún.</simpara></note>'>

<!ENTITY note.network.header.sapi '<note xmlns="http://docbook.org/ns/docbook">
   <simpara>
    Los encabezados solo serán accesibles y se mostrarán cuando se utilice un SAPI
    que los soporte.
   </simpara>
  </note>
'>

<!ENTITY note.sigchild '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Si PHP ha sido compilado con la opción de configuración --enable-sigchild, el valor devuelto de esta función será indefinido.
 </simpara>
</note>
'>

<!ENTITY note.sort-unstable '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Si dos miembros se comparan como iguales, mantienen su orden original.
  Anterior a PHP 8.0.0, su orden relativo en el array ordenado no está definido.
 </simpara>
</note>
'>

<!ENTITY note.reset-index "<note xmlns='http://docbook.org/ns/docbook'>
 <simpara>
    Reinicia el puntero interno del array al primer elemento.
 </simpara>
</note>
">

<!ENTITY note.resource-migration-8.0-dead-function '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Esta función no tiene ningún efecto. Anterior a PHP 8.0.0, esta función era utilizada para cerrar un recurso.
 </simpara>
</note>
'>

<!-- Tips -->

<!ENTITY tip.fopen-wrapper '<tip xmlns="http://docbook.org/ns/docbook"><simpara> Puede utilizar una URL como nombre de
archivo con esta función, si el <link linkend="ini.allow-url-fopen"
>gestor fopen</link> ha sido activado.
Véase <function>fopen</function> para más detalles sobre cómo especificar el nombre
del archivo. Consulte <xref linkend="wrappers"/> para más información sobre
las capacidades de los diferentes gestores, las notas sobre su uso, así
como la información sobre las variables predefinidas que
proporcionan.</simpara></tip>'>

<!ENTITY tip.fopen-wrapper.stat '<tip xmlns="http://docbook.org/ns/docbook"><simpara> A partir de PHP 5.0.0, esta función
también puede ser utilizada con <emphasis>algunos</emphasis> protocolos url. Lea
<xref linkend="wrappers"/> para conocer los protocolos que soportan la familia de funcionalidades de
<function>stat</function>.</simpara></tip>'>

<!ENTITY tip.ob-capture '<tip xmlns="http://docbook.org/ns/docbook"><simpara>Al igual que con cualquier cosa
que envíe sus resultados directamente al navegador, las <link
linkend="book.outcontrol">funciones de control de salida</link> se pueden usar para capturar
la salida de esta función y guardarla en un
<type>string</type> (por ejemplo).</simpara></tip>'>

<!ENTITY tip.userlandnaming '<tip xmlns="http://docbook.org/ns/docbook"><simpara> Véase también
<xref linkend="userlandnaming" />.</simpara></tip>'>


<!-- Warnings -->

<!ENTITY warn.escapeshell '<warning xmlns="http://docbook.org/ns/docbook"><simpara> Si los datos provenientes de los usuarios tienen permiso
de ser pasados a esta función, utilice
<function>escapeshellarg</function> o <function>escapeshellcmd</function>
para asegurarse de que los usuarios no puedan hacer que el sistema ejecute comandos
arbitrarios.</simpara></warning>'>

<!ENTITY warn.experimental '<warning xmlns="http://docbook.org/ns/docbook"><simpara> Esta extensión es
<emphasis>EXPERIMENTAL</emphasis>. El comportamiento de esta extensión, los
nombres de sus funciones, y toda la documentación alrededor de esta
extensión puede cambiar sin previo aviso en una próxima versión de PHP.
Esta extensión debe ser utilizada bajo su propio riesgo.</simpara></warning>'>

<!ENTITY deprecated.function 'Esta función está obsoleta.'>
<!ENTITY removed.function 'Esta función ha sido eliminada.'>

<!ENTITY warn.deprecated.feature-5-6-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara> Esta funcionalidad está
<emphasis>OBSOLETA</emphasis> a partir de PHP 5.6.0. Depender de esta funcionalidad
está altamente desaconsejado.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-1-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara> Esta funcionalidad está
<emphasis>OBSOLETA</emphasis> a partir de PHP 7.1.0. Depender de esta funcionalidad
está altamente desaconsejado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-0-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara> Esta función está
<emphasis>OBSOLETA</emphasis> a partir de PHP 7.0.0 y ha sido
<emphasis>ELIMINADA</emphasis> a partir de PHP 8.0.0. Depender de esta función
está altamente desaconsejado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-1-0.removed-7-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara> Esta función está
<emphasis>OBSOLETA</emphasis> a partir de PHP 7.1.0 y ha sido
<emphasis>ELIMINADA</emphasis> a partir de PHP 7.2.0. Depender de esta función
está altamente desaconsejado.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-2-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara> Esta funcionalidad está
<emphasis>OBSOLETA</emphasis> a partir de PHP 7.2.0, y <emphasis>ELIMINADA</emphasis> a partir de PHP 8.0.0. Depender de esta funcionalidad
está altamente desaconsejado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-2-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara> Esta funcionalidad está
<emphasis>OBSOLETA</emphasis> a partir de PHP 7.2.0 y ha sido <emphasis>ELIMINADA</emphasis> a partir de PHP
8.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara> Esta funcionalidad está
<emphasis>OBSOLETA</emphasis> a partir de PHP 7.3.0. Depender de esta funcionalidad
está altamente desaconsejado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-3-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara> Esta función está
<emphasis>OBSOLETA</emphasis> a partir de PHP 7.3.0, y ha sido <emphasis>ELIMINADA</emphasis> a partir de PHP 8.0.0. Depender de esta función
está altamente desaconsejado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara> Esta función está
<emphasis>OBSOLETA</emphasis> a partir de PHP 7.4.0. Depender de esta función
está altamente desaconsejado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-4-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta función está
<emphasis>OBSOLETA</emphasis> a partir de PHP 7.4.0, y ha sido <emphasis>ELIMINADA</emphasis> a partir de PHP 8.0.0. Depender de esta función
está altamente desaconsejado.</simpara></warning>'>

<!ENTITY warn.feature.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Esta característica ha sido <emphasis>ELIMINADA</emphasis> a partir de PHP 8.0.0.</simpara>
</warning>'>

<!ENTITY warn.deprecated.function-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta función está
<emphasis>OBSOLETA</emphasis> a partir de PHP 8.0.0. Depender de esta función
está altamente desaconsejado.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-8-1-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta característica está
<emphasis>OBSOLETA</emphasis> a partir de PHP 8.0.0. Depender de esta característica
está altamente desaconsejado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-1-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta función está
<emphasis>OBSOLETA</emphasis> a partir de PHP 8.1.0. Depender de esta función
está altamente desaconsejado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta función está
<emphasis>OBSOLETA</emphasis> a partir de PHP 8.2.0. Depender de esta función
está altamente desaconsejado.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-8-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta característica está
<emphasis>OBSOLETA</emphasis> a partir de PHP 8.3.0. Depender de esta característica
está altamente desaconsejado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta función está
<emphasis>OBSOLETA</emphasis> a partir de PHP 8.3.0. Depender de esta función
está altamente desaconsejado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta función está
<emphasis>OBSOLETA</emphasis> a partir de PHP 8.4.0. Depender de esta función
está altamente desaconsejado.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-8-5-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta característica está
<emphasis>OBSOLETA</emphasis> a partir de PHP 8.5.0. Depender de esta característica
está altamente desaconsejado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-5-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta función está
<emphasis>OBSOLETA</emphasis> a partir de PHP 8.5.0. Depender de esta función
está altamente desaconsejado.</simpara></warning>'>

<!ENTITY removed.php.future 'Esta funcionalidad obsoleta <emphasis xmlns="http://docbook.org/ns/docbook">será</emphasis>
ciertamente <emphasis xmlns="http://docbook.org/ns/docbook">eliminada</emphasis> en el futuro.'>

<!ENTITY warn.deprecated.alias-5-4-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Este alias está <emphasis>OBSOLETO</emphasis> a partir de PHP 5.4.0.
Depender de este alias está fuertemente desaconsejado.</simpara></warning>'>

<!ENTITY warn.removed.function-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara> Esta función ha sido
<emphasis>ELIMINADA</emphasis> a partir de PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.removed.function-7-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara> Esta función ha sido
<emphasis>ELIMINADA</emphasis> a partir de PHP 7.4.0.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-7-2-0.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Este alias está
<emphasis>OBSOLETO</emphasis> en PHP 7.2.0, y <emphasis>ELIMINADO</emphasis> a partir de PHP 8.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-7-4-0.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Este alias está
<emphasis>OBSOLETO</emphasis> en PHP 7.4.0, y <emphasis>ELIMINADO</emphasis> a partir de PHP 8.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Este alias está
<emphasis>OBSOLETO</emphasis> en PHP 8.0.0.</simpara></warning>'>

<!ENTITY warn.removed.alias-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Este alias está
<emphasis>ELIMINADO</emphasis> a partir de PHP 8.0.0.</simpara></warning>'>

<!ENTITY warn.removed.feature-8-5-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta funcionalidad ha sido
<emphasis>ELIMINADA</emphasis> a partir de PHP 8.5.0.</simpara></warning>'>

<!ENTITY warn.experimental.func '<warning xmlns="http://docbook.org/ns/docbook"><simpara> Esta función es
<emphasis>EXPERIMENTAL</emphasis>. El comportamiento de esta función, su nombre, y toda la
documentación alrededor de esta función puede cambiar sin previo aviso en una próxima versión
de PHP. Esta función debe ser utilizada bajo su propio riesgo.
</simpara></warning>'>

<!ENTITY warn.imaprecodeyaz '<warning xmlns="http://docbook.org/ns/docbook"><simpara> Las extensiones <link
linkend="book.imap">IMAP</link>, <link linkend="book.recode">recode</link> y
<link linkend="book.yaz">YAZ</link>
no pueden ser utilizadas simultáneamente ya que utilizan
un símbolo interno común. Nota: Yaz 2.0 y superior ya no sufre de este problema.</simpara></warning>'>

<!ENTITY warn.install.cgi '<warning xmlns="http://docbook.org/ns/docbook"><simpara> Un servidor desplegado en modo CGI se expone a
varias vulnerabilidades posibles. Por favor, lea nuestra
<link linkend="security.cgi-bin">sección sobre la seguridad en modo CGI</link> para aprender cómo
protegerse contra estos ataques.</simpara></warning>'>

<!ENTITY warn.passwordhashing '
<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  No se recomienda utilizar esta función para asegurar contraseñas, debido
  a la naturaleza rápida de este algoritmo de hash. Ver
  <link linkend="faq.passwords.fasthash">F.A.Q del hash de contraseñas</link>
  para más detalles y las buenas prácticas.
 </simpara>
</warning>
'>

<!ENTITY warn.ssl-non-standard '<warning xmlns="http://docbook.org/ns/docbook"><simpara> Cuando SSL es utilizado, el servidor
IIS de Microsoft violará el protocolo al cerrar la conexión sin enviar un indicador
<literal>close_notify</literal>. PHP lo reportará como "SSL: Fatal Protocol
Error" cuando se llegue al final de los datos. Para evitar esto, el nivel de
la directiva <link linkend="ini.error-reporting">error_reporting</link> debe ser
bajado para no incluir los avisos. PHP
puede detectar automáticamente los servidores IIS defectuosos al abrir
el flujo utilizando <literal>https://</literal> y suprimirá el aviso.
Al utilizar <function>fsockopen</function> para crear un socket
<literal>ssl://</literal>, es responsabilidad del desarrollador detectar
y suprimir el aviso.</simpara></warning>'>

<!ENTITY warn.undocumented.func '<warning xmlns="http://docbook.org/ns/docbook"> <simpara>Esta función está actualmente
no documentada; solo la lista de sus argumentos está disponible.
</simpara></warning>'>


<!-- Deprecation and removal warnings designed for use with a list of
     alternatives. See en/reference/regex/functions/ereg.xml and
     en/reference/regex/reference.xml for examples of these in action. -->

<!ENTITY warn.deprecated.feature.7-1-0.removed.7-2-0.alternatives '
<simpara xmlns="http://docbook.org/ns/docbook">
 Esta funcionalidad está <emphasis>OBSOLETA</emphasis> a partir de PHP 7.1.0 y ha sido
 <emphasis>ELIMINADA</emphasis> a partir de PHP 7.2.0.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
 Las alternativas a esta funcionalidad incluyen:
</simpara>
'>

<!ENTITY warn.deprecated.function.7-1-0.removed.7-2-0.alternatives '
<simpara xmlns="http://docbook.org/ns/docbook">
 Esta función está <emphasis>OBSOLETA</emphasis> a partir de PHP 7.1.0 y ha sido
 <emphasis>ELIMINADA</emphasis> a partir de PHP 7.2.0.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
 Las alternativas a esta función incluyen:
</simpara>
'>

<!ENTITY warn.deprecated.function-8-1-0.alternatives '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta función está
<emphasis>OBSOLETA</emphasis> a partir de PHP 8.1.0. Se recomienda
evitar su uso.</simpara></warning>
<simpara xmlns="http://docbook.org/ns/docbook">
 Las alternativas a esta función incluyen:
</simpara>
'>

<!-- Misc -->

<!ENTITY version.exists.asof 'Existe a partir de PHP '>

<!ENTITY no.function.parameters '<simpara xmlns="http://docbook.org/ns/docbook">Esta función no contiene ningún parámetro.</simpara>'>

<!ENTITY example.outputs '<simpara xmlns="http://docbook.org/ns/docbook">El ejemplo anterior mostrará:</simpara>'>

<!ENTITY example.outputs.5 '<simpara xmlns="http://docbook.org/ns/docbook">Resultado del ejemplo anterior en PHP 5:</simpara>'>

<!ENTITY example.outputs.55 '<simpara xmlns="http://docbook.org/ns/docbook">Resultado del ejemplo anterior en PHP 5.5:</simpara>'>

<!ENTITY example.outputs.56 '<simpara xmlns="http://docbook.org/ns/docbook">Resultado del ejemplo anterior en PHP 5.6:</simpara>'>

<!ENTITY example.outputs.7 '<simpara xmlns="http://docbook.org/ns/docbook">Resultado del ejemplo anterior en PHP 7:</simpara>'>

<!ENTITY example.outputs.70 '<simpara xmlns="http://docbook.org/ns/docbook">Resultado del ejemplo anterior en PHP 7.0:</simpara>'>

<!ENTITY example.outputs.71 '<simpara xmlns="http://docbook.org/ns/docbook">Resultado del ejemplo anterior en PHP 7.1:</simpara>'>

<!ENTITY example.outputs.73 '<simpara xmlns="http://docbook.org/ns/docbook">Resultado del ejemplo anterior en PHP 7.3:</simpara>'>

<!ENTITY example.outputs.8 '<simpara xmlns="http://docbook.org/ns/docbook">Resultado del ejemplo anterior en PHP 8:</simpara>'>

<!ENTITY example.outputs.8.similar '<simpara xmlns="http://docbook.org/ns/docbook">Resultado del ejemplo anterior en PHP 8 es similar a:</simpara>'>

<!ENTITY example.outputs.80 '<simpara xmlns="http://docbook.org/ns/docbook">Resultado del ejemplo anterior en PHP 8.0:</simpara>'>

<!ENTITY example.outputs.81 '<simpara xmlns="http://docbook.org/ns/docbook">Resultado del ejemplo anterior en PHP 8.1:</simpara>'>

<!ENTITY example.outputs.82 '<simpara xmlns="http://docbook.org/ns/docbook">Resultado del ejemplo anterior en PHP 8.2:</simpara>'>

<!ENTITY example.outputs.82.similar '<simpara xmlns="http://docbook.org/ns/docbook">Resultado del ejemplo anterior en PHP 8.2 es similar a:</simpara>'>

<!ENTITY example.outputs.83 '<simpara xmlns="http://docbook.org/ns/docbook">Resultado del ejemplo anterior en PHP 8.3:</simpara>'>

<!ENTITY example.outputs.83.similar '<simpara xmlns="http://docbook.org/ns/docbook">Resultado del ejemplo anterior en PHP 8.3 es similar a:</simpara>'>

<!ENTITY example.outputs.84 '<simpara xmlns="http://docbook.org/ns/docbook">Salida del ejemplo anterior en PHP 8.4:</simpara>'>

<!ENTITY example.outputs.84.similar '<simpara xmlns="http://docbook.org/ns/docbook">La salida del ejemplo anterior en PHP 8.4 es similar a:</simpara>'>

<!ENTITY example.outputs.85.similar '<simpara xmlns="http://docbook.org/ns/docbook">La salida del ejemplo anterior en PHP 8.5 es similar a:</simpara>'>

<!ENTITY example.outputs.32bit '<simpara xmlns="http://docbook.org/ns/docbook">Resultado del ejemplo anterior en una máquina de 32 bits:</simpara>'>

<!ENTITY example.outputs.64bit '<simpara xmlns="http://docbook.org/ns/docbook">Resultado del ejemplo anterior en una máquina de 64 bits:</simpara>'>

<!ENTITY example.outputs.similar '<simpara xmlns="http://docbook.org/ns/docbook">Resultado del ejemplo anterior
es similar a:</simpara>'>

<!ENTITY examples.outputs '<simpara xmlns="http://docbook.org/ns/docbook">Los ejemplos anteriores mostrarán:</simpara>'>

<!ENTITY examples.outputs.similar '<simpara xmlns="http://docbook.org/ns/docbook">Los ejemplos anteriores mostrarán
algo similar a:</simpara>'>

<!ENTITY array.resetspointer '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta función ejecutará
<function>reset</function> sobre el puntero del <type>array</type> de entrada después de
usarlo.</simpara></note>'>

<!ENTITY array.changelog.by-ref '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Si <parameter>callback</parameter> espera un parámetro a ser pasado
  por referencia, esta función emite ahora una <constant>E_WARNING</constant>.
 </entry>
</row>'>

<!ENTITY array.changelog.require-only-one '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.0.0</entry>
  <entry>
  Esta función puede ser llamada ahora con un solo
  parámetro. Anteriormente, al menos dos parámetros eran necesarios.
  </entry>
</row>'>

<!ENTITY seealso.array.sorting 'Las funciones de <link xmlns="http://docbook.org/ns/docbook" linkend="array.sorting">ordenación de arrays</link>'>

<!ENTITY sort.flags.parameter '<varlistentry xmlns="http://docbook.org/ns/docbook">
  <term><parameter>flags</parameter></term>
  <listitem>
   <simpara>
    El segundo parámetro opcional <parameter>flags</parameter>
    puede ser utilizado para modificar el comportamiento de ordenación utilizando estos valores:
   </simpara>
   <para>
    Tipo de banderas de ordenación:
    <itemizedlist>
     <listitem>
      <simpara><constant>SORT_REGULAR</constant> - compara los elementos normalmente; los
      detalles son descritos en la sección de los <link linkend="language.operators.comparison">operadores de comparación</link></simpara>
     </listitem>
     <listitem>
      <simpara><constant>SORT_NUMERIC</constant> - compara los elementos numéricamente</simpara>
     </listitem>
     <listitem>
      <simpara><constant>SORT_STRING</constant> - compara los elementos como strings</simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>SORT_LOCALE_STRING</constant> - compara los elementos como
       strings, basado en la configuración regional actual. Esto utiliza la configuración
       regional, que puede ser cambiada utilizando <function>setlocale</function>
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>SORT_NATURAL</constant> - compara los elementos como strings
       utilizando el "orden natural" como <function>natsort</function>
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>SORT_FLAG_CASE</constant> - puede ser combinado (OR a
       nivel de bits) con
       <constant>SORT_STRING</constant> o
       <constant>SORT_NATURAL</constant> para ordenar strings sin tener en cuenta la mayúscula/minúscula
      </simpara>
     </listitem>
    </itemizedlist>
   </para>
  </listitem>
 </varlistentry>
'>

<!ENTITY sort.callback.description '<simpara xmlns="http://docbook.org/ns/docbook">
 &return.callbacksort;
</simpara>
&callback.cmp;
<caution xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Devolver valores <emphasis>no enteros</emphasis> (como
  <type>float</type>) desde la función de comparación resultará en una conversión interna del valor de retorno de la retrollamada a
  <type>int</type>. Así, valores como
  <literal>0.99</literal> y <literal>0.1</literal> serán convertidos ambos al
  valor entero <literal>0</literal>, por lo que se compararán como iguales.
 </simpara>
</caution>'>

<!ENTITY sort.callback.description.presort '<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  La función de callback de ordenación debe tratar cualquier valor de cualquier array en cualquier
  orden, independientemente del orden en el que fueron proporcionados inicialmente.
  Esto se debe a que cada array individual es ordenado primero antes de ser comparado con otros arrays.

  Por ejemplo:
  <programlisting role="php">
<![CDATA[
<?php
$arrayA = ["string", 1];
$arrayB = [["value" => 1]];
// $item1 y $item2 pueden ser cualquiera de los siguientes valores : "cadena", 1 o
["value" => 1] $compareFunc = static function ($item1,
    $item2) { $value1 = is_string($item1) ? strlen($item1) : (is_array($item1) ? $item1["value"] :
    $item1); $value2 = is_string($item2) ? strlen($item2) : (is_array($item2) ? $item2["value"] : $item2);
    return $value1 <=> $value2;
};
?>
]]>
  </programlisting>
 </para>
</caution>'>

<!ENTITY ini.shorthandbytes '<simpara xmlns="http://docbook.org/ns/docbook">Cuando se utiliza un <type>int</type>, el valor se
mide en bytes. También se puede usar la notación abreviada, como se describe
en <link linkend="faq.using.shorthandbytes">esta FAQ</link>.
</simpara>'>

<!ENTITY info.deprecated.alias 'Por razones de compatibilidad ascendente, el
siguiente alias obsoleto puede ser utilizado: '>

<!ENTITY info.function.alias 'Esta función es un alias de: '>

<!ENTITY info.method.alias 'Este método es un alias de: '>

<!ENTITY ext.windows.path.dll 'Para hacer funcionar esta extensión, algunas bibliotecas
<acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym> deben estar disponibles a través
del <envar xmlns="http://docbook.org/ns/docbook">PATH</envar> del sistema Windows. Lea la
<acronym xmlns="http://docbook.org/ns/docbook">F.A.Q</acronym> titulada "<link
 xmlns="http://docbook.org/ns/docbook" linkend="faq.installation.addtopath">Cómo agregar mi carpeta PHP a mi PATH
de Windows</link>" para más información. Copiar
las bibliotecas DLL desde la carpeta PHP a la carpeta del sistema de Windows también
funciona (ya que la carpeta del sistema está por defecto en el
<envar xmlns="http://docbook.org/ns/docbook">PATH</envar> del sistema), pero este método no es recomendado.
<emphasis xmlns="http://docbook.org/ns/docbook">Esta extensión requiere que los siguientes ficheros estén en el
<envar>PATH</envar>:</emphasis> '>

<!ENTITY manual.migration.seealso 'Véase también las guías de migración entre las diferentes versiones de PHP'>

<!ENTITY style.oop 'Estilo orientado a objetos'>
<!ENTITY style.procedural 'Estilo procedimental'>

<!ENTITY match '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.match">match</link>'>

<!ENTITY parameter.context 'Consulte la sección <link xmlns="http://docbook.org/ns/docbook" linkend="context">contexto</link>
de este manual para una descripción de los <literal xmlns="http://docbook.org/ns/docbook">contexts</literal>.'>

<!ENTITY parameter.use_include_path 'Cuando está definido como &true;, el nombre del archivo
también es buscado en <link xmlns="http://docbook.org/ns/docbook" linkend="ini.include-path">include_path</link>'>

<!-- Returns -->

<!ENTITY return.type.true '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.2.0</entry>
 <entry>
  El tipo de retorno es ahora &true;, anteriormente era <type>bool</type>.
 </entry>
</row>'>

<!ENTITY return.type.true.84 '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  El tipo de retorno es ahora &true;, anteriormente era <type>bool</type>.
 </entry>
</row>'>

<!ENTITY return.type.true.85 '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.5.0</entry>
 <entry>
  El tipo de retorno es ahora &true;, anteriormente era <type>bool</type>.
 </entry>
</row>'>

<!ENTITY return.falseforfailure ' o &false; si ocurre un error'>
<!ENTITY return.falseforfailure.style.procedural '&style.procedural; retorna &false; en caso de error.'>

<!ENTITY return.success 'Esta función retorna &true; en caso de éxito&return.falseforfailure;.'>

<!ENTITY return.nullorfalse 'Esta función retorna &null; en caso de éxito&return.falseforfailure;.'>

<!ENTITY return.void 'No se retorna ningún valor.'>

<!ENTITY return.true.always 'Retorna siempre &true;.'>

<!ENTITY return.callbacksort 'La función de comparación debe retornar un entero menor que, igual a, o mayor que 0 si el primer argumento es considerado, respectivamente, menor que, igual a, o mayor que el segundo.'>

<!ENTITY return.falseproblem '<warning xmlns="http://docbook.org/ns/docbook"><simpara> Esta función puede
retornar &false;, pero también puede retornar un valor equivalente a
&false;. Por favor, lea la sección sobre los <link
linkend="language.types.boolean">booleanos</link> para más
información. Utilice el <link linkend="language.operators.comparison">operador
===</link> para probar el valor de retorno exacto de esta
función.</simpara></warning>'>

<!-- Standard -->
<!ENTITY standard.changelog.calling-on-objects '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  O bien convertir el
  &object; en un &array; utilizando <function>get_mangled_object_vars</function> primero, o utilizar los métodos
  proporcionados por una clase que implemente <interfacename>Iterator</interfacename>, tal como <classname>ArrayIterator</classname>.
 </entry>
</row>
<row xmlns="http://docbook.org/ns/docbook">
 <entry>7.4.0</entry>
 <entry>
  A partir de PHP 7.4.0, las instancias de clases <link xmlns="http://docbook.org/ns/docbook" linkend="book.spl">SPL</link> son tratadas como objetos vacíos sin propiedades en lugar de llamar al método <interfacename>Iterator</interfacename> con el mismo nombre que esta función.
 </entry>
</row>
'>

<!ENTITY standard.changelog.binary-safe-string-comparison '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.2.0</entry>
 <entry>
  Esta función ya no garantiza retornar
  <code>strlen($string1) - strlen($string2)</code> cuando las longitudes de
  las strings no son iguales, y puede retornar <literal>-1</literal> o
  <literal>1</literal> en su lugar.
 </entry>
</row>
'>

<!-- FileInfo -->
<!ENTITY fileinfo.parameters.finfo '<simpara xmlns="http://docbook.org/ns/docbook">Una instancia <classname>finfo</classname>, retornada por <function>finfo_open</function>.</simpara>'>
<!ENTITY fileinfo.changelog.finfo-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  El parámetro <parameter>finfo</parameter> ahora espera una instancia de <classname>finfo</classname>
  ; anteriormente, una &resource; era esperado.
 </entry>
</row>'>

<!-- OpenSSL -->
<!ENTITY openssl.param.x509 '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>certificate</parameter></term>
 <listitem>
  <simpara>
   Ver los <link linkend="openssl.certparams">parámetros clave/Certificados</link> para una lista de valores válidos.
  </simpara>
 </listitem>
</varlistentry>'>

<!ENTITY openssl.param.csr '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>csr</parameter></term>
 <listitem>
  <simpara>
   Ver los <link linkend="openssl.certparams">parámetros CSR</link> para obtener una lista de los valores válidos.
  </simpara>
 </listitem>
</varlistentry>'>

<!-- Image (GD) Notes -->
<!ENTITY note.freetype '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta función solo está disponible si
si PHP es compilado con soporte Freetype (<option role="configure">--with-freetype-dir=DIR</option>)
</simpara></note>'>

<!ENTITY note.gd.notrequired '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta función no requiere la biblioteca GD.</simpara></note>'>

<!ENTITY note.gd.interpolation '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta función es afectada por el método de interpolación, definido por la función <function>imagesetinterpolation</function>.</simpara></note>'>

<!ENTITY gd.image.description '<varlistentry xmlns="http://docbook.org/ns/docbook"> <term>
<parameter>image</parameter></term><listitem><simpara> Un objeto <classname>GdImage</classname>, retornado por una de las funciones de creación de
imágenes, como <function>imagecreatetruecolor</function>.</simpara></listitem></varlistentry>'>

<!ENTITY gd.font.description '<varlistentry xmlns="http://docbook.org/ns/docbook"> <term>
<parameter>font</parameter></term><listitem><simpara> Puede ser 1, 2, 3, 4, 5 para las fuentes internas de
codificación Latin2 (donde los números más grandes corresponden a fuentes anchas) o una instancia de <classname>GdFont</classname> retornado
por <function>imageloadfont</function>.</simpara></listitem></varlistentry>'>

<!ENTITY gd.changelog.gdfont-instance '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.1.0</entry>
  <entry>
  El parámetro <parameter>font</parameter> ahora acepta una instancia de <classname>GdFont</classname> y
  un &integer;; anteriormente solo un &integer; era aceptado.
  </entry>
</row>'>

<!ENTITY gd.ttf.fontfile "
    <varlistentry xmlns='http://docbook.org/ns/docbook'>
     <term><parameter>fontfile</parameter></term>
     <listitem>
      <simpara>
       La ruta de acceso al fichero de la fuente TrueType que desea utilizar.
      </simpara>
      <simpara>
       Dependiendo de qué versión de la biblioteca GD esté utilizando PHP, <emphasis>cuando
       <parameter>fontfile</parameter> no comienza con una barra diagonal inicial
       <literal>/</literal> entonces <literal>.ttf</literal> será añadido</emphasis>
       al nombre del fichero y la biblioteca intentará buscar ese nombre de fichero a lo largo de una
       ruta de acceso de fuentes definida por la biblioteca.
      </simpara>
      <simpara>
       Al utilizar versiones de la biblioteca GD inferiores a 2.0.18, un carácter <literal>espacio</literal>,
       en lugar de un punto y coma, se utilizaba como 'separador de rutas' para diferentes ficheros de
       fuentes. El uso no intencional de esta característica resultará en el mensaje de advertencia:
       <literal>Advertencia: No se pudo encontrar/abrir la fuente</literal>. Para estas versiones afectadas, la
       única solución es mover la fuente a una ruta que no contenga espacios.
      </simpara>
      <para>
       En muchos casos donde una fuente reside en el mismo directorio que el script que la utiliza,
       el siguiente truco aliviará cualquier problema de inclusión.
       <programlisting role='php'>
<![CDATA[
<?php
// Set the environment variable for GD
putenv('GDFONTPATH=' . realpath('.'));

// Name the font to be used (note the lack of the .ttf extension)
$font = 'SomeFont';
?>
]]>
       </programlisting>
      </para>
      <note>
       <simpara>
        Tenga en cuenta que <link linkend='ini.open-basedir'>open_basedir</link> no
        <emphasis>aplica</emphasis> a <parameter>fontfile</parameter>.
       </simpara>
      </note>
     </listitem>
    </varlistentry>
">

<!ENTITY gd.return.identifier 'Devuelve un objeto de imagen en caso de éxito, &false; en caso de error.'>

<!ENTITY gd.return.trueonerror '<caution xmlns="http://docbook.org/ns/docbook"><simpara>Sin embargo, si libgd no logra producir la imagen, esta función devuelve &true;.</simpara></caution>'>

<!ENTITY gd.identifier.color "Un identificador de color creado con <function xmlns='http://docbook.org/ns/docbook'>imagecolorallocate</function>.">

<!ENTITY gd.value.red 'Valor del componente rojo.'>

<!ENTITY gd.value.green 'Valor del componente verde.'>

<!ENTITY gd.value.blue 'Valor del componente azul.'>

<!ENTITY gd.source.height 'Altura de la fuente.'>

<!ENTITY gd.source.width 'Ancho de la fuente.'>

<!ENTITY gd.image.path 'La ruta o un recurso de flujo abierto (que se cierra automáticamente después de que esta función retorne) donde guardar el fichero. Si no se define o es &null;, el flujo de imagen sin procesar se enviará directamente.'>

<!ENTITY gd.image.new 'Crear una nueva imagen a partir de un fichero o una URL'>

<!ENTITY gd.image.source 'Recurso de imagen de origen.'>

<!ENTITY gd.image.destination 'Recurso de imagen de destino.'>

<!ENTITY gd.image.output 'Enviar la imagen al navegador o a un fichero'>

<!ENTITY gd.image.colors 'Si la imagen fue creada a partir de un fichero, solo se resuelven los colores utilizados en la imagen. Los colores presentes únicamente en la paleta no se resuelven.'>

<!ENTITY gd.font.size 'El tamaño de la fuente en puntos.'>

<!ENTITY gd.constants.types '<simpara xmlns="http://docbook.org/ns/docbook">
    Utilizado como valor de retorno por <function>imagetypes</function>
</simpara>'>

<!ENTITY gd.constants.color '<simpara xmlns="http://docbook.org/ns/docbook">
    Opción de color especial que puede utilizarse en lugar de un color asignado con
    <function>imagecolorallocate</function> o
    <function>imagecolorallocatealpha</function>.
</simpara>'>

<!ENTITY gd.constants.affine '<simpara xmlns="http://docbook.org/ns/docbook">
    Constante de tipo de transformación afín utilizada por la función <function>imageaffinematrixget</function>.
</simpara>'>

<!ENTITY gd.constants.arc '<simpara xmlns="http://docbook.org/ns/docbook">
    Constante de estilo utilizada por la función <function>imagefilledarc</function>.
</simpara>'>

<!ENTITY gd.constants.gd2 '<simpara xmlns="http://docbook.org/ns/docbook">
    Constante de tipo utilizada por la función <function>imagegd2</function>.
</simpara>'>

<!ENTITY gd.constants.effect '<simpara xmlns="http://docbook.org/ns/docbook">
    Efecto de mezcla alfa utilizado por la función <function>imagelayereffect</function>.
</simpara>'>

<!ENTITY gd.constants.filter '<simpara xmlns="http://docbook.org/ns/docbook">
    Filtro GD especial utilizado por la función <function>imagefilter</function>.
</simpara>'>

<!ENTITY gd.constants.type '<simpara xmlns="http://docbook.org/ns/docbook">
    Constante de tipo de imagen utilizada por las funciones <function>image_type_to_mime_type</function>
    y <function>image_type_to_extension</function>.
</simpara>'>

<!ENTITY gd.constants.png-filter '<simpara xmlns="http://docbook.org/ns/docbook">
    Filtro PNG especial, utilizado por la función <function>imagepng</function>.
</simpara>'>

<!ENTITY gd.constants.flip '<simpara xmlns="http://docbook.org/ns/docbook">
    Utilizado junto con <function>imageflip</function>, disponible a partir de PHP 5.5.0.
</simpara>'>

<!ENTITY gd.constants.interpolation '<simpara xmlns="http://docbook.org/ns/docbook">
    Utilizado junto con <function>imagesetinterpolation</function>, disponible a partir de PHP 5.5.0.
</simpara>'>

<!ENTITY gd.deprecated.gd-formats '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Los formatos
de imagen GD y GD2 son formatos propietarios de libgd. Deben considerarse
<emphasis>obsoletos</emphasis>, y solo deben utilizarse con fines de desarrollo y
pruebas.</simpara></warning>'>

<!ENTITY gd.changelog.image-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>image</parameter> ahora espera una instancia de <classname>GdImage</classname>
  ; anteriormente, se esperaba un recurso <literal>gd</literal> de tipo <type>resource</type> válido.
 </entry>
</row>'>

<!-- CSV -->
<!ENTITY warning.csv.escape-parameter '<warning xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><simpara>
 Cuando <parameter>escape</parameter> se define con un valor diferente a una cadena vacía
 (<literal>""</literal>), puede resultar en un CSV que no sea compatible con
 <link xlink:href="&url.rfc;4180">RFC 4180</link> o que no pueda sobrevivir a un ciclo de ida
 y vuelta a través de las funciones CSV de PHP. El valor predeterminado de <parameter>escape</parameter> es
 <literal>"\\"</literal>, por lo que se recomienda definirlo explícitamente como cadena vacía.
 El valor predeterminado cambiará en una futura versión de PHP, no antes de PHP 9.0.
</simpara></warning>'>

<!-- DBM notes -->

<!-- JSON notes -->

<!ENTITY json.implementation.superset '
 <note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <simpara>
   PHP implementa un superconjunto de JSON tal como se especifica en el
   <link xlink:href="&url.rfc;7159">RFC 7159</link> original.
  </simpara>
 </note>
'>

<!-- cURL notes -->

<!ENTITY curl.ch.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>handle</parameter>
</term><listitem><simpara>Un gestor cURL devuelto por
<function>curl_init</function>.</simpara></listitem></varlistentry>'>

<!ENTITY curl.mh.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>multi_handle</parameter>
</term><listitem><simpara>Un gestor múltiple cURL devuelto por
<function>curl_multi_init</function>.</simpara></listitem></varlistentry>'>

<!ENTITY curl.sh.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>share_handle</parameter>
</term><listitem><simpara>Un gestor compartido cURL devuelto por
<function>curl_share_init</function>.</simpara></listitem></varlistentry>'>

<!ENTITY curl.changelog.handle-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>handle</parameter> ahora espera una instancia de <classname>CurlHandle</classname>
  ; anteriormente, se esperaba un <type>resource</type>.
 </entry>
</row>'>

<!ENTITY curl.changelog.multi-handle-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>multi_handle</parameter> ahora espera una instancia de <classname>CurlMultiHandle</classname>
  ; anteriormente, se esperaba un <type>resource</type>.
 </entry>
</row>'>

<!ENTITY curl.changelog.share-handle-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>share_handle</parameter> ahora espera una instancia de <classname>CurlShareHandle</classname>
  ; anteriormente, se esperaba un <type>resource</type>.
 </entry>
</row>'>

<!-- dba notes -->
<!ENTITY dba.parameter.dba 'Una instancia de <classname xmlns="http://docbook.org/ns/docbook">Dba\Connection</classname>, devuelta por <function xmlns="http://docbook.org/ns/docbook">dba_open</function> o <function xmlns="http://docbook.org/ns/docbook">dba_popen</function>.'>
<!ENTITY dba.changelog.dba-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  El parámetro <parameter>dba</parameter> ahora espera una instancia de <classname>Dba\Connection</classname>
  ; anteriormente, se esperaba un &resource; <literal>dba</literal> válido.
 </entry>
</row>'>

<!-- dbase notes -->

<!ENTITY dbase.type-conversion '<para xmlns="http://docbook.org/ns/docbook">
   Cada campo se convierte al tipo PHP apropiado, excepto:
   <itemizedlist>
    <listitem>
     <simpara>
      Las fechas se mantienen como cadenas.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Los valores DateTime se convierten en cadenas.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Los enteros fuera del rango
      <constant>PHP_INT_MIN</constant>..<constant>PHP_INT_MAX</constant> se
      devuelven como cadenas.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Antes de dbase 7.0.0, los booleanos (<literal>L</literal>) se convertían en <literal>1</literal> o
      <literal>0</literal>.
     </simpara>
    </listitem>
   </itemizedlist>
  </para>'>

<!-- enchant entities -->

<!ENTITY enchant.param.broker '<varlistentry xmlns="http://docbook.org/ns/docbook">
     <term><parameter>broker</parameter></term>
     <listitem>
      <simpara>
       Un broker Enchant devuelto por <function>enchant_broker_init</function>.
      </simpara>
     </listitem>
    </varlistentry>'>

<!ENTITY enchant.param.dictionary '<varlistentry xmlns="http://docbook.org/ns/docbook">
     <term><parameter>dictionary</parameter></term>
     <listitem>
      <simpara>
       Un diccionario Enchant devuelto por <function>enchant_broker_request_dict</function>
       o <function>enchant_broker_request_pwl_dict</function>.
      </simpara>
     </listitem>
    </varlistentry>'>

<!ENTITY enchant.changelog.broker-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>broker</parameter> ahora espera una instancia de <classname>EnchantBroker</classname>; anteriormente,
  se esperaba un &resource;.
 </entry>
</row>'>

<!ENTITY enchant.changelog.dictionary-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>dictionary</parameter> ahora espera una instancia de <classname>EnchantDictionary</classname>; anteriormente,
  se esperaba un &resource;.
 </entry>
</row>'>

<!-- IMAP notes -->

<!ENTITY imap.changelog.imap-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  El parámetro <parameter>imap</parameter> ahora espera una instancia de <classname>IMAP\Connection</classname>
  ; anteriormente, se esperaba un &resource; <literal>imap</literal> válido.
 </entry>
</row>'>

<!ENTITY imap.imap-parameter.imap '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>imap</parameter></term><listitem><simpara>Una instancia de <classname>IMAP\Connection</classname>.</simpara></listitem></varlistentry>'>

<!-- Deprecated -->
<!ENTITY imap.pattern '<simpara xmlns="http://docbook.org/ns/docbook">Especifica en qué parte de la jerarquía del
buzón comenzar la búsqueda.</simpara><simpara xmlns="http://docbook.org/ns/docbook">Hay dos caracteres especiales que se
pueden pasar como parte del <parameter>pattern</parameter>:
&apos;<literal>*</literal>&apos; y &apos;<literal>&#37;</literal>&apos;.
&apos;<literal>*</literal>&apos; significa devolver todos los buzones. Si se pasa
<parameter>pattern</parameter> como &apos;<literal>*</literal>&apos;, se obtendrá
una lista de toda la jerarquía del buzón.
&apos;<literal>&#37;</literal>&apos;
significa devolver solo el nivel actual.
&apos;<literal>&#37;</literal>&apos; como parámetro <parameter>pattern</parameter>
devolverá solo los buzones de nivel
superior; &apos;<literal>~/mail/&#37;</literal>&apos; en <literal>UW_IMAPD</literal> devolverá cada buzón en el directorio <filename>~/mail</filename>, pero ninguno en las subcarpetas de ese directorio.</simpara>'>

<!ENTITY imap.mailboxname.insecure '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
Pasar datos no confiables a este parámetro es <emphasis>inseguro</emphasis>, a menos que
<link linkend="ini.imap.enable-insecure-rsh">imap.enable_insecure_rsh</link> esté desactivado.
</simpara></warning>'>

<!-- intl notes -->

<!ENTITY intl.parameter.intl-calendar '<simpara xmlns="http://docbook.org/ns/docbook">Una instancia de <classname>IntlCalendar</classname>.</simpara>'>

<!ENTITY intl.error.intl-calendar '<simpara xmlns="http://docbook.org/ns/docbook">En caso de fallo, también se devuelve &false;. Para detectar condiciones de error, utilice <function>intl_get_error_code</function>, o configure Intl para lanzar <link linkend="ini.intl.use-exceptions">excepciones</link>.</simpara>'>

<!ENTITY intl.codepoint.parameter '<simpara xmlns="http://docbook.org/ns/docbook">El valor <type>int</type> del punto de código (por ejemplo, <literal>0x2603</literal> para <emphasis>U+2603 SNOWMAN</emphasis>), o el carácter codificado como un <type>string</type> UTF-8 (por ejemplo, <literal>"\u{2603}"</literal>)</simpara>'>

<!ENTITY intl.codepoint.return '<simpara xmlns="http://docbook.org/ns/docbook">El tipo de retorno es <type>int</type> a menos que el punto de código haya sido pasado como un <type>string</type> UTF-8, en cuyo caso se devuelve un <type>string</type>. Devuelve &null; en caso de fallo.</simpara>'>

<!ENTITY intl.codepoint.example 'Probar diferentes puntos de código'>

<!ENTITY intl.locale-len.return '<simpara xmlns="http://docbook.org/ns/docbook">Devuelve &null; cuando la longitud de <parameter>locale</parameter> excede <constant>INTL_MAX_LOCALE_LEN</constant>.</simpara>'>

<!ENTITY intl.property.parameter '<simpara xmlns="http://docbook.org/ns/docbook">La propiedad Unicode a buscar (véanse las constantes <literal>IntlChar::PROPERTY_*</literal>).</simpara>'>

<!ENTITY intl.property.example 'Probar diferentes propiedades'>

<!ENTITY intl.param.grapheme.locale '<simpara>La configuración regional a utilizar.</simpara>'>

<!ENTITY intl.changelog.grapheme.locale '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.5.0</entry>
 <entry>
  Se ha añadido el parámetro opcional <parameter>locale</parameter>.
 </entry>
</row>'>

<!-- LDAP notes -->

<!ENTITY ldap.parameter.ldap 'Una instancia de <classname xmlns="http://docbook.org/ns/docbook">LDAP\Connection</classname>, devuelta por <function xmlns="http://docbook.org/ns/docbook">ldap_connect</function>.'>

<!ENTITY ldap.parameter.result 'Una instancia de <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>, devuelta por <function xmlns="http://docbook.org/ns/docbook">ldap_list</function> o <function xmlns="http://docbook.org/ns/docbook">ldap_search</function>.'>

<!ENTITY ldap.parameter.entry 'Una instancia de <classname xmlns="http://docbook.org/ns/docbook">LDAP\ResultEntry</classname>.'>

<!ENTITY ldap.warn.control-paged '<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Esta función está <emphasis>OBSOLETA</emphasis> a partir de PHP 7.4.0, y fue <emphasis>ELIMINADA</emphasis> a partir de PHP 8.0.0. En su lugar, se
  debe utilizar el parámetro <parameter>controls</parameter> de <function>ldap_search</function>. Véase
  también <link linkend="ldap.controls">LDAP Controls</link> para más detalles.
 </simpara>
</warning>'>

<!ENTITY ldap.changelog.controls-nullable '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>controls</parameter> ahora acepta &null;; anteriormente, su valor predeterminado era <literal>[]</literal>.
 </entry>
</row>'>

<!ENTITY ldap.changelog.ldap-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  El parámetro <parameter>ldap</parameter> ahora espera una instancia de <classname>LDAP\Connection</classname>
  ; anteriormente, se esperaba un &resource; <literal>ldap link</literal> válido.
 </entry>
</row>'>

<!ENTITY ldap.changelog.entry-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  El parámetro <parameter>entry</parameter> ahora espera una instancia de <classname>LDAP\ResultEntry</classname>
  ; anteriormente, se esperaba un &resource; <literal>ldap result entry</literal> válido.
 </entry>
</row>'>

<!ENTITY ldap.changelog.result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  El parámetro <parameter>result</parameter> ahora espera una instancia de <classname>LDAP\Result</classname>
  ; anteriormente, se esperaba un &resource; <literal>ldap result</literal> válido.
 </entry>
</row>'>

<!ENTITY ldap.changelog.return-result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Ahora devuelve una instancia de <classname>LDAP\Result</classname>; anteriormente,
  se devolvía un &resource;.
 </entry>
</row>'>

<!ENTITY ldap.changelog.return-result-entry-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Ahora devuelve una instancia de <classname>LDAP\ResultEntry</classname>; anteriormente,
  se devolvía un &resource;.
 </entry>
</row>'>

<!ENTITY ldap.return-result 'Devuelve una instancia de <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>,&return.falseforfailure;.'>
<!ENTITY ldap.return-result-array 'Devuelve una instancia de <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>, un array de instancias de <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>,&return.falseforfailure;.'>

<!ENTITY ldap.return-result-array-info '<simpara xmlns="http://docbook.org/ns/docbook">También es posible realizar búsquedas en paralelo. En este caso, el primer argumento debe ser un array de instancias de
<classname>LDAP\Connection</classname>, en lugar de una sola.
Si las búsquedas no deben utilizar todas el mismo DN base y filtro, se puede pasar un array de DN base y/o un array de filtros como argumentos. Estos arrays deben
tener el mismo tamaño que el array de instancias de <classname>LDAP\Connection</classname>, ya
que las primeras entradas de los arrays se utilizan para una búsqueda, las segundas entradas para otra, y así sucesivamente. Al realizar búsquedas en
paralelo, se devuelve un array de instancias de <classname>LDAP\Result</classname>, excepto en caso de error, donde el valor de retorno será &false;.</simpara>'>

<!-- mbstring notes -->

<!ENTITY note.mbstring.encoding.internal '<note xmlns="http://docbook.org/ns/docbook"><simpara>La codificación interna o la codificación
de caracteres especificada por <function>mb_regex_encoding</function>
se utilizará como codificación de caracteres para esta función.</simpara></note>'>

<!ENTITY note.mbstring.encoding.current '<note xmlns="http://docbook.org/ns/docbook"><simpara>La
codificación de caracteres especificada por <function>mb_regex_encoding</function>
se utilizará como codificación de caracteres para esta función de forma predeterminada.</simpara></note>'>

<!ENTITY mbstring.encoding.parameter '<simpara xmlns="http://docbook.org/ns/docbook">El parámetro <parameter>encoding</parameter>
es la codificación de caracteres. Si se omite o es &null;, se utilizará el valor
de la codificación de caracteres interna.</simpara>'>

<!ENTITY mbstring.warning.e-modifier '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Nunca utilice el modificador <literal>e</literal> con datos de entrada no confiables. No se realizará ningún escape automático (como se conoce de <function>preg_replace</function>). No tener esto en cuenta probablemente creará vulnerabilidades de ejecución remota de código en la aplicación.</simpara></warning>'>

<!ENTITY mbstring.changelog.encoding-nullable '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>encoding</parameter> ahora acepta &null;.
 </entry>
</row>'>

<!ENTITY mbstring.errors.encoding-invalid '<para xmlns="http://docbook.org/ns/docbook">
 A partir de PHP 8.0.0, se lanza una <exceptionname>ValueError</exceptionname> si
 <parameter>encoding</parameter> es una codificación no válida.
 Antes de PHP 8.0.0, se emitía una advertencia <constant>E_WARNING</constant> en su lugar.
</para>'>

<!ENTITY mbstring.changelog.encoding-invalid '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Ahora lanza una <exceptionname>ValueError</exceptionname> si
  <parameter>encoding</parameter> es una codificación no válida.
  Anteriormente, se emitía una advertencia <constant>E_WARNING</constant>
  y se devolvía &false;.
 </entry>
</row>'>

<!ENTITY mbstring.changelog.needle-empty '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>needle</parameter> ahora acepta una cadena vacía.
 </entry>
</row>'>

<!-- mcrypt notes -->

<!ENTITY mcrypt.parameter.cipher '<simpara xmlns="http://docbook.org/ns/docbook">Una de las constantes <constant>MCRYPT_ciphername</constant>, o el nombre del algoritmo como cadena.</simpara>'>

<!ENTITY mcrypt.parameter.iv.strict '<simpara xmlns="http://docbook.org/ns/docbook">Utilizado para la inicialización en los modos CBC, CFB, OFB, y en algunos algoritmos en modo STREAM. Si el tamaño del IV proporcionado no es soportado por el modo de encadenamiento o no se proporcionó un IV, pero el modo de encadenamiento requiere uno, la función emitirá una advertencia y devolverá &false;.</simpara>'>

<!ENTITY mcrypt.parameter.mode '<simpara xmlns="http://docbook.org/ns/docbook">Una de las constantes <constant>MCRYPT_MODE_modename</constant>, o una de las siguientes cadenas: "ecb", "cbc", "cfb", "ofb", "nofb" o "stream".</simpara>'>

 <!-- MCVE notes -->

<!-- memcached notes -->

<!ENTITY memcached.note.delete-time '<note xmlns="http://docbook.org/ns/docbook"><simpara>
       A partir de memcached 1.3.0 (publicado en 2009) esta funcionalidad ya no está soportada. Pasar
       un valor distinto de cero para <parameter>time</parameter> causará que
       la eliminación falle. <methodname>Memcached::getResultCode</methodname>
       devolverá <constant>MEMCACHED_INVALID_ARGUMENTS</constant>.
      </simpara></note>
'>

<!ENTITY memcached.parameter.expiration 'El tiempo de expiración, predeterminado a 0. Véase <link
 linkend="memcached.expiration" xmlns="http://docbook.org/ns/docbook">Expiration Times</link> para más información.'>

<!ENTITY memcached.parameter.server_key 'La clave que identifica el servidor donde almacenar o recuperar el valor. En lugar de calcular el hash sobre la clave real del elemento, se calcula el hash sobre la clave del servidor al decidir con qué servidor memcached comunicarse. Esto permite agrupar elementos relacionados en un solo servidor para mayor eficiencia con operaciones múltiples.'>

<!ENTITY memcached.parameter.items 'Un array de pares clave/valor para almacenar en el servidor.'>

<!ENTITY memcached.parameter.key 'La clave bajo la cual almacenar el valor.'>

<!ENTITY memcached.parameter.value 'El valor a almacenar.'>

<!ENTITY memcached.result.getresultcode 'Utilice <methodname xmlns="http://docbook.org/ns/docbook">Memcached::getResultCode</methodname> si es necesario.'>

<!ENTITY memcached.result.delete-multi '<simpara xmlns="http://docbook.org/ns/docbook">
   Devuelve un array indexado por <parameter>keys</parameter>. Cada elemento
   es &true; si la clave correspondiente fue eliminada, o una de las constantes
   <constant>Memcached::RES_<replaceable>*</replaceable></constant> si la eliminación correspondiente
   falló.
   </simpara>
  <simpara xmlns="http://docbook.org/ns/docbook">
   <methodname>Memcached::getResultCode</methodname> devolverá el
   código de resultado de la última operación de eliminación ejecutada, es decir, la operación
   de eliminación del último elemento de <parameter>keys</parameter>.
  </simpara>
'>

<!-- password notes -->

<!ENTITY password.parameter.algo 'Una <link xmlns="http://docbook.org/ns/docbook" linkend="password.constants">constante del algoritmo de contraseña</link> que representa el algoritmo a utilizar durante el hasheo de la contraseña.'>

<!ENTITY password.parameter.hash 'Un hash creado por la función <function xmlns="http://docbook.org/ns/docbook">password_hash</function>.'>

<!ENTITY password.parameter.options 'Un array asociativo que contiene las opciones. Ver también <link xmlns="http://docbook.org/ns/docbook" linkend="password.constants">las constantes del algoritmo de contraseña</link> para la documentación sobre las opciones soportadas para cada algoritmo.'>

<!ENTITY password.parameter.password 'La contraseña del usuario.'>

<!-- pspell notes -->

<!ENTITY pspell.changelog.pspell-dictionary '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  El parámetro <parameter>dictionary</parameter> ahora espera una instancia de <classname>PSpell\Dictionary</classname>
  ; anteriormente, se esperaba un &resource;.
 </entry>
</row>'>

<!ENTITY pspell.changelog.pspell-config '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  El parámetro <parameter>config</parameter> ahora espera una instancia de <classname>PSpell\Config</classname>
  ; anteriormente, se esperaba un &resource;.
 </entry>
</row>'>

<!ENTITY pspell.parameter.pspell-dictionary '<simpara xmlns="http://docbook.org/ns/docbook">Una instancia de <classname>PSpell\Dictionary</classname>.</simpara>'>

<!ENTITY pspell.parameter.pspell-config '<simpara xmlns="http://docbook.org/ns/docbook">Una instancia de <classname>PSpell\Config</classname>.</simpara>'>

<!-- RNP -->

<!ENTITY rnp.parameter.ffi-description 'El objeto FFI retornado por <function xmlns="http://docbook.org/ns/docbook">rnp_ffi_create</function>.'>

<!ENTITY rnp.parameter.key-format 'El formato de clave para los datos (GPG, KBX, G10).'>

<!ENTITY rnp.parameter.loadsave-flags 'Ver la descripción de los flags <constant xmlns="http://docbook.org/ns/docbook">RNP_LOAD_SAVE_<replaceable>*</replaceable></constant>.'>

<!-- socket entities -->

<!ENTITY sockets.changelog.socket-param '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.0.0</entry>
  <entry>
   <parameter>socket</parameter> ahora es una instancia de <classname>Socket</classname> ;
   anteriormente, era un <type>resource</type>.
  </entry>
 </row>'>

<!ENTITY sockets.changelog.address-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>address</parameter> ahora es una instancia de <classname>AddressInfo</classname> ;
  anteriormente, era un <type>resource</type>.
 </entry>
</row>'>

<!-- geaman notes -->

<!ENTITY gearman.parameter.host 'El nombre de host del servidor de trabajos.'>

<!ENTITY gearman.parameter.port 'El puerto del servidor de trabajos.'>

<!ENTITY gearman.parameter.functionname 'Una función registrada que el trabajador va a ejecutar'>

<!ENTITY gearman.parameter.workload 'Datos serializados a analizar'>

<!ENTITY gearman.parameter.context 'Contexto de la aplicación a asociar con una tarea'>

<!ENTITY gearman.parameter.unique 'Un identificador único utilizado para identificar una tarea particular'>

<!ENTITY gearman.parameter.jobhandle 'El manejador de trabajos asignado por el servidor Gearman'>

<!ENTITY gearman.parameter.callback '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>callback</parameter></term>
 <listitem>
  <simpara>
   Una función o método a llamar.
   Debe retornar un valor válido <link linkend="gearman.constants">de retorno Gearman</link>.
  </simpara>
  <simpara>
   Si no se proporciona una instrucción de retorno, el valor predeterminado será <constant>GEARMAN_SUCCESS</constant>.
  </simpara>
  <methodsynopsis>
   <type>int</type><methodname><replaceable>callback</replaceable></methodname>
   <methodparam><type>GearmanTask</type><parameter>task</parameter></methodparam>
   <methodparam><type>mixed</type><parameter>context</parameter></methodparam>
  </methodsynopsis>
  <variablelist>
   <varlistentry>
    <term><parameter>task</parameter></term>
    <listitem>
     <simpara>
      La tarea para la cual se llama este callback.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry>
    <term><parameter>context</parameter></term>
    <listitem>
     <simpara>
      Todo lo que se pasó a <methodname>GearmanClient::addTask</methodname> (o método equivalente) como <parameter>context</parameter>.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>
 </listitem>
</varlistentry>'>

<!ENTITY gearman.note.callback '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  El callback solo será disparado para las tareas que son añadidas (por ejemplo llamando a <methodname>GearmanClient::addTask</methodname>) después
  de la llamada a este método.
 </simpara>
</note>'>

<!-- Date and time entities -->
<!ENTITY date.timezone.intro.title '<title xmlns="http://docbook.org/ns/docbook">Lista de Zonas Horarias Soportadas</title>'>

<!ENTITY date.timezone.intro "<para xmlns='http://docbook.org/ns/docbook'>
Aquí, se encuentra una lista completa de las zonas horarias soportadas por PHP, que
pueden ser utilizadas con, por ejemplo, <function>date_default_timezone_set</function>.
<caution><simpara>El comportamiento de las zonas horarias que no están listadas aquí es indefinido.</simpara></caution>
</para><note xmlns='http://docbook.org/ns/docbook'> <simpara>La última versión de la base de datos de zonas horarias puede ser instalada
vía el comando PECL <link xlink:href='&url.pecl.package.get;timezonedb' xmlns:xlink='http://www.w3.org/1999/xlink'>timezonedb</link>.
</simpara></note>">

<!ENTITY date.timezone.bc '<simpara xmlns="http://docbook.org/ns/docbook"> No se utilice ninguna de las zonas horarias listadas
aquí (excepto UTC), estas solo existen por razones de compatibilidad ascendente y su comportamiento puede provocar errores. Además, estas
zonas horarias pueden ser eliminadas de la base de datos IANA de zonas horarias en cualquier momento.
</simpara>'>

<!ENTITY date.timezone.posix-signs '<simpara xmlns="http://docbook.org/ns/docbook">
 Si se ignora la advertencia anterior, tenga en cuenta que la base de datos de la
 IANA que proporciona el soporte de zonas horarias en PHP utiliza los signos
 POSIX lo que significa que las zonas <literal>Etc/GMT+n</literal> y
 <literal>Etc/GMT-n</literal> están invertidas respecto al uso común.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
 Por ejemplo, la zona horaria 8 horas después de GMT que se utiliza en China
 y en Australia Occidental es actualmente
 <literal>Etc/GMT-8</literal> en esta base de datos, y no
 <literal>Etc/GMT+8</literal> como se podría esperar.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
 Una vez más, se recomienda encarecidamente que se utilice la zona horaria
 correcta para su ubicación, como <literal>Asia/Shanghai</literal> o
 <literal>Australia/Perth</literal> para los ejemplos anteriores.
</simpara>'>

<!ENTITY date.timezone.errors.description '<simpara xmlns="http://docbook.org/ns/docbook">
Cada llamada a una función de fecha/hora generará un diagnóstico de tipo <constant>E_WARNING</constant>
si la zona horaria no es válida. Ver también <function>date_default_timezone_set</function></simpara>'>

<!ENTITY date.timestamp.description '
<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>timestamp</parameter></term><listitem><simpara>
El parámetro opcional <parameter>timestamp</parameter> es un
<type>int</type> timestamp Unix que por defecto es la hora
local actual si <parameter>timestamp</parameter> se omite o es &null;. En
otras palabras, por defecto toma el valor de <function>time</function>.
</simpara></listitem></varlistentry>'>

<!ENTITY date.datetime.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>object</parameter></term>
<listitem><simpara>Solo en estilo procedimental: un objeto <classname>DateTime</classname> retornado
por <function>date_create</function></simpara></listitem></varlistentry>'>

<!ENTITY date.datetime.description.modified '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>object</parameter></term>
<listitem><simpara>Solo en estilo procedimental: Un objeto <classname>DateTime</classname> retornado
por la función <function>date_create</function>.
Esta función modifica este objeto.</simpara></listitem></varlistentry>'>

<!ENTITY date.datetimezone.description '<varlistentry xmlns="http://docbook.org/ns/docbook"> <term>
<parameter>object</parameter></term><listitem><simpara> Solo en estilo procedimental: un objeto <classname>DateTimeZone</classname> retornado
por <function>timezone_open</function> </simpara></listitem></varlistentry>'>

<!ENTITY date.datetime.return.modifiedobject 'Retorna el objeto modificado <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname> para encadenar métodos.'>
<!ENTITY date.datetimeimmutable.return.modifiedobject 'Retorna un nuevo objeto <classname xmlns="http://docbook.org/ns/docbook">DateTimeImmutable</classname> con los datos modificados.'>

<!ENTITY date.timezone.dbversion 'Esta lista está basada en la versión de la base de datos de zonas horarias'>

<!ENTITY date.timezone.africa 'África'>
<!ENTITY date.timezone.america 'América'>
<!ENTITY date.timezone.antarctica 'Antártida'>
<!ENTITY date.timezone.arctic 'Ártico'>
<!ENTITY date.timezone.asia 'Asia'>
<!ENTITY date.timezone.atlantic 'Atlántico'>
<!ENTITY date.timezone.australia 'Australia'>
<!ENTITY date.timezone.europe 'Europa'>
<!ENTITY date.timezone.indian 'Índico'>
<!ENTITY date.timezone.pacific 'Pacífico'>
<!ENTITY date.timezone.others 'Otros'>
<!ENTITY date.formats 'Los formatos válidos son explicados en la documentación sobre los <link xmlns="http://docbook.org/ns/docbook" linkend="datetime.formats">formatos de Fecha y Hora</link>.'>
<!ENTITY date.formats.parameter 'Una cadena de fecha/hora. &date.formats;'>

<!-- Dom Notes -->
<!ENTITY dom.node.inserted 'Este nodo no será mostrado en el documento, a
menos que sea insertado con <function xmlns="http://docbook.org/ns/docbook">DOMNode::appendChild</function>.'>

<!ENTITY dom.malformederror '<simpara xmlns="http://docbook.org/ns/docbook">Aunque el HTML mal-formado debería cargarse con éxito, esta función puede generar una advertencia de tipo <constant>E_WARNING</constant> cuando encuentre una mala etiqueta.<link linkend="function.libxml-use-internal-errors">Las funciones de manejo de errores libxml</link>pueden ser utilizadas para manejar estos errores.</simpara>'>
<!ENTITY dom.note.utf8 '<note xmlns="http://docbook.org/ns/docbook"><simpara>La extensión DOM utiliza el codificado UTF-8. Utilice <function>mb_convert_encoding</function>, <methodname>UConverter::transcode</methodname>, o <function>iconv</function> para manipular otros codificados.</simpara></note>'>
<!ENTITY dom.note.modern.utf8 '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  La extensión DOM utiliza el codificado UTF-8 al utilizar los métodos o las
  propiedades. Los métodos del analizador detectan automáticamente el codificado o permiten al llamante especificar un codificado.
 </simpara>
</note>'>

<!ENTITY dom.note.json '<note xmlns="http://docbook.org/ns/docbook"><simpara> Al utilizar <function>json_encode</function> sobre un objeto <classname>DOMDocument</classname> el resultado será el de codificar un objeto vacío.</simpara></note>'>
<!ENTITY dom.domdocument.html5 '<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Utilice <classname>Dom\HTMLDocument</classname> para analizar y tratar el HTML moderno en
  lugar de <classname>DOMDocument</classname>.
 </simpara>
 <simpara>
  Esta función analiza la entrada utilizando un analizador HTML 4. Las reglas de análisis del
  HTML 5, que son las utilizadas por los navegadores web modernos, son diferentes. Según la entrada,
  esto puede resultar en una estructura DOM diferente. Por lo tanto, esta función no
  puede ser utilizada de forma segura para la sanitización del HTML.
 </simpara>
 <simpara>
  El comportamiento durante el análisis del HTML puede depender de la versión de
  <literal>libxml</literal> que se utilice, especialmente en lo que respecta a
  los casos límite y el manejo
  de errores. Para un análisis conforme a la especificación HTML5,
  utilice <methodname>Dom\HTMLDocument::createFromString</methodname> o
  <methodname>Dom\HTMLDocument::createFromFile</methodname>, añadidos en PHP 8.4.
 </simpara>
 <simpara>
  Por ejemplo, algunos elementos HTML cerrarán implícitamente un elemento padre cuando sean
  encontrados. Las reglas de cierre automático de elementos padres difieren
  entre HTML 4 y HTML 5, y por lo tanto, la estructura DOM que
  <classname>DOMDocument</classname> ve puede ser diferente de la que un
  navegador web ve, lo que puede permitir potencialmente a un atacante comprometer el
  HTML resultante.
 </simpara>
</warning>'>
<!ENTITY dom.tokenlist.errors '<itemizedlist xmlns="http://docbook.org/ns/docbook">
 <listitem>
  <simpara>
   Levanta una <exceptionname>ValueError</exceptionname> si
   un token contiene bytes nulos.
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Levanta una <exceptionname>Dom\DOMException</exceptionname> con el código
   <constant>Dom\SYNTAX_ERR</constant> si un token es una cadena vacía.
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Levanta una <exceptionname>Dom\DOMException</exceptionname> con el código
   <constant>Dom\INVALID_CHARACTER_ERR</constant> si un token contiene
   espacios ASCII.
  </simpara>
 </listitem>
</itemizedlist>'>



<!-- Dom Examples -->
<!ENTITY dom.book.example '<simpara xmlns="http://docbook.org/ns/docbook">El siguiente ejemplo utiliza el archivo <filename>book.xml</filename>, cuyo contenido es:</simpara>
<programlisting role="xml" xmlns="http://docbook.org/ns/docbook">
<!-- Warning: The CDATA markup here is a little tricky. Please DO NOT BREAK it! -->
<![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE books [
  <!ELEMENT books   (book+)>
  <!ELEMENT book    (title, author+, xhtml:blurb?)>
  <!ELEMENT title   (#PCDATA)>
  <!ELEMENT blurb   (#PCDATA)>
  <!ELEMENT author  (#PCDATA)>
  <!ATTLIST books   xmlns        CDATA  #IMPLIED>
  <!ATTLIST books   xmlns:xhtml  CDATA  #IMPLIED>
  <!ATTLIST book    id           ID     #IMPLIED>
  <!ATTLIST author  email        CDATA  #IMPLIED>
]>
<?xml-stylesheet type="text/xsl" href="style.xsl"?>
<books xmlns="http://books.php/" xmlns:xhtml="http://www.w3.org/1999/xhtml">
  <book id="php-basics">
    <title>PHP Basics</title>
    <author email="jim.smith@basics.php">Jim Smith</author>
    <author email="jane.smith@basics.php">Jane Smith</author>
    <xhtml:blurb><![CDATA[
<p><em>PHP Basics</em> provides an introduction to PHP.</p>
]]]]><![CDATA[></xhtml:blurb>
  </book>
  <book id="php-advanced">
    <title>PHP Advanced Programming</title>
    <author email="jon.doe@advanced.php">Jon Doe</author>
  </book>
</books>
]]></programlisting>'>

<!-- Dom entities -->
<!ENTITY dom.parameter.options '<simpara xmlns="http://docbook.org/ns/docbook">
  <link linkend="language.operators.bitwise">Operación a nivel de bits <literal>OR</literal></link>
  de las <link linkend="libxml.constants">constantes de opción libxml</link>.
</simpara>'>

<!ENTITY dom.parameter.compliant.options '&dom.parameter.options;
 <simpara xmlns="http://docbook.org/ns/docbook">
  También es posible pasar <constant>Dom\HTML_NO_DEFAULT_NS</constant>
  para desactivar el uso del espacio de nombres HTML y del elemento template.
  Esto solo debería ser utilizado si las implicaciones son correctamente comprendidas.
</simpara>'>

<!ENTITY dom.parameter.compliant.encoding '<simpara xmlns="http://docbook.org/ns/docbook">
 El codificado en el cual el documento
 fue creado. Si no se proporciona, intentará determinar el codificado más probable utilizado.
</simpara>'>

<!ENTITY dom.parser.compliant.note.whitespace '<refsect1 role="notes" xmlns="http://docbook.org/ns/docbook">
 &reftitle.notes;
 <note>
  <simpara>
   Los espacios en blanco en las etiquetas <literal>html</literal> y <literal>head</literal> no
   son considerados significativos y pueden perder su formato.
  </simpara>
 </note>
</refsect1>'>

<!ENTITY dom.parameters.register_node_ns '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>registerNodeNS</parameter></term>
 <listitem>
  <simpara>
   Indica si se deben registrar automáticamente los prefijos de espacio de nombres en vigor del nodo de contexto en el objeto <classname>DOMXPath</classname>.
   Esto puede ser utilizado para evitar tener que llamar manualmente a <methodname>DOMXPath::registerNamespace</methodname> para cada espacio de nombres en vigor. En
   caso de conflicto de prefijos de espacio de nombres, solo se registra el prefijo de espacio de nombres descendiente más cercano.
  </simpara>
 </listitem>
</varlistentry>'>

<!ENTITY dom.parameters.serialize.options '<simpara xmlns="http://docbook.org/ns/docbook">
 Opciones adicionales. Las
 opciones <constant>LIBXML_NOEMPTYTAG</constant>
 y <constant>LIBXML_NOXMLDECL</constant> son soportadas. Antes
 de PHP 8.3.0, solo la opción <constant>LIBXML_NOEMPTYTAG</constant>
 era soportada.
</simpara>'>

<!ENTITY dom.errors.hierarchy.parent '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
  <listitem>
  <simpara>
    Se levanta si el padre es de un tipo que no permite hijos del
    tipo de uno de los <parameter>nodes</parameter> transmitidos, o si el nodo a
    insertar es uno de los ancestros de este nodo o este nodo mismo.
  </simpara>
 </listitem>
</varlistentry>'>

<!ENTITY dom.errors.hierarchy.self '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
  <listitem>
  <simpara>
    Se levanta si este nodo es de un tipo que no permite hijos del
    tipo de uno de los <parameter>nodes</parameter> transmitidos, o si el nodo a
    insertar es uno de los ancestros de este nodo o este nodo mismo.
  </simpara>
 </listitem>
</varlistentry>'>

<!ENTITY dom.errors.wrong_document '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><constant>DOM_WRONG_DOCUMENT_ERR</constant></term>
  <listitem>
  <simpara>
    Se levanta si uno de los <parameter>nodes</parameter> transmitidos ha sido creado a partir
    de un documento diferente del que creó este nodo.
  </simpara>
 </listitem>
</varlistentry>'>

<!ENTITY dom.errors.compliant.wrong_document '<listitem xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Levanta una excepción <exceptionname>Dom\DOMException</exceptionname> con el código
  <constant>Dom\WRONG_DOCUMENT_ERR</constant> si el <parameter>node</parameter>
  proviene de otro documento.
 </simpara>
</listitem>'>

<!ENTITY dom.errors.compliant.common '<listitem xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Levanta una excepción <exceptionname>ValueError</exceptionname> si
  <parameter>options</parameter> contiene una opción inválida.
 </simpara>
</listitem>
<listitem>
 <simpara>
  Levanta una excepción <exceptionname>ValueError</exceptionname> si
  <parameter>overrideEncoding</parameter> utiliza un codificado desconocido.
 </simpara>
</listitem>'>

<!ENTITY dom.changelog.previous_hierarchy_exception 'Anteriormente, esto desencadenaba una
 <classname xmlns="http://docbook.org/ns/docbook">DOMException</classname> con el código
 <constant xmlns="http://docbook.org/ns/docbook">DOM_HIERARCHY_REQUEST_ERR</constant>.'>

<!ENTITY dom.c14n.xpath_array '<listitem xmlns="http://docbook.org/ns/docbook">
  <para>
   Un array de XPaths para filtrar los nodos. Cada
   entrada en este array es un array asociativo con:
   <itemizedlist>
    <listitem>
     <simpara>
      Una clave <literal>query</literal> requerida que contiene la expresión XPath como cadena de caracteres.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Una clave <literal>namespaces</literal> opcional que contiene un array que mapea los prefijos del espacio de nombres (claves) a los URI del espacio de nombres (valores).
     </simpara>
    </listitem>
   </itemizedlist>
  </para>
 </listitem>'>

<!-- FileSystem entities -->
<!ENTITY fs.emits.warning.on.failure '<simpara xmlns="http://docbook.org/ns/docbook">
En caso de fallo, se emitirá una advertencia de tipo <constant>E_WARNING</constant>.
</simpara>'>

<!ENTITY fs.validfp.all '<simpara xmlns="http://docbook.org/ns/docbook">El puntero de fichero debe ser válido y apuntar a un
archivo abierto con éxito por <function>fopen</function> o
<function>fsockopen</function> (y no cerrado aún por
<function>fclose</function>).</simpara>'>

<!ENTITY fs.file.pointer '<simpara xmlns="http://docbook.org/ns/docbook">Un puntero al sistema de ficheros de tipo <type>resource</type>
que típicamente se crea utilizando <function>fopen</function>.</simpara>'>

<!ENTITY fs.file.32bit '<note xmlns="http://docbook.org/ns/docbook"><simpara>
    Como el tipo entero de PHP es firmado y que muchas plataformas utilizan enteros de 32 bits,
    algunas funciones relacionadas con el sistema de archivos pueden retornar resultados extraños para ficheros
    de tamaño superior a 2 Go.
   </simpara></note>'>

<!ENTITY ini.scanner.typed '<simpara xmlns="http://docbook.org/ns/docbook">
    A partir de PHP 5.6.1 también puede ser especificado como <constant>INI_SCANNER_TYPED</constant>.
    En este modo los booleanos, null y enteros son preservados tanto como sea posible. Las
    cadenas de caracteres <literal>"true"</literal>, <literal>"on"</literal> y <literal>"yes"</literal>
    son convertidas a &true;. <literal>"false"</literal>, <literal>"off"</literal>, <literal>"no"</literal>
    y <literal>"none"</literal> son considerados como &false;. <literal>"null"</literal> es convertido a &null;
    en este modo. Además todas las cadenas de caracteres numéricas son convertidas a entero si es posible.
   </simpara>'>

<!-- GNUPG -->
<!ENTITY gnupg.identifier '<simpara xmlns="http://docbook.org/ns/docbook">El identificador gnupg, generado por una llamada a la función
<function>gnupg_init</function> o a la función <classname>gnupg</classname>.</simpara>'>

<!ENTITY gnupg.fingerprint '<simpara xmlns="http://docbook.org/ns/docbook">La huella de la clave.</simpara>'>

<!-- HaruDoc -->
<!-- ODBC -->
<!ENTITY odbc.connection.id '<simpara xmlns="http://docbook.org/ns/docbook">El objeto de conexión ODBC, ver la documentación de
la función <function>odbc_connect</function> para más detalles.</simpara>'><!ENTITY odbc.result.object 'El objeto de resultado ODBC'>

<!ENTITY odbc.result.object 'The ODBC result object'>

<!ENTITY odbc.result.object-return 'Devuelve un objeto de resultado ODBC'>

<!ENTITY odbc.result.object-return-falseforfailure '&odbc.result.object-return;&return.falseforfailure;.'>

<!ENTITY odbc.parameter.catalog 'El catálogo (&apos;calificativo&apos; en el argot ODBC 2).'>

<!ENTITY odbc.parameter.schema 'El esquema (&apos;propietario&apos; en el argot ODBC 2).'>

<!ENTITY odbc.parameter.search 'Este parámetro acepta los siguientes patrones de búsqueda:
<literal xmlns="http://docbook.org/ns/docbook">&#x25;</literal> para buscar cero o más caracteres,
y <literal xmlns="http://docbook.org/ns/docbook">_</literal> para buscar un solo carácter.'>

<!ENTITY odbc.result.driver-specific 'Los controladores pueden indicar columnas adicionales.'>

<!ENTITY odbc.changelog.connection-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  <parameter>odbc</parameter> ahora espera una instancia de <classname>Odbc\Connection</classname>
  ; anteriormente, se esperaba un <type>resource</type>.
 </entry>
</row>'>

<!ENTITY odbc.changelog.connection-return '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.4.0</entry>
  <entry>
   Esta función ahora devuelve una instancia de <classname>Odbc\Connection</classname>; anteriormente,
   se devolvía un <type>resource</type>.
  </entry>
 </row>'>

<!ENTITY odbc.changelog.credential-params '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.4.0</entry>
  <entry>
   <parameter>user</parameter> y <parameter>password</parameter> ahora pueden ser
   nulos, también son opcionales y valen por defecto &null;.
  </entry>
 </row>
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>8.4.0</entry>
  <entry>
   Anteriormente, el uso de una cadena vacía para <parameter>password</parameter> no incluía
   <literal>pwd</literal> en la cadena de conexión generada para <parameter>dsn</parameter>
   . Ahora, <literal>pwd</literal> se incluye en la cadena de conexión, con un valor de
   cadena vacía. Para restaurar el comportamiento anterior, <parameter>password</parameter> puede ser definido como &null;.
  </entry>
 </row>
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>8.4.0</entry>
  <entry>
   Anteriormente, si <parameter>dsn</parameter> contenía <literal>uid</literal> o <literal>pwd</literal>
   , entonces los parámetros <parameter>user</parameter> y <parameter>password</parameter> eran ignorados.
   Ahora, <parameter>user</parameter> solo es ignorado si <parameter>dsn</parameter> contiene
   <literal>uid</literal>, y <parameter>password</parameter> solo es ignorado si
   <parameter>dsn</parameter> contiene <literal>pwd</literal>.
  </entry>
 </row>'>

<!ENTITY odbc.changelog.result-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  <parameter>statement</parameter> ahora espera una instancia de <classname>Odbc\Result</classname>
  ; anteriormente, se esperaba un <type>resource</type>.
 </entry>
</row>'>

<!ENTITY odbc.changelog.result-return '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  Esta función ahora devuelve una instancia de <classname>Odbc\Result</classname>
  ; anteriormente, se devolvía un <type>resource</type>.
 </entry>
</row>'>

<!-- OAUTH -->
<!ENTITY oauth.callback.error 'Emite un error <constant xmlns="http://docbook.org/ns/docbook">E_ERROR</constant> si
la función de devolución de llamada no puede ser llamada o no ha sido especificada.'>

<!ENTITY oauth.changelog.error.null 'Antes de esta versión, &null; era devuelto en lugar de &false;.'>

<!-- Oracle -->
<!ENTITY oci.db "<simpara xmlns='http://docbook.org/ns/docbook' xmlns:xlink='http://www.w3.org/1999/xlink'> Contiene la
instancia <literal>Oracle</literal> a la que debemos conectarnos. Esto puede ser
una <link xlink:href='&url.oracle.oic.connect;'>cadena de conexión
rápida</link>, un nombre de conexión del
fichero <filename>tnsnames.ora</filename>, o el nombre de una instancia
local Oracle.
</simpara>
<simpara xmlns='http://docbook.org/ns/docbook'>Si no se especifica o es &null;, PHP
utiliza variables de entorno como <constant>TWO_TASK</constant> (en Linux)
o <constant>LOCAL</constant> (en Windows)
y <constant>ORACLE_SID</constant> para determinar la instancia
<literal>Oracle</literal> a la que debemos conectarnos.
</simpara>
<simpara xmlns='http://docbook.org/ns/docbook'>
Para usar el método de conexión rápida, PHP debe estar vinculado con la biblioteca cliente Oracle
10<emphasis>g</emphasis> o superior. La cadena de conexión rápida para Oracle
10<emphasis>g</emphasis> o superior es de la forma:
<emphasis>[//]host_name[:port][/service_name]</emphasis>. Desde Oracle
11<emphasis>g</emphasis>, la sintaxis es:
<emphasis>[//]host_name[:port][/service_name][:server_type][/instance_name]</emphasis>.
Opciones adicionales fueron introducidas con Oracle 19c Los
nombres de los servicios pueden ser encontrados ejecutando la
utilidad Oracle <literal>lsnrctl status</literal> en la máquina que ejecuta la base
de datos.
</simpara>
<simpara xmlns='http://docbook.org/ns/docbook'>
El fichero <filename>tnsnames.ora</filename> puede estar en el camino de búsqueda de Oracle Net,
que
incluye <filename>/your/path/to/instantclient/network/admin</filename>, <filename>$ORACLE_HOME/network/admin</filename>
y <filename>/etc</filename>. Una solución alternativa sería definir <literal>TNS_ADMIN</literal>
para que el fichero <filename>$TNS_ADMIN/tnsnames.ora</filename> sea leído. Asegúrese de que el demonio que ejecuta
el servidor web tenga acceso de lectura a este fichero.
</simpara>">

<!ENTITY oci.charset "<simpara xmlns='http://docbook.org/ns/docbook'>Determina
el juego de caracteres utilizado por la biblioteca cliente Oracle. El juego de
caracteres no necesita ser idéntico al utilizado por la base de datos. Si no coincide, Oracle
hará lo mejor posible para convertir los datos desde el juego de caracteres de la base
de datos. Dependiendo de los juegos de caracteres, el resultado puede no ser
perfecto. Además, esta conversión requiere un poco de tiempo del sistema.
</simpara>
<simpara xmlns='http://docbook.org/ns/docbook'>Si no se especifica, la biblioteca
cliente Oracle determinará un juego de caracteres desde la variable de
entorno <constant>NLS_LANG</constant>.
</simpara>
<simpara xmlns='http://docbook.org/ns/docbook'>Pasar este parámetro puede
reducir el tiempo de conexión.
</simpara>">

<!ENTITY oci.sessionmode '<simpara xmlns="http://docbook.org/ns/docbook">Este
parámetro está disponible a partir de PHP 5 (PECL OCI8 1.1) y acepta los
siguientes valores: <constant>OCI_DEFAULT</constant>,
<constant>OCI_SYSOPER</constant> y <constant>OCI_SYSDBA</constant>. Si
bien la constante <constant>OCI_SYSOPER</constant> o la constante
<constant>OCI_SYSDBA</constant> es especificada, esta función intentará establecer
una conexión privilegiada usando identidades externas.
Las conexiones privilegiadas están desactivadas por defecto. Para activarlas, debe
definir la opción <link linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link>
a <literal>On</literal>.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
PHP 5.3 (PECL OCI8 1.3.4) introducen el valor de modo
<constant>OCI_CRED_EXT</constant>. Este modo solicita a Oracle usar una identificación externa
o bien del sistema operativo, que debe ser configurada en la base de
datos. El flag <constant>OCI_CRED_EXT</constant> solo puede ser usado con el nombre
de usuario &quot;/&quot; asociado a una contraseña vacía. La opción
<link linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link>
puede ser definida a <literal>On</literal> o <literal>Off</literal>.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
<constant>OCI_CRED_EXT</constant> puede ser combinado con el modo
<constant>OCI_SYSOPER</constant> o el modo
<constant>OCI_SYSDBA</constant>.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
<constant>OCI_CRED_EXT</constant> no es soportado en Windows por razones
de seguridad.
</simpara>'>

<!ENTITY oci.datatypes '<simpara xmlns="http://docbook.org/ns/docbook">Para más detalles sobre el mapeo de tipos de datos realizado
por la extensión OCI8, lea los <link linkend="oci8.datatypes">tipos
de datos soportados por el driver</link>.</simpara>'>

<!ENTITY oci.parameter.connection '<simpara xmlns="http://docbook.org/ns/docbook">Un identificador de conexión Oracle, devuelto
por la función <function>oci_connect</function>, <function>oci_pconnect</function> o la
función <function>oci_new_connect</function>.</simpara>'>

<!ENTITY oci.availability.note.10g '<note xmlns="http://docbook.org/ns/docbook"><title>Requerido por la versión Oracle</title>
<simpara>Esta función está disponible si PHP está vinculado a partir
de la versión 10<emphasis>g</emphasis> de la biblioteca de la base de datos Oracle.</simpara></note>'>

<!ENTITY oci.clientinfo.tip '<tip xmlns="http://docbook.org/ns/docbook"><title>Rendimiento</title><simpara>Con versiones antiguas de OCI8
o bases de datos Oracle antiguas, la información del cliente puede ser definida usando el paquete Oracle
<literal>DBMS_APPLICATION_INFO</literal>. Esto es menos eficiente que usar la
función <function>oci_set_client_info</function>.</simpara></tip>'>

<!ENTITY oci.roundtrip.caution '<caution xmlns="http://docbook.org/ns/docbook"><title>Ida y vuelta</title>
<simpara>Algunas funciones OCI8 requieren ida y vuelta con la base de datos. Estas ida
y vuelta pueden ser evitadas al usar consultas cuyo resultado es almacenado en caché.
</simpara></caution>'>

<!ENTITY oci.use.setprefetch '<simpara xmlns="http://docbook.org/ns/docbook">Para las
consultas que devuelven un número muy grande de líneas, el rendimiento puede ser muy significativamente mejorado
aumentando el valor de
la opción <link linkend="ini.oci8.default-prefetch">oci8.default_prefetch</link>
o usando la función <function>oci_set_prefetch</function>.
</simpara>'>


<!ENTITY oci.arg.statement.id
"<simpara xmlns='http://docbook.org/ns/docbook'>Un identificador de consulta OCI8
creado por la función <function>oci_parse</function> y ejecutado por
la función <function>oci_execute</function>, o un identificador de consulta <literal>REF
CURSOR</literal>.</simpara>">

<!-- PCNTL Notes -->
<!ENTITY pcntl.parameter.status '<simpara xmlns="http://docbook.org/ns/docbook">El parámetro <parameter>status</parameter>
es el parámetro status pasado a una
llamada de <function>pcntl_waitpid</function> que tuvo éxito.</simpara>'>

<!-- PS Notes -->
<!ENTITY ps.note.visible '<simpara xmlns="http://docbook.org/ns/docbook">La nota no será visible si el documento es
impreso o mostrado, pero será visible si el documento es convertido a PDF, ya
sea por Acrobat Distiller™, o por Ghostview.</simpara>'>

<!ENTITY note.open-basedir.func '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta función es afectada por la directiva de configuración <link
linkend="ini.open-basedir">open_basedir</link>.</simpara></note>'>


<!ENTITY note.language-construct '<note xmlns="http://docbook.org/ns/docbook"><simpara>Como esto es una estructura
del lenguaje, y no una función, no es posible llamarla con las
<link linkend="functions.variable-functions">funciones variables</link>
o <link linkend="functions.named-arguments">argumentos nombrados</link>.</simpara>
</note>'>

<!-- Common pieces in partintro-sections -->
<!ENTITY no.config '<simpara xmlns="http://docbook.org/ns/docbook">Esta extensión no define ninguna directiva de configuración.</simpara>'>
<!ENTITY no.requirement '<simpara xmlns="http://docbook.org/ns/docbook">No se requiere ninguna biblioteca externa para compilar esta extensión.</simpara>'>
<!ENTITY no.install '<simpara xmlns="http://docbook.org/ns/docbook">No hay instalación necesaria para usar estas
funciones, son parte del núcleo de PHP.</simpara>'>

<!-- Used in every chapter that has directive descriptions -->
<!ENTITY ini.descriptions.title '<simpara xmlns="http://docbook.org/ns/docbook">Aquí hay una aclaración sobre el uso de
las directivas de configuración.</simpara>'>

<!-- Common pieces for reference part BEGIN-->

<!-- Used in reference/$extname/ini.xml -->
<!ENTITY extension.runtime '<simpara xmlns="http://docbook.org/ns/docbook">
El comportamiento de estas funciones es afectado por la configuración en el archivo &php.ini;.
</simpara>'>

<!ENTITY ini.php.constants 'Para más detalles sobre los modos
INI_*, refiérase a <xref xmlns="http://docbook.org/ns/docbook" linkend="configuration.changes.modes"/>.'>

<!-- Used in reference/$extname/constants.xml -->
<!ENTITY extension.constants '<simpara xmlns="http://docbook.org/ns/docbook">
Estas constantes son definidas por esta extensión, y solo
están disponibles si esta extensión ha sido compilada
con PHP, o bien cargada en tiempo de ejecución.
</simpara>'>

<!-- For STANDARD Constants used in reference/$extname/constants.xml -->
<!ENTITY extension.constants.core '<simpara xmlns="http://docbook.org/ns/docbook">
Las constantes listadas aquí están siempre disponibles en PHP.
</simpara>'>

<!-- Used in reference/$extname/classes.xml -->
<!-- PDO entities -->
<!ENTITY pdo.driver-constants '<simpara xmlns="http://docbook.org/ns/docbook">Las constantes a continuación son definidas
por este controlador y solo estarán disponibles cuando la extensión haya sido compilada en
PHP o cargada dinámicamente del motor de ejecución. Además, estas constantes específicas
del controlador deberían ser usadas solo si se usa este controlador. Usar atributos
específicos de un controlador con otro controlador podría causar un
comportamiento inesperado. <function>PDO::getAttribute</function> podría ser usado para obtener
el atributo <constant>PDO::ATTR_DRIVER_NAME</constant> para verificar el controlador,
si su código puede funcionar en múltiples controladores.</simpara>'>

<!ENTITY pdo.errors.exception-not-errmode '<note xmlns="http://docbook.org/ns/docbook"><simpara>Una excepción será emitida incluso si el atributo <constant>PDO::ATTR_ERRMODE</constant> no vale <constant>PDO::ERRMODE_EXCEPTION</constant>.</simpara></note>'>

<!-- PDO errors -->

<!ENTITY pdo.errors '<simpara xmlns="http://docbook.org/ns/docbook">
Emite un error de nivel <constant>E_WARNING</constant> si el atributo <constant>PDO::ATTR_ERRMODE</constant> está definido
a <constant>PDO::ERRMODE_WARNING</constant>.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
Lanza una excepción <classname>PDOException</classname> si el atributo <constant>PDO::ATTR_ERRMODE</constant>
está definido a <constant>PDO::ERRMODE_EXCEPTION</constant>.
</simpara>'>

<!-- PECL entities -->
<!ENTITY pecl.moved 'Esta extensión &link.pecl; no está integrada en PHP.'>

<!ENTITY pecl.info 'Información sobre la instalación de estas extensiones PECL puede ser
encontrada en el capítulo del manual titulado <link xmlns="http://docbook.org/ns/docbook" linkend="install.pecl">Instalación
de extensiones PECL</link>. Otra información como notas sobre nuevas versiones, descargas,
fuentes de ficheros, información sobre los mantenedores así como un CHANGELOG, pueden
ser encontradas aquí:'>

<!ENTITY pecl.info.dead 'Esta extensión es considerada no mantenida y muerta. Sin embargo, el
código fuente sigue disponible desde el <acronym xmlns="http://docbook.org/ns/docbook">SVN</acronym> de
<acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym> aquí: '>

<!ENTITY pecl.info.dead.git 'Esta extensión es considerada muerta y no mantenida. Sin embargo, el código fuente
de esta extensión sigue disponible en el <acronym xmlns="http://docbook.org/ns/docbook">GIT</acronym> de
<acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym>: '>

<!ENTITY pecl.windows.download 'No hay biblioteca <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym> para esta extensión
<acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym> actualmente disponible. Consulte la sección
<link xmlns="http://docbook.org/ns/docbook" linkend="install.windows.building">Compilación en Windows</link>
.'>

<!ENTITY pecl.windows.download.avail 'Los binarios Windows (los ficheros <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym>)
para esta extensión <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym> están disponibles en el sitio web PECL.'>

<!ENTITY pecl.moved-ver 'Esta extensión ha sido movida al módulo &link.pecl;
y no será integrada en PHP a partir de PHP '>

<!ENTITY pecl.moving.to.pie '<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  PECL está obsoleto.
  El instalador de Extensiones para PHP (PHP Installer for Extensions - <acronym>PIE</acronym>) reemplaza a PECL y es el recomendado para instalar extensiones.
  Más información en <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://github.com/php/pie">https://github.com/php/pie</link>
 </simpara>
</warning>'>

<!ENTITY warn.pecl.unmaintained '<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>Esta extensión es <emphasis>no mantenida</emphasis>.</simpara>
</warning>'>

<!-- PGSQL entities -->

<!ENTITY pgsql.parameter.connection '<simpara xmlns="http://docbook.org/ns/docbook">Una instancia <classname>PgSql\Connection</classname>.</simpara>'>

<!ENTITY pgsql.parameter.connection-with-unspecified-default '<para xmlns="http://docbook.org/ns/docbook">Una <classname>PgSql\Connection</classname> instancia.
Cuando <parameter>connection</parameter> no es especificado, se usa la conexión por
defecto. La conexión predeterminada es la última conexión hecha por <function>pg_connect</function>
o <function>pg_pconnect</function>
<warning><simpara>Desde PHP 8.1.0, usar la conexión predeterminada está obsoleto.</simpara></warning> </para>'>

<!ENTITY pgsql.parameter.connection-with-nullable-default '<para xmlns="http://docbook.org/ns/docbook"> Una instancia <classname>PgSql\Connection</classname>.
Cuando <parameter>connection</parameter> es &null;, se usa la conexión predeterminada.
La conexión predeterminada es la última conexión hecha por <function>pg_connect</function>
o <function>pg_pconnect</function>
<warning><simpara>Desde PHP 8.1.0, usar la conexión predeterminada está obsoleto.</simpara></warning> </para>'>

<!ENTITY pgsql.parameter.result '<simpara xmlns="http://docbook.org/ns/docbook"> Una instancia <classname>PgSql\Result</classname>, devuelta por <function>pg_query</function>,
<function>pg_query_params</function>, o <function>pg_execute</function> (entre otros).</simpara>'>

<!ENTITY pgsql.parameter.lob '<simpara xmlns="http://docbook.org/ns/docbook">Una instancia <classname>PgSql\Lob</classname>, devuelta por <function>pg_lo_open</function>.</simpara>'>

<!ENTITY pgsql.parameter.mode '<simpara xmlns="http://docbook.org/ns/docbook">
Un parámetro opcional que controla cómo el <type>array</type> devuelto es indexado.
<parameter>mode</parameter> es una constante que puede tomar los siguientes valores:
<constant>PGSQL_ASSOC</constant>, <constant>PGSQL_NUM</constant> y <constant>PGSQL_BOTH</constant>.
Usando <constant>PGSQL_NUM</constant>, la función devolverá un array con índices numéricos,
usando <constant>PGSQL_ASSOC</constant>, devolverá solo índices asociativos mientras
que <constant>PGSQL_BOTH</constant> devolverá ambos índices numéricos y asociativos.</simpara>'>

<!ENTITY pgsql.changelog.connection-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  El parámetro <parameter>connection</parameter> ahora espera una instancia de <classname>PgSql\Connection</classname>
  ; anteriormente, se esperaba un &resource;.
 </entry>
</row>'>

<!ENTITY pgsql.changelog.result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  El parámetro <parameter>result</parameter> ahora espera una instancia de <classname>PgSql\Result</classname>
  ; anteriormente, se esperaba un &resource;.
 </entry>
</row>'>

<!ENTITY pgsql.changelog.lob-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  El parámetro <parameter>lob</parameter> ahora espera una instancia de <classname>PgSql\Lob</classname>
  ; anteriormente, se esperaba un &resource;.
 </entry>
</row>'>

<!ENTITY pgsql.changelog.return-result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Ahora devuelve una instancia de <classname>PgSql\Result</classname> ; anteriormente,
  se devolvía un &resource;.
 </entry>
</row>'>

<!-- SNMP entities -->

<!ENTITY snmp.changelog.auth-protocol-sha2 '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  El protocolo de autenticación ahora acepta <literal>"SHA256"</literal>
  y <literal>"SHA512"</literal> cuando la biblioteca Net-SNMP lo soporta.
 </entry>
</row>'>

<!ENTITY snmp.changelog.privacy-protocol-aes '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.6.0</entry>
 <entry>
  El protocolo de privacidad ahora acepta <literal>"AES192"</literal>,
  <literal>"AES192C"</literal>, <literal>"AES256"</literal> y
  <literal>"AES256C"</literal> cuando la biblioteca Net-SNMP lo soporta.
 </entry>
</row>'>

<!ENTITY snmp.parameter.security-name '<simpara xmlns="http://docbook.org/ns/docbook">El nombre de seguridad, habitualmente algún tipo de nombre de usuario.</simpara>'>

<!ENTITY snmp.parameter.security-level '<simpara xmlns="http://docbook.org/ns/docbook">El nivel de seguridad: <literal>"noAuthNoPriv"</literal>,
<literal>"authNoPriv"</literal> o <literal>"authPriv"</literal>.</simpara>'>

<!ENTITY snmp.parameter.auth-protocol '<simpara xmlns="http://docbook.org/ns/docbook">El protocolo de autenticación: <literal>"MD5"</literal>, <literal>"SHA"</literal>,
<literal>"SHA256"</literal> o <literal>"SHA512"</literal>.</simpara>'>

<!ENTITY snmp.parameter.auth-passphrase '<simpara xmlns="http://docbook.org/ns/docbook">La frase de contraseña de autenticación.</simpara>'>

<!ENTITY snmp.parameter.privacy-protocol '<simpara xmlns="http://docbook.org/ns/docbook">El protocolo de privacidad: <literal>"DES"</literal> o <literal>"AES"</literal>,
aceptado también como <literal>"AES128"</literal>. <literal>"AES192"</literal>, <literal>"AES192C"</literal>,
<literal>"AES256"</literal> y <literal>"AES256C"</literal> se aceptan cuando la biblioteca
Net-SNMP los soporta.</simpara>'>

<!ENTITY snmp.parameter.privacy-passphrase '<simpara xmlns="http://docbook.org/ns/docbook">La frase de contraseña de privacidad.</simpara>'>

<!-- Common pieces for reference part END -->


<!ENTITY windows.builtin '<simpara xmlns="http://docbook.org/ns/docbook">La versión Windows de PHP dispone
del soporte automático de esta extensión. No es necesario añadir ninguna biblioteca
adicional para disponer de estas funciones.</simpara>'>

<!-- These are here as helpers for manual consistency and brievety-->
<!ENTITY sqlsafemode '<link xmlns="http://docbook.org/ns/docbook" linkend="ini.sql.safe-mode">safe mode SQL</link>'>

<!-- CTYPE Notes -->
<!ENTITY note.ctype.parameter.integer '<note xmlns="http://docbook.org/ns/docbook"><simpara>
Si se proporciona un <type>int</type> entre -128 y 255 inclusive, este se interpreta como el valor
ASCII de un solo carácter (a los valores negativos se les añade 256 para permitir
caracteres del rango ASCII extendido). Cualquier otro entero se interpreta como un string
que contiene los dígitos decimales del entero.</simpara></note>'>

<!ENTITY note.ctype.parameter.non-string '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
A partir de PHP 8.1.0, pasar un argumento que no sea
string está obsoleto. En el futuro, el argumento se interpretará como un string en lugar de un punto de
código ASCII. Según el comportamiento deseado, el argumento debería convertirse a &string; o se
debería realizar una llamada explícita a <function>chr</function>.</simpara></warning>'>

<!ENTITY ctype.result.empty-string 'Cuando se llama con una cadena vacía, el resultado será siempre &false;.'>

<!-- FTP Notes -->
<!ENTITY ftp.changelog.ftp-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  El parámetro <parameter>ftp</parameter> ahora espera una instancia de <classname>FTP\Connection</classname>
  ; anteriormente, se esperaba un &resource;.
 </entry>
</row>'>
<!ENTITY ftp.parameter.ftp '<simpara xmlns="http://docbook.org/ns/docbook">Una instancia de <classname>FTP\Connection</classname>.</simpara>'>

<!-- GMP Notes -->
<!ENTITY gmp.return 'Un objeto <classname xmlns="http://docbook.org/ns/docbook">GMP</classname>.'>
<!ENTITY gmp.parameter '<simpara xmlns="http://docbook.org/ns/docbook">
 Un objeto <classname>GMP</classname>, un &integer;,
 o un &string; que puede ser interpretado como un número siguiendo la misma lógica
 que si la cadena fuera usada en <function>gmp_init</function> con detección automática
 de la base (es decir cuando <parameter>base</parameter> es igual a 0).
</simpara>'>

<!-- MySQLi Notes -->
<!ENTITY mysqli.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>result</parameter></term><listitem><simpara>Solo estilo procedimental: Un objeto <classname>mysqli_result</classname>
devuelto por <function>mysqli_query</function>, <function>mysqli_store_result</function>,
<function>mysqli_use_result</function> o <function>mysqli_stmt_get_result</function>.</simpara></listitem></varlistentry>'>
<!ENTITY mysqli.link.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>mysql</parameter></term><listitem><simpara>Solo estilo procedimental: Un objeto <classname>mysqli</classname> devuelto
por <function>mysqli_connect</function> o <function>mysqli_init</function>
</simpara></listitem></varlistentry>'>
<!ENTITY mysqli.stmt.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>statement</parameter></term><listitem><simpara>Solo estilo procedimental: Un objeto <classname>mysqli_stmt</classname> devuelto
por <function>mysqli_stmt_init</function>.</simpara></listitem></varlistentry>'>
<!ENTITY mysqli.available.mysqlnd 'Disponible solo con <link xmlns="http://docbook.org/ns/docbook"
linkend="book.mysqlnd">mysqlnd</link>.'>
<!ENTITY mysqli.charset.note '<note xmlns="http://docbook.org/ns/docbook">
<simpara>MySQLnd siempre asume el juego de caracteres predeterminado del servidor. Este juego de caracteres es enviado durante el
intercambio de conexión/autenticación, el cual mysqlnd utilizará.</simpara><simpara>Libmysqlclient utiliza el juego de caracteres predeterminado establecido en el
<filename>my.cnf</filename> o mediante una llamada explícita a <function>mysqli_options</function> antes de llamar
a <function>mysqli_real_connect</function>, pero después de <function>mysqli_init</function>.</simpara></note>'>
<!ENTITY mysqli.integer.overflow.as.string.note '<note xmlns="http://docbook.org/ns/docbook">
<simpara>Si el número de filas es mayor que <constant>PHP_INT_MAX</constant>,
el número será devuelto como un &string;.</simpara></note>'>
<!ENTITY mysqli.sqlinjection.warning '<warning xmlns="http://docbook.org/ns/docbook">
<title>Advertencia de seguridad: Inyección SQL</title><simpara>Si la consulta contiene alguna entrada de variable, entonces
se deben usar <link linkend="mysqli.quickstart.prepared-statements">sentencias
preparadas parametrizadas</link> en su lugar. Alternativamente, los datos
deben estar correctamente formateados y todas las cadenas deben ser escapadas usando la
función <function>mysqli_real_escape_string</function>
.</simpara></warning>'>
<!ENTITY mysqli.conditionalexception '<simpara xmlns="http://docbook.org/ns/docbook">
Si el informe de errores de mysqli está habilitado (<constant>MYSQLI_REPORT_ERROR</constant>) y la operación solicitada falla,
se genera una advertencia. Si, además, el modo está configurado como <constant>MYSQLI_REPORT_STRICT</constant>, se
lanza una <classname>mysqli_sql_exception</classname> en su lugar.</simpara>'>

<!-- Notes for PCRE -->
<!ENTITY pcre.pattern.warning '<simpara xmlns="http://docbook.org/ns/docbook">
Si el patrón regex pasado no se compila a una regex válida, se emite una <constant>E_WARNING</constant>.
</simpara>'>

<!-- Notes for SAPI/Apache -->
<!ENTITY apache.req.module '<simpara xmlns="http://docbook.org/ns/docbook">Esta función es soportada cuando PHP
está instalado como módulo de Apache.
</simpara>'>

<!-- Notes for SAPI/FPM -->
<!ENTITY fpm.intro '<simpara xmlns="http://docbook.org/ns/docbook">FPM (FastCGI Process Manager, gestor de procesos
FastCGI) es una implementación de PHP FastCGI que contiene algunas características (principalmente) útiles para sitios con mucha carga.
</simpara>'>

<!-- SimpleXML Notes -->
<!ENTITY simplexml.iteration '<note xmlns="http://docbook.org/ns/docbook"><simpara>SimpleXML añade propiedades iterativas para casi
todos sus métodos. Estas no pueden ser vistas utilizando <function>var_dump</function>
o cualquier otra función que examine los objetos.</simpara></note>'>

<!-- SQLite Notes -->
<!-- Database Notes -->
<!ENTITY database.field-case '<note xmlns="http://docbook.org/ns/docbook"><simpara>Los nombres de los campos devueltos por esta función
son <emphasis>sensibles a la case</emphasis>.</simpara></note>'>

<!ENTITY database.fetch-null '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta función define los campos NULL
al valor PHP &null;.</simpara></note>'>

<!-- MySQL Notes -->
<!-- The mysql.*.description entities are used in the parameters refsect1 -->
<!ENTITY mysql.linkid.description '<varlistentry xmlns="http://docbook.org/ns/docbook"> <term>
<parameter>link_identifier</parameter></term><listitem><simpara> La conexión MySQL. Si no
se especifica, se utilizará la última conexión abierta con la función
<function>mysql_connect</function>. Si no se encuentra una conexión de este tipo, la
función intentará abrir una conexión, como si la función <function>mysql_connect</function> hubiera sido llamada sin
argumento. Si no se encuentra o establece una conexión, se generará una alerta de nivel
<constant>E_WARNING</constant>.</simpara></listitem>
</varlistentry>'>

<!ENTITY mysql.linkid-noreopen.description '<varlistentry
xmlns="http://docbook.org/ns/docbook"> <term>
<parameter>link_identifier</parameter></term><listitem><simpara> La conexión MySQL. Si el identificador del
enlace no se especifica, se utilizará la última conexión abierta con la función
<function>mysql_connect</function>. Si no se encuentra o establece una conexión, se generará una
alerta de nivel <constant>E_WARNING</constant>.
</simpara></listitem></varlistentry>'>

<!ENTITY mysql.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>result</parameter></term><listitem><simpara>El <type>resource</type> de
resultado que está siendo evaluado. Este resultado proviene de una llamada a
<function>mysql_query</function>.</simpara></listitem></varlistentry>'>

<!ENTITY mysql.field-offset.req.description '<varlistentry xmlns="http://docbook.org/ns/docbook"> <term>
<parameter>field_offset</parameter></term><listitem><simpara> La posición numérica del campo.
<parameter>field_offset</parameter> comienza en <literal>0</literal>. Si
<parameter>field_offset</parameter> no existe, se generará una alerta de nivel
<constant>E_WARNING</constant>.</simpara></listitem></varlistentry>'>

<!ENTITY mysql.alternative.note '<simpara xmlns="http://docbook.org/ns/docbook">Esta extensión estaba obsoleta en PHP 5.5.0, y fue eliminada en PHP 7.0.0. En su lugar, se puede
utilizar la extensión <link linkend="book.mysqli">MySQLi</link> o la extensión <link linkend="ref.pdo-mysql">PDO_MySQL</link>. Ver
también <link linkend="mysqlinfo.api.choosing">MySQL: elegir una API</link> de
la guía. Alternativas a esta función:</simpara>'>

<!ENTITY mysql.alternative.note.4-3-0 '<simpara xmlns="http://docbook.org/ns/docbook">Esta función estaba obsoleta en PHP 4.3.0, y
toda la <link linkend="book.mysql">extensión original MySQL</link> fue eliminada en PHP 7.0.0. En
su lugar, se puede utilizar la extensión <link linkend="book.mysqli">MySQLi</link> o la extensión <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Ver también <link linkend="mysqlinfo.api.choosing">MySQL: elegir una API</link> de
la guía. Alternativas a esta función:</simpara>'>

<!ENTITY mysql.alternative.note.5-3-0 '<simpara xmlns="http://docbook.org/ns/docbook">Esta función estaba obsoleta en PHP 5.3.0, y
toda la <link linkend="book.mysql">extensión original MySQL</link> fue eliminada en PHP 7.0.0. En
su lugar, se puede utilizar la extensión <link linkend="book.mysqli">MySQLi</link> o la extensión <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Ver también <link linkend="mysqlinfo.api.choosing">MySQL: elegir una API</link> de
la guía. Alternativas a esta función:</simpara>'>

<!ENTITY mysql.alternative.note.5-4-0 '<simpara xmlns="http://docbook.org/ns/docbook">Esta función estaba obsoleta en PHP 5.4.0, y
toda la <link linkend="book.mysql">extensión original MySQL</link> fue eliminada en PHP 7.0.0. En
su lugar, se puede utilizar la extensión <link linkend="book.mysqli">MySQLi</link> o la extensión <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Ver también <link linkend="mysqlinfo.api.choosing">MySQL: elegir una API</link> de
la guía. Alternativas a esta función:</simpara>'>

<!ENTITY mysql.close.connections.result.sets '<simpara xmlns="http://docbook.org/ns/docbook">
Las conexiones y los juegos de resultados abiertos de forma no persistente son automáticamente destruidos
cuando un script PHP termina su ejecución. También, el hecho de cerrar una
conexión y liberar los resultados siendo opcional, el hecho de hacerlo explícitamente es altamente
recomendado. Esto devolverá los recursos inmediatamente a PHP y a MySQL, lo que mejorará
las performance. Para más información, refiérase a la
<link linkend="language.types.resource.self-destruct">liberación de recursos</link></simpara>'>

<!-- Xattr entities -->
<!ENTITY xattr.namespace '<simpara xmlns="http://docbook.org/ns/docbook">Los atributos extendidos tienen dos espacios de nombres diferentes:
user y root. El espacio de nombres user está disponible para todos los usuarios, mientras que el espacio
de nombres root solo está disponible para usuarios con privilegios de root. xattr opera sobre el espacio
de nombres user por defecto, pero esto se puede cambiar con el parámetro
<parameter>flags</parameter>.</simpara>'>

<!-- Notes for IPv6 -->
<!ENTITY ipv6.brackets '<note xmlns="http://docbook.org/ns/docbook"><simpara>Al especificar direcciones IPv6 en formato numérico
(ej. <literal>fe80::1</literal>) se debe colocar la dirección IP entre corchetes.
Por ejemplo: <literal>tcp://[fe80::1]:80</literal>.</simpara></note>'>

<!-- Notes for tidy -->
<!ENTITY tidy.object 'El objeto <classname xmlns="http://docbook.org/ns/docbook">Tidy</classname>'>

<!-- Snippets for the installation section -->
<!ENTITY warn.install.third-party-support '<warning xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <simpara>
  Las versiones provenientes de terceros son consideradas no oficiales y
  no son directamente soportadas por el proyecto PHP. Cualquier bug encontrado debe ser reportado al proveedor
  de estas versiones no oficiales, a menos que pueda ser reproducido utilizando las versiones
  provenientes de <link xlink:href="&url.php.downloads;"> la zona de descargas
  oficial</link>.
 </simpara>
</warning>'>

<!ENTITY note.apache.slashes '<note xmlns="http://docbook.org/ns/docbook"><simpara>Recuerde que al añadir valores
que representan una ruta en la configuración de Apache bajo Windows, todos los
backslash, como <filename>c:\directorio\fichero.ext</filename>, deben ser convertidos a
slashes, como <filename>c:/directorio/fichero.ext</filename>. Un slash
final puede también ser necesario para los directorios.</simpara></note>'>

<!-- Snippets and titles for the contributors section -->
<!ENTITY Credit.Authors.and.Contributors 'Autores y Contribuyentes'>

<!ENTITY Credit.Introduction '<simpara xmlns="http://docbook.org/ns/docbook">Destacamos a las personas más activas en el
prólogo del manual pero hay muchos más contribuyentes que nos ayudan actualmente en nuestro trabajo o
que han proporcionado ayuda preciosa al proyecto en el pasado. Hay muchos desconocidos que nos han
ayudado mediante sus notas concernientes a las páginas del manual que son
continuamente incluidas en el manual, trabajo del cual estamos muy agradecidos. La lista proporcionada a continuación está
ordenada alfabéticamente.
</simpara>'>

<!ENTITY Credit.Authors.and.Editors 'Autores y Editores'>

<!ENTITY Credit.Past.Authors.Text 'Los siguientes contribuyentes
han tenido un impacto enorme al añadir contenido
al manual:'>

<!ENTITY Credit.Past.Editors.Text 'Los siguientes contribuyentes han ayudado enormemente
en la edición del manual:'>

<!ENTITY Credit.Note.Editors.Title 'Mantenimiento de las notas de usuarios'>

<!ENTITY Credit.Note.Editors.Active 'Los mantenimientos actualmente más activos son:'>

<!ENTITY Credit.Note.Editors.Inactive 'Estas personas también han desplegado enormes esfuerzos en el mantenimiento
de las notas de usuarios:'>

<!ENTITY listendand ' y'>

<!-- runkit entities -->
<!ENTITY note.runkit.selfmanipulation '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta función no puede
ser utilizada para manipular el método en curso de utilización (o encadenado).</simpara>
</note>'>

<!ENTITY note.runkit.internal-override '<note xmlns="http://docbook.org/ns/docbook"><simpara>Por defecto, solo
las funciones definidas por el usuario pueden ser eliminadas, renombradas o modificadas. Para
sobrescribir funciones internas, se debe activar la configuración
<literal>runkit.internal_override</literal> en el archivo &php.ini; del sistema entero.</simpara>
</note>'>

<!-- SSH2 Extension -->
<!ENTITY note.ssh2.subsystem.publickey '<note xmlns="http://docbook.org/ns/docbook"><simpara>El publickey subsystem es
utilizado para gestionar las claves públicas en un servidor en el cual el cliente ya está
<emphasis>identificado</emphasis>. Para identificarse a un sistema remoto utilizando la
identificación por clave pública, utilice la función
<function>ssh2_auth_pubkey_file</function> en su lugar.</simpara></note>'>

<!-- Session notes -->
<!ENTITY returns.session.storage.retval 'El valor devuelto (habitualmente &true; en caso de éxito, &false; si ocurre un error). Tenga en cuenta que este valor es devuelto internamente a PHP para análisis.'>

<!-- XMLWriter Notes -->
<!ENTITY xmlwriter.xmlwriter.description '<varlistentry xmlns="http://docbook.org/ns/docbook"> <term>
<parameter>writer</parameter></term><listitem><simpara> Únicamente para llamadas procedimentales. La
instancia <classname>XMLWriter</classname> que es modificada. Este objeto proviene de una llamada a <function>xmlwriter_open_uri</function> o <function>xmlwriter_open_memory</function>.</simpara></listitem></varlistentry>'>

<!ENTITY xmlwriter.changelog.writer-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>writer</parameter> ahora espera una instancia de <classname>XMLWriter</classname>
  anteriormente, se esperaba una <type>resource</type>.
 </entry>
</row>'>

<!-- SOAP notes -->
<!ENTITY soap.wsdl.mode.only "<note xmlns='http://docbook.org/ns/docbook'><simpara>Esta función solo está disponible en modo WSDL.</simpara></note>">

<!-- Stomp notes -->
<!ENTITY stomp.param.link "<varlistentry xmlns='http://docbook.org/ns/docbook'><term><parameter>link</parameter></term><listitem><simpara>Estilo procedimental únicamente: El identificador stomp devuelto por la función<function>stomp_connect</function>.</simpara></listitem></varlistentry>">
<!ENTITY stomp.param.headers "<varlistentry xmlns='http://docbook.org/ns/docbook'><term><parameter>headers</parameter></term><listitem><simpara>Array asociativo que contiene los encabezados adicionales (ejemplo: receipt).</simpara></listitem></varlistentry>">
<!ENTITY stomp.note.transaction "<note xmlns='http://docbook.org/ns/docbook'><simpara>Un encabezado de transacción puede ser especificado, indicando que la confirmación de los mensajes debe ser parte de la transacción.</simpara></note>">
<!ENTITY stomp.note.sync "<tip xmlns='http://docbook.org/ns/docbook'><simpara>Stomp es, por naturaleza, asíncrono. Una comunicación síncrona puede ser implementada añadiendo un encabezado receipt. Esto hará que los métodos no devuelvan nada hasta que el mensaje de confirmación no haya sido recibido o hasta que el tiempo de espera no sea alcanzado.</simpara></tip>">

<!-- SVN notes -->
<!ENTITY svn.relativepath "<note xmlns='http://docbook.org/ns/docbook'><simpara>Los caminos relativos pueden ser resueltos si el directorio de trabajo actual es uno de los que contienen el binario PHP. Para utilizar el directorio de trabajo, utilice la función <function>realpath</function>, o la instrucción dirname(__FILE__).</simpara></note>">
<!ENTITY svn.referto.status 'Refiérase a las <link xmlns="http://docbook.org/ns/docbook" linkend="svn.constants.status">constantes de estado</link> para los valores posibles.'>
<!ENTITY svn.referto.type 'Refiérase a las <link xmlns="http://docbook.org/ns/docbook" linkend="svn.constants.type">constantes de tipo</link> para los valores posibles.'>

<!-- FANN notes -->
<!ENTITY fann.ann.description '<simpara xmlns="http://docbook.org/ns/docbook">Un <type>resource</type> de red neuronal.</simpara>'>
<!ENTITY fann.train.description '<simpara xmlns="http://docbook.org/ns/docbook">Un <type>resource</type> de datos de entrenamiento de red neuronal.</simpara>'>
<!ENTITY fann.errdat.description '<simpara xmlns="http://docbook.org/ns/docbook">O bien un <type>resource</type> de red neuronal, o un <type>resource</type> de datos de entrenamiento de red neuronal.</simpara>'>
<!ENTITY fann.return.void '<simpara xmlns="http://docbook.org/ns/docbook">No devuelve ningún valor.</simpara>'>
<!ENTITY fann.return.bool '<simpara xmlns="http://docbook.org/ns/docbook">Devuelve &true; en caso de éxito, &false; de lo contrario.</simpara>'>
<!ENTITY fann.return.ann '<simpara xmlns="http://docbook.org/ns/docbook">Devuelve un <type>resource</type> de red neuronal en caso de éxito, o &false; en caso de error.</simpara>'>
<!ENTITY fann.return.train '<simpara xmlns="http://docbook.org/ns/docbook">Devuelve un <type>resource</type> de datos de entrenamiento en caso de éxito, o &false; en caso de error.</simpara>'>
<!ENTITY fann.note.function.fann-2.2 '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta función ahora está disponible si la extensión fann ha sido compilada con libfann >= 2.2.</simpara></note>'>

<!-- Imagick generic return types -->
<!ENTITY imagick.return.success 'Devuelve &true; en caso de éxito.'>
<!ENTITY imagick.imagick.throws 'Lanza una ImagickException en caso de error.'>
<!-- Imagick version infos -->
<!ENTITY imagick.method.available.0x629 'Este método solo está disponible si Imagick ha sido compilado con ImageMagick versión 6.2.9 o superior.'>
<!ENTITY imagick.method.available.0x631 'Este método solo está disponible si Imagick ha sido compilado con ImageMagick versión 6.3.1 o superior.'>
<!ENTITY imagick.method.available.0x632 'Este método solo está disponible si Imagick ha sido compilado con ImageMagick versión 6.3.2 o superior.'>
<!ENTITY imagick.method.available.0x636 'Este método solo está disponible si Imagick ha sido compilado con ImageMagick versión 6.3.6 o superior.'>
<!ENTITY imagick.method.available.0x637 'Este método solo está disponible si Imagick ha sido compilado con ImageMagick versión 6.3.7 o superior.'>
<!ENTITY imagick.method.available.0x638 'Este método solo está disponible si Imagick ha sido compilado con ImageMagick versión 6.3.8 o superior.'>
<!ENTITY imagick.method.available.0x639 'Este método solo está disponible si Imagick ha sido compilado con ImageMagick versión 6.3.9 o superior.'>
<!ENTITY imagick.method.available.0x640 'Este método solo está disponible si Imagick ha sido compilado con ImageMagick versión 6.4.0 o superior.'>
<!ENTITY imagick.method.available.0x644 'Este método solo está disponible si Imagick ha sido compilado con ImageMagick versión 6.4.4 o superior.'>
<!ENTITY imagick.method.available.0x645 'Este método solo está disponible si Imagick ha sido compilado con ImageMagick versión 6.4.5 o superior.'>
<!ENTITY imagick.method.available.0x647 'Este método solo está disponible si Imagick ha sido compilado con ImageMagick versión 6.4.7 o superior.'>
<!ENTITY imagick.method.available.0x649 'Este método solo está disponible si Imagick ha sido compilado con ImageMagick versión 6.4.9 o superior.'>
<!ENTITY imagick.method.available.0x657 'Este método solo está disponible si Imagick ha sido compilado con ImageMagick versión 6.5.7 o superior.'>

<!ENTITY imagick.method.not.available.0x700 'Este método no está disponible si Imagick ha sido compilado con ImageMagick versión 7.0.0 o superior.'>

<!ENTITY imagick.constant.available 'Esta constante solo está disponible si Imagick ha sido compilado con ImageMagick versión'>

<!ENTITY imagick.deprecated.function-3-4-4 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Esta función está <emphasis>DEPRECADA</emphasis> a partir de Imagick 3.4.4. Depender de esta funcionalidad está fuertemente desaconsejado.</simpara></warning>'><!-- Imagick default channel information -->

<!-- Imagick default channel information -->
<!ENTITY imagick.default.channel.info 'Por defecto, vale <constant xmlns="http://docbook.org/ns/docbook">Imagick::CHANNEL_DEFAULT</constant>. Consúltese la lista de <link xmlns="http://docbook.org/ns/docbook" linkend="imagick.constants.channel">constantes de canales</link>'>

<!-- Fuzz parameter -->
<!ENTITY imagick.parameter.fuzz 'La cantidad de polvo de papel. Por ejemplo, definir el polvo de papel a 10 y el color rojo a una intensidad de 100 y 102 no será interpretado como el mismo color.'>

<!-- Channel parameter -->
<!ENTITY imagick.parameter.channel 'Proporciona una constante de canal válida para su modo de canal. Para aplicarlo a más de un canal, combínense las <link xmlns="http://docbook.org/ns/docbook" linkend="imagick.constants.channel">constantes de canales</link> utilizando un operador a nivel de bits. &imagick.default.channel.info;'>

<!-- Alpha parameter -->
<!ENTITY imagick.parameter.alpha 'El grado de transparencia: 1.0 corresponde a totalmente opaco y 0.0 a totalmente transparente.'>

<!ENTITY imagick.imagickexception.throw 'Emite una excepción
<classname xmlns="http://docbook.org/ns/docbook">ImagickException</classname> en caso de fallo.'>

<!ENTITY imagick.bestfit.note '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  El comportamiento del parámetro <parameter>bestfit</parameter> cambió con Imagick 3.0.0.
  Antes de esta versión, proporcionar las dimensiones 400x400 a una imagen de dimensiones 200x150 hacía
  que la parte izquierda permaneciera sin cambios. Con Imagick 3.0.0 y posteriores, la imagen se reduce al tamaño 400x300,
  siendo este el mejor resultado para esas dimensiones. Si el parámetro <parameter>bestfit</parameter>
  es utilizado, la anchura y la altura deben ser proporcionadas.
 </simpara>
</note>'>

<!ENTITY note.openssl.cnf '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Debe existir un archivo <filename>openssl.cnf</filename> válido e instalado
  para que esta función opere correctamente. Ver
  las notas encontradas en la <link linkend="openssl.installation">sección concerniente a
  la instalación</link> para más información.
 </simpara>
</note>'>
<!ENTITY note.openssl.param-notext '<simpara xmlns="http://docbook.org/ns/docbook">
 El parámetro opcional <parameter>notext</parameter> afecta
 al nivel de verbosidad del display; si vale &false;, se añadirán información
 legible por humanos en el display. Por defecto, el parámetro
 <parameter>notext</parameter> vale &true;.
</simpara>'>

<!-- COM/Dotnet -->
<!ENTITY com.variant-arith '<note xmlns="http://docbook.org/ns/docbook">
<simpara>
 Al igual que para todas las funciones aritméticas, los parámetros para esta función
 pueden ser ya sea un tipo nativo de PHP (entero, string, float, bool o
 &null;), o una instancia de la clase COM, VARIANT o DOTNET. Los tipos nativos de PHP
 serán convertidos a VARIANT utilizando las mismas reglas que las encontradas en el constructor de
 la clase <xref linkend="class.variant"/>. Los objetos COM y
 DOTNET tendrán el valor de su propiedad predeterminada recuperado y utilizado como valor VARIANT.
</simpara>
<simpara>
 Las funciones aritméticas VARIANT están interfazadas con las funciones equivalentes
 de la biblioteca COM; para más información sobre estas funciones, consúltese
 la biblioteca MSDN. Las funciones PHP tienen nombres ligeramente diferentes: por ejemplo,
 <function>variant_add</function>, en PHP, corresponde a <literal>VarAdd()
 </literal> en la documentación MSDN.
</simpara>
</note>
'>

<!-- phar -->
<!ENTITY phar.write '<note xmlns="http://docbook.org/ns/docbook"><simpara>Este método
requiere que la variable de configuración INI <literal>phar.readonly</literal> esté definida
a <literal>0</literal> para funcionar con los objetos <classname>Phar</classname>
. De lo contrario, se lanzará una excepción <classname>PharException</classname>.</simpara></note>'>

<!ENTITY phar.note.performance '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  <function>Phar::addFile</function>, <function>Phar::addFromString</function> y <function>Phar::offsetSet</function>
  registran un nuevo archivo phar cada vez que son llamadas. Si las prestaciones son una preocupación,
  <function>Phar::buildFromDirectory</function> o <function>Phar::buildFromIterator</function>
  deberían ser utilizadas en su lugar.
 </simpara>
</note>'>

<!ENTITY phardata.note.performance '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  <function>PharData::addFile</function>, <function>PharData::addFromString</function> y <function>PharData::offsetSet</function>
  registran un nuevo archivo phar cada vez que son llamadas. Si las prestaciones son una preocupación,
  <function>PharData::buildFromDirectory</function> o <function>PharData::buildFromIterator</function>
  deberían ser utilizadas en su lugar.
 </simpara>
</note>'>

<!-- XML -->
<!ENTITY libxml.required '<simpara xmlns="http://docbook.org/ns/docbook">
 Esta extensión requiere la extensión PHP <link linkend="book.libxml">libxml</link>. Esto significa
 pasar la opción de configuración <option role="configure">--with-libxml</option>,
 o anterior a PHP 7.4 la opción de configuración <option role="configure">--enable-libxml</option>,
 aunque esto se realiza implícitamente ya que libxml
 está activado por defecto.
</simpara>'>

<!-- XMLReader -->
<!ENTITY xmlreader.libxml20620.note '<caution xmlns="http://docbook.org/ns/docbook"><simpara>Esta función solo está disponible si PHP es compilado utilizando la biblioteca libxml 20620 o posterior.</simpara></caution>'>

<!-- inotify -->
<!ENTITY inotify.instance.description 'Recurso retornado por
<function xmlns="http://docbook.org/ns/docbook">inotify_init</function>'>

<!-- User streams -->
<!ENTITY userstream.not.implemented.warning '<simpara xmlns="http://docbook.org/ns/docbook">Emite una advertencia
<constant>E_WARNING</constant> si la llamada a este método falla
(i.e. no implementado).</simpara>'>
<!ENTITY userstream.updates.context '<note xmlns="http://docbook.org/ns/docbook"><simpara>La propiedad
<varname linkend="streamwrapper.props.context">streamWrapper::$context</varname>
es actualizada si un contexto válido es pasado a la función.</simpara></note>'>

<!ENTITY stream.bucket.param '<parameter>bucket</parameter> ahora espera una instancia de <classname>StreamBucket</classname>; anteriormente, se esperaba una <classname>stdClass</classname>.'>
<!ENTITY stream.bucket.return 'Esta función ahora retorna una instancia de <classname>StreamBucket</classname>; anteriormente, se retornaba una <classname>stdClass</classname>.'>

<!-- Gmagick -->
<!ENTITY gmagick.gmagickexception.throw 'Emite una excepción
<classname xmlns="http://docbook.org/ns/docbook">GmagickException</classname> en caso de error.'>

<!-- Reflection -->
<!ENTITY reflection.export.return 'Si el parámetro <parameter xmlns="http://docbook.org/ns/docbook">return</parameter> se
establece a &true;, entonces la exportación se devuelve como un <type xmlns="http://docbook.org/ns/docbook">string</type>,
de lo contrario se devuelve &null;.'>

<!ENTITY reflection.export.param.return 'Definirlo a &true; retornará la exportación
en lugar de emitirla. Definirlo a &false; (por defecto) hará lo contrario.'>

<!ENTITY reflection.invoke.reference 'Si la función tiene argumentos que necesitan
ser referencias, entonces deben ser pasados por referencia en la lista de argumentos.'>

<!ENTITY reflection.export.param.name 'La reflexión a exportar.'>

<!ENTITY reflection.getattributes.param.name '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>name</parameter></term>
<listitem>
 <simpara>
  Filtrar los resultados para incluir únicamente las instancias de <classname>ReflectionAttribute</classname>
  para los atributos correspondientes a este nombre de clase.
 </simpara>
</listitem>
</varlistentry>'>

<!ENTITY reflection.getattributes.param.flags '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>flags</parameter></term>
<listitem>
 <simpara>
  Flags para determinar cómo filtrar los resultados, si <parameter>name</parameter>
  es proporcionado.
 </simpara>
 <simpara>
  El valor predeterminado es <literal>0</literal> que solo retornará los resultados para los atributos que
  son de la clase <parameter>name</parameter>.
 </simpara>
 <simpara>
  La única otra opción disponible es utilizar <constant>ReflectionAttribute::IS_INSTANCEOF</constant>,
  que utilizará <literal>instanceof</literal> para el filtrado.
 </simpara>
</listitem>
</varlistentry>'>

<!-- ZIP -->
<!ENTITY zip.filename.separator '<note xmlns="http://docbook.org/ns/docbook"><simpara>Para una portabilidad máxima, se recomienda siempre utilizar barras oblicuas (<literal>/</literal>) como separador de directorio en los nombres de archivos zip.</simpara></note>'>

<!-- Win32Service -->
<!ENTITY win32service.false.error ', &false; si hay un problema con los parámetros o un <link xmlns="http://docbook.org/ns/docbook" linkend="win32service.constants.errors">Código de Error Win32</link> en caso de fallo.'>
<!ENTITY win32service.noerror.false.error 'retornaba <constant xmlns="http://docbook.org/ns/docbook">WIN32_NO_ERROR</constant> en caso de éxito&win32service.false.error;'>

<!-- SNMP -->
<!ENTITY snmp.set.type.values '<simpara xmlns="http://docbook.org/ns/docbook">
 El <acronym>MIB</acronym> define el tipo de cada identificador de objeto. Debe ser especificado como un carácter simple de la lista siguiente.
</simpara>
<table xmlns="http://docbook.org/ns/docbook">
 <title>tipos</title>
 <tgroup cols="2">
  <tbody>
   <row><entry>=</entry><entry>El tipo es recuperado desde el MIB</entry></row>
   <row><entry>i</entry><entry>INTEGER</entry> </row>
   <row><entry>u</entry><entry>INTEGER</entry></row>
   <row><entry>s</entry><entry>STRING</entry></row>
   <row><entry>x</entry><entry>HEX STRING</entry></row>
   <row><entry>d</entry><entry>DECIMAL STRING</entry></row>
   <row><entry>n</entry><entry>NULLOBJ</entry></row>
   <row><entry>o</entry><entry>OBJID</entry></row>
   <row><entry>t</entry><entry>TIMETICKS</entry></row>
   <row><entry>a</entry><entry>IPADDRESS</entry></row>
   <row><entry>b</entry><entry>BITS</entry></row>
  </tbody>
 </tgroup>
</table>
<simpara xmlns="http://docbook.org/ns/docbook">
 Si la constante <constant>OPAQUE_SPECIAL_TYPES</constant> ha sido definida durante la compilación de la biblioteca <acronym>SNMP</acronym>, los caracteres siguientes también estarán disponibles:
</simpara>
<table xmlns="http://docbook.org/ns/docbook">
 <title>tipos</title>
 <tgroup cols="2">
  <tbody>
   <row><entry>U</entry><entry>int64 sin signo</entry></row>
   <row><entry>I</entry><entry>int64 con signo</entry></row>
   <row><entry>F</entry><entry>float</entry></row>
   <row><entry>D</entry><entry>double</entry></row>
  </tbody>
 </tgroup>
</table>
'>
<!ENTITY snmp.set.type.values.asn.mapping '<simpara xmlns="http://docbook.org/ns/docbook">
 La mayoría de estos valores utilizan el tipo ASN.1 correspondiente. &apos;s&apos;, &apos;x&apos;, &apos;d&apos; y &apos;b&apos; son todas formas diferentes de especificar el valor OCTET STRING y el
 tipo sin signo &apos;u&apos; también es utilizado para manejar los valores Gauge32.
</simpara>
'>
<!ENTITY snmp.set.type.values.equal.note '<simpara xmlns="http://docbook.org/ns/docbook">
 Si los ficheros MIB se cargan en el árbol MIB con "snmp_read_mib" o especificándolos en la configuración de libsnmp, se puede usar &apos;=&apos; como el
 parámetro <parameter>type</parameter> para todos los identificadores de objeto, ya que entonces el tipo se puede leer automáticamente desde el MIB.
</simpara>
'>
<!ENTITY snmp.set.type.values.bitset.note '<simpara xmlns="http://docbook.org/ns/docbook">
 Nota que hay 2 formas de definir una variable de tipo BITS como i.e. "SYNTAX
 BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https(6)}":
</simpara>
<itemizedlist xmlns="http://docbook.org/ns/docbook">
 <listitem>
  <simpara>
   Utilizando el tipo "b" y una lista de octetos. Este método no es recomendado ya que la petición GET para un mismo OID retornará i.e. 0xF8.
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Utilizando el tipo "x" y un número hexadecimal pero sin(!) el prefijo usual "0x".
  </simpara>
 </listitem>
</itemizedlist>
<simpara xmlns="http://docbook.org/ns/docbook">
 Consúltese la sección sobre ejemplos para más detalles.
</simpara>
'>
<!ENTITY snmp.methods.exceptions_enable.refsect '<refsect1 role="errors" xmlns="http://docbook.org/ns/docbook">
&reftitle.errors;
<simpara>
 Este método no lanza excepciones por defecto. Para activar
 el lanzamiento de excepciones SNMPException cuando ocurren errores de la biblioteca, el parámetro
 de la clase SNMP <parameter>exceptions_enabled</parameter>
 ebe ser definido al valor correspondiente. Ver las <link linkend="snmp.props.exceptions-enabled"> explicaciones
 sobre <parameter>SNMP::$exceptions_enabled</parameter></link> para más detalles.
</simpara>
</refsect1>
'>

<!-- Eio -->
<!ENTITY eio.callback.proto '<para xmlns="http://docbook.org/ns/docbook"> La función
de retrollamada <parameter xmlns="http://docbook.org/ns/docbook">callback</parameter> es llamada cuando la petición está terminada.
Debe corresponder al siguiente prototipo: <programlisting role="php"><![CDATA[
void callback(mixed $data, int $result[, resource $req]);
]]></programlisting>
<variablelist xmlns="http://docbook.org/ns/docbook">
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>data</parameter></term>
<listitem><simpara>representa los datos personalizados pasados a la petición.</simpara></listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>result</parameter></term>
<listitem><simpara>representa el valor resultante específico de la petición; básicamente, el valor retornado por la llamada
al sistema correspondiente.</simpara></listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>req</parameter></term>
<listitem><simpara>es el recurso opcional de la petición que puede ser utilizado con funciones como <function>eio_get_last_error</function>.</simpara></listitem>
</varlistentry>
</variablelist>
</para>
'>

<!ENTITY eio.request.pri.values '<simpara
xmlns="http://docbook.org/ns/docbook">La prioridad de la petición: <constant
xmlns="http://docbook.org/ns/docbook">EIO_PRI_DEFAULT</constant>, <constant
xmlns="http://docbook.org/ns/docbook">EIO_PRI_MIN</constant>, <constant
xmlns="http://docbook.org/ns/docbook">EIO_PRI_MAX</constant>, o &null;. Si
&null; es pasado, el parámetro <parameter
xmlns="http://docbook.org/ns/docbook">pri</parameter>, internamente, es definido a
<constant xmlns="http://docbook.org/ns/docbook">EIO_PRI_DEFAULT</constant>.
</simpara>
'>

<!ENTITY eio.warn.relpath '<warning
xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Evite las rutas
relativas.</simpara></warning>
'>

<!ENTITY trader.arg.array.of.real 'Array de valores reales.'>
<!ENTITY trader.arg.array.of.real.high 'Precio alto, array de valores reales.'>
<!ENTITY trader.arg.array.of.real.low 'Precio bajo, array de valores reales.'>
<!ENTITY trader.arg.array.of.real.close 'Precio cerrado, array de valores reales.'>
<!ENTITY trader.arg.array.of.real.open 'Precio abierto, array de valores reales.'>
<!ENTITY trader.arg.array.of.real.volume 'Volumen intercambiado, array de valores reales.'>
<!ENTITY trader.arg.array.of.real.periods 'Array de valores reales.'>
<!ENTITY trader.arg.penetration 'Porcentaje de penetración de una vela en otra vela.'>
<!ENTITY trader.arg.vfactor 'Factor de volumen. Intervalo válido: 1 a 0.'>
<!ENTITY trader.arg.time.period 'Número de período. Intervalo válido: 2 a 100000.'>
<!ENTITY trader.arg.fast.period 'Número de período para el MA rápido. Intervalo válido: 2 a 100000.'>
<!ENTITY trader.arg.slow.period 'Número de período para el MA. Intervalo válido: 2 a 100000.'>
<!ENTITY trader.arg.signal.period 'Suavizado de la línea de señal (número de período). Intervalo válido: 1 a 100000.'>
<!ENTITY trader.arg.fastk.period 'Período de tiempo para construir la línea Fast-K. Intervalo válido: 1 a 100000.'>
<!ENTITY trader.arg.fastd.period 'Suavizado para realizar la línea Fast-D. Intervalo válido: 1 a 100000, habitualmente definido a 3.'>
<!ENTITY trader.arg.slowk.period 'Suavizado para realizar la línea Slow-K. Intervalo válido: 1 a 100000, habitualmente definido a 3.'>
<!ENTITY trader.arg.slowd.period 'Suavizado para realizar la línea Slow-D. Intervalo válido: 1 a 100000.'>
<!ENTITY trader.arg.min.period 'Un valor inferior al mínimo será modificado a la período mínimo. Intervalo válido: 2 a 100000'>
<!ENTITY trader.arg.max.period 'Un valor superior al mínimo será modificado a la período máximo. Intervalo válido: 2 a 100000'>
<!ENTITY trader.arg.ma.type 'Tipo de media móvil. Una constante de la serie <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> debe ser utilizada.'>
<!ENTITY trader.arg.fast.ma.type 'Tipo de media móvil para MA rápido. Una constante de la serie <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> debe ser utilizada.'>
<!ENTITY trader.arg.slow.ma.type 'Tipo de media móvil para MA lento. Una constante de la serie <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> debe ser utilizada.'>
<!ENTITY trader.arg.fastd.ma.type 'Tipo de media móvil para Fast-D. Una constante de la serie <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> debe ser utilizada.'>
<!ENTITY trader.arg.slowd.ma.type 'Tipo de media móvil para Slow-D. Una constante de la serie <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> debe ser utilizada.'>
<!ENTITY trader.arg.slowk.ma.type 'Tipo de media móvil para Slow-K. Una constante de la serie <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> debe ser utilizada.'>
<!ENTITY trader.arg.signal.ma.type 'Tipo de media móvil para la línea de señal. Una constante de la serie <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> debe ser utilizada.'>
<!ENTITY trader.arg.nbdevup 'Multiplicador de desviación para la banda superior. Intervalo válido: <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-min">TRADER_REAL_MIN</link> a <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-max">TRADER_REAL_MAX</link>.'>
<!ENTITY trader.arg.nbdevdn 'Multiplicador de desviación para la banda inferior. Intervalo válido: <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-min">TRADER_REAL_MIN</link> a <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-max">TRADER_REAL_MAX</link>.'>
<!ENTITY trader.arg.fast.limit 'Límite superior del algoritmo adaptativo. Intervalo válido: 0.01 a 0.99.'>
<!ENTITY trader.arg.slow.limit 'Límite inferior del algoritmo adaptativo. Intervalo válido: 0.01 a 0.99.'>

<!-- mongodb -->
<!ENTITY mongodb.changelog.class-removed '
       <row xmlns="http://docbook.org/ns/docbook">
        <entry>PECL mongodb 2.0.0</entry>
        <entry>
         Esta clase ha sido eliminada.
        </entry>
       </row>
'>

<!ENTITY mongodb.changelog.function-removed '
       <row xmlns="http://docbook.org/ns/docbook">
        <entry>PECL mongodb 2.0.0</entry>
        <entry>
         Esta función ha sido eliminada.
        </entry>
       </row>
'>

<!ENTITY mongodb.changelog.method-removed '
       <row xmlns="http://docbook.org/ns/docbook">
        <entry>PECL mongodb 2.0.0</entry>
        <entry>
         Este método ha sido eliminado.
        </entry>
       </row>
'>

<!ENTITY mongodb.changelog.serializable-interface-removed '
       <row xmlns="http://docbook.org/ns/docbook">
        <entry>PECL mongodb 2.0.0</entry>
        <entry>
         <simpara>
          Esta clase ya no implementa la interfaz
          <interfacename>Serializable</interfacename>.
         </simpara>
        </entry>
       </row>
'>

<!ENTITY mongodb.changelog.tentative-return-types '
       <row xmlns="http://docbook.org/ns/docbook">
        <entry>PECL mongodb 1.15.0</entry>
        <entry>
         Los tipos de retorno de los métodos son declarados como provisionales en PHP 8.0 y posteriores, lo
         que desencadena avisos de depreciación en el código que implementa esta interfaz
         sin declarar los tipos de retorno apropiados. El atributo <code>#[ReturnTypeWillChange]</code>
         puede ser añadido para ignorar la notificación de depreciación.
        </entry>
       </row>
'>

<!ENTITY mongodb.changelog.tentative-return-types-enforced '
       <row xmlns="http://docbook.org/ns/docbook">
        <entry>PECL mongodb 2.0.0</entry>
        <entry>
         Los tipos de retorno previamente declarados como provisionales ahora son aplicados.
        </entry>
       </row>
'>

<!ENTITY mongodb.changelog.throw-unacknowledged-write '
       <row xmlns="http://docbook.org/ns/docbook">
        <entry>PECL mongodb 2.0.0</entry>
        <entry>
         <simpara>
          Este método ahora lanza una excepción cuando es llamado para una escritura no reconocida, en lugar de retornar &null;.
         </simpara>
        </entry>
       </row>
'>

<!ENTITY mongodb.option.collation '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>collation</entry>
          <entry><type class="union"><type>array</type><type>object</type></type></entry>
          <entry>
           <simpara>
            <link xlink:href="&url.mongodb.docs.collation;" xmlns:xlink="http://www.w3.org/1999/xlink">Collation</link> permite a los usuarios especificar reglas específicas del lenguaje para la comparación de cadenas, por ejemplo, reglas para mayúsculas o acentos. Al especificar una collation, el campo <literal>"locale"</literal> es obligatorio; todos los demás campos de la collation son opcionales. Para la descripción de estos campos, consúltese el <link xlink:href="&url.mongodb.docs.collation;#collation-document" xmlns:xlink="http://www.w3.org/1999/xlink">documento Collation</link>.
           </simpara>
           <simpara>
            Si la collation no es especificada pero la colección tiene una collation predeterminada, la operación utilizará la collation especificada para la colección. Si ninguna collation es especificada para la colección o para la operación, MongoDB utilizará el binario simple de comparación utilizado en versiones anteriores para las comparaciones de cadenas.
           </simpara>
           <simpara>
            Esta opción está disponible en MongoDB 3.4+ y una excepción será emitida en tiempo de ejecución si es especificada en una versión anterior.
           </simpara>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.let '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>let</entry>
          <entry><type class="union"><type>array</type><type>object</type></type></entry>
          <entry>
           <simpara>
            Diccionario de nombres y valores de parámetros. Los valores deben ser constantes o expresiones cerradas que no hagan referencia a campos del documento. Los parámetros pueden ser accedidos luego como variables en un contexto de expresión agregada (por ejemplo <literal>$$var</literal>).
           </simpara>
           <simpara>
            Esta opción está disponible en MongoDB 5.0+ y resultará en una excepción en tiempo de ejecución si es especificada para una versión anterior del servidor.
           </simpara>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.keyVaultClient '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>keyVaultClient</entry>
          <entry><classname>MongoDB\Driver\Manager</classname></entry>
          <entry>El Manager utilizado para enrutar las peticiones de claves de datos a un cluster MongoDB diferente. Por defecto, el Manager y cluster actual es utilizado.</entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.keyVaultNamespace '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>keyVaultNamespace</entry>
          <entry><type>string</type></entry>
          <entry>Un nombre de espacio completamente calificado (por ejemplo <literal>"databaseName.collectionName"</literal>) denotando la colección que contiene todas las claves de datos utilizadas para el cifrado y descifrado. Esta opción es requerida.</entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.kmsProviders '
         <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
          <entry>kmsProviders</entry>
          <entry><type>array</type></entry>
          <entry>
           <simpara>
            Un documento que contiene la configuración de uno o más proveedores KMS, que se utilizan para cifrar claves de datos. Los proveedores admitidos incluyen <literal>"aws"</literal>, <literal>"azure"</literal>, <literal>"gcp"</literal>, <literal>"kmip"</literal> y <literal>"local"</literal>, y se debe especificar al menos uno.
           </simpara>
           <simpara>
            Si se especifica un documento vacío para <literal>"aws"</literal>,
            <literal>"azure"</literal> o <literal>"gcp"</literal>, el
            controlador intentará configurar el proveedor utilizando
            <link xlink:href="&url.mongodb.specs;/blob/master/source/client-side-encryption/client-side-encryption.rst#automatic-credentials">Automatic Credentials</link>.
           </simpara>
           <simpara>
            El formato para <literal>"aws"</literal> es el siguiente:
           </simpara>
           <programlisting role="javascript">
<![CDATA[
aws: {
    accessKeyId: <string>,
    secretAccessKey: <string>,
    sessionToken: <optional string>
}
]]>
           </programlisting>
           <simpara>
            El formato para <literal>"azure"</literal> es el siguiente:
           </simpara>
           <programlisting role="javascript">
<![CDATA[
azure: {
    tenantId: <string>,
    clientId: <string>,
    clientSecret: <string>,
    identityPlatformEndpoint: <optional string> // Defaults to "login.microsoftonline.com"
}
]]>
           </programlisting>
           <simpara>
            El formato para <literal>"gcp"</literal> es el siguiente:
           </simpara>
           <programlisting role="javascript">
<![CDATA[
gcp: {
    email: <string>,
    privateKey: <base64 string>|<MongoDB\BSON\Binary>,
    endpoint: <optional string> // Defaults to "oauth2.googleapis.com"
}
]]>
           </programlisting>
           <simpara>
            El formato para <literal>"kmip"</literal> es el siguiente:
           </simpara>
           <programlisting role="javascript">
<![CDATA[
kmip: {
    endpoint: <string>
}
]]>
           </programlisting>
           <simpara>
            El formato para <literal>"local"</literal> es el siguiente:
           </simpara>
           <programlisting role="javascript">
<![CDATA[
local: {
    // 96-byte master key used to encrypt/decrypt data keys
    key: <base64 string>|<MongoDB\BSON\Binary>
}
]]>
           </programlisting>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.masterKey-options-by-provider '
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title>Opciones del proveedor <literal>"aws"</literal></title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Opción</entry>
       <entry>Tipo</entry>
       <entry>Descripción</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>region</entry>
       <entry>string</entry>
       <entry>Requis.</entry>
      </row>
      <row>
       <entry>key</entry>
       <entry>string</entry>
       <entry>Requis. El nombre de recurso Amazon (ARN) de la clave maestra del cliente AWS (CMK).</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Opcional. Un identificador de host alternativo para enviar las solicitudes KMS. Puede incluir el número de puerto.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title>Opciones del proveedor <literal>"azure"</literal></title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Opción</entry>
       <entry>Tipo</entry>
       <entry>Descripción</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>keyVaultEndpoint</entry>
       <entry>string</entry>
       <entry>Requis. Host con puerto opcional (por ejemplo, "example.vault.azure.net").</entry>
      </row>
      <row>
       <entry>keyName</entry>
       <entry>string</entry>
       <entry>Requis.</entry>
      </row>
      <row>
       <entry>keyVersion</entry>
       <entry>string</entry>
       <entry>Opcional. Una versión específica de la clave nombrada. De forma predeterminada, se utiliza la versión primaria de la clave.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title>Opciones del proveedor <literal>"gcp"</literal></title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Opción</entry>
       <entry>Tipo</entry>
       <entry>Descripción</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>projectId</entry>
       <entry>string</entry>
       <entry>Requis.</entry>
      </row>
      <row>
       <entry>location</entry>
       <entry>string</entry>
       <entry>Requis.</entry>
      </row>
      <row>
       <entry>keyRing</entry>
       <entry>string</entry>
       <entry>Requis.</entry>
      </row>
      <row>
       <entry>keyName</entry>
       <entry>string</entry>
       <entry>Requis.</entry>
      </row>
      <row>
       <entry>keyVersion</entry>
       <entry>string</entry>
       <entry>Opcional. Una versión específica de la clave nombrada. De forma predeterminada, se utiliza la versión primaria de la clave.</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Opcional. Host con puerto opcional. El valor predeterminado es "cloudkms.googleapis.com".</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title>Opciones del proveedor <literal>"kmip"</literal></title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Opción</entry>
       <entry>Tipo</entry>
       <entry>Descripción</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>keyId</entry>
       <entry>string</entry>
       <entry>Opcional. Identificador único de un objeto gestionado de 96 bytes de datos secretos KMIP. Si no se especifica, el controlador crea un objeto gestionado aleatorio de 96 bytes de datos secretos KMIP.</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Opcional. Host con puerto opcional.</entry>
      </row>
      <row>
       <entry>delegated</entry>
       <entry>bool</entry>
       <entry>Opcional. Si es true, esta clave debe ser descifrada por el servidor KMIP.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
'>
<!ENTITY mongodb.option.encryption.tlsOptions '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>tlsOptions</entry>
          <entry><type>array</type></entry>
          <entry>
           <simpara>
            Un documento que contiene la configuración TLS de uno o varios proveedores KMS. Los proveedores soportados son <literal>"aws"</literal>, <literal>"azure"</literal>, <literal>"gcp"</literal> y <literal>"kmip"</literal>. Todos los proveedores soportan las siguientes opciones:
           </simpara>
           <programlisting role="javascript">
<![CDATA[
<provider>: {
    tlsCaFile: <optional string>,
    tlsCertificateKeyFile: <optional string>,
    tlsCertificateKeyFilePassword: <optional string>,
    tlsDisableOCSPEndpointCheck: <optional bool>
}
]]>
           </programlisting>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.maxCommitTimeMS '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>maxCommitTimeMS</entry>
          <entry>integer</entry>
          <entry>
           <simpara>
            El tiempo máximo en milisegundos para permitir que una sola comando
            <literal>commitTransaction</literal> se ejecute.
           </simpara>
           <simpara>
            Si se especifica, <literal>maxCommitTimeMS</literal> debe ser un entero
            32 bits con signo superior o igual a cero.
           </simpara>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.readConcern '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>readConcern</entry>
          <entry><classname>MongoDB\Driver\ReadConcern</classname></entry>
          <entry>
           <simpara>
            Una preocupación de lectura a aplicar a la operación.
           </simpara>
           <simpara>
            Esta opción está disponible en MongoDB 3.2+ y se traducirá en una excepción en el
            momento de la ejecución si se especifica para una versión más antigua del
            servidor.
           </simpara>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.readPreference '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>readPreference</entry>
          <entry><classname>MongoDB\Driver\ReadPreference</classname></entry>
          <entry>
           <simpara>
            Una preferencia de lectura a utilizar para seleccionar un servidor para la operación.
           </simpara>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.session '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>session</entry>
          <entry><classname>MongoDB\Driver\Session</classname></entry>
          <entry>
           <simpara>
            Una sesión a asociar a la operación.
           </simpara>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.transactionReadWriteConcern '
     <warning xmlns="http://docbook.org/ns/docbook">
      <simpara>
       Si se utiliza una <literal>"session"</literal> que tiene una transacción en
       curso, no se puede especificar la opción <literal>"readConcern"</literal> o
       <literal>"writeConcern"</literal>. Intentar hacer esto lanzará una excepción
       <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>
       . En su lugar, debe definir estas opciones cuando se crea
       la transacción con
       <methodname>MongoDB\Driver\Session::startTransaction</methodname>.
      </simpara>
     </warning>
'>
<!ENTITY mongodb.option.writeConcern '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>writeConcern</entry>
          <entry><classname>MongoDB\Driver\WriteConcern</classname></entry>
          <entry>
           <simpara>
            Una preocupación de escritura a aplicar a la operación.
           </simpara>
          </entry>
         </row>
'>
<!ENTITY mongodb.parameter.namespace '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>namespace</parameter> (<type>string</type>)</term>
    <listitem>
     <simpara>
      Un espacio de nombres completamente calificado (ej. <literal>"databaseName.collectionName"</literal>)
     </simpara>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.db '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>db</parameter> (<type>string</type>)</term>
    <listitem>
     <simpara>
      El nombre de la base de datos sobre la cual se ejecutará el comando.
     </simpara>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.bulkwrite '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>bulk</parameter> (<classname>MongoDB\Driver\BulkWrite</classname>)</term>
    <listitem>
     <simpara>
      Escritura(s) a ejecutar.
     </simpara>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.bulkwritecommand '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>bulk</parameter> (<classname>MongoDB\Driver\BulkWriteCommand</classname>)</term>
    <listitem>
     <simpara>
      Escritura(s) a ejecutar.
     </simpara>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.command '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>command</parameter> (<classname>MongoDB\Driver\Command</classname>)</term>
    <listitem>
     <simpara>
      El comando a ejecutar.
     </simpara>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.encryptOpts '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>options</parameter></term>
    <listitem>
     <para>
      <table>
       <title>Opciones de cifrado</title>
       <tgroup cols="3">
        <thead>
         <row>
          <entry>Opción</entry>
          <entry>Tipo</entry>
          <entry>Descripción</entry>
         </row>
        </thead>
        <tbody>
         <row>
          <entry>algorithm</entry>
          <entry><type>string</type></entry>
          <entry>
           <simpara>
            El algoritmo de cifrado a utilizar. Esta opción es requerida. Especifique
            una de las siguientes constantes de
            <link linkend="mongodb-driver-clientencryption.constants">ClientEncryption</link>:
           </simpara>
           <simplelist>
            <member><constant>MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_DETERMINISTIC</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_RANDOM</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_UNINDEXED</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE</constant></member>
           </simplelist>
          </entry>
         </row>
         <row>
          <entry>contentionFactor</entry>
          <entry><type>int</type></entry>
          <entry>
           <simpara>
            El factor de contención para evaluar las consultas con cargas útiles cifradas
            indexadas.
           </simpara>
           <simpara>
            Esta opción se aplica únicamente y solo puede ser especificada cuando
            <literal>algorithm</literal> es
            <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant>
            o
            <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE</constant>.
           </simpara>
          </entry>
         </row>
         <row>
          <entry>keyAltName</entry>
          <entry><type>string</type></entry>
          <entry>
           <simpara>
            Identifica un documento de colección de cofre de claves por
            <literal>keyAltName</literal>. Esta opción es mutuamente exclusiva
            con <literal>keyId</literal> y una de las dos es requerida.
           </simpara>
          </entry>
         </row>
         <row>
          <entry>keyId</entry>
          <entry><classname>MongoDB\BSON\Binary</classname></entry>
          <entry>
           <simpara>
            Identifica una clave de datos por <literal>_id</literal>. El valor es un UUID
            (subtipo binario 4). Esta opción es mutuamente exclusiva con
            <literal>keyAltName</literal> y una de las dos es requerida.
           </simpara>
          </entry>
         </row>
         <row>
          <entry>queryType</entry>
          <entry><type>string</type></entry>
          <entry>
           <simpara>
            El tipo de consulta para evaluar las consultas con cargas útiles cifradas
            indexadas. Especifique una de las siguientes constantes de
            <link linkend="mongodb-driver-clientencryption.constants">ClientEncryption</link>:
           </simpara>
           <simplelist>
            <member><constant>MongoDB\Driver\ClientEncryption::QUERY_TYPE_EQUALITY</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE</constant></member>
           </simplelist>
           <simpara>
            Esta opción se aplica únicamente y solo puede ser especificada cuando
            <literal>algorithm</literal> es
            <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant>
            o <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE</constant>.
           </simpara>
          </entry>
         </row>
         <row>
          <entry>rangeOpts</entry>
          <entry><type>array</type></entry>
          <entry>
           <simpara>
            Opciones de índice para un campo de cifrado interrogeable que soporta
            consultas "range". Las opciones a continuación deben coincidir con los valores definidos en
            <literal>encryptedFields</literal> de la colección objetivo. Para los
            tipos de campo BSON double y decimal128, <literal>min</literal>,
            <literal>max</literal> y <literal>precision</literal> deben ser todos
            definidos o todos no definidos.
           </simpara>
           <para>
            <table>
             <title>Opciones de índice de rango</title>
             <tgroup cols="3">
              <thead>
               <row>
                <entry>Opción</entry>
                <entry>Tipo</entry>
                <entry>Descripción</entry>
               </row>
              </thead>
              <tbody>
               <row>
                <entry>min</entry>
                <entry><type>mixed</type></entry>
                <entry>
                 Requisito si <literal>precision</literal> está definido. El valor
                 BSON mínimo del rango.
                </entry>
               </row>
               <row>
                <entry>max</entry>
                <entry><type>mixed</type></entry>
                <entry>
                 Requisito si <literal>precision</literal> está definido. El valor
                 BSON máximo del rango.
                </entry>
               </row>
               <row>
                <entry>sparsity</entry>
                <entry><type>int</type></entry>
                <entry>Opcional. Entero positivo de 64 bits.</entry>
               </row>
               <row>
                <entry>precision</entry>
                <entry><type>int</type></entry>
                <entry>
                 Opcional. Entero positivo de 32 bits que especifica la precisión a
                 utilizar para el cifrado explícito. Solo puede ser definido para los tipos de
                 campo BSON double o decimal128.
                </entry>
               </row>
               <row>
                <entry>trimFactor</entry>
                <entry><type>int</type></entry>
                <entry>Opcional. Entero positivo de 32 bits.</entry>
               </row>
              </tbody>
             </tgroup>
            </table>
           </para>
          </entry>
         </row>
        </tbody>
       </tgroup>
      </table>
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.query '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>query</parameter> (<classname>MongoDB\Driver\Query</classname>)</term>
    <listitem>
     <simpara>
      La consulta a ejecutar.
     </simpara>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.typeMap '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>typeMap</parameter> (<type>array</type>)</term>
    <listitem>
     <simpara>
      <link linkend="mongodb.persistence.typemaps">Configuración del mapa de tipos</link>.
     </simpara>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.filter '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>filter</parameter> (<type class="union"><type>array</type><type>object</type></type>)</term>
    <listitem>
     <simpara>
      El <link xlink:href="&url.mongodb.docs;tutorial/query-documents/" xmlns:xlink="http://www.w3.org/1999/xlink">atributo de la consulta</link>.
      Un atributo vacío hará coincidir todos los documentos de la colección.
     </simpara>
     <note>
      <simpara>
       Al evaluar los criterios de consulta, MongoDB compara los tipos y los valores según sus propias <link xlink:href="&url.mongodb.docs;reference/bson-type-comparison-order/" xmlns:xlink="http://www.w3.org/1999/xlink">reglas de comparación para los tipos BSON</link>, que difieren de las reglas de <link linkend="types.comparisons">comparación</link> y de <link linkend="language.types.type-juggling">manipulación de tipos</link> de PHP. Al hacer coincidir un tipo BSON especial, los criterios de consulta deben utilizar la <link linkend="mongodb.bson">clase BSON</link> (ej.: utilizar <classname>MongoDB\BSON\ObjectId</classname> para hacer coincidir un <link xlink:href="&url.mongodb.docs.objectid;" xmlns:xlink="http://www.w3.org/1999/xlink">ObjectId</link>).
      </simpara>
     </note>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.returns.cursor '<simpara xmlns="http://docbook.org/ns/docbook">Retorna un <classname>MongoDB\Driver\Cursor</classname> en caso de éxito.</simpara>'>
<!ENTITY mongodb.returns.writeresult '<simpara xmlns="http://docbook.org/ns/docbook">Retorna un <classname>MongoDB\Driver\WriteResult</classname> en caso de éxito.</simpara>'>
<!ENTITY mongodb.returns.bulkwritecommandresult '<simpara xmlns="http://docbook.org/ns/docbook">Retorna un <classname>MongoDB\Driver\BulkWriteCommandResult</classname> en caso de éxito.</simpara>'>
<!ENTITY mongodb.throws.std '&mongodb.throws.argumentparsing;&mongodb.throws.connection;&mongodb.throws.authentication;'>
<!ENTITY mongodb.throws.session-readwriteconcern '<member xmlns="http://docbook.org/ns/docbook">Lanza una excepción <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname> si la opción <literal>"session"</literal> se utiliza con una transacción asociada en combinación con una opción <literal>"readConcern"</literal> o <literal>"writeConcern"</literal>.</member>'>
<!ENTITY mongodb.throws.session-unacknowledged '<member xmlns="http://docbook.org/ns/docbook">Lanza una excepción <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname> si la opción <literal>"session"</literal> se utiliza junto con una preocupación de escritura no reconocida.</member>'>
<!ENTITY mongodb.throws.bulkwritecommandexception '<member xmlns="http://docbook.org/ns/docbook">Lanza una excepción <classname>MongoDB\Driver\Exception\BulkWriteCommandException</classname> en caso de error de escritura (por ejemplo, fallo de comando, error de escritura o preocupación de escritura)</member>'>
<!ENTITY mongodb.throws.bulkwriteexception '<member xmlns="http://docbook.org/ns/docbook">Lanza una excepción <classname>MongoDB\Driver\Exception\BulkWriteException</classname> en caso de error de una operación de escritura (un error WriteError y WriteConcern)</member>'>
<!ENTITY mongodb.throws.argumentparsing '<member xmlns="http://docbook.org/ns/docbook">Lanza una excepción <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname> en caso de error durante el análisis de un argumento.</member>'>
<!ENTITY mongodb.throws.authentication '<member xmlns="http://docbook.org/ns/docbook">Lanza una excepción <classname>MongoDB\Driver\Exception\AuthenticationException</classname> si se requiere una identificación pero falla</member>'>
<!ENTITY mongodb.throws.connection '<member xmlns="http://docbook.org/ns/docbook">Lanza una excepción <classname>MongoDB\Driver\Exception\ConnectionException</classname> si la conexión al servidor falla por una razón distinta a un problema de identificación</member>'>
<!ENTITY mongodb.throws.bson.unexpected '<member xmlns="http://docbook.org/ns/docbook">Lanza una excepción <classname>MongoDB\Driver\Exception\UnexpectedValueException</classname> si la entrada no contiene exactamente un documento BSON. Las razones posibles incluyen, pero no se limitan a, BSON inválido, datos adicionales (después de leer un documento BSON), o un error inesperado de <link xlink:href="&url.mongodb.libbson;" xmlns:xlink="http://www.w3.org/1999/xlink">libbson</link>.</member>'>
<!ENTITY mongodb.throws.unacknowledged '<member xmlns="http://docbook.org/ns/docbook">Levanta una excepción <classname>MongoDB\Driver\Exception\LogicException</classname>si la escritura no ha sido reconocida.</member>'>

<!-- Not used in EN anymore -->
<!ENTITY mongodb.note.decimal128 '
   <note xmlns="http://docbook.org/ns/docbook">
    <simpara>
     <classname>MongoDB\BSON\Decimal128</classname> solo es compatible con
     MongoDB 3.4+. Si se intenta utilizar el tipo BSON con una versión antigua
     de MongoDB, se emitirá un error.
    </simpara>
   </note>
'>
<!ENTITY mongodb.note.extended-json '
  <note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <simpara>
    La salida es coherente con la función <function>MongoDB\BSON\toJSON</function>
    , que utiliza el formato JSON extendido específico del controlador. Esto no corresponde
    necesariamente a las representaciones JSON extendidas
    <link xlink:href="&url.mongodb.specs.extendedjson;#relaxed-extended-json-example">relajadas</link>
    o <link xlink:href="&url.mongodb.specs.extendedjson;#canonical-extended-json-example">canónicas</link>
    utilizadas por
    <function>MongoDB\BSON\toRelaxedExtendedJSON</function> y
    <function>MongoDB\BSON\toCanonicalExtendedJSON</function>, respectivamente.
   </simpara>
  </note>
'>
<!ENTITY mongodb.note.forking '
   <note xmlns="http://docbook.org/ns/docbook">
    <simpara>
     En las plataformas Unix, la extensión MongoDB es sensible a los scripts que
     utilizan la llamada al sistema fork() sin llamar a exec(). No se deben reutilizar
     instancias <classname>MongoDB\Driver\Manager</classname> en un proceso hijo derivado
     de un fork.
    </simpara>
   </note>
'>

<!ENTITY mongodb.note.uint32 '
  <note xmlns="http://docbook.org/ns/docbook">
   <simpara>
    Dado que el tipo integer de PHP es con signo, algunos de los valores devueltos por
    este método pueden aparecer como enteros negativos en plataformas de 32 bits. El formateador
    <literal>"&#37;u"</literal> de <function>sprintf</function> se puede
    utilizar para obtener una representación en forma de string del valor decimal sin signo.
   </simpara>
  </note>
'>

<!ENTITY mongodb.note.server.readpreference '
  <note xmlns="http://docbook.org/ns/docbook">
   <simpara>
    La opción <literal>"readPreference"</literal> no controla el servidor hacia el
    cual el controlador emite la operación; siempre se ejecutará en este objeto servidor. En su
    lugar, puede ser utilizado al emitir la operación a un secundario (desde una conexión de
    conjunto de réplicas, no autónoma) o el nodo Mongos para asegurarse de que
    el controlador defina el protocolo de fila en consecuencia o añada la preferencia de
    lectura a la operación, respectivamente.
   </simpara>
  </note>
'>

<!ENTITY mongodb.note.server.write '
  <note xmlns="http://docbook.org/ns/docbook">
   <simpara>
    Es responsabilidad del llamante asegurarse de que el servidor sea capaz de ejecutar la
    operación de escritura. Por ejemplo, la ejecución de una operación de escritura
    en un secundario (excluyendo su base de datos "local") fallará.
   </simpara>
  </note>
'>

<!ENTITY mongodb.warning.duplicate-keys '
   <warning xmlns="http://docbook.org/ns/docbook">
    <simpara>
     Los documentos BSON pueden contener técnicamente claves duplicadas ya que los documentos
     se almacenan como una lista de pares clave-valor; sin embargo, las aplicaciones deben abstenerse
     de generar documentos con claves duplicadas ya que el comportamiento del servidor y
     del controlador puede ser indefinido. Dado que los objetos y arrays de PHP no pueden
     tener claves duplicadas, los datos también podrían perderse al decodificar un documento BSON con claves duplicadas.
    </simpara>
   </warning>
'>

<!-- Radius -->
<!ENTITY radius.request.required '<note xmlns="http://docbook.org/ns/docbook"><simpara>Una petición debe ser creada mediante la función <function>radius_create_request</function> antes de que esta función pueda ser llamada.</simpara></note>'>
<!ENTITY radius.parameter.attribute-type '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>type</parameter></term><listitem><simpara>El tipo de atributo.</simpara></listitem></varlistentry>'>
<!ENTITY radius.parameter.handle '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>radius_handle</parameter></term><listitem><simpara>El recurso RADIUS.</simpara></listitem></varlistentry>'>
<!ENTITY radius.parameter.options '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>options</parameter></term><listitem><simpara>Una máscara de opciones de atributo. Las opciones disponibles incluyen <link linkend="constant.radius-option-tagged"><constant>RADIUS_OPTION_TAGGED</constant></link> y <link linkend="constant.radius-option-salt"><constant>RADIUS_OPTION_SALT</constant></link>.</simpara></listitem></varlistentry>'>
<!ENTITY radius.parameter.tag '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>tag</parameter></term><listitem><simpara>La etiqueta del atributo. Este parámetro es ignorado mientras que la opción <link linkend="constant.radius-option-tagged"><constant>RADIUS_OPTION_TAGGED</constant></link> esté definida.</simpara></listitem></varlistentry>'>
<!ENTITY radius.parameter.vendor '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>vendor</parameter></term><listitem><simpara>El identificador del proveedor.</simpara></listitem></varlistentry>'>

<!-- posix snippets -->
<!ENTITY posix.parameter.fd '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>file_descriptor</parameter></term>
 <listitem>
  <simpara>
   El descriptor de fichero, el cual se espera que sea un
   <type>resource</type> de fichero o un <type>int</type>. Se asumirá que un <type>int</type>
   es un descriptor de fichero que puede ser pasado directamente a la
   llamada al sistema subyacente.
  </simpara>
 </listitem>
</varlistentry>'>

<!ENTITY posix.rlimits '
<simpara xmlns="http://docbook.org/ns/docbook">
  Cada recurso tiene un límite soft y hard asociados. El límite soft
  corresponde al valor que el núcleo fuerza para el recurso correspondiente.
  El límite hard actúa como un techo del límite soft. Un proceso no
  privilegiado solo puede definir su límite soft en un valor comprendido entre
  0 y el límite hard, lo que solo hará bajar su límite hard.
</simpara>
'>

<!-- strings snippets -->
<!ENTITY strings.stripped.characters '
 <itemizedlist xmlns="http://docbook.org/ns/docbook">
    <listitem>
     <simpara>
      <literal>" "</literal>: carácter <acronym>SP</acronym> en <acronym>ASCII</acronym>
      <literal>0x20</literal>, un espacio ordinario.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\t"</literal>: carácter <acronym>HT</acronym> en <acronym>ASCII</acronym>
      <literal>0x09</literal>, una tabulación.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\n"</literal>: carácter <acronym>LF</acronym> en <acronym>ASCII</acronym>
      <literal>0x0A</literal>, un salto de línea (line feed).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\r"</literal>: carácter <acronym>CR</acronym> en <acronym>ASCII</acronym>
      <literal>0x0D</literal>, un retorno de carro.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\0"</literal>: carácter <acronym>NUL</acronym> en <acronym>ASCII</acronym>
      <literal>0x00</literal>, el octeto NUL.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\v"</literal>: carácter <acronym>VT</acronym> en <acronym>ASCII</acronym>
      <literal>0x0B</literal>, una tabulación vertical.
     </simpara>
    </listitem>
   </itemizedlist>
'>

<!ENTITY strings.stripped.unicode '
 <itemizedlist xmlns="http://docbook.org/ns/docbook">
    <listitem>
     <simpara>
      <literal>" "</literal> (<acronym>Unicode</acronym> U+0020), un espacio ordinario.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\t"</literal> (<acronym>Unicode</acronym> U+0009), una tabulación.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\n"</literal> (<acronym>Unicode</acronym> U+000A), un salto de línea.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\r"</literal> (<acronym>Unicode</acronym> U+000D), un retorno de carro.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\0"</literal> (<acronym>Unicode</acronym> U+0000), el octeto NUL.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\v"</literal> (<acronym>Unicode</acronym> U+000B), una tabulación vertical.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\f"</literal> (<acronym>Unicode</acronym> U+000C), un avance de página.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u00A0"</literal> (<acronym>Unicode</acronym> U+00A0), un ESPACIO INSÉCABLE.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u1680"</literal> (<acronym>Unicode</acronym> U+1680), una MARCA DE ESPACIO OGHAM.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2000"</literal> (<acronym>Unicode</acronym> U+2000), un CUADRADO MEDIO.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2001"</literal> (<acronym>Unicode</acronym> U+2001), un CUADRADO.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2002"</literal> (<acronym>Unicode</acronym> U+2002), un ESPACIO MEDIO.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2003"</literal> (<acronym>Unicode</acronym> U+2003), un ESPACIO CUADRADO.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2004"</literal> (<acronym>Unicode</acronym> U+2004), un ESPACIO DE UN-TERCIO-DE-CUADRADO.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2005"</literal> (<acronym>Unicode</acronym> U+2005), un ESPACIO DE UN-CUARTO-DE-CUADRADO.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2006"</literal> (<acronym>Unicode</acronym> U+2006), un ESPACIO DE UN-SEXTO-DE-CUADRADO.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u2007"</literal> (<acronym>Unicode</acronym> U+2007), un ESPACIO PARA DÍGITOS.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u2008"</literal> (<acronym>Unicode</acronym> U+2008), un ESPACIO DE PUNTUACIÓN.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u2009"</literal> (<acronym>Unicode</acronym> U+2009), un ESPACIO FINO.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u200A"</literal> (<acronym>Unicode</acronym> U+200A), un ESPACIO PELUDO.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u2028"</literal> (<acronym>Unicode</acronym> U+2028), un SEPARADOR DE LÍNEA.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u2029"</literal> (<acronym>Unicode</acronym> U+2029), un SEPARADOR DE PÁRRAFO.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u202F"</literal> (<acronym>Unicode</acronym> U+202F), un ESPACIO INSÉCABLE ESTRECHO.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u205F"</literal> (<acronym>Unicode</acronym> U+205F), un ESPACIO MATEMÁTICO MEDIO.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u3000"</literal> (<acronym>Unicode</acronym> U+3000), un ESPACIO IDEOGRÁFICO.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u0085"</literal> (<acronym>Unicode</acronym> U+0085), una LÍNEA SIGUIENTE (NEL).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u180E"</literal> (<acronym>Unicode</acronym> U+180E), un SEPARADOR DE VOCALES MONGOL.
     </simpara>
    </listitem>
   </itemizedlist>
'>

<!ENTITY strings.parameter.characters.optional '
 <simpara xmlns="http://docbook.org/ns/docbook">
  Opcionalmente, los caracteres a eliminar también pueden ser especificados utilizando el
  parámetro <parameter>characters</parameter>.
  Basta con listar todos los caracteres que deben ser eliminados.
  Con <literal>..</literal>, es posible especificar un rango creciente de caracteres.
 </simpara>
'>

<!ENTITY strings.parameter.unicode.optional '
 <simpara xmlns="http://docbook.org/ns/docbook">
  Opcionalmente, los caracteres a eliminar también pueden ser especificados utilizando el
  parámetro <parameter>characters</parameter>.
  Basta con listar todos los caracteres a eliminar.
 </simpara>
'>

<!ENTITY strings.parameter.encoding '
 <simpara xmlns="http://docbook.org/ns/docbook">
  Un argumento opcional que define el codificado utilizado durante la conversión de caracteres.
 </simpara>

 <simpara xmlns="http://docbook.org/ns/docbook">
  Si se omite, el valor predeterminado del parámetro <parameter>encoding</parameter> es el valor de la opción de configuración
  <link linkend="ini.default-charset">default_charset</link>
  .
 </simpara>

 <simpara xmlns="http://docbook.org/ns/docbook">
  Aunque este argumento es técnicamente opcional, se recomienda encarecidamente especificar el valor
  correcto para su código si la opción
  de configuración <link linkend="ini.default-charset">default_charset</link>
  ha sido definida incorrectamente para la entrada proporcionada.
 </simpara>
'>

<!ENTITY strings.parameter.format '
<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>format</parameter></term>
 <listitem>
  <simpara>
   La cadena de formato está compuesta por cero o más directivas:
   caracteres ordinarios (excepto <literal>&#37;</literal>) que se
   copian directamente al resultado y <emphasis>especificaciones de
   conversión</emphasis>, cada una con su propio
   parámetro.
  </simpara>

  <simpara>
   Una especificación de conversión que sigue este prototipo:
   <literal>&#37;[argnum$][flags][width][.precision]specifier</literal>.
  </simpara>

  <formalpara>
   <title>Argnum</title>
   <para>
    Un &integer; seguido de un signo dólar <literal>$</literal>,
    para especificar qué número de argumento tratar en la conversión.
   </para>
  </formalpara>

  <formalpara>
   <title>Banderas</title>
   <para>
    <informaltable>
     <tgroup cols="2">
      <thead>
       <row>
        <entry>Bandera</entry>
        <entry>&Description;</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry><literal>-</literal></entry>
        <entry>
         Justifica el texto a la izquierda dado el ancho del campo;
         la justificación a la derecha es el comportamiento predeterminado.
        </entry>
       </row>
       <row>
        <entry><literal>+</literal></entry>
        <entry>
         Prefija los números positivos con un signo más
         <literal>+</literal>; por defecto solo los
         números negativos son prefijados con un signo negativo.
        </entry>
       </row>
       <row>
        <entry><literal> </literal>(espacio)</entry>
        <entry>
         Rellena el resultado con espacios.
         Esto es por defecto.
        </entry>
       </row>
       <row>
        <entry><literal>0</literal></entry>
        <entry>
         Rellena solo los números a la izquierda con ceros. Con
         el especificador <literal>s</literal> esto también puede rellenar
         a la derecha con ceros.
        </entry>
       </row>
       <row>
        <entry><literal>&apos;</literal>(char)</entry>
        <entry>
         Rellena el resultado con el carácter (char).
        </entry>
       </row>
      </tbody>
     </tgroup>
    </informaltable>
   </para>
  </formalpara>

  <formalpara>
   <title>Ancho</title>
   <para>
    Sea un entero indicando el número de caracteres (mínimo)
    que esta conversión debe producir, o <literal>*</literal>.
    Si <literal>*</literal> es utilizado, entonces el ancho es proporcionado
    como un valor entero adicional precediendo al que se formatea
    por el especificador.
   </para>
  </formalpara>

  <formalpara>
   <title>Precisión</title>
   <para>
    Un punto <literal>.</literal> seguido opcionalmente sea
    de un entero, o de <literal>*</literal>,
    cuya significación depende del especificador:
    <itemizedlist>
     <listitem>
      <simpara>
       Para los especificadores <literal>e</literal>, <literal>E</literal>,
       <literal>f</literal> y <literal>F</literal>
       : esto es el número de dígitos a mostrar
       después de la coma (por defecto, esto es 6).
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Para los especificadores <literal>g</literal>, <literal>G</literal>,
       <literal>h</literal> y <literal>H</literal>
       : esto es el número máximo de
       dígitos significativos a mostrar.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Para el especificador <literal>s</literal>: actúa como un punto de corte,
       definiendo un límite máximo de caracteres de la cadena.
      </simpara>
     </listitem>
    </itemizedlist>
    <note>
     <simpara>
      Si el punto es especificado sin un valor explícito para la precisión,
      0 es asumido. Si <literal>*</literal> es utilizado, la precisión es
      proporcionada como un valor entero adicional precediendo al que se formatea
      por el especificador.
     </simpara>
    </note>
   </para>
  </formalpara>

  <para>
   <table>
    <title>Especificadores</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Especificador</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>&#37;</literal></entry>
       <entry>
        Un carácter de porcentaje literal. No se necesita ningún argumento.
       </entry>
      </row>
      <row>
       <entry><literal>b</literal></entry>
       <entry>
        El argumento es tratado como un entero y presentado
        como un número binario.
       </entry>
      </row>
      <row>
       <entry><literal>c</literal></entry>
       <entry>
        El argumento es tratado como un entero y presentado como
        el carácter de código ASCII correspondiente.
       </entry>
      </row>
      <row>
       <entry><literal>d</literal></entry>
       <entry>
        El argumento es tratado como un entero y presentado como
        un número entero decimal (firmado).
       </entry>
      </row>
      <row>
       <entry><literal>e</literal></entry>
       <entry>
        El argumento es tratado como una notación científica (ej. 1.2e+2).
       </entry>
      </row>
      <row>
       <entry><literal>E</literal></entry>
       <entry>
        Como el especificador <literal>e</literal> pero utiliza una
        letra mayúscula (por ejemplo 1.2E+2).
       </entry>
      </row>
      <row>
       <entry><literal>f</literal></entry>
       <entry>
        El argumento es tratado como un número de coma flotante (tipo &float;) y presentado como un
        número de coma flotante (teniendo en cuenta la configuración local).
       </entry>
      </row>
      <row>
       <entry><literal>F</literal></entry>
       <entry>
        El argumento es tratado como un número de coma flotante (tipo &float;) y presentado como un
        número de coma flotante (sin tener en cuenta la configuración local).
       </entry>
      </row>
      <row>
       <entry><literal>g</literal></entry>
       <entry>
        <simpara>
         Formato general.
        </simpara>
        <simpara>
         Sea P igual a la precisión si diferente de 0, 6 si la precisión
         es omitida o 1 si la precisión
         es cero. Entonces, si la conversión con el estilo E tuviera como exponente X:
        </simpara>
        <simpara>
         Si P > X ≥ −4, la conversión es con estilo f y precisión P − (X + 1). De lo
         contrario, la conversión es con el estilo e y precisión P - 1.
        </simpara>
       </entry>
      </row>
      <row>
       <entry><literal>G</literal></entry>
       <entry>
        Como el especificador <literal>g</literal> pero utiliza
        <literal>E</literal> y <literal>f</literal>.
       </entry>
      </row>
      <row>
       <entry><literal>h</literal></entry>
       <entry>
        Como el especificador <literal>g</literal> pero utiliza <literal>F</literal>.
        Disponible a partir de PHP 8.0.0.
       </entry>
      </row>
      <row>
       <entry><literal>H</literal></entry>
       <entry>
        Como el especificador <literal>g</literal> pero utiliza
        <literal>E</literal> y <literal>F</literal>. Disponible a partir de PHP 8.0.0.
       </entry>
      </row>
      <row>
       <entry><literal>o</literal></entry>
       <entry>
        El argumento es tratado como un entero y presentado
        como un número octal.
       </entry>
      </row>
      <row>
       <entry><literal>s</literal></entry>
       <entry>
        El argumento es tratado y presentado como una cadena de caracteres.
       </entry>
      </row>
      <row>
       <entry><literal>u</literal></entry>
       <entry>
        El argumento es tratado como un entero y presentado como
        un número decimal no firmado.
       </entry>
      </row>
      <row>
       <entry><literal>x</literal></entry>
       <entry>
        El argumento es tratado como un entero y presentado como
        un número hexadecimal (las letras en minúsculas).
       </entry>
      </row>
      <row>
       <entry><literal>X</literal></entry>
       <entry>
        El argumento es tratado como un entero y presentado como
        un número hexadecimal (las letras en mayúsculas).
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>

  <warning>
   <simpara>
    El especificador de tipo <literal>c</literal> ignora el alineamiento y el tamaño.
   </simpara>
  </warning>

  <warning>
   <simpara>
    Intentar utilizar una combinación de una cadena y especificadores con juegos de caracteres que necesitan más de un octeto por carácter dará un resultado inesperado.
   </simpara>
  </warning>

  <para>
   Las variables serán forzadas a un tipo apropiado para el especificador:
   <table>
    <title>Manejo de tipos</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Tipo</entry>
       <entry>Especificadores</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><type>string</type></entry>
       <entry><literal>s</literal></entry>
      </row>
      <row>
       <entry><type>int</type></entry>
       <entry>
        <literal>d</literal>,
        <literal>u</literal>,
        <literal>c</literal>,
        <literal>o</literal>,
        <literal>x</literal>,
        <literal>X</literal>,
        <literal>b</literal>
       </entry>
      </row>
      <row>
       <entry><type>float</type></entry>
       <entry>
        <literal>e</literal>,
        <literal>E</literal>,
        <literal>f</literal>,
        <literal>F</literal>,
        <literal>g</literal>,
        <literal>G</literal>,
        <literal>h</literal>,
        <literal>H</literal>
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
 </listitem>
</varlistentry>
'>

<!ENTITY strings.scanf.parameter.format '
<varlistentry xmlns="http://docbook.org/ns/docbook">
     <term><parameter>format</parameter></term>
     <listitem>
      <para>
       El formato interpretado para <parameter>string</parameter> se describe en
       la documentación de la <function>sprintf</function> con
       las siguientes diferencias:
       <simplelist>
        <member>
         La función no tiene en cuenta el contexto local.
        </member>
        <member>
         <literal>F</literal>, <literal>g</literal>, <literal>G</literal> y
         <literal>b</literal> no son soportados.
        </member>
        <member>
         <literal>D</literal> representa un número decimal.
        </member>
        <member>
         <literal>i</literal> representa un número entero con detección de base.
        </member>
        <member>
         <literal>n</literal> representa el número de caracteres tratados hasta este punto.
        </member>
        <member>
         <literal>s</literal> detiene la lectura en cada carácter de espacio.
        </member>
        <member>
         <literal>*</literal> en lugar de <literal>argnum$</literal> elimina
         la asignación de esta especificación de conversión.
        </member>
       </simplelist>
      </para>
     </listitem>
    </varlistentry>
'>

<!ENTITY strings.parameter.needle.non-string '
 <simpara xmlns="http://docbook.org/ns/docbook">
  Anterior a PHP 8.0.0, si <parameter>needle</parameter> no es una cadena de caracteres, se
  convierte en un entero y se aplica como valor ordinal de un
  carácter. Este comportamiento está obsoleto a partir de PHP 7.3.0, y confiar en él
  está fuertemente desaconsejado. Dependiendo del comportamiento esperado,
  <parameter>needle</parameter> debe ser explícitamente convertido a una cadena de caracteres,
  o debe realizarse una llamada explícita a <function>chr</function>.
 </simpara>
'>

<!ENTITY strings.changelog.needle-empty '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>needle</parameter> acepta ahora una cadena vacía.
 </entry>
</row>'>

<!ENTITY strings.changelog.ascii-case-conversion '
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>8.2.0</entry>
  <entry>
   La conversión de la casilla ya no depende de la configuración local definida con
   <function>setlocale</function>. Solo se convertirán los caracteres ASCII.
  </entry>
 </row>
'>

<!ENTITY strings.changelog.ascii-case-folding '
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>8.2.0</entry>
  <entry>
   El case folding ya no depende de la configuración local definida con
   <function>setlocale</function>. Solo se realizará el case folding ASCII.
   Los octetos no-ASCII serán comparados por su valor de octeto.
  </entry>
 </row>
'>

<!ENTITY strings.changelog.sprintf '
  <informaltable xmlns="http://docbook.org/ns/docbook">
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Esta función ya no devuelve &false; en caso de fallo.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Lanza una <classname>ValueError</classname> si el número de argumentos es cero;
       anteriormente, esta función emitía un <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Lanza una <classname>ValueError</classname> si <literal>[width]</literal> es inferior a cero o superior a <constant>PHP_INT_MAX</constant>;
       anteriormente, esta función emitía un <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Lanza una <classname>ValueError</classname> si <literal>[precision]</literal> es inferior a cero o superior a <constant>PHP_INT_MAX</constant>;
       anteriormente, esta función emitía un <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Lanza una <classname>ArgumentCountError</classname> cuando se proporcionan menos argumentos de los requeridos;
       anteriormente, esta función emitía un <constant>E_WARNING</constant>.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
'>

<!ENTITY strings.changelog.vsprintf '
  <informaltable xmlns="http://docbook.org/ns/docbook">
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Esta función ya no devuelve &false; en caso de fallo.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Lanza una <classname>ValueError</classname> si el número de argumentos es cero;
       anteriormente, esta función emitía un <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Lanza una <classname>ValueError</classname> si <literal>[width]</literal> es inferior a cero o superior a <constant>PHP_INT_MAX</constant>;
       anteriormente, esta función emitía un <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Lanza una <classname>ValueError</classname> si <literal>[precision]</literal> es inferior a cero o superior a <constant>PHP_INT_MAX</constant>;
       anteriormente, esta función emitía un <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Lanza una <classname>ValueError</classname> cuando se proporcionan menos argumentos de los requeridos;
       anteriormente, esta función emitía un <constant>E_WARNING</constant>.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
'>

<!ENTITY strings.errors.sprintf '
  <simpara xmlns="http://docbook.org/ns/docbook">
   A partir de PHP 8.0.0, se lanza una <classname>ValueError</classname> si el número de argumentos es nulo. Anterior a
   PHP 8.0.0, se emitía un <constant>E_WARNING</constant> en su lugar.
  </simpara>
  <simpara xmlns="http://docbook.org/ns/docbook">
   A partir de PHP 8.0.0, se lanza una <classname>ValueError</classname> si <literal>[width]</literal> es inferior a cero o superior a <constant>PHP_INT_MAX</constant>.
   Anterior a PHP 8.0.0, se emitía un <constant>E_WARNING</constant> en su lugar.
  </simpara>
  <simpara xmlns="http://docbook.org/ns/docbook">
   A partir de PHP 8.0.0, se lanza una <classname>ValueError</classname> si <literal>[precision]</literal> es inferior a cero o superior a <constant>PHP_INT_MAX</constant>.
   Anterior a PHP 8.0.0, se emitía un <constant>E_WARNING</constant> en su lugar.
  </simpara>
  <simpara xmlns="http://docbook.org/ns/docbook">
   A partir de PHP 8.0.0, se lanza una <classname>ArgumentCountError</classname> cuando se proporcionan menos argumentos de los requeridos. Anterior a
   PHP 8.0.0, se devolvía &false; y se emitía un <constant>E_WARNING</constant> en su lugar.
  </simpara>
'>

<!ENTITY strings.errors.vsprintf '
  <simpara xmlns="http://docbook.org/ns/docbook">
   A partir de PHP 8.0.0, se lanza un <classname>ValueError</classname> si el número de argumentos es cero. Anterior a
   PHP 8.0.0, se emitía un <constant>E_WARNING</constant> en su lugar.
  </simpara>
  <simpara xmlns="http://docbook.org/ns/docbook">
   A partir de PHP 8.0.0, se lanza un <classname>ValueError</classname> si <literal>[width]</literal> es menor que cero o mayor que <constant>PHP_INT_MAX</constant>.
   Anterior a PHP 8.0.0, se emitía un <constant>E_WARNING</constant> en su lugar.
  </simpara>
  <simpara xmlns="http://docbook.org/ns/docbook">
   A partir de PHP 8.0.0, se lanza un <classname>ValueError</classname> si <literal>[precision]</literal> es menor que cero o mayor que <constant>PHP_INT_MAX</constant>.
   Anterior a PHP 8.0.0, se emitía un <constant>E_WARNING</constant> en su lugar.
  </simpara>
  <simpara xmlns="http://docbook.org/ns/docbook">
   A partir de PHP 8.0.0, se lanza un <classname>ValueError</classname> cuando se proporcionan menos argumentos de los requeridos. Anterior a
   PHP 8.0.0, se devolvía &false; y se emitía un <constant>E_WARNING</constant> en su lugar.
  </simpara>
'>

<!ENTITY strings.comparison.return '
  <simpara xmlns="http://docbook.org/ns/docbook">
   Devuelve un valor inferior a 0 si <parameter>string1</parameter>
   es inferior a <parameter>string2</parameter>; un valor superior
   a 0 si <parameter>string1</parameter> es superior a
   <parameter>string2</parameter>, y <literal>0</literal> si son
   iguales. No
   se puede deducir ningún significado particular de este valor,
   excepto su signo.
  </simpara>
'>

<!-- filter snippets -->
<!-- TODO: Remove -->
<!-- csprng snippets -->
<!ENTITY csprng.sources '
<simpara xmlns="http://docbook.org/ns/docbook">
 Las fuentes de aleatoriedad por orden de prioridad son las siguientes:
</simpara>
<itemizedlist xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <listitem>
  <simpara>
   Linux: <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   FreeBSD >= 12 (PHP >= 7.3): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Windows (PHP >= 7.2): <link xlink:href="&url.csprng.cng-api;">CNG-API</link>
  </simpara>
  <simpara>
   Windows: <link xlink:href="&url.csprng.crypt-gen-random;">CryptGenRandom</link>
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   macOS (PHP >= 8.2; >= 8.1.9; >= 8.0.22 si CCRandomGenerateBytes está disponible en el momento de la compilación): CCRandomGenerateBytes()
  </simpara>
  <simpara>
   macOS (PHP >= 8.1; >= 8.0.2): arc4random_buf(), <filename>/dev/urandom</filename>
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   NetBSD >= 7 (PHP >= 7.1; >= 7.0.1): arc4random_buf(), <filename>/dev/urandom</filename>
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   OpenBSD >= 5.5 (PHP >= 7.1; >= 7.0.1): arc4random_buf(), <filename>/dev/urandom</filename>
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   DragonflyBSD (PHP >= 8.1): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Solaris (PHP >= 8.1): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Cualquier combinación de un sistema operativo y una versión de PHP no mencionada anteriormente: <filename>/dev/urandom</filename>.
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Si ninguna de las fuentes de aleatoriedad está disponible o todas fallan al generar aleatoriedad, se lanzará
   una excepción de tipo <classname>Random\RandomException</classname>
   .
  </simpara>
 </listitem>
</itemizedlist>
'>
<!ENTITY csprng.errors '
 <listitem xmlns="http://docbook.org/ns/docbook">
  <simpara>
   Si no se encuentra ninguna fuente de datos aleatorios, se lanzará
   una <classname>Random\RandomException</classname>.
  </simpara>
 </listitem>
'>
<!ENTITY csprng.function.backport '
 <note xmlns="http://docbook.org/ns/docbook">
  <simpara>
   Aunque esta función fue añadida en PHP 7.0, una
   <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.csprng.compat;">implementación en espacio de usuario</link>
   está disponible para PHP 5.2 hasta 5.6, inclusive.
  </simpara>
 </note>
'>

<!-- Random snippets -->
<!ENTITY random.engineErrors '
 <listitem xmlns="http://docbook.org/ns/docbook">
  <simpara>
   Cualquier <classname>Throwable</classname> lanzado por el método <methodname>Random\Engine::generate</methodname>
   del <link linkend="random-randomizer.props.engine"><literal>Random\Randomizer::$engine</literal></link> subyacente.
  </simpara>
 </listitem>
'>

<!-- URI snippets -->
<!ENTITY uri.errors.invalidUriException '
  <simpara>
   Si la URI resultante es inválida, se lanza una excepción <exceptionname>Uri\InvalidUriException</exceptionname>.
  </simpara>
'>

<!ENTITY uri.errors.invalidUrlException '
  <simpara>
   Si la URL resultante es inválida, se lanza una excepción <exceptionname>Uri\WhatWg\InvalidUrlException</exceptionname>.
  </simpara>
'>

<!-- UOPZ snippets -->

<!ENTITY uopz.warn.removed.function-5-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta función ha sido
<emphasis>ELIMINADA</emphasis> en PECL uopz 5.0.0.</simpara></warning>'>

<!-- XML snippets -->
<!ENTITY xml.parser.param '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>parser</parameter></term>
 <listitem>
  <simpara>
   El analizador XML.
  </simpara>
 </listitem>
</varlistentry>'>

<!ENTITY xml.handler.description '<para xmlns="http://docbook.org/ns/docbook">
 Si &null; se pasa, el controlador se reinicia a su estado predeterminado.
 <warning>
  <simpara>
    Una cadena vacía también reiniciará el controlador, sin embargo
    esta funcionalidad está deprecada a partir de PHP 8.4.0.
  </simpara>
 </warning>
</para>
<simpara xmlns="http://docbook.org/ns/docbook">
 Si <parameter>handler</parameter> es un <type>callable</type>,
 el callable se define como el controlador.
</simpara>
<para xmlns="http://docbook.org/ns/docbook">
 Si <parameter>handler</parameter> es una <type>string</type>,
 puede ser el nombre de un método de un objeto definido con
 <function>xml_set_object</function>.
 <warning>
  <simpara>
   Esta funcionalidad está deprecada a partir de PHP 8.4.0.
  </simpara>
 </warning>
</para>
<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  A partir de PHP 8.4.0, se verifica la validez del callable durante la configuración del controlador, y no
  en el momento de su
  llamada. Esto significa que <function>xml_set_object</function> debe ser llamado antes de definir
  un método como cadena como devolución de llamada.
  Sin embargo, como este comportamiento también está deprecado a partir de PHP 8.4.0,
  se recomienda utilizar un <type>callable</type> adecuado para el método.
 </simpara>
</warning>
'>

<!ENTITY xml.handler.parser.param '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>parser</parameter></term>
 <listitem>
  <simpara>
   El analizador XML que llama al controlador.
  </simpara>
 </listitem>
</varlistentry>'>

<!ENTITY xml.changelog.handler-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  Pasar un valor no <type>callable</type> de tipo <type>string</type> a
  <parameter>handler</parameter> ahora está obsoleto;
  utilice un callable apropiado para los métodos, o &null; para reinicializar el gestor.
 </entry>
</row>
<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  La validez de <parameter>handler</parameter> como <type>callable</type>
  ahora se verifica al definir el gestor en lugar de verificarse al invocarlo.
 </entry>
</row>'>

<!ENTITY xml.changelog.parser-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>parser</parameter> ahora espera una instancia de <classname>XMLParser</classname>
  ; anteriormente, se esperaba un recurso <literal>xml</literal> de tipo <type>resource</type> válido.
 </entry>
</row>'>

<!-- Migration Guide snippets -->
<!ENTITY migration56.openssl.peer-verification '
   <simpara xmlns="http://docbook.org/ns/docbook">
    Todos los flujos cifrados de cliente activan ahora la verificación de pares de forma
    predeterminada. De forma predeterminada, esto utilizará el paquete de CA predeterminado de OpenSSL para verificar el
    certificado de par. Para la mayoría de los usuarios, esto no debería causar problemas al comunicarse con
    servidores que tengan certificados SSL válidos, ya que la mayoría de los
    distribuidores configuran OpenSSL para usar las rutas de CA predeterminadas.
   </simpara>

   <simpara xmlns="http://docbook.org/ns/docbook">
    El paquete de CA predeterminado se puede sobrescribir a nivel global utilizando las
    opciones de configuración openssl.cafile o openssl.capath, o para cada
    solicitud utilizando las opciones de contexto
    <link linkend="context.ssl.cafile"><parameter>cafile</parameter></link> o
    <link linkend="context.ssl.capath"><parameter>capath</parameter></link>
    .
   </simpara>

   <simpara xmlns="http://docbook.org/ns/docbook">
    Aunque en general no se recomienda, es posible desactivar la verificación del certificado
    de par para una solicitud estableciendo la opción de contexto
    <link linkend="context.ssl.verify-peer"><parameter>verify_peer</parameter></link>
    a &false;, y desactivar la validación del nombre del par configurando la opción de
    contexto <link linkend="context.ssl.verify-peer-name"><parameter>verify_peer_name</parameter></link>
    a &false;.
   </simpara>
'>

<!-- Sodium -->
<!ENTITY sodium.changelog.aes256gcm-aarch64 '
  <informaltable xmlns="http://docbook.org/ns/docbook">
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.4.0</entry>
      <entry>
       Esta función ahora también está definida en aarch64.
       Anteriormente solo estaba definida en x86 y x86_64.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
'>

<!-- readline -->
<!ENTITY readline.system-callback-support '
  <simpara xmlns="http://docbook.org/ns/docbook">
   Esta función solo está disponible si la biblioteca readline con la que se compiló
   PHP la admite. No está disponible en Windows.
  </simpara>
'>

<!-- 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: fen fdm=syntax fdl=2 si
vim: et tw=78
vi: ts=1 sw=1
-->