From 02b6340b79a42ae18b2261b4593f37c7202d129b Mon Sep 17 00:00:00 2001 From: Waldo Malqui Date: Tue, 14 Jul 2026 18:22:36 -0500 Subject: [PATCH] [Review] Sync format and review root translation files - Synchronize formatting, indentation, and line breaks to match doc-en structures. - Review and refine translation quality for spanish style guidelines. - Add missing translations and complete omitted sections. --- bookinfo.xml | 126 +- extensions.ent | 64 +- language-defs.ent | 35 +- language-snippets.ent | 5676 ++++++++++++++++++++--------------------- preface.xml | 41 +- 5 files changed, 2909 insertions(+), 3033 deletions(-) diff --git a/bookinfo.xml b/bookinfo.xml index 7ecc99d603..66047a2b68 100644 --- a/bookinfo.xml +++ b/bookinfo.xml @@ -1,73 +1,73 @@ - - + + - - &frontpage.authors; - - &frontpage.editors; + + &frontpage.authors; + + &frontpage.editors; - - - - ¿Quieres ayudarnos a traducir? - Ponte en contacto con: seros[arroba]php.net - - - - - Traduciendo desde Dic-2009. Estado: 80% - completo y al día. - - - - - - - - - - - Lista de encargados del mantenimiento y - traducción por número de ficheros: - - - - - 1. Pedro Antonio - Gil Rodríguez 2. Andrés García 3. Yago Ferrer 4. Jesús Ruiz-Ayúcar Vázquez 5. Juan Pablo Berdejo 6. Alexander Garzon 7. Jesús Ruiz García 8. Marta Regina Cano Jiménez 9. Leonardo Boshell 10. Francisco José Naranjo Abad 11. Jesús Rafael + + + + ¿Quieres ayudarnos a traducir? + Ponte en contacto con: seros[arroba]php.net + + + + + Traduciendo desde Dic-2009. Estado: 80% + completo y al día. + + + + + + + + + + + Lista de encargados del mantenimiento y + traducción por número de ficheros: + + + + + 1. Pedro Antonio + Gil Rodríguez 2. Andrés García 3. Yago Ferrer 4. Jesús Ruiz-Ayúcar Vázquez 5. Juan Pablo Berdejo 6. Alexander Garzon 7. Jesús Ruiz García 8. Marta Regina Cano Jiménez 9. Leonardo Boshell 10. Francisco José Naranjo Abad 11. Jesús Rafael Cova Huerta 12. Jorge Eduardo Olaya P. 13. Edwin Cartagena Hdez. 14. Jesús Díez 15. Diego Agulló Falcó 16. Ernesto Mediavilla del Río 17. Carlos Hernández Afan de Ribera 18. Waldo Malqui Silva 19. Braian Iván Monnier 20. José Mercedes Venegas Acevedo - - - - - y - muchos más... - - - - - - - - - + + + + + y + muchos más... + + + + + + + + + - - Copyright - - Copyright © 1997 - por el PHP Documentation Group. - Este material puede ser distribuido solamente sujeto a los términos y - condiciones establecidos por la licencia de Creative Commons Attribution - 3.0 o superior. Una copia de la Licencia de - Commons Attribution 3.0 está distribuida con este manual. La - versión más reciente está disponible en - &url.cc.by;. - - + + Copyright + + Copyright © 1997 - por el PHP Documentation Group. + Este material puede ser distribuido únicamente bajo los términos y + condiciones establecidos en la licencia Creative Commons Attribution + 3.0 o posterior. Una copia de la licencia + Creative Commons Attribution 3.0 se distribuye con este manual. + La versión más reciente está actualmente disponible en + &url.cc.by;. + + - + - - + + -Categorización de -ExtensionesEste apéndice categoriza más de 150 extensiones -documentadas en el manual de PHP de acuerdo a varios criterios.'> +Categorización de ExtensionesEste +apéndice categoriza más de 150 extensiones documentadas en el Manual de +PHP según varios criterios.'> Alfabética'> @@ -21,13 +20,13 @@ documentadas en el manual de PHP de acuerdo a varios criterios.'> Extensiones PHP básicas'> Extensiones relacionadas con variables y tipos'> Procesamiento de texto'> -Afectan el comportamiento de PHP"> +Extensiones que afectan el comportamiento de PHP"> Extensiones de sesión'> Otras extensiones básicas'> + Extensiones de bases de datos'> Capas de abstracción'> -Extensiones de bases de datos de -proveedores especí­ficos'> +Extensiones de bases de datos de proveedores específicos'> Manipulación de XML'> @@ -35,12 +34,11 @@ proveedores especí­ficos'> Procesamiento de tarjetas de crédito'> -Matemáticas y criptografí­a'> +Matemáticas y criptografía'> Extensiones matemáticas'> -Extensiones de criptografí­a'> +Extensiones de criptografía'> -Soporte de idioma Humano y -codificación de caracteres'> +Soporte de idioma humano y codificación de caracteres'> Sistema de archivos y control de procesos'> Extensiones relacionadas con sistemas de archivos'> @@ -51,42 +49,48 @@ codificación de caracteres'> Servicios de autenticación'> Otros servicios'> -Extensiones de compresión y paquetes'> +Extensiones de compresión y archivo'> -Extensiones relacionadas con calendario y eventos'> +Extensiones relacionadas con fecha y hora'> -Extensiones de uso en áreas especí­ficas'> +Extensiones de uso en áreas específicas'> Salida MIME diferente a texto'> Procesamiento y generación de imágenes'> Manipulación de formatos de audio'> -Extensiones especí­ficas de lí­nea de comandos'> +Extensiones específicas de línea de comandos'> Extensiones solo para Windows'> -Extensiones especí­ficas de servidor'> +Extensiones específicas de servidor'> -Incorporación'> +Integración'> -Extensiones del núcleoNo son extensiones realmente. Son parte del núcleo de PHP y no pueden omitirse en un binario de PHP con opciones de -compilación.'> +Extensiones del núcleoNo +son extensiones realmente. Son parte del núcleo de PHP y no pueden omitirse +en un binario de PHP con opciones de compilación.'> -Bundled -Extensiones incorporadas en PHP.'> +Extensiones incorporadasEstas +extensiones vienen incorporadas con PHP.'> -Extensiones externasEstas extensiones vienen con PHP, pero para poder compilarlas, se requieren bibliotecas externas.'> +Extensiones externasEstas +extensiones vienen con PHP, pero para poder compilarlas, se requieren bibliotecas externas.'> Extensiones PECL Estas extensiones están disponibles desde &link.pecl;. Pueden requerir bibliotecas externas. Existen más extensiones PECL pero -todavía no están documentadas en el manual de PHP.'> +todavía no están documentadas en el Manual de PHP.'> -EstadoEsta sección lista las extensiones que no son recomendables para su uso en producción - son demasiado "viejas" (obsoletas) o "nuevas" (experimentales).'> +EstadoEsta sección lista las extensiones que +no están destinadas para su uso en producción; ya sea porque son demasiado "antiguas" (deprecadas) o +"nuevas" (experimentales).'> -Extensiones obsoletasEstas extensiones han sido marcadas como obsoletas, por lo general han sido reemplazadas por otras extensiones.'> +Extensiones obsoletasEstas +extensiones han sido deprecadas, por lo general en favor de otras extensiones.'> -Extensiones experimentalesEl comportamiento de estas extensiones - incluyendo los nombres de sus funciones y cualquier otra cosa documentada -sobre estas extensiones - puede cambiar sin previo aviso en una futura -versión de PHP. Use estas extensiones bajo su propio riesgo.'> +Extensiones experimentalesEl +comportamiento de estas extensiones - incluyendo los nombres de sus funciones y cualquier otra +cosa documentada sobre estas extensiones - puede cambiar sin previo aviso en una futura versión +de PHP. Use estas extensiones bajo su propio riesgo.'> diff --git a/language-defs.ent b/language-defs.ent index 14b45d0020..de5cfd4b9a 100644 --- a/language-defs.ent +++ b/language-defs.ent @@ -1,11 +1,10 @@ - - - + + - + @@ -14,13 +13,13 @@ - + - + - + @@ -30,7 +29,7 @@ - + @@ -42,13 +41,13 @@ - + - + @@ -57,8 +56,8 @@ - - + + @@ -87,8 +86,8 @@ supplemental files to mark section titles --> &Changelog;'> Clases predefinidas'> -Sinopsis de la Clase'> -Sinopsis del Enum'> +Sinopsis de la clase'> +Sinopsis del enum'> Constantes predefinidas'> Constructor'> Descripción'> @@ -100,18 +99,18 @@ supplemental files to mark section titles --> Instalación'> Introducción'> Índices'> -Sinopsis de la Interfaz'> +Sinopsis de la interfaz'> Métodos'> -Solo Controlador Nativo de MySQL'> +Solo controlador nativo de MySQL'> Notas'> Parámetros'> Opciones'> Propiedades'> -Requerimientos'> +Requisitos'> Tipos de recursos'> Configuración en tiempo de ejecución'> Valores devueltos'> -Ver también'> +Véase también'> Instalación/Configuración'> Unicode'> Uso'> diff --git a/language-snippets.ent b/language-snippets.ent index 7999bbab0e..7fe547c788 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -1,8 +1,8 @@ - - + + - + 4.2.0El generador @@ -18,189 +18,174 @@ xmlns="http://docbook.org/ns/docbook">Esta función está OBSOLETA a partir de PHP 5.3.0. Depender de esta función está altamente desaconsejado.'> - + Esta función no genera valores criptográficamente seguros, y no debe ser utilizada con fines criptográficos, o con fines que requieran que los valores devueltos sean indescifrables. - Si se requiere aleatoriedad criptográficamente segura, el Random\Randomizer puede ser utilizado - con el motor Random\Engine\Secure. Para casos de uso simples, las funciones - random_int y random_bytes proporcionan una API - práctica y segura que es soportada por el CSPRNG del sistema operativo. + Si se requiere aleatoriedad criptográficamente segura, el Random\Randomizer puede ser + utilizado con el motor Random\Engine\Secure. Para casos de uso simples, las funciones random_int + y random_bytes proporcionan una API práctica y segura que es + soportada por el CSPRNG del sistema operativo. '> - 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 todas las demás funciones, independientemente del ámbito. + 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 todas las demás funciones, independientemente del ámbito. - Generar secuencias repetibles sembrando mt_srand o srand con un valor conocido también producirá una salida repetible de esta función. + Generar secuencias repetibles inicializando mt_srand o srand con un valor conocido también producirá una salida repetible de esta función. - Preferir el uso de los métodos de Random\Randomizer en todo código nuevo. + Prefiera utilizar los métodos de Random\Randomizer en todo el código nuevo. '> - 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 232 - (por ejemplo 4 294 967 296), a pesar de la enorme período de Mt19937 de 219937-1. + 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 232 + (por ejemplo 4 294 967 296), a pesar de la enorme período de Mt19937 de 219937-1. - 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% después de menos de - 80 000 semillas generadas aleatoriamente según el problema del cumpleaños. Una probabilidad del 10% - de una semilla duplicada ocurre después de haber generado aproximadamente 30 000 semillas de manera aleatoria. + 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% después de menos de 80 + 000 semillas generadas aleatoriamente según el problema del cumpleaños. Una probabilidad del 10% de una + semilla duplicada ocurre después de haber generado aproximadamente 30 000 semillas de manera aleatoria. 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 Random\Engine\Xoshiro256StarStar como Random\Engine\PcgOneseq128XslRr64 + más que una probabilidad despreciable. Si se requiere una semilla reproducible, tanto el motor + Random\Engine\Xoshiro256StarStar como Random\Engine\PcgOneseq128XslRr64 soportan semillas mucho más grandes que son poco propensas a colisionar aleatoriamente. Si la reproductibilidad - no es requerida, el motor Random\Engine\Secure proporciona datos aleatorios criptográficamente - seguros. + no es requerida, el motor Random\Engine\Secure proporciona datos aleatorios + criptográficamente seguros. '> -Esta función es -segura para sistemas binarios.'> +Esta función es segura para +sistemas binarios.'> -Los resultados de esta -función se almacenan en caché. Véase la función clearstatcache para +Los resultados de esta función se +almacenan en caché. Véase la función clearstatcache para más detalles.'> - Un resource de - contexto de flujo.'> - - Si un programa es iniciado con esta función - y se ejecuta en segundo plano, la salida del programa debe - ser redirigida a un archivo, o a otro flujo de salida. De lo contrario, - PHP se bloqueará hasta el final de la ejecución del programa.'> - - En Windows exec - iniciará primero cmd.exe para ejecutar el comando. Si se desea iniciar un programa externo sin ejecutar cmd.exe - utilice proc_open definiendo la opción bypass_shell.'> - - Los sistemas de archivos NTFS de Windows - no soportan ciertos caracteres en los nombres de archivo, como <|>*?":. Los nombres de archivo 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 archivos.'> - - En lugar de un nombre de función, un - array que contenga una referencia de objeto y un nombre de método también - puede ser utilizado.'> - - Las devoluciónes de llamada registradas - con funciones como call_user_func y call_user_func_array 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.'> - - 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.'> - - - Dado que esta función depende del ámbito actual para determinar los detalles de los argumentos, estos no - pueden ser utilizados como argumento de una función en versiones de PHP anteriores a 5.3.0. - Si este valor debe ser pasado, el resultado debe ser asignado a una variable y esta variable debe ser pasada. -'> - - - 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. -'> - - - Si PHP no reconoce correctamente los finales de línea al leer archivos que han sido creados o leídos en - un Macintosh, la activación de la opción de configuración - auto_detect_line_endings puede resolver el problema. -'> - - - Esta función no funciona con los archivos remotos, - ya que el archivo examinado debe ser accesible en el sistema de archivos del servidor. -'> - - - Esta función no es capaz de manejar strings binarios ! -'> - - - Esta función asigna nuevas claves a los elementos en array. - Eliminará todas las claves existentes que hayan podido ser asignadas, en lugar de reordenar las claves. -'> - - - Esta función no está implementada en las plataformas Windows. -'> - - - Esta extensión no está disponible en las plataformas Windows. -'> - - - 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 php -i o pruebe la - constante incluida PHP_ZTS. -'> - - - No es necesario inicializar el generador de números aleatorios con - srand o mt_srand, esto se hace automáticamente. +Un contexto de flujo de +tipo resource.'> + +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.'> + +En Windows exec +iniciará primero cmd.exe para ejecutar el comando. Si se desea iniciar un programa externo sin ejecutar cmd.exe +utilice proc_open definiendo la opción bypass_shell.'> + +Los sistemas de archivos NTFS de +Windows no soportan ciertos caracteres en los nombres de fichero, como <|>*?":. 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.'> + + En lugar de un nombre de función, un +array que contenga una referencia de objeto y un nombre de método también puede ser +utilizado.'> + +Las devoluciónes de +llamada registradas con funciones como call_user_func y call_user_func_array 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.'> + +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.'> + +Dado que esta función depende del ámbito +actual para determinar los detalles de los argumentos, estos no pueden ser utilizados como +argumento de una función en versiones de PHP anteriores a 5.3.0. Si este valor debe ser pasado, el resultado debe ser +asignado a una variable y esta variable debe ser pasada.'> + + 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.'> + + Si PHP no reconoce correctamente los finales de +línea al leer ficheros que han sido creados o leídos en un Macintosh, la activación de +la opción de configuración +auto_detect_line_endings +puede resolver el problema.'> + + Esta función no funciona con los +archivos remotos, ya que el archivo +examinado debe ser accesible en el sistema de archivos del servidor.'> + + Esta función no +es capaz de manejar strings binarios (aún)!'> + + Esta función +asigna nuevas claves a los elementos en array. +Eliminará todas las claves existentes que hayan podido ser asignadas, en +lugar de reordenar las claves.'> + + Esta función no está +implementada en las plataformas Windows.'> + + Esta extensión no está +disponible en las plataformas Windows.'> + + 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 php -i o pruebe la constante incluida PHP_ZTS.'> + + No es necesario inicializar +el generador de números aleatorios con srand o +mt_srand, esto se hace automáticamente. '> - - 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 global $variable; - para acceder a ella en las funciones o los métodos. + 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 +global $variable; para acceder a ella en las funciones o los métodos. "> - - Cuando el parámetro return 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 ob_start. -'> + Cuando el parámetro return 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 +ob_start.'> - - Cuando el parámetro return 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 ob_start. -'> + Cuando el parámetro return 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 +ob_start.'> - - Tenga en cuenta que la precisión temporal puede variar según el sistema de archivos utilizado. -'> + Tenga en cuenta que la precisión temporal puede +variar según el sistema de archivos utilizado.'> - - El uso de esta función utilizará todos los autoloaders - registrados si la clase no es conocida aún. -'> + + El uso de esta función utilizará todos los +autoloaders registrados si la clase no es conocida aún.'> - - - Los encabezados solo serán accesibles y se mostrarán cuando se utilice un SAPI que los soporte. - - + + + Los encabezados solo serán accesibles y se mostrarán cuando se utilice un SAPI + que los soporte. + + '> - + - Si PHP ha sido compilado con la opción de configuración --enable-sigchild, - el valor devuelto de esta función será indefinido. + Si PHP ha sido compilado con la opción de configuración --enable-sigchild, el valor devuelto de esta función será indefinido. '> - + 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. @@ -208,163 +193,158 @@ más detalles.'> '> - - + + Reinicia el puntero interno del array al primer elemento. - + "> - + - Esta función no tiene ningún efecto. Anterior a PHP 8.0.0, - esta función era utilizada para cerrar un recurso. + Esta función no tiene ningún efecto. Anterior a PHP 8.0.0, esta función era utilizada para cerrar un recurso. '> - - - - Puede utilizar una URL como nombre de archivo con esta función, si el - gestor fopen ha sido activado. Véase fopen - para más detalles sobre cómo especificar el nombre del archivo. Consulte - 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. -'> - - - A partir de PHP 5.0.0, esta función también puede ser utilizada con algunos protocolos url. - Lea para conocer los protocolos que soportan la familia de funcionalidades de - stat. -'> - - - Al igual que con todas las funciones que muestran directamente resultados al navegador, las - funciones de gestión de salida pueden ser utilizadas para capturar la salida - de esta función y almacenarla en un string (por ejemplo). -'> - - - Eche un vistazo a . -'> - - - - - Si los datos provenientes de los usuarios tienen permiso de ser pasados a esta función, utilice - escapeshellarg o escapeshellcmd para asegurarse de que los usuarios - no puedan hacer que el sistema ejecute comandos arbitrarios. -'> + - - Esta extensión es EXPERIMENTAL. 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. -'> + Puede utilizar una URL como nombre de +archivo con esta función, si el gestor fopen ha sido activado. +Véase fopen para más detalles sobre cómo especificar el nombre +del archivo. Consulte 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.'> - - + A partir de PHP 5.0.0, esta función +también puede ser utilizada con algunos protocolos url. Lea + para conocer los protocolos que soportan la familia de funcionalidades de +stat.'> - - Esta funcionalidad está OBSOLETA a partir de PHP 5.3.0. - Depender de esta funcionalidad está altamente desaconsejado. -'> +Al igual que con cualquier cosa +que envíe sus resultados directamente al navegador, las funciones de control de salida se pueden usar para capturar +la salida de esta función y guardarla en un +string (por ejemplo).'> - - Esta funcionalidad está OBSOLETA a partir de PHP 5.3.0 y ha sido - ELIMINADA a partir de PHP 5.4.0. -'> + Véase también +.'> - - Esta función está OBSOLETA a partir de PHP 5.3.0 y ha sido - ELIMINADA a partir de PHP 5.4.0. -'> - - Esta funcionalidad está OBSOLETA a partir de PHP 5.5.0. - Depender de esta funcionalidad está altamente desaconsejado. -'> + - - Esta funcionalidad está OBSOLETA a partir de PHP 5.6.0. - Depender de esta funcionalidad está altamente desaconsejado. -'> + Si los datos provenientes de los usuarios tienen permiso +de ser pasados a esta función, utilice +escapeshellarg o escapeshellcmd +para asegurarse de que los usuarios no puedan hacer que el sistema ejecute comandos +arbitrarios.'> - - Esta funcionalidad está OBSOLETA a partir de PHP 7.0.0. - Depender de esta funcionalidad está altamente desaconsejado. -'> + Esta extensión es +EXPERIMENTAL. 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.'> - - Esta funcionalidad está OBSOLETA a partir de PHP 7.1.0. - Depender de esta funcionalidad está altamente desaconsejado. -'> + + - - Esta función está OBSOLETA a partir de PHP 7.1.0. - Depender de esta función está altamente desaconsejado. -'> + Esta funcionalidad está +OBSOLETA a partir de PHP 5.3.0. Depender de esta funcionalidad +está altamente desaconsejado.'> - - Esta función está OBSOLETA a partir de PHP 7.0.0 y ha sido - ELIMINADA a partir de PHP 8.0.0. - Depender de esta función está altamente desaconsejado. -'> + Esta funcionalidad está +OBSOLETA a partir de PHP 5.3.0 y ha sido ELIMINADA +a partir de PHP 5.4.0.'> - - Esta función está OBSOLETA a partir de PHP 7.1.0 y ha sido - ELIMINADA a partir de PHP 7.2.0. - Depender de esta función está altamente desaconsejado. -'> + Esta función está +OBSOLETA a partir de PHP 5.3.0 y ha sido ELIMINADA a partir de PHP 5.4.0.'> - - Esta funcionalidad está OBSOLETA a partir de PHP 7.2.0. - Depender de esta funcionalidad está altamente desaconsejado. -'> + Esta funcionalidad está +OBSOLETA a partir de PHP 5.5.0. Depender de esta funcionalidad +está altamente desaconsejado.'> - - Esta funcionalidad está OBSOLETA a partir de PHP 7.2.0, - y ELIMINADA a partir de PHP 8.0.0. - Depender de esta funcionalidad está altamente desaconsejado. -'> + Esta funcionalidad está +OBSOLETA a partir de PHP 5.6.0. Depender de esta funcionalidad +está altamente desaconsejado.'> - - Esta función está OBSOLETA a partir de PHP 7.2.0. - Depender de esta función está altamente desaconsejado. -'> + Esta funcionalidad está +OBSOLETA a partir de PHP 7.0.0. Depender de esta funcionalidad +está altamente desaconsejado.'> - - Esta funcionalidad está OBSOLETA a partir de PHP 7.2.0 y ha sido - ELIMINADA a partir de PHP 8.0.0. -'> + Esta funcionalidad está +OBSOLETA a partir de PHP 7.1.0. Depender de esta funcionalidad +está altamente desaconsejado.'> - - Esta funcionalidad está OBSOLETA a partir de PHP 7.3.0. - Depender de esta funcionalidad está altamente desaconsejado. -'> + Esta función está +OBSOLETA a partir de PHP 7.1.0. Depender de esta función +está altamente desaconsejado.'> - - Esta función está OBSOLETA a partir de PHP 7.3.0. - Depender de esta función está altamente desaconsejado. -'> + Esta función está +OBSOLETA a partir de PHP 7.0.0 y ha sido +ELIMINADA a partir de PHP 8.0.0. Depender de esta función +está altamente desaconsejado.'> - - Esta función está OBSOLETA a partir de PHP 7.3.0, - y ha sido ELIMINADA a partir de PHP 8.0.0. - Depender de esta función está altamente desaconsejado. -'> + Esta función está +OBSOLETA a partir de PHP 7.1.0 y ha sido +ELIMINADA a partir de PHP 7.2.0. Depender de esta función +está altamente desaconsejado.'> - - Esta funcionalidad está OBSOLETA a partir de PHP 7.4.0. - Depender de esta funcionalidad está altamente desaconsejado. -'> + Esta funcionalidad está +OBSOLETA a partir de PHP 7.2.0. Depender de esta funcionalidad +está altamente desaconsejado.'> - - Esta función está OBSOLETA a partir de PHP 7.4.0. - Depender de esta función está altamente desaconsejado. -'> + Esta funcionalidad está +OBSOLETA a partir de PHP 7.2.0, y ELIMINADA a partir de PHP 8.0.0. Depender de esta funcionalidad +está altamente desaconsejado.'> + + Esta función está +OBSOLETA a partir de PHP 7.2.0. Depender de esta función +está altamente desaconsejado.'> + + Esta funcionalidad está +OBSOLETA a partir de PHP 7.2.0 y ha sido ELIMINADA a partir de PHP +8.0.0.'> + + Esta funcionalidad está +OBSOLETA a partir de PHP 7.3.0. Depender de esta funcionalidad +está altamente desaconsejado.'> + + Esta función está +OBSOLETA a partir de PHP 7.3.0. Depender de esta función +está altamente desaconsejado.'> + + Esta función está +OBSOLETA a partir de PHP 7.3.0, y ha sido ELIMINADA a partir de PHP 8.0.0. Depender de esta función +está altamente desaconsejado.'> + + Esta funcionalidad está +OBSOLETA a partir de PHP 7.4.0. Depender de esta funcionalidad +está altamente desaconsejado.'> + + Esta función está +OBSOLETA a partir de PHP 7.4.0. Depender de esta función +está altamente desaconsejado.'> Esta función está @@ -425,149 +405,140 @@ xmlns="http://docbook.org/ns/docbook">Esta función está OBSOLETA a partir de PHP 8.5.0. Depender de esta función está altamente desaconsejado.'> - será +será ciertamente eliminada en el futuro.'> - - Esta función está OBSOLETA y ha sido ELIMINADA a partir de PHP 5.3.0. -'> + Esta función está +OBSOLETA y ha sido ELIMINADA a partir de PHP 5.3.0.'> - - Esta función está OBSOLETA, y ha sido ELIMINADA a partir de PHP 5.5.0. -'> + Esta función está +OBSOLETA, y ha sido ELIMINADA a partir de PHP 5.5.0.'> - - Este alias está OBSOLETO a partir de PHP 5.3.0. - Depender de este alias está fuertemente desaconsejado. -'> + +Este alias está OBSOLETO a partir de PHP 5.3.0. +Depender de este alias está fuertemente desaconsejado.'> - - Esta función está OBSOLETA a partir de PHP 5.4.0. - Depender de esta función está fuertemente desaconsejado. -'> + +Esta función está OBSOLETA a partir de PHP 5.4.0. +Depender de esta función está fuertemente desaconsejado.'> - - Este alias está OBSOLETO a partir de PHP 5.4.0. - Depender de este alias está fuertemente desaconsejado. -'> + +Este alias está OBSOLETO a partir de PHP 5.4.0. +Depender de este alias está fuertemente desaconsejado.'> - - Esta función está OBSOLETA a partir de PHP 5.5.0. - Depender de esta función está fuertemente desaconsejado. -'> + +Esta función está OBSOLETA a partir de PHP 5.5.0. +Depender de esta función está fuertemente desaconsejado.'> - - Esta funcionalidad está OBSOLETA a partir de PHP 5.5.0 y ha sido - ELIMINADA a partir de PHP 7.0.0. -'> + Esta funcionalidad está +OBSOLETA a partir de PHP 5.5.0 y ha sido ELIMINADA a partir de PHP 7.0.0.'> - - Esta función está OBSOLETA a partir de PHP 5.5.0 y ha sido - ELIMINADA a partir de PHP 7.0.0. -'> + Esta función está +OBSOLETA a partir de PHP 5.5.0 y ha sido ELIMINADA a partir de PHP 7.0.0.'> - - Esta función está OBSOLETA a partir de PHP 4.1.0 y ha sido - ELIMINADA a partir de PHP 7.0.0. -'> + Esta función está +OBSOLETA a partir de PHP 4.1.0 y ha sido ELIMINADA a partir de PHP 7.0.0.'> - - Esta función está OBSOLETA a partir de PHP 5.3.0 y ha sido - ELIMINADA a partir de PHP 7.0.0. -'> + Esta función está +OBSOLETA a partir de PHP 5.3.0 y ha sido ELIMINADA a partir de PHP 7.0.0.'> - - Este alias está OBSOLETO a partir de PHP 5.4.0. y ha sido - ELIMINADO a partir de PHP 7.0.0. -'> - Esta funcionalidad está OBSOLETA a partir de PHP 5.6.0 y ha sido - ELIMINADA a partir de PHP 7.0.0. -'> + Este alias está +OBSOLETO a partir de PHP 5.4.0. y ha sido ELIMINADO a partir de PHP 7.0.0.'> - - Esta función ha sido ELIMINADA a partir de PHP 7.0.0. -'> + Esta funcionalidad está +OBSOLETA a partir de PHP 5.6.0 y ha sido +ELIMINADA a partir de PHP 7.0.0.'> - - Esta función ha sido ELIMINADA a partir de PHP 7.4.0. -'> + Esta función ha sido +ELIMINADA a partir de PHP 7.0.0.'> + + Esta función ha sido +ELIMINADA a partir de PHP 7.4.0.'> - Este alias está +Este alias está OBSOLETO en PHP 7.2.0, y ELIMINADO a partir de PHP 8.0.0.'> - Este alias está +Este alias está OBSOLETO en PHP 7.4.0, y ELIMINADO a partir de PHP 8.0.0.'> - Este alias está +Este alias está OBSOLETO en PHP 8.0.0.'> - Este alias está +Este alias está ELIMINADO a partir de PHP 8.0.0.'> Esta funcionalidad ha sido ELIMINADA a partir de PHP 8.5.0.'> - - Esta función es EXPERIMENTAL. 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. -'> - - - Las extensiones IMAP, recode y - YAZ - 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. + Esta función es +EXPERIMENTAL. 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. '> - - Un servidor desplegado en modo CGI se expone a varias vulnerabilidades posibles. Por favor, lea nuestra - sección sobre la seguridad en modo CGI - para aprender cómo protegerse contra estos ataques. -'> - - - - No se recomienda utilizar esta función para asegurar contraseñas, debido a la naturaleza - rápida de este algoritmo de hash. Ver F.A.Q del hash de - contraseñas para más detalles y las buenas prácticas. - -'> + Las extensiones IMAP, recode y +YAZ +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.'> - - Cuando SSL es utilizado, el servidor IIS de Microsoft violará el protocolo al cerrar la conexión sin - enviar un indicador close_notify. PHP lo reportará como "SSL: Fatal Protocol Error" - cuando se llegue al final de los datos. Para evitar esto, el nivel de la directiva - error_reporting debe ser bajado para no incluir los avisos. - PHP puede detectar automáticamente los servidores IIS defectuosos al abrir - el flujo utilizando https:// y suprimirá el aviso. - Al utilizar fsockopen para crear un socket ssl://, - es responsabilidad del desarrollador detectar y suprimir el aviso. -'> + Un servidor desplegado en modo CGI se expone a +varias vulnerabilidades posibles. Por favor, lea nuestra +sección sobre la seguridad en modo CGI para aprender cómo +protegerse contra estos ataques.'> - - - Esta clase está actualmente no documentada; solo la lista de sus propiedades y métodos está disponible. - + + No se recomienda utilizar esta función para asegurar contraseñas, debido + a la naturaleza rápida de este algoritmo de hash. Ver + F.A.Q del hash de contraseñas + para más detalles y las buenas prácticas. + '> - Cuando SSL es utilizado, el servidor +IIS de Microsoft violará el protocolo al cerrar la conexión sin enviar un indicador +close_notify. PHP lo reportará como "SSL: Fatal Protocol +Error" cuando se llegue al final de los datos. Para evitar esto, el nivel de +la directiva error_reporting debe ser +bajado para no incluir los avisos. PHP +puede detectar automáticamente los servidores IIS defectuosos al abrir +el flujo utilizando https:// y suprimirá el aviso. +Al utilizar fsockopen para crear un socket +ssl://, es responsabilidad del desarrollador detectar +y suprimir el aviso.'> + + - - Esta función está actualmente no documentada; solo la lista de sus argumentos está disponible. - + + Esta clase está actualmente no documentada; solo la lista de sus propiedades y + métodos está disponible. + '> - - Esta función está OBSOLETA a partir de PHP 4.1.0 y ha sido ELIMINADA a partir de PHP 7.0.0. @@ -577,7 +548,7 @@ xmlns="http://docbook.org/ns/docbook">Esta funcionalidad ha sido '> - Esta funcionalidad está OBSOLETA a partir de PHP 5.3.0 y ha sido ELIMINADA a partir de PHP 7.0.0. @@ -587,7 +558,7 @@ xmlns="http://docbook.org/ns/docbook">Esta funcionalidad ha sido '> - Esta función está OBSOLETA a partir de PHP 5.3.0 y ha sido ELIMINADA a partir de PHP 7.0.0. @@ -597,7 +568,7 @@ xmlns="http://docbook.org/ns/docbook">Esta funcionalidad ha sido '> - Esta función está OBSOLETA a partir de PHP 5.5.0 y ha sido ELIMINADA a partir de PHP 7.0.0. @@ -607,7 +578,7 @@ xmlns="http://docbook.org/ns/docbook">Esta funcionalidad ha sido '> - Esta funcionalidad ha sido ELIMINADA a partir de PHP 7.0.0. @@ -616,7 +587,7 @@ xmlns="http://docbook.org/ns/docbook">Esta funcionalidad ha sido '> - Esta función ha sido ELIMINADA a partir de PHP 7.0.0. @@ -625,7 +596,7 @@ xmlns="http://docbook.org/ns/docbook">Esta funcionalidad ha sido '> - Esta funcionalidad está OBSOLETA a partir de PHP 7.1.0 y ha sido ELIMINADA a partir de PHP 7.2.0. @@ -635,7 +606,7 @@ xmlns="http://docbook.org/ns/docbook">Esta funcionalidad ha sido '> - Esta función está OBSOLETA a partir de PHP 7.1.0 y ha sido ELIMINADA a partir de PHP 7.2.0. @@ -645,182 +616,184 @@ xmlns="http://docbook.org/ns/docbook">Esta funcionalidad ha sido '> - Esta función -está OBSOLETA a partir de PHP 8.1.0. -Se recomienda evitar su uso. +Esta función está +OBSOLETA a partir de PHP 8.1.0. Se recomienda +evitar su uso. Las alternativas a esta función incluyen: '> - + - + - + - Esta función no contiene ningún parámetro.'> +Esta función no contiene ningún parámetro.'> - El ejemplo anterior mostrará:'> +El ejemplo anterior mostrará:'> - Resultado del ejemplo anterior en PHP 5:'> +Resultado del ejemplo anterior en PHP 5:'> - Resultado del ejemplo anterior en PHP 5.3:'> +Resultado del ejemplo anterior en PHP 5.3:'> - Resultado del ejemplo anterior en PHP 5.4:'> +Resultado del ejemplo anterior en PHP 5.4:'> - Resultado del ejemplo anterior en PHP 5.5:'> +Resultado del ejemplo anterior en PHP 5.5:'> - Resultado del ejemplo anterior en PHP 5.6:'> +Resultado del ejemplo anterior en PHP 5.6:'> - Resultado del ejemplo anterior en PHP 7:'> +Resultado del ejemplo anterior en PHP 7:'> - Resultado del ejemplo anterior en PHP 7.0:'> +Resultado del ejemplo anterior en PHP 7.0:'> - Resultado del ejemplo anterior en PHP 7.1:'> +Resultado del ejemplo anterior en PHP 7.1:'> - Resultado del ejemplo anterior en PHP 7.2:'> +Resultado del ejemplo anterior en PHP 7.2:'> - Resultado del ejemplo anterior en PHP 7.3:'> +Resultado del ejemplo anterior en PHP 7.3:'> - Resultado del ejemplo anterior en PHP 8:'> +Resultado del ejemplo anterior en PHP 8:'> - Resultado del ejemplo anterior en PHP 8 es similar a:'> +Resultado del ejemplo anterior en PHP 8 es similar a:'> - Resultado del ejemplo anterior en PHP 8.0:'> +Resultado del ejemplo anterior en PHP 8.0:'> - Resultado del ejemplo anterior en PHP 8.1:'> +Resultado del ejemplo anterior en PHP 8.1:'> - Resultado del ejemplo anterior en PHP 8.2:'> +Resultado del ejemplo anterior en PHP 8.2:'> - Resultado del ejemplo anterior en PHP 8.2 es similar a:'> +Resultado del ejemplo anterior en PHP 8.2 es similar a:'> - Resultado del ejemplo anterior en PHP 8.3:'> +Resultado del ejemplo anterior en PHP 8.3:'> - Resultado del ejemplo anterior en PHP 8.3 es similar a:'> +Resultado del ejemplo anterior en PHP 8.3 es similar a:'> - Salida del ejemplo anterior en PHP 8.4:'> +Salida del ejemplo anterior en PHP 8.4:'> - La salida del ejemplo anterior en PHP 8.4 es similar a:'> +La salida del ejemplo anterior en PHP 8.4 es similar a:'> - Salida del ejemplo anterior en PHP 8.5:'> +Salida del ejemplo anterior en PHP 8.5:'> - La salida del ejemplo anterior en PHP 8.5 es similar a:'> +La salida del ejemplo anterior en PHP 8.5 es similar a:'> - Resultado del ejemplo anterior en una máquina de 32 bits:'> +Resultado del ejemplo anterior en una máquina de 32 bits:'> - Resultado del ejemplo anterior en una máquina de 64 bits:'> +Resultado del ejemplo anterior en una máquina de 64 bits:'> - Resultado del ejemplo anterior es similar a:'> +Resultado del ejemplo anterior +es similar a:'> - Los ejemplos anteriores mostrarán:'> +Los ejemplos anteriores mostrarán:'> - Resultado de los ejemplos anteriores en una máquina de 32 bits:'> +Resultado de los ejemplos anteriores en una máquina de 32 bits:'> - Resultado de los ejemplos anteriores en una máquina de 64 bits:'> +Resultado de los ejemplos anteriores en una máquina de 64 bits:'> - Los ejemplos anteriores mostrarán algo similar a:'> +Los ejemplos anteriores mostrarán +algo similar a:'> - - Esta función reinicia el puntero al inicio del array de entrada (equivalente a reset). -'> +Esta función ejecutará +reset sobre el puntero del array de entrada después de +usarlo.'> - + 8.0.0 - Si callback espera un parámetro a ser pasado por - referencia, esta función emite ahora una E_WARNING. + Si callback espera un parámetro a ser pasado + por referencia, esta función emite ahora una E_WARNING. '> - - 8.0.0 - - Esta función puede ser llamada ahora con un solo parámetro. - Anteriormente, al menos dos parámetros eran necesarios. - + + 8.0.0 + + Esta función puede ser llamada ahora con un solo + parámetro. Anteriormente, al menos dos parámetros eran necesarios. + '> - ordenación de arrays'> +ordenación de arrays'> - - flags - - - El segundo parámetro opcional flags - puede ser utilizado para modificar el comportamiento de ordenación utilizando estos valores: - - - Tipo de banderas de ordenación: - - - SORT_REGULAR - compara los elementos normalmente; - los detalles son descritos en la sección de los operadores de comparación - - - SORT_NUMERIC - compara los elementos numéricamente - - - SORT_STRING - compara los elementos como strings - - - - SORT_LOCALE_STRING - compara los elementos como - strings, basado en la configuración regional actual. Esto utiliza la configuración regional, - que puede ser cambiada utilizando setlocale - - - - - SORT_NATURAL - compara los elementos como strings - utilizando el "orden natural" como natsort - - - - - SORT_FLAG_CASE - puede ser combinado - (OR a nivel de bits) con - SORT_STRING o - SORT_NATURAL para ordenar strings sin tener en cuenta la mayúscula/minúscula - - - - - - + + flags + + + El segundo parámetro opcional flags + puede ser utilizado para modificar el comportamiento de ordenación utilizando estos valores: + + + Tipo de banderas de ordenación: + + + SORT_REGULAR - compara los elementos normalmente; los + detalles son descritos en la sección de los operadores de comparación + + + SORT_NUMERIC - compara los elementos numéricamente + + + SORT_STRING - compara los elementos como strings + + + + SORT_LOCALE_STRING - compara los elementos como + strings, basado en la configuración regional actual. Esto utiliza la configuración + regional, que puede ser cambiada utilizando setlocale + + + + + SORT_NATURAL - compara los elementos como strings + utilizando el "orden natural" como natsort + + + + + SORT_FLAG_CASE - puede ser combinado (OR a + nivel de bits) con + SORT_STRING o + SORT_NATURAL para ordenar strings sin tener en cuenta la mayúscula/minúscula + + + + + + '> - -&return.callbacksort; + + &return.callbacksort; &callback.cmp; - -Retornar valores no-entero desde la función -de comparación, tales como float, resultará en una conversión interna -del valor de retorno del callback a int. Así, valores tales como -0.99 y 0.1 serán convertidos ambos a un -valor entero de 0, lo que comparará tales valores como iguales. - + + Devolver valores no enteros (como + float) desde la función de comparación resultará en una conversión interna del valor de retorno de la retrollamada a + int. Así, valores como + 0.99 y 0.1 serán convertidos ambos al + valor entero 0, por lo que se compararán como iguales. + '> - + - 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. + 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: 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); +// $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; }; ?> @@ -829,234 +802,229 @@ $compareFunc = static function ($item1, $item2) { '> - Cuando un &integer; es utilizado, -su valor es medido en bytes. También puede utilizar la notación abreviada -como se describe en esta -entrada de la FAQ..'> +Cuando se utiliza un int, el valor se +mide en bytes. También se puede usar la notación abreviada, como se describe +en esta FAQ. +'> - + - + - + - Este alias está obsoleto -y solo existe por razones de compatibilidad. Se recomienda -no utilizar esta función ya que puede ser eliminada en una versión futura de PHP.'> +Este alias está obsoleto +y solo existe por razones de compatibilidad. Se recomienda no utilizar +esta función ya que puede ser eliminada en una versión futura de PHP. +'> - DLL deben estar disponibles a través del -PATH del sistema Windows. Lea la -F.A.Q titulada -"Cómo agregar mi carpeta -PHP a mi PATH de Windows" 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 +DLL deben estar disponibles a través +del PATH del sistema Windows. Lea la +F.A.Q titulada "Cómo agregar mi carpeta PHP a mi PATH +de Windows" 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 PATH del sistema), pero este método no es recomendado. -Esta extensión requiere que los siguientes archivos estén en el +Esta extensión requiere que los siguientes ficheros estén en el PATH: '> - + - - + + - match'> +match'> - contexto -de este manual para una descripción de los contextos.'> +contexto +de este manual para una descripción de los contexts.'> - include_path'> +include_path'> - + - + 8.2.0 El tipo de retorno es ahora &true;, anteriormente era bool. '> - + 8.4.0 El tipo de retorno es ahora &true;, anteriormente era bool. '> - + 8.5.0 El tipo de retorno es ahora &true;, anteriormente era bool. '> - - + + - + - + - + - + - + - - Esta función puede retornar &false;, pero también puede retornar un valor equivalente a &false;. - Por favor, lea la sección sobre los booleanos para más información. - Utilice el operador === - para probar el valor de retorno exacto de esta función. -'> + Esta función puede +retornar &false;, pero también puede retornar un valor equivalente a +&false;. Por favor, lea la sección sobre los booleanos para más +información. Utilice el operador +=== para probar el valor de retorno exacto de esta +función.'> - - + + 8.1.0 - O bien convertir el &object; en un &array; utilizando get_mangled_object_vars primero, - o utilizar los métodos proporcionados por una clase que implemente Iterator, tal como - ArrayIterator. + O bien convertir el + &object; en un &array; utilizando get_mangled_object_vars primero, o utilizar los métodos + proporcionados por una clase que implemente Iterator, tal como ArrayIterator. 7.4.0 - A partir de PHP 7.4.0, las instancias de clases SPL son tratadas como - objetos vacíos sin propiedades en lugar de llamar al método Iterator con - el mismo nombre que esta función. + A partir de PHP 7.4.0, las instancias de clases SPL son tratadas como objetos vacíos sin propiedades en lugar de llamar al método Iterator con el mismo nombre que esta función. '> - + 8.2.0 Esta función ya no garantiza retornar - strlen($string1) - strlen($string2) cuando las longitudes - de las strings no son iguales, y puede retornar - -1 o 1 en su lugar. + strlen($string1) - strlen($string2) cuando las longitudes de + las strings no son iguales, y puede retornar -1 o + 1 en su lugar. '> - - Una instancia finfo, retornada por finfo_open.'> - + +Una instancia finfo, retornada por finfo_open.'> + 8.1.0 - El parámetro finfo ahora espera una instancia de - finfo ; anteriormente, una &resource; era esperado. + El parámetro finfo ahora espera una instancia de finfo + ; anteriormente, una &resource; era esperado. '> - - -x509 - - - Ver los parámetros clave/Certificados - para una lista de valores válidos. - - + + + certificate + + + Ver los parámetros clave/Certificados para una lista de valores válidos. + + '> - -csr - - - Ver los parámetros CSR para obtener una lista de los valores válidos. - - + + csr + + + Ver los parámetros CSR para obtener una lista de los valores válidos. + + '> - -key - - - Ver los parámetros clave pública/privada para obtener una lista de los valores válidos. - - + + key + + + Ver los parámetros clave pública/privada para obtener una lista de los valores válidos. + + '> - - Esta función solo está disponible - si PHP es compilado utilizando .'> + +Esta función solo está disponible +si PHP es compilado utilizando . +'> - Esta función solo está disponible si - si PHP es compilado con soporte Freetype () +Esta función solo está disponible si +si PHP es compilado con soporte Freetype () '> - Esta función no requiere la biblioteca GD.'> +Esta función no requiere la biblioteca GD.'> - Esta función es afectada por - el método de interpolación, definido por la función imagesetinterpolation.'> +Esta función es afectada por el método de interpolación, definido por la función imagesetinterpolation.'> - -image - Un objeto GdImage, retornado por una de las funciones de - creación de imágenes, como imagecreatetruecolor. -'> + +image Un objeto GdImage, retornado por una de las funciones de creación de +imágenes, como imagecreatetruecolor.'> - -font - 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 GdFont retornado por imageloadfont. -'> + +font 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 GdFont retornado +por imageloadfont.'> - - 8.1.0 - - El parámetro font ahora acepta una instancia de GdFont - y un &integer;; anteriormente solo un &integer; era aceptado. - + + 8.1.0 + + El parámetro font ahora acepta una instancia de GdFont y + un &integer;; anteriormente solo un &integer; era aceptado. + '> - fontfile - + La ruta de acceso al fichero de la fuente TrueType que desea utilizar. - - + + Dependiendo de qué versión de la biblioteca GD esté utilizando PHP, cuando fontfile no comienza con una barra diagonal inicial / entonces .ttf será añadido - 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. - - + 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. + + Al utilizar versiones de la biblioteca GD inferiores a 2.0.18, un carácter espacio, - 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: + 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: Advertencia: No se pudo encontrar/abrir la fuente. Para estas versiones afectadas, la única solución es mover la fuente a una ruta que no contenga espacios. - + 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. ]]> - + Tenga en cuenta que open_basedir no aplica a fontfile. - + @@ -1078,17 +1046,17 @@ $font = 'SomeFont'; - + - + - + - + @@ -1151,8 +1119,8 @@ pruebas.'> 8.0.0 - image ahora espera una instancia de GdImage; - anteriormente, se esperaba un resource gd válido. + image ahora espera una instancia de GdImage + ; anteriormente, se esperaba un recurso gd de tipo resource válido. '> @@ -1160,8 +1128,8 @@ pruebas.'> Cuando escape se define con un valor diferente a una cadena vacía (""), puede resultar en un CSV que no sea compatible con - RFC 4180 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 escape es + RFC 4180 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 escape es "\\", 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. '> @@ -1200,24 +1168,24 @@ devuelto por dbmopen.'> 8.0.0 - handle ahora espera una instancia de CurlHandle; - anteriormente, se esperaba un resource. + handle ahora espera una instancia de CurlHandle + ; anteriormente, se esperaba un resource. '> 8.0.0 - multi_handle ahora espera una instancia de CurlMultiHandle; - anteriormente, se esperaba un resource. + multi_handle ahora espera una instancia de CurlMultiHandle + ; anteriormente, se esperaba un resource. '> 8.0.0 - share_handle ahora espera una instancia de CurlShareHandle; - anteriormente, se esperaba un resource. + share_handle ahora espera una instancia de CurlShareHandle + ; anteriormente, se esperaba un resource. '> @@ -1226,8 +1194,8 @@ devuelto por dbmopen.'> 8.4.0 - El parámetro dba ahora espera una instancia de Dba\Connection; - anteriormente, se esperaba un &resource; dba válido. + El parámetro dba ahora espera una instancia de Dba\Connection + ; anteriormente, se esperaba un &resource; dba válido. '> @@ -1286,16 +1254,16 @@ devuelto por dbmopen.'> 8.0.0 - broker ahora espera una instancia de EnchantBroker; - anteriormente, se esperaba un &resource;. + broker ahora espera una instancia de EnchantBroker; anteriormente, + se esperaba un &resource;. '> 8.0.0 - dictionary ahora espera una instancia de EnchantDictionary; - anteriormente, se esperaba un &resource;. + dictionary ahora espera una instancia de EnchantDictionary; anteriormente, + se esperaba un &resource;. '> @@ -1304,8 +1272,8 @@ devuelto por dbmopen.'> 8.1.0 - El parámetro imap ahora espera una instancia de IMAP\Connection; - anteriormente, se esperaba un &resource; imap válido. + El parámetro imap ahora espera una instancia de IMAP\Connection + ; anteriormente, se esperaba un &resource; imap válido. '> @@ -1317,18 +1285,18 @@ devuelto por dbmopen.'> imapUn flujo IMAP devuelto por imap_open.'> -Especifica en qué parte de la jerarquía del buzón -comenzar la búsqueda.Hay dos caracteres especiales que se pueden -pasar como parte del pattern: +Especifica en qué parte de la jerarquía del +buzón comenzar la búsqueda.Hay dos caracteres especiales que se +pueden pasar como parte del pattern: '*' y '%'. '*' significa devolver todos los buzones. Si se pasa -pattern como '*', se -obtendrá una lista de toda la jerarquía del buzón. +pattern como '*', se obtendrá +una lista de toda la jerarquía del buzón. '%' significa devolver solo el nivel actual. '%' como parámetro pattern -devolverá solo los buzones de nivel superior; -'~/mail/%' en UW_IMAPD devolverá cada buzón en el directorio ~/mail, pero ninguno en las subcarpetas de ese directorio.'> +devolverá solo los buzones de nivel +superior; '~/mail/%' en UW_IMAPD devolverá cada buzón en el directorio ~/mail, pero ninguno en las subcarpetas de ese directorio.'> Pasar datos no confiables a este parámetro es inseguro, a menos que @@ -1372,9 +1340,9 @@ Pasar datos no confiables a este parámetro es inseguro, a - Esta función está OBSOLETA a partir de PHP 7.4.0, y fue ELIMINADA a partir de PHP 8.0.0. - En su lugar, se debe utilizar el parámetro controls de ldap_search. - Véase también LDAP Controls para más detalles. + Esta función está OBSOLETA a partir de PHP 7.4.0, y fue ELIMINADA a partir de PHP 8.0.0. En su lugar, se + debe utilizar el parámetro controls de ldap_search. Véase + también LDAP Controls para más detalles. '> @@ -1388,57 +1356,57 @@ Pasar datos no confiables a este parámetro es inseguro, a 8.1.0 - El parámetro ldap ahora espera una instancia de LDAP\Connection; - anteriormente, se esperaba un &resource; ldap link válido. + El parámetro ldap ahora espera una instancia de LDAP\Connection + ; anteriormente, se esperaba un &resource; ldap link válido. '> 8.1.0 - El parámetro entry ahora espera una instancia de LDAP\ResultEntry; - anteriormente, se esperaba un &resource; ldap result entry válido. + El parámetro entry ahora espera una instancia de LDAP\ResultEntry + ; anteriormente, se esperaba un &resource; ldap result entry válido. '> 8.1.0 - El parámetro result ahora espera una instancia de LDAP\Result; - anteriormente, se esperaba un &resource; ldap result válido. + El parámetro result ahora espera una instancia de LDAP\Result + ; anteriormente, se esperaba un &resource; ldap result válido. '> 8.1.0 - Ahora devuelve una instancia de LDAP\Result; - anteriormente, se devolvía un &resource;. + Ahora devuelve una instancia de LDAP\Result; anteriormente, + se devolvía un &resource;. '> 8.1.0 - Ahora devuelve una instancia de LDAP\ResultEntry; - anteriormente, se devolvía un &resource;. + Ahora devuelve una instancia de LDAP\ResultEntry; anteriormente, + se devolvía un &resource;. '> LDAP\Result,&return.falseforfailure;.'> LDAP\Result, un array de instancias de LDAP\Result,&return.falseforfailure;.'> -También es posible realizar búsquedas en paralelo. En este caso, el primer argumento debe ser un array de -instancias de LDAP\Connection, 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 LDAP\Connection, -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 LDAP\Result, excepto en caso de error, donde el valor de retorno será &false;.'> +También es posible realizar búsquedas en paralelo. En este caso, el primer argumento debe ser un array de instancias de +LDAP\Connection, 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 LDAP\Connection, 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 LDAP\Result, excepto en caso de error, donde el valor de retorno será &false;.'> -La codificación interna o la -codificación de caracteres especificada por mb_regex_encoding +La codificación interna o la codificación +de caracteres especificada por mb_regex_encoding se utilizará como codificación de caracteres para esta función.'> La @@ -1446,8 +1414,8 @@ codificación de caracteres especificada por mb_regex_encoding'> El parámetro encoding -es la codificación de caracteres. Si se omite o es &null;, se utilizará el valor de la codificación -de caracteres interna.'> +es la codificación de caracteres. Si se omite o es &null;, se utilizará el valor +de la codificación de caracteres interna.'> Nunca utilice el modificador e con datos de entrada no confiables. No se realizará ningún escape automático (como se conoce de preg_replace). No tener esto en cuenta probablemente creará vulnerabilidades de ejecución remota de código en la aplicación.'> @@ -1484,9 +1452,9 @@ de caracteres interna.'> - A partir de memcached 1.3.0 (publicado en 2009) esta funcionalidad ya no está - soportada. Pasar un valor distinto de cero para time causará - que la eliminación falle. Memcached::getResultCode + A partir de memcached 1.3.0 (publicado en 2009) esta funcionalidad ya no está soportada. Pasar + un valor distinto de cero para time causará que + la eliminación falle. Memcached::getResultCode devolverá MEMCACHED_INVALID_ARGUMENTS. '> @@ -1506,73 +1474,68 @@ de caracteres interna.'> Devuelve un array indexado por keys. Cada elemento - es &true; si la clave correspondiente fue eliminada, o una de las - constantes Memcached::RES_* si la eliminación correspondiente + es &true; si la clave correspondiente fue eliminada, o una de las constantes + Memcached::RES_* si la eliminación correspondiente falló. - Memcached::getResultCode 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 keys. + Memcached::getResultCode 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 keys. '> - + - constante del algoritmo -de contraseña que representa el algoritmo a utilizar durante el hasheo de la contraseña.'> +constante del algoritmo de contraseña que representa el algoritmo a utilizar durante el hasheo de la contraseña.'> - password_hash.'> +password_hash.'> - las constantes del algoritmo de contraseña - para la documentación sobre las opciones soportadas para cada algoritmo.'> +las constantes del algoritmo de contraseña para la documentación sobre las opciones soportadas para cada algoritmo.'> - + - + - + 8.1.0 - El parámetro dictionary ahora espera una instancia de - PSpell\Dictionary ; anteriormente, se esperaba un &resource;. + El parámetro dictionary ahora espera una instancia de PSpell\Dictionary + ; anteriormente, se esperaba un &resource;. '> - + 8.1.0 - El parámetro config ahora espera una instancia de - PSpell\Config ; anteriormente, se esperaba un &resource;. + El parámetro config ahora espera una instancia de PSpell\Config + ; anteriormente, se esperaba un &resource;. '> - Una instancia de PSpell\Dictionary.'> +Una instancia de PSpell\Dictionary.'> - Una instancia de PSpell\Config.'> +Una instancia de PSpell\Config.'> - + - rnp_ffi_create.'> +rnp_ffi_create.'> - + - -RNP_LOAD_SAVE_*.'> +RNP_LOAD_SAVE_*.'> - + - - 8.0.0 - - socket ahora es una instancia de Socket ; - anteriormente, era un resource. - -'> + + 8.0.0 + + socket ahora es una instancia de Socket ; + anteriormente, era un resource. + + '> - + 8.0.0 address ahora es una instancia de AddressInfo ; @@ -1580,25 +1543,25 @@ RNP_LOAD_SAVE_*.'> '> - + - + - + - + - + - + - + - + - + - + callback @@ -1606,7 +1569,7 @@ RNP_LOAD_SAVE_*.'> Debe retornar un valor válido de retorno Gearman. - Si no se proporciona una instrucción de retorno, el valor por omisión será GEARMAN_SUCCESS. + Si no se proporciona una instrucción de retorno, el valor predeterminado será GEARMAN_SUCCESS. intcallback @@ -1634,166 +1597,148 @@ RNP_LOAD_SAVE_*.'> '> - + - El callback solo será disparado para las tareas que son añadidas (por ejemplo llamando a GearmanClient::addTask) - después de la llamada a este método. + El callback solo será disparado para las tareas que son añadidas (por ejemplo llamando a GearmanClient::addTask) después + de la llamada a este método. '> - - Lista de Zonas Horarias Soportadas'> + +Lista de Zonas Horarias Soportadas'> - Aquí, se encuentra una lista completa de las -zonas horarias soportadas por PHP, que pueden ser utilizadas con, por ejemplo, -date_default_timezone_set. + +Aquí, se encuentra una lista completa de las zonas horarias soportadas por PHP, que +pueden ser utilizadas con, por ejemplo, date_default_timezone_set. El comportamiento de las zonas horarias que no están listadas aquí es indefinido. - -La última versión de la base de datos de zonas horarias puede - ser instalada vía el comando PECL - timezonedb. + La última versión de la base de datos de zonas horarias puede ser instalada +vía el comando PECL timezonedb. "> - -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. + 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. '> - -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 -Etc/GMT+n y Etc/GMT-n están invertidas -respecto al uso común. + + 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 Etc/GMT+n y + Etc/GMT-n están invertidas respecto al uso común. -Por ejemplo, la zona horaria 8 horas después de GMT que se utiliza en China y -en Australia Occidental es actualmente Etc/GMT-8 en -esta base de datos, y no Etc/GMT+8 como se podría esperar. + Por ejemplo, la zona horaria 8 horas después de GMT que se utiliza en China + y en Australia Occidental es actualmente + Etc/GMT-8 en esta base de datos, y no + Etc/GMT+8 como se podría esperar. -Una vez más, se recomienda encarecidamente que se utilice la zona horaria correcta -para su ubicación, como Asia/Shanghai o -Australia/Perth para los ejemplos anteriores. + Una vez más, se recomienda encarecidamente que se utilice la zona horaria + correcta para su ubicación, como Asia/Shanghai o + Australia/Perth para los ejemplos anteriores. '> - -Estas abreviaturas de zonas horarias deben ser consideradas como no permanentes, es decir -pueden ser diferentes para cada versión de la base de datos de zonas horarias, y por lo tanto no deben ser utilizadas. Se recomienda encarecidamente evitarlas. + +Estas abreviaturas de zonas horarias deben ser consideradas como no permanentes, es decir pueden +ser diferentes para cada versión de la base de datos de zonas horarias, y por lo +tanto no deben ser utilizadas. Se recomienda encarecidamente evitarlas. '> - -Cada llamada a una función de fecha/hora generará un diagnóstico de tipo -E_WARNING si la zona horaria no es válida. -Ver también date_default_timezone_set'> + +Cada llamada a una función de fecha/hora generará un diagnóstico de tipo E_WARNING +si la zona horaria no es válida. Ver también date_default_timezone_set'> - 5.1.0 - Emite un mensaje de tipo E_STRICT y E_NOTICE - durante errores de zonas horarias.'> +5.1.0 +Emite un mensaje de tipo E_STRICT y E_NOTICE +durante errores de zonas horarias.'> - timestamp - El parámetro opcional timestamp es un timestamp - Unix de tipo &integer; que por omisión es la hora actual local si - timestamp es omitido o &null;. En otras - palabras, es por omisión el valor de la función time. -'> - - object -Solo en estilo procedimental: un objeto DateTime - retornado por date_create'> - - object -Solo en estilo procedimental: Un objeto DateTime - retornado por la función date_create. - Esta función modifica este objeto.'> - - -object - Solo en estilo procedimental: un objeto DateTimeZone - retornado por timezone_open +El parámetro opcional timestamp es un +int timestamp Unix que por defecto es la hora +local actual si timestamp se omite o es &null;. En +otras palabras, por defecto toma el valor de time. '> - DateTime para encadenar métodos&return.falseforfailure;.'> - DateTime para encadenar métodos.'> - DateTimeImmutable con los datos modificados &return.falseforfailure;.'> - DateTimeImmutable con los datos modificados.'> - - - - - - - - - - - - - - - - - formatos de Fecha y Hora.'> - - - - DOMNode::appendChild.'> - - Aunque el HTML mal-formado debería cargarse con éxito, esta función puede generar -una advertencia de tipo E_WARNING cuando encuentre una mala etiqueta. -Las funciones de manejo de errores libxml -pueden ser utilizadas para manejar estos errores.'> - - - La extensión DOM utiliza el codificado UTF-8. Utilice mb_convert_encoding, - UConverter::transcode, o iconv para manipular otros codificados. -'> - - +object +Solo en estilo procedimental: un objeto DateTime retornado +por date_create'> + +object +Solo en estilo procedimental: Un objeto DateTime retornado +por la función date_create. +Esta función modifica este objeto.'> + + +object Solo en estilo procedimental: un objeto DateTimeZone retornado +por timezone_open '> + +DateTime para encadenar métodos&return.falseforfailure;.'> +DateTime para encadenar métodos.'> +DateTimeImmutable con los datos modificados &return.falseforfailure;.'> +DateTimeImmutable con los datos modificados.'> + + + + + + + + + + + + + + + + +formatos de Fecha y Hora.'> + + + +DOMNode::appendChild.'> + +Aunque el HTML mal-formado debería cargarse con éxito, esta función puede generar una advertencia de tipo E_WARNING cuando encuentre una mala etiqueta.Las funciones de manejo de errores libxmlpueden ser utilizadas para manejar estos errores.'> +La extensión DOM utiliza el codificado UTF-8. Utilice mb_convert_encoding, UConverter::transcode, o iconv para manipular otros codificados.'> + - 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. + 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. '> - - Al utilizar json_encode sobre un objeto - DOMDocument el resultado será el de codificar un objeto vacío. -'> - + Al utilizar json_encode sobre un objeto DOMDocument el resultado será el de codificar un objeto vacío.'> + - Utilice Dom\HTMLDocument para analizar y tratar el HTML moderno en lugar de DOMDocument. + Utilice Dom\HTMLDocument para analizar y tratar el HTML moderno en + lugar de DOMDocument. - 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. + 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. El comportamiento durante el análisis del HTML puede depender de la versión de - libxml 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, + libxml 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 Dom\HTMLDocument::createFromString o Dom\HTMLDocument::createFromFile, añadidos en PHP 8.4. - 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 - DOMDocument ve puede ser diferente de la que un navegador - web ve, lo que puede permitir potencialmente a un atacante comprometer el HTML - resultante. + 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 + DOMDocument ve puede ser diferente de la que un + navegador web ve, lo que puede permitir potencialmente a un atacante comprometer el + HTML resultante. '> - + Levanta una ValueError si @@ -1813,12 +1758,12 @@ pueden ser utilizadas para manejar estos errores.'> espacios ASCII. - -'> +'> + - - El siguiente ejemplo -utiliza el archivo book.xml, cuyo contenido es: + + +El siguiente ejemplo utiliza el archivo book.xml, cuyo contenido es: book.xml, cuyo contenido es: ]]>'> - - - Operación de 'OR' lógica + + + Operación a nivel de bits OR de las constantes de opción libxml. '> - También es posible pasar Dom\HTML_NO_DEFAULT_NS 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. - '> +'> - - El codificado en el cual el documento fue creado. - Si no se proporciona, intentará determinar el codificado más probable utilizado. - '> + + El codificado en el cual el documento + fue creado. Si no se proporciona, intentará determinar el codificado más probable utilizado. +'> - + &reftitle.notes; - Los espacios en blanco en las etiquetas html y head - no son considerados significativos y pueden perder su formato. + Los espacios en blanco en las etiquetas html y head no + son considerados significativos y pueden perder su formato. '> - + registerNodeNS Indica si se deben registrar automáticamente los prefijos de espacio de nombres en vigor del nodo de contexto en el objeto DOMXPath. - Esto puede ser utilizado para evitar tener que llamar manualmente a DOMXPath::registerNamespace 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. + Esto puede ser utilizado para evitar tener que llamar manualmente a DOMXPath::registerNamespace 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. '> - - Opciones adicionales. - Las opciones LIBXML_NOEMPTYTAG - y LIBXML_NOXMLDECL son soportadas. - Antes de PHP 8.3.0, solo la opción LIBXML_NOEMPTYTAG + + Opciones adicionales. Las + opciones LIBXML_NOEMPTYTAG + y LIBXML_NOXMLDECL son soportadas. Antes + de PHP 8.3.0, solo la opción LIBXML_NOEMPTYTAG era soportada. '> - + DOM_HIERARCHY_REQUEST_ERR @@ -1909,7 +1854,7 @@ utiliza el archivo book.xml, cuyo contenido es: '> - + DOM_HIERARCHY_REQUEST_ERR @@ -1920,17 +1865,17 @@ utiliza el archivo book.xml, cuyo contenido es: '> - + DOM_WRONG_DOCUMENT_ERR - Se levanta si uno de los nodes transmitidos ha sido creado a partir de un documento diferente - del que creó este nodo. + Se levanta si uno de los nodes transmitidos ha sido creado a partir + de un documento diferente del que creó este nodo. '> - + Levanta una excepción Dom\DOMException con el código Dom\WRONG_DOCUMENT_ERR si el node @@ -1938,7 +1883,7 @@ utiliza el archivo book.xml, cuyo contenido es: '> - + Levanta una excepción ValueError si options contiene una opción inválida. @@ -1951,14 +1896,14 @@ utiliza el archivo book.xml, cuyo contenido es: '> - DOMException con el código DOM_HIERARCHY_REQUEST_ERR.'> - + - Un array de XPaths para filtrar los nodos. - Cada entrada en este array es un array asociativo con: + Un array de XPaths para filtrar los nodos. Cada + entrada en este array es un array asociativo con: @@ -1974,200 +1919,196 @@ utiliza el archivo book.xml, cuyo contenido es: '> - - + + En caso de fallo, se emitirá una advertencia de tipo E_WARNING. '> - El puntero de archivo debe ser válido y apuntar -a un archivo abierto con éxito por fopen o -fsockopen (y no cerrado aún por fclose).'> +El puntero de fichero debe ser válido y apuntar a un +archivo abierto con éxito por fopen o +fsockopen (y no cerrado aún por +fclose).'> - Un puntero del sistema de archivos de tipo &resource; -que es habitualmente creado utilizando la función fopen.'> +Un puntero al sistema de ficheros de tipo resource +que típicamente se crea utilizando fopen.'> - - 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 archivos de - tamaño superior a 2 Go. -'> + + 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. + '> - -A partir de PHP 5.6.1 también puede ser especificado como INI_SCANNER_TYPED. -En este modo los booleanos, null y enteros son preservados tanto como sea posible. -Las cadenas de caracteres "true", "on" y "yes" -son convertidas a &true;. "false", "off", "no" -y "none" son considerados como &false;. "null" es convertido a &null; en este modo. Además todas las cadenas de caracteres numéricas son convertidas a entero si es posible. -'> + + A partir de PHP 5.6.1 también puede ser especificado como INI_SCANNER_TYPED. + En este modo los booleanos, null y enteros son preservados tanto como sea posible. Las + cadenas de caracteres "true", "on" y "yes" + son convertidas a &true;. "false", "off", "no" + y "none" son considerados como &false;. "null" es convertido a &null; + en este modo. Además todas las cadenas de caracteres numéricas son convertidas a entero si es posible. + '> + + +El identificador gnupg, generado por una llamada a la función +gnupg_init o a la función gnupg.'> - - El identificador gnupg, generado por una llamada -a la función gnupg_init o a la función -gnupg.'> +La huella de la clave.'> - La huella de la clave.'> + +Emite una excepción HaruException en caso de error.'> - - Emite una excepción HaruException en caso de error.'> + +El objeto de conexión ODBC, ver la documentación de +la función odbc_connect para más detalles.'> - - El objeto de conexión ODBC, -ver la documentación de la función odbc_connect para más -detalles.'> + - + - + - + - + - % para buscar cero o más caracteres, y _ para buscar un solo carácter.'> +% para buscar cero o más caracteres, +y _ para buscar un solo carácter.'> - + - + 8.4.0 - odbc ahora espera una instancia de - Odbc\Connection; anteriormente, se esperaba un resource. + odbc ahora espera una instancia de Odbc\Connection + ; anteriormente, se esperaba un resource. '> - + 8.4.0 - Esta función ahora devuelve una instancia de - Odbc\Connection; anteriormente, se devolvía un resource. + Esta función ahora devuelve una instancia de Odbc\Connection; anteriormente, + se devolvía un resource. '> - + 8.4.0 - user y password ahora pueden ser nulos, - también son opcionales y valen por omisión &null;. + user y password ahora pueden ser + nulos, también son opcionales y valen por defecto &null;. - - + + 8.4.0 - Anteriormente, el uso de una cadena vacía para password - no incluía pwd en la cadena de conexión generada - para dsn. - Ahora, pwd se incluye en la cadena de conexión, con - un valor de cadena vacía. - Para restaurar el comportamiento anterior, password puede - ser definido como &null;. + Anteriormente, el uso de una cadena vacía para password no incluía + pwd en la cadena de conexión generada para dsn + . Ahora, pwd se incluye en la cadena de conexión, con un valor de + cadena vacía. Para restaurar el comportamiento anterior, password puede ser definido como &null;. - - + + 8.4.0 - Anteriormente, si dsn contenía uid o pwd, - entonces los parámetros user y password eran ignorados. - Ahora, user solo es ignorado si dsn contiene - uid, y password solo es ignorado si - dsn contiene pwd. + Anteriormente, si dsn contenía uid o pwd + , entonces los parámetros user y password eran ignorados. + Ahora, user solo es ignorado si dsn contiene + uid, y password solo es ignorado si + dsn contiene pwd. - -'> + '> - + 8.4.0 - statement ahora espera una instancia de - Odbc\Result; anteriormente, se esperaba un resource. + statement ahora espera una instancia de Odbc\Result + ; anteriormente, se esperaba un resource. '> - + 8.4.0 - Esta función ahora devuelve una instancia de - Odbc\Result; anteriormente, se devolvía un resource. + Esta función ahora devuelve una instancia de Odbc\Result + ; anteriormente, se devolvía un resource. '> - - E_ERROR - si la función de devolución de llamada no puede ser llamada o no ha sido especificada.'> + +E_ERROR si +la función de devolución de llamada no puede ser llamada o no ha sido especificada.'> - + - - -Contiene la instancia Oracle a la que debemos conectarnos. -Esto puede ser una cadena de conexión - rápida, un nombre de conexión del archivo tnsnames.ora, -o el nombre de una instancia local Oracle. -Si no se especifica o es &null;, PHP utiliza variables de entorno como TWO_TASK (en Linux) + + Contiene la +instancia Oracle a la que debemos conectarnos. Esto puede ser +una cadena de conexión +rápida, un nombre de conexión del +fichero tnsnames.ora, o el nombre de una instancia +local Oracle. + +Si no se especifica o es &null;, PHP +utiliza variables de entorno como TWO_TASK (en Linux) o LOCAL (en Windows) y ORACLE_SID para determinar la instancia Oracle a la que debemos conectarnos. -Para usar el método de conexión rápida, PHP debe estar vinculado con la biblioteca -cliente Oracle 10g o superior. La cadena de conexión rápida para Oracle +Para usar el método de conexión rápida, PHP debe estar vinculado con la biblioteca cliente Oracle +10g o superior. La cadena de conexión rápida para Oracle 10g o superior es de la forma: [//]host_name[:port][/service_name]. Desde Oracle 11g, la sintaxis es: [//]host_name[:port][/service_name][:server_type][/instance_name]. - Opciones adicionales fueron introducidas con Oracle 19c -Los nombres de los servicios pueden ser encontrados ejecutando la utilidad -Oracle lsnrctl status en la máquina que ejecuta -la base de datos. +Opciones adicionales fueron introducidas con Oracle 19c Los +nombres de los servicios pueden ser encontrados ejecutando la +utilidad Oracle lsnrctl status en la máquina que ejecuta la base +de datos. -El archivo tnsnames.ora puede estar en el camino -de búsqueda de Oracle Net, que incluye -/your/path/to/instantclient/network/admin, $ORACLE_HOME/network/admin -y /etc. -Una solución alternativa sería definir TNS_ADMIN -para que el archivo $TNS_ADMIN/tnsnames.ora sea leído. -Asegúrese de que el demonio que ejecuta el servidor web tenga acceso de lectura a este -archivo. +El fichero tnsnames.ora puede estar en el camino de búsqueda de Oracle Net, +que +incluye /your/path/to/instantclient/network/admin, $ORACLE_HOME/network/admin +y /etc. Una solución alternativa sería definir TNS_ADMIN +para que el fichero $TNS_ADMIN/tnsnames.ora sea leído. Asegúrese de que el demonio que ejecuta +el servidor web tenga acceso de lectura a este fichero. "> - Determina +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. +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. Si no se especifica, la biblioteca -cliente Oracle determinará un juego de caracteres desde la variable de entorno -NLS_LANG. +cliente Oracle determinará un juego de caracteres desde la variable de +entorno NLS_LANG. Pasar este parámetro puede reducir el tiempo de conexión. "> - Este parámetro -está disponible a partir de PHP 5 (PECL OCI8 1.1) y acepta los siguientes valores: -OCI_DEFAULT, OCI_SYSOPER y -OCI_SYSDBA. -Si bien la constante OCI_SYSOPER o la constante +Este +parámetro está disponible a partir de PHP 5 (PECL OCI8 1.1) y acepta los +siguientes valores: OCI_DEFAULT, +OCI_SYSOPER y OCI_SYSDBA. Si +bien la constante OCI_SYSOPER o la constante OCI_SYSDBA es especificada, esta función intentará establecer -una conexión privilegiada usando identidades externas. Las -conexiones privilegiadas están desactivadas por omisión. Para activarlas, debe +una conexión privilegiada usando identidades externas. +Las conexiones privilegiadas están desactivadas por defecto. Para activarlas, debe definir la opción oci8.privileged_connect a On. PHP 5.3 (PECL OCI8 1.3.4) introducen el valor de modo -OCI_CRED_EXT. 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 OCI_CRED_EXT -solo puede ser usado con el nombre de usuario "/" asociado a una contraseña vacía. -La opción oci8.privileged_connect +OCI_CRED_EXT. 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 OCI_CRED_EXT solo puede ser usado con el nombre +de usuario "/" asociado a una contraseña vacía. La opción +oci8.privileged_connect puede ser definida a On o Off. @@ -2176,155 +2117,163 @@ puede ser definida a On o Off. OCI_SYSDBA. -OCI_CRED_EXT no es soportado en Windows por razones de seguridad. +OCI_CRED_EXT no es soportado en Windows por razones +de seguridad. '> - Para más detalles sobre el mapeo de tipos de datos -realizado por la extensión OCI8, lea los tipos de datos - soportados por el driver.'> +Para más detalles sobre el mapeo de tipos de datos realizado +por la extensión OCI8, lea los tipos +de datos soportados por el driver.'> - Un identificador de conexión Oracle, -devuelto por la función oci_connect, oci_pconnect -o la función oci_new_connect.'> +Un identificador de conexión Oracle, devuelto +por la función oci_connect, oci_pconnect o la +función oci_new_connect.'> - Requerido por la versión Oracle -Esta función está disponible si PHP está vinculado a partir de la versión 10g - de la biblioteca de la base de datos Oracle.'> +Requerido por la versión Oracle +Esta función está disponible si PHP está vinculado a partir +de la versión 10g de la biblioteca de la base de datos Oracle.'> - RendimientoCon versiones antiguas de OCI8 o bases de datos Oracle antiguas, la información del cliente - puede ser definida usando el paquete Oracle DBMS_APPLICATION_INFO. - Esto es menos eficiente que usar la función - oci_set_client_info.'> +RendimientoCon versiones antiguas de OCI8 +o bases de datos Oracle antiguas, la información del cliente puede ser definida usando el paquete Oracle +DBMS_APPLICATION_INFO. Esto es menos eficiente que usar la +función oci_set_client_info.'> - Ida y vuelta -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é. +Ida y vuelta +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é. '> - 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 -oci8.default_prefetch +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 oci8.default_prefetch o usando la función oci_set_prefetch. '> - Un identificador de consulta OCI8 -creado por la función oci_parse y ejecutado por la función -oci_execute, o un identificador de consulta REF - CURSOR."> - - El parámetro -status es el parámetro status pasado a una llamada -de pcntl_waitpid que tuvo éxito.'> +Un identificador de consulta OCI8 +creado por la función oci_parse y ejecutado por +la función oci_execute, o un identificador de consulta REF +CURSOR."> - - 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.'> + +El parámetro status +es el parámetro status pasado a una +llamada de pcntl_waitpid que tuvo éxito.'> - Esta función es afectada por - la directiva de configuración open_basedir.'> + +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.'> - Como esto es una estructura - del lenguaje, y no una función, no es posible llamarla - con las funciones variables o argumentos nombrados. -'> +Esta función es afectada por la directiva de configuración open_basedir.'> + + +Como esto es una estructura +del lenguaje, y no una función, no es posible llamarla con las +funciones variables +o argumentos nombrados. +'> + + +Esta extensión no define ninguna directiva de configuración.'> +Esta extensión no define ningún recurso.'> +Esta extensión no define ninguna constante.'> +No se requiere ninguna biblioteca externa para compilar esta extensión.'> +No hay instalación necesaria para usar estas +funciones, son parte del núcleo de PHP.'> + + +Aquí hay una aclaración sobre el uso de +las directivas de configuración.'> + + + + + +El comportamiento de estas funciones es afectado por la configuración en el archivo &php.ini;. +'> - - Esta extensión no define ninguna directiva de configuración.'> - Esta extensión no define ningún recurso.'> - Esta extensión no define ninguna constante.'> - No se requiere ninguna biblioteca externa para compilar esta extensión.'> - No hay instalación necesaria para -usar estas funciones, son parte del núcleo de PHP.'> - - - Aquí hay una aclaración sobre -el uso de las directivas de configuración.'> - - - - - El comportamiento de estas funciones es -afectado por la configuración en el archivo &php.ini;.'> - - .'> - - - 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.'> - - - Las constantes listadas aquí están -siempre disponibles en PHP.'> - - - Estas clases son definidas por esta -extensión, y solo estarán disponibles si esta extensión ha sido compilada -con PHP, o bien cargada dinámicamente.'> - - - 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. -PDO::getAttribute podría ser usado para obtener -el atributo PDO::ATTR_DRIVER_NAME para verificar el -controlador, si su código puede funcionar en múltiples controladores.'> - - - Una excepción será emitida incluso si el atributo PDO::ATTR_ERRMODE no vale - PDO::ERRMODE_EXCEPTION.'> - - - - +.'> + + + +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. +'> + + + +Las constantes listadas aquí están siempre disponibles en PHP. +'> + + + +Estas clases son definidas por esta extensión, y +solo estarán disponibles si esta extensión ha +sido compilada con PHP, o bien cargada dinámicamente. +'> + + +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. PDO::getAttribute podría ser usado para obtener +el atributo PDO::ATTR_DRIVER_NAME para verificar el controlador, +si su código puede funcionar en múltiples controladores.'> + +Una excepción será emitida incluso si el atributo PDO::ATTR_ERRMODE no vale PDO::ERRMODE_EXCEPTION.'> + + + + Emite un error de nivel E_WARNING si el atributo PDO::ATTR_ERRMODE está definido a PDO::ERRMODE_WARNING. -Lanza una excepción PDOException si el atributo PDO::ATTR_ERRMODE está definido -a PDO::ERRMODE_EXCEPTION. +Lanza una excepción PDOException si el atributo PDO::ATTR_ERRMODE +está definido a PDO::ERRMODE_EXCEPTION. '> - - + + - + - Instalación -de extensiones PECL. Otra información como notas sobre nuevas - versiones, descargas, fuentes de archivos, información sobre los mantenedores - así como un CHANGELOG, pueden ser encontradas aquí:'> +Instalación +de extensiones PECL. 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í:'> - SVN de +SVN de PECL aquí: '> - GIT - de PECL: '> +GIT de +PECL: '> - DLL para esta - extensión PECL actualmente disponible. Consulte la sección -Compilación en Windows.'> +DLL para esta extensión +PECL actualmente disponible. Consulte la sección +Compilación en Windows +.'> - DLL) - para esta extensión PECL están disponibles en el sitio web PECL.'> +DLL) +para esta extensión PECL están disponibles en el sitio web PECL.'> - + - + - + El instalador de Extensiones para PHP (PHP Installer for Extensions - PIE) es una nueva herramienta que reemplazará PECL. Recomendamos usar PIE para instalar extensiones. @@ -2332,310 +2281,298 @@ de extensiones PECL. Otra información como notas sobre nuevas '> - + Esta extensión es no mantenida. '> - - - Una instancia PgSql\Connection.'> - - - Una instancia PgSql\Connection. - Cuando connection no es especificado, se usa la conexión por defecto. - La conexión por defecto es la última conexión hecha por - pg_connect o pg_pconnect - Desde PHP 8.1.0, usar la conexión por defecto está obsoleto. -'> - - - Una instancia PgSql\Connection. - Cuando connection es &null;, se usa la conexión por defecto. - La conexión por defecto es la última conexión hecha por - pg_connect o pg_pconnect - Desde PHP 8.1.0, usar la conexión por defecto está obsoleto. - '> - - - Una instancia PgSql\Result, devuelta por pg_query, - pg_query_params, o pg_execute (entre otros). -'> + + +Una instancia PgSql\Connection.'> - Una instancia PgSql\Lob, devuelta por pg_lo_open.'> +Una PgSql\Connection instancia. +Cuando connection no es especificado, se usa la conexión por +defecto. La conexión predeterminada es la última conexión hecha por pg_connect +o pg_pconnect +Desde PHP 8.1.0, usar la conexión predeterminada está obsoleto. '> - + Una instancia PgSql\Connection. +Cuando connection es &null;, se usa la conexión predeterminada. +La conexión predeterminada es la última conexión hecha por pg_connect +o pg_pconnect +Desde PHP 8.1.0, usar la conexión predeterminada está obsoleto. '> + + Una instancia PgSql\Result, devuelta por pg_query, +pg_query_params, o pg_execute (entre otros).'> + +Una instancia PgSql\Lob, devuelta por pg_lo_open.'> + + Un parámetro opcional que controla cómo el array devuelto es indexado. mode es una constante que puede tomar los siguientes valores: PGSQL_ASSOC, PGSQL_NUM y PGSQL_BOTH. Usando PGSQL_NUM, la función devolverá un array con índices numéricos, -usando PGSQL_ASSOC, devolverá solo índices asociativos -mientras que PGSQL_BOTH devolverá ambos índices numéricos y asociativos.'> +usando PGSQL_ASSOC, devolverá solo índices asociativos mientras +que PGSQL_BOTH devolverá ambos índices numéricos y asociativos.'> - + 8.1.0 - El parámetro connection ahora espera una instancia de - PgSql\Connection ; anteriormente, se esperaba un &resource;. + El parámetro connection ahora espera una instancia de PgSql\Connection + ; anteriormente, se esperaba un &resource;. '> - + 8.1.0 - El parámetro result ahora espera una instancia de - PgSql\Result ; anteriormente, se esperaba un &resource;. + El parámetro result ahora espera una instancia de PgSql\Result + ; anteriormente, se esperaba un &resource;. '> - + 8.1.0 - El parámetro lob ahora espera una instancia de - PgSql\Lob ; anteriormente, se esperaba un &resource;. + El parámetro lob ahora espera una instancia de PgSql\Lob + ; anteriormente, se esperaba un &resource;. '> - + 8.1.0 - Ahora devuelve una instancia de PgSql\Result ; - anteriormente, se devolvía un &resource;. + Ahora devuelve una instancia de PgSql\Result ; anteriormente, + se devolvía un &resource;. '> - + + - 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.'> +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.'> - - safe mode'> + +safe mode'> - safe mode SQL'> +safe mode SQL'> - - - Si se proporciona un entero en el rango -128 y 255 inclusive, será interpretado como - el valor ASCII de un solo carácter (los valores negativos se verán añadir 256 para permitir - caracteres en el rango ASCII extendido). Cualquier otro entero será interpretado como - una cadena de caracteres que contiene los dígitos decimales del entero.'> + + +Si se proporciona un int 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.'> - -Desde PHP 8.1.0, pasar un argumento diferente de una cadena está obsoleto. -En el futuro, el argumento será interpretado como una cadena de caracteres en lugar de un punto de código ASCII. -Según el comportamiento deseado, el argumento debe ser convertido a &string; o debe realizarse una llamada explícita a chr."> + +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 chr.'> - + - - + + 8.1.0 - El parámetro ftp ahora espera una instancia de - FTP\Connection ; anteriormente, se esperaba un &resource;. + El parámetro ftp ahora espera una instancia de FTP\Connection + ; anteriormente, se esperaba un &resource;. '> - Una instancia de FTP\Connection.'> +Una instancia de FTP\Connection.'> - - GMP.'> - + +GMP.'> + Un objeto GMP, 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 gmp_init con detección automática de la base (es decir cuando base es igual a 0). + que si la cadena fuera usada en gmp_init con detección automática + de la base (es decir cuando base es igual a 0). '> - - + + resultSolo estilo procedimental: Un objeto mysqli_result devuelto por mysqli_query, mysqli_store_result, mysqli_use_result o mysqli_stmt_get_result.'> - -mysqlSolo estilo procedimental: Un objeto mysqli -devuelto por mysqli_connect o mysqli_init + +mysqlSolo estilo procedimental: Un objeto mysqli devuelto +por mysqli_connect o mysqli_init '> - -statementSolo estilo procedimental: Un objeto mysqli_stmt -devuelto por mysqli_stmt_init.'> - +statementSolo estilo procedimental: Un objeto mysqli_stmt devuelto +por mysqli_stmt_init.'> +mysqlnd.'> - -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á.Libmysqlclient utiliza el juego de caracteres predeterminado establecido en el -my.cnf o mediante una llamada explícita a mysqli_options antes de -llamar a mysqli_real_connect, pero después de mysqli_init.'> - + +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á.Libmysqlclient utiliza el juego de caracteres predeterminado establecido en el +my.cnf o mediante una llamada explícita a mysqli_options antes de llamar +a mysqli_real_connect, pero después de mysqli_init.'> + Si el número de filas es mayor que PHP_INT_MAX, el número será devuelto como un &string;.'> - -Advertencia de seguridad: Inyección SQLSi la consulta contiene alguna entrada de variable, -entonces se deben usar sentencias preparadas -parametrizadas en su lugar. Alternativamente, los datos deben estar correctamente formateados y todas las cadenas deben ser escapadas usando -la función mysqli_real_escape_string.'> - + +Advertencia de seguridad: Inyección SQLSi la consulta contiene alguna entrada de variable, entonces +se deben usar sentencias +preparadas parametrizadas en su lugar. Alternativamente, los datos +deben estar correctamente formateados y todas las cadenas deben ser escapadas usando la +función mysqli_real_escape_string +.'> + Si el informe de errores de mysqli está habilitado (MYSQLI_REPORT_ERROR) y la operación solicitada falla, -se genera una advertencia. Si, además, el modo está configurado como MYSQLI_REPORT_STRICT, -se lanza una mysqli_sql_exception en su lugar.'> +se genera una advertencia. Si, además, el modo está configurado como MYSQLI_REPORT_STRICT, se +lanza una mysqli_sql_exception en su lugar.'> - - + + Si el patrón regex pasado no se compila a una regex válida, se emite una E_WARNING. '> - - Esta función -es soportada cuando PHP está instalado como módulo de Apache. + +Esta función es soportada cuando PHP +está instalado como módulo de Apache. '> - - FPM (FastCGI Process Manager, gestor de procesos FastCGI) -es una alternativa a la implementación PHP FastCGI con funcionalidades adicionales útiles para sitios muy altamente cargados. -"> - - - SimpleXML añade propiedades - iterativas para casi todos sus métodos. Estas no pueden ser vistas - utilizando var_dump o cualquier otra función que examine los - objetos.'> - - - Los nombres de columnas devueltos por -SQLITE_ASSOC y SQLITE_BOTH -siguen las reglas concernientes a la case definidas por la opción de configuración -sqlite.assoc_case.'> - - Cuando decode_binary -vale &true; (por defecto), PHP va a decodificar los datos binarios, si estos han sido -codificados con la función sqlite_escape_string. -Generalmente se dejará este valor en su valor por defecto, -a menos que se esté trabajando con bases operadas por otras -aplicaciones.'> - - Esta función no funcionará con - resultados no bufferizados.'> - - Dos sintaxis alternativas son - soportadas para asegurar la compatibilidad con otras bases de datos - (tales como MySQL): la forma recomendada es la primera, donde el parámetro - dbhandle es el primero en la función.'> - - El parámetro opcional -result_type acepta una constante y determina cómo -el array devuelto debe ser indexado. El uso de -SQLITE_ASSOC devolverá únicamente un array asociativo -(nombres de los campos) mientras que SQLITE_NUM devolverá un -array indexado numéricamente (número ordinal de los campos). -SQLITE_BOTH devolverá índices numéricos y asociativos. -SQLITE_BOTH es el valor por defecto para esta -función.'> - - - Los nombres de los campos devueltos por - esta función son sensibles a la case.'> - - Esta función define los campos NULL al valor PHP &null;.'> - - - - -link_identifier - La conexión MySQL. - Si no se especifica, se utilizará la última conexión abierta con la función - mysql_connect. Si no se encuentra una conexión de este tipo, - la función intentará abrir una conexión, como si la función mysql_connect hubiera sido llamada sin argumento. - Si no se encuentra o establece una conexión, se generará una alerta de nivel - E_WARNING. -'> - - -link_identifier - La conexión MySQL. - Si el identificador del enlace no se especifica, se utilizará la última conexión - abierta con la función mysql_connect. - Si no se encuentra o establece una conexión, se generará una alerta de nivel - E_WARNING. -'> + +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. +'> - -result - La &resource; de resultado que acaba de ser evaluada. - Este resultado proviene de la llamada a la función mysql_query. -'> + +SimpleXML añade propiedades iterativas para casi +todos sus métodos. Estas no pueden ser vistas utilizando var_dump +o cualquier otra función que examine los objetos.'> + + +Los nombres de columnas devueltos por +SQLITE_ASSOC y SQLITE_BOTH siguen las reglas +concernientes a la case definidas por la opción de configuración +sqlite.assoc_case +.'> + +Cuando decode_binary +vale &true; (por defecto), PHP va a decodificar los datos +binarios, si estos han sido codificados con la función +sqlite_escape_string. Generalmente se dejará este valor +en su valor predeterminado, a menos que se esté trabajando con bases +operadas por otras aplicaciones.'> + +Esta función no funcionará con +resultados no bufferizados.'> + +Dos sintaxis alternativas son soportadas +para asegurar la compatibilidad con otras bases de datos (tales como MySQL): +la forma recomendada es la primera, donde el parámetro dbhandle +es el primero en la función.'> + +El parámetro opcional result_type +acepta una constante y determina cómo el array devuelto debe ser indexado. El +uso de SQLITE_ASSOC devolverá únicamente un array asociativo (nombres +de los campos) mientras que SQLITE_NUM devolverá un +array indexado numéricamente (número ordinal de los campos). SQLITE_BOTH +devolverá índices numéricos y asociativos. +SQLITE_BOTH es el valor predeterminado para esta función.'> + + +Los nombres de los campos devueltos por esta función +son sensibles a la case.'> + +Esta función define los campos NULL +al valor PHP &null;.'> + + + + +link_identifier La conexión MySQL. Si no +se especifica, se utilizará la última conexión abierta con la función +mysql_connect. Si no se encuentra una conexión de este tipo, la +función intentará abrir una conexión, como si la función mysql_connect hubiera sido llamada sin +argumento. Si no se encuentra o establece una conexión, se generará una alerta de nivel +E_WARNING. +'> - -field_offset - La posición numérica del campo. - field_offset comienza en 0. - Si field_offset no existe, se generará una alerta de nivel - E_WARNING. + +link_identifier La conexión MySQL. Si el identificador del +enlace no se especifica, se utilizará la última conexión abierta con la función +mysql_connect. Si no se encuentra o establece una conexión, se generará una +alerta de nivel E_WARNING. '> - 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 MySQLi o la extensión -PDO_MySQL. Ver también -MySQL: elegir una API de la guía. -Alternativas a esta función:'> - - Esta función estaba obsoleta -en PHP 4.3.0, y toda la extensión original MySQL fue eliminada en PHP 7.0.0. -En su lugar, se puede utilizar la extensión MySQLi o la extensión -PDO_MySQL. Ver también MySQL: elegir -una API de la guía. Alternativas a esta función:'> - - Esta función estaba obsoleta -en PHP 5.3.0, y toda la extensión original MySQL fue eliminada en PHP 7.0.0. -En su lugar, se puede utilizar la extensión MySQLi o la extensión -PDO_MySQL. Ver también MySQL: elegir -una API de la guía. -Alternativas a esta función:'> - - Esta función estaba obsoleta -en PHP 5.4.0, y toda la extensión original MySQL fue eliminada en PHP 7.0.0. -En su lugar, se puede utilizar la extensión MySQLi o la extensión -PDO_MySQL. Ver también MySQL: elegir - una API de la guía. Alternativas a esta función:'> - - Esta función estaba obsoleta -en PHP 5.5.0, y toda la extensión original MySQL fue eliminada en PHP 7.0.0. -En su lugar, se puede utilizar la extensión MySQLi o la extensión -PDO_MySQL. Ver también MySQL: elegir - una API de la guía. Alternativas a esta función:'> - - -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 + +resultEl resource de +resultado que está siendo evaluado. Este resultado proviene de una llamada a +mysql_query.'> + + +field_offset La posición numérica del campo. +field_offset comienza en 0. Si +field_offset no existe, se generará una alerta de nivel +E_WARNING.'> + +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 MySQLi o la extensión PDO_MySQL. Ver +también MySQL: elegir una API de +la guía. Alternativas a esta función:'> + +Esta función estaba obsoleta en PHP 4.3.0, y +toda la extensión original MySQL fue eliminada en PHP 7.0.0. En +su lugar, se puede utilizar la extensión MySQLi o la extensión PDO_MySQL. +Ver también MySQL: elegir una API de +la guía. Alternativas a esta función:'> + +Esta función estaba obsoleta en PHP 5.3.0, y +toda la extensión original MySQL fue eliminada en PHP 7.0.0. En +su lugar, se puede utilizar la extensión MySQLi o la extensión PDO_MySQL. +Ver también MySQL: elegir una API de +la guía. Alternativas a esta función:'> + +Esta función estaba obsoleta en PHP 5.4.0, y +toda la extensión original MySQL fue eliminada en PHP 7.0.0. En +su lugar, se puede utilizar la extensión MySQLi o la extensión PDO_MySQL. +Ver también MySQL: elegir una API de +la guía. Alternativas a esta función:'> + +Esta función estaba obsoleta en PHP 5.5.0, y +toda la extensión original MySQL fue eliminada en PHP 7.0.0. En +su lugar, se puede utilizar la extensión MySQLi o la extensión PDO_MySQL. +Ver también MySQL: elegir una API de +la guía. Alternativas a esta función:'> + + +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 liberación de recursos'> - - 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 los usuarios con privilegios -root. xattr opera sobre el espacio de nombres user por -defecto, pero esto puede ser cambiado utilizando el argumento + +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 flags.'> - - Al especificar direcciones - IPv6 en formato numérico (ej. fe80::1) se debe colocar la dirección IP - entre corchetes. Por ejemplo: tcp://[fe80::1]:80. -'> - - - Tidy'> - - El parámetro config puede -tomar la forma de un array o de una cadena de caracteres. En forma de cadena, representa el nombre del archivo de configuración y de lo contrario, es -un array con las opciones de configuración. Lea &url.tidy.conf; para saber más sobre cada -opción. -El parámetro encoding especifica el juego de caracteres -utilizado para los documentos de entrada y salida. Los valores posibles de -encoding son: + +Al especificar direcciones IPv6 en formato numérico +(ej. fe80::1) se debe colocar la dirección IP entre corchetes. +Por ejemplo: tcp://[fe80::1]:80.'> + + +Tidy'> + +El parámetro config puede +tomar la forma de un array o de una cadena de caracteres. En forma de cadena, +representa el nombre del fichero de configuración y de lo contrario, es un array +con las opciones de configuración. Lea +&url.tidy.conf; +para saber más sobre cada opción. El parámetro +encoding especifica el juego de caracteres utilizado para los documentos +de entrada y salida. Los valores posibles de encoding son: ascii, latin0, latin1, raw, utf8, iso2022, mac, win1252, ibm858, @@ -2643,90 +2580,84 @@ utilizado para los documentos de entrada y salida. Los valores posibles de utf16be, big5 y shiftjis.'> - - No se recomienda - el uso de PHP en un entorno thread MPM, con Apache 2. - Utilice el modo prefork MPM, que es el MPM por defecto para Apache 2.0 y 2.2. - Para saber por qué, lea - la entrada de la FAQ correspondiente a la - utilización de Apache 2 en un entorno thread MPM.'> - + +No se recomienda el uso de PHP +en un entorno thread MPM, con Apache 2. Utilice el modo prefork MPM, que es +el MPM predeterminado para Apache 2.0 y 2.2. Para +saber por qué, lea la entrada de la FAQ correspondiente a la +utilización de Apache 2 en un entorno thread MPM.'> + - 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 - la zona de descargas oficial. + 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 la zona de descargas + oficial. '> - Recuerde que al añadir - valores que representan una ruta en la configuración de Apache bajo Windows, - todos los backslash, como c:\directorio\archivo.ext, deben ser - convertidos a slashes, como - c:/directorio/archivo.ext. Un slash final puede - también ser necesario para los directorios.'> - - - +Recuerde que al añadir valores +que representan una ruta en la configuración de Apache bajo Windows, todos los +backslash, como c:\directorio\fichero.ext, deben ser convertidos a +slashes, como c:/directorio/fichero.ext. Un slash +final puede también ser necesario para los directorios.'> + + + + +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. +'> - 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.'> + - + - + - + - + - + - + - + +Esta función no puede +ser utilizada para manipular el método en curso de utilización (o encadenado). +'> - - Esta función - no puede ser utilizada para manipular el método en curso de utilización (o encadenado). +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 +runkit.internal_override en el archivo &php.ini; del sistema entero. '> - Por defecto, solo - las funciones definidas por el usuario pueden ser eliminadas, - renombradas o modificadas. Para sobreescribir funciones internas, se - debe activar la configuración runkit.internal_override - en el archivo &php.ini; del sistema entero.'> - - - El publickey subsystem - es utilizado para gestionar las claves públicas en un servidor en el cual el cliente - ya está identificado. Para identificarse a un sistema - remoto utilizando la identificación por clave pública, utilice la función - ssh2_auth_pubkey_file en su lugar.'> - - - - - - -writer - Únicamente para llamadas procedimentales. - La instancia XMLWriter que es modificada. - Este objeto proviene de una llamada a xmlwriter_open_uri - o xmlwriter_open_memory. -'> + +El publickey subsystem es +utilizado para gestionar las claves públicas en un servidor en el cual el cliente ya está +identificado. Para identificarse a un sistema remoto utilizando la +identificación por clave pública, utilice la función +ssh2_auth_pubkey_file en su lugar.'> + + + + + + +writer Únicamente para llamadas procedimentales. La +instancia XMLWriter que es modificada. Este objeto proviene de una llamada a xmlwriter_open_uri o xmlwriter_open_memory.'> - + 8.0.0 writer ahora espera una instancia de XMLWriter @@ -2734,128 +2665,129 @@ continuamente incluidas en el manual, trabajo del cual estamos muy agradecidos. '> - - Esta función solo está disponible en modo WSDL."> - - - linkEstilo procedimental únicamente: El identificador stomp devuelto por la funciónstomp_connect."> - headersArray asociativo que contiene los encabezados adicionales (ejemplo: receipt)."> - Un encabezado de transacción puede ser especificado, indicando que la confirmación de los mensajes debe ser parte de la transacción."> - 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."> - - - 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 realpath, - o la instrucción dirname(__FILE__)."> - constantes de estado para los valores posibles.'> - constantes de tipo para los valores posibles.'> - - - Recurso de red neuronal.'> - Recurso de datos de entrenamiento de la red neuronal.'> - O bien un recurso de red neuronal, o un recurso de datos de entrenamiento de una red neuronal.'> - No devuelve ningún valor.'> - Devuelve &true; en caso de éxito, &false; de lo contrario.'> - Devuelve un recurso de red neuronal en caso de éxito, o &false; si ocurre un error.'> - Devuelve un recurso de datos de entrenamiento en caso de éxito, o &false; si ocurre un error.'> - Esta función ahora está disponible si la extensión fann ha sido compilada -con libfann >= 2.2.'> - - - - ImagickException si ocurre un error.'> - ImagickDrawException si ocurre un error.'> - ImagickPixelException si ocurre un error.'> - ImagickPixelIteratorException si ocurre un error.'> - - - - - - - - - - - - - - - - - - - - - - - - - Esta función está DEPRECADA a partir de Imagick 3.4.4. Depender de esta funcionalidad está fuertemente desaconsejado.'> - Imagick::CHANNEL_DEFAULT. Consúltese la lista de constantes de canales'> - - - - - - constantes de canales utilizando un operador a nivel de bits. &imagick.default.channel.info;'> - - - - - +Esta función solo está disponible en modo WSDL."> + + +linkEstilo procedimental únicamente: El identificador stomp devuelto por la funciónstomp_connect."> +headersArray asociativo que contiene los encabezados adicionales (ejemplo: receipt)."> +Un encabezado de transacción puede ser especificado, indicando que la confirmación de los mensajes debe ser parte de la transacción."> +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."> + + +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 realpath, o la instrucción dirname(__FILE__)."> +constantes de estado para los valores posibles.'> +constantes de tipo para los valores posibles.'> + + +Un resource de red neuronal.'> +Un resource de datos de entrenamiento de red neuronal.'> +O bien un resource de red neuronal, o un resource de datos de entrenamiento de red neuronal.'> +No devuelve ningún valor.'> +Devuelve &true; en caso de éxito, &false; de lo contrario.'> +Devuelve un resource de red neuronal en caso de éxito, o &false; en caso de error.'> +Devuelve un resource de datos de entrenamiento en caso de éxito, o &false; en caso de error.'> +Esta función ahora está disponible si la extensión fann ha sido compilada con libfann >= 2.2.'> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Esta función está DEPRECADA a partir de Imagick 3.4.4. Depender de esta funcionalidad está fuertemente desaconsejado.'> + + +Imagick::CHANNEL_DEFAULT. Consúltese la lista de constantes de canales'> + + + + + +constantes de canales utilizando un operador a nivel de bits. &imagick.default.channel.info;'> + + + + +ImagickException en caso de fallo.'> - - - El comportamiento del parámetro bestfit 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 bestfit es utilizado, la anchura y la altura deben ser proporcionadas. - + + + El comportamiento del parámetro bestfit 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 bestfit + es utilizado, la anchura y la altura deben ser proporcionadas. + '> - - - Debe existir un archivo openssl.cnf válido e - instalado para que esta función opere correctamente. - Ver las notas encontradas en la sección - concerniente a la instalación para más información. - + + + Debe existir un archivo openssl.cnf válido e instalado + para que esta función opere correctamente. Ver + las notas encontradas en la sección concerniente a + la instalación para más información. + '> - -El parámetro opcional notext afecta al nivel de verbosidad del display; -si vale &false;, se añadirán información legible por humanos en el display. -Por omisión, el parámetro notext vale &true;. + + El parámetro opcional notext 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 + notext vale &true;. '> - - + + - 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 . Los objetos COM y DOTNET - tendrán el valor de su propiedad por defecto recuperado y utilizado como valor VARIANT. + 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 . Los objetos COM y + DOTNET tendrán el valor de su propiedad predeterminada recuperado y utilizado como valor VARIANT. - 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, variant_add, en PHP, corresponde a - VarAdd() en la documentación MSDN. + 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, + variant_add, en PHP, corresponde a VarAdd() + en la documentación MSDN. '> - - Este - método requiere que la variable de configuración INI phar.readonly - esté definida a 0 para funcionar con los objetos Phar. - De lo contrario, se lanzará una excepción PharException.'> + +Este método +requiere que la variable de configuración INI phar.readonly esté definida +a 0 para funcionar con los objetos Phar +. De lo contrario, se lanzará una excepción PharException.'> - + Phar::addFile, Phar::addFromString y Phar::offsetSet registran un nuevo archivo phar cada vez que son llamadas. Si las prestaciones son una preocupación, @@ -2864,7 +2796,7 @@ Por omisión, el parámetro notext vale &true;. '> - + PharData::addFile, PharData::addFromString y PharData::offsetSet registran un nuevo archivo phar cada vez que son llamadas. Si las prestaciones son una preocupación, @@ -2873,72 +2805,71 @@ Por omisión, el parámetro notext vale &true;. '> - - - Esta extensión requiere la extensión PHP libxml. - Esto significa pasar la opción de configuración - , o anterior a PHP 7.4 - la opción de configuración , - aunque esto se realiza implícitamente ya que libxml está activado por omisión. + + + Esta extensión requiere la extensión PHP libxml. Esto significa + pasar la opción de configuración , + o anterior a PHP 7.4 la opción de configuración , + aunque esto se realiza implícitamente ya que libxml + está activado por defecto. '> - - Esta función solo está disponible - si PHP es compilado utilizando la biblioteca libxml 20620 o posterior.'> + +Esta función solo está disponible si PHP es compilado utilizando la biblioteca libxml 20620 o posterior.'> - - +inotify_init'> - - Emite una advertencia + +Emite una advertencia E_WARNING si la llamada a este método falla (i.e. no implementado).'> +La propiedad +streamWrapper::$context +es actualizada si un contexto válido es pasado a la función.'> - La propiedad - streamWrapper::$context - es actualizada si un contexto válido es pasado a la función.'> +bucket ahora espera una instancia de StreamBucket; anteriormente, se esperaba una stdClass.'> +StreamBucket; anteriormente, se retornaba una stdClass.'> - bucket ahora espera una instancia de StreamBucket; anteriormente, se esperaba una stdClass.'> - StreamBucket; anteriormente, se retornaba una stdClass.'> - - - - + +GmagickException en caso de error.'> - - return - está definido a &true;, la exportación será retornada en forma de &string;, - de lo contrario, &null; será retornado.'> + +return se +establece a &true;, entonces la exportación se devuelve como un string, +de lo contrario se devuelve &null;.'> - + - + - + - + name - Filtrar los resultados para incluir únicamente las instancias - de ReflectionAttribute para los atributos correspondientes a este nombre de clase. + Filtrar los resultados para incluir únicamente las instancias de ReflectionAttribute + para los atributos correspondientes a este nombre de clase. '> - + flags - Flags para determinar cómo filtrar los resultados, si name es proporcionado. + Flags para determinar cómo filtrar los resultados, si name + es proporcionado. - El valor por omisión es 0 que solo retornará los resultados - para los atributos que son de la clase name. + El valor predeterminado es 0 que solo retornará los resultados para los atributos que + son de la clase name. La única otra opción disponible es utilizar ReflectionAttribute::IS_INSTANCEOF, @@ -2947,313 +2878,294 @@ Por omisión, el parámetro notext vale &true;. '> - - Para una portabilidad máxima, se recomienda siempre utilizar barras oblicuas (/) como separador de directorio en los nombres de archivos zip.'> + +Para una portabilidad máxima, se recomienda siempre utilizar barras oblicuas (/) como separador de directorio en los nombres de archivos zip.'> - - Código de Error Win32 en caso de fallo.'> - - WIN32_NO_ERROR en caso de éxito&win32service.false.error;'> + +Código de Error Win32 en caso de fallo.'> + +WIN32_NO_ERROR en caso de éxito&win32service.false.error;'> - - -El MIB define el tipo de cada identificador de objeto. Debe -ser especificado como un carácter simple de la lista siguiente. + + + El MIB define el tipo de cada identificador de objeto. Debe ser especificado como un carácter simple de la lista siguiente. -tipos - - - =El tipo es recuperado desde el MIB - iINTEGER - uINTEGER - sSTRING - xHEX STRING - dDECIMAL STRING - nNULLOBJ - oOBJID - tTIMETICKS - aIPADDRESS - bBITS - - + tipos + + + =El tipo es recuperado desde el MIB + iINTEGER + uINTEGER + sSTRING + xHEX STRING + dDECIMAL STRING + nNULLOBJ + oOBJID + tTIMETICKS + aIPADDRESS + bBITS + +
-Si la constante OPAQUE_SPECIAL_TYPES ha sido definida durante -la compilación de la biblioteca SNMP, los caracteres siguientes -también estarán disponibles: + Si la constante OPAQUE_SPECIAL_TYPES ha sido definida durante la compilación de la biblioteca SNMP, los caracteres siguientes también estarán disponibles: -tipos - - - Uint64 sin signo - Iint64 con signo - Ffloat - Ddouble - - + tipos + + + Uint64 sin signo + Iint64 con signo + Ffloat + Ddouble + +
'> - -La mayoría de estos valores utilizan el tipo ASN.1 correspondiente. 's', 'x', 'd' y 'b' -son todas formas diferentes de especificar el valor OCTET STRING y el tipo sin signo -'u' también es utilizado para manejar los valores Gauge32. + + La mayoría de estos valores utilizan el tipo ASN.1 correspondiente. 's', 'x', 'd' y 'b' son todas formas diferentes de especificar el valor OCTET STRING y el + tipo sin signo 'u' también es utilizado para manejar los valores Gauge32. '> - -Si los archivos MIB son cargados en el árbol MIB con "snmp_read_mib" o especificándolos -en la configuración de libsnmp, '=' podrá ser utilizado como parámetro -de tipo para todos los identificadores de objetos, ya que el tipo puede ser leído automáticamente desde el MIB. + + 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 '=' como el + parámetro type para todos los identificadores de objeto, ya que entonces el tipo se puede leer automáticamente desde el MIB. '> - -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)}": + + 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)}": - - - 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. - - - - - Utilizando el tipo "x" y un número hexadecimal pero sin(!) el prefijo usual - "0x". - - + + + 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. + + + + + Utilizando el tipo "x" y un número hexadecimal pero sin(!) el prefijo usual "0x". + + -Consúltese la sección sobre ejemplos para más detalles. + Consúltese la sección sobre ejemplos para más detalles. '> - + &reftitle.errors; - Este método no lanza excepciones por omisión. - Para activar el lanzamiento de excepciones SNMPException cuando - ocurren errores de la biblioteca, - el parámetro de la clase SNMP exceptions_enabled - debe ser definido al valor correspondiente. Ver las - explicaciones sobre SNMP::$exceptions_enabled - para más detalles. + 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 exceptions_enabled + ebe ser definido al valor correspondiente. Ver las explicaciones + sobre SNMP::$exceptions_enabled para más detalles. '> - - -La función de retrollamada callback -es llamada cuando la petición está terminada. + + La función +de retrollamada callback es llamada cuando la petición está terminada. Debe corresponder al siguiente prototipo: - - data - representa los datos personalizados pasados a la petición. - - - result - representa el valor resultante específico de la petición; básicamente, - el valor retornado por la llamada al sistema correspondiente. - - - req - es el recurso opcional de la petición que puede ser - utilizado con funciones como eio_get_last_error. - + +data +representa los datos personalizados pasados a la petición. + + +result +representa el valor resultante específico de la petición; básicamente, el valor retornado por la llamada +al sistema correspondiente. + + +req +es el recurso opcional de la petición que puede ser utilizado con funciones como eio_get_last_error. + '> - La prioridad de la petición: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, o &null;. -Si &null; es pasado, el parámetro pri, internamente, es definido a +xmlns="http://docbook.org/ns/docbook">EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, o &null;. Si +&null; es pasado, el parámetro pri, internamente, es definido a EIO_PRI_DEFAULT. '> - Evitar los - caminos relativos. +Evite las rutas +relativas. '> - - - - - - - - - - - - - - - - - - - - TRADER_MA_TYPE_* debe ser utilizada.'> - TRADER_MA_TYPE_* debe ser utilizada.'> - TRADER_MA_TYPE_* debe ser utilizada.'> - TRADER_MA_TYPE_* debe ser utilizada.'> - TRADER_MA_TYPE_* debe ser utilizada.'> - TRADER_MA_TYPE_* debe ser utilizada.'> - TRADER_MA_TYPE_* debe ser utilizada.'> - TRADER_MA_TYPE_* debe ser utilizada.'> - - TRADER_REAL_MIN a TRADER_REAL_MAX.'> - TRADER_REAL_MIN a TRADER_REAL_MAX.'> - - - - - + + + + + + + + + + + + + + + + + + + +TRADER_MA_TYPE_* debe ser utilizada.'> +TRADER_MA_TYPE_* debe ser utilizada.'> +TRADER_MA_TYPE_* debe ser utilizada.'> +TRADER_MA_TYPE_* debe ser utilizada.'> +TRADER_MA_TYPE_* debe ser utilizada.'> +TRADER_MA_TYPE_* debe ser utilizada.'> +TRADER_MA_TYPE_* debe ser utilizada.'> +TRADER_MA_TYPE_* debe ser utilizada.'> +TRADER_REAL_MIN a TRADER_REAL_MAX.'> +TRADER_REAL_MIN a TRADER_REAL_MAX.'> + + + + + PECL mongodb 2.0.0 - Esta clase ha sido eliminada. + Esta clase ha sido eliminada. - + '> - + PECL mongodb 2.0.0 - Esta función ha sido eliminada. + Esta función ha sido eliminada. - + '> - + PECL mongodb 2.0.0 - Este método ha sido eliminado. + Este método ha sido eliminado. - + '> - + PECL mongodb 2.0.0 - - Esta clase ya no implementa la interfaz - Serializable. - + + Esta clase ya no implementa la interfaz + Serializable. + - + '> - - PECL mongodb 1.15.0 - - 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 #[ReturnTypeWillChange] puede ser añadido - para ignorar la notificación de depreciación. - - + + PECL mongodb 1.15.0 + + 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 #[ReturnTypeWillChange] + puede ser añadido para ignorar la notificación de depreciación. + + '> - + PECL mongodb 2.0.0 - Los tipos de retorno previamente declarados como provisionales ahora son aplicados. + Los tipos de retorno previamente declarados como provisionales ahora son aplicados. - + '> - + PECL mongodb 2.0.0 - - Este método ahora lanza una excepción cuando es llamado - para una escritura no reconocida, en lugar de retornar &null;. - + + Este método ahora lanza una excepción cuando es llamado para una escritura no reconocida, en lugar de retornar &null;. + - + '> - -collation -arrayobject - - - Collation 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 "locale" es obligatorio; todos los demás campos de la collation son opcionales. Para la descripción de estos campos, consúltese el documento Collation. - - - Si la collation no es especificada pero la colección tiene una collation por omisión, 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. - - - 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. - - - + + collation + arrayobject + + + Collation 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 "locale" es obligatorio; todos los demás campos de la collation son opcionales. Para la descripción de estos campos, consúltese el documento Collation. + + + 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. + + + 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. + + + '> - - - let - arrayobject - - - 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 $$var). - - - 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. - - - + + let + arrayobject + + + 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 $$var). + + + 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. + + + '> - - keyVaultClient MongoDB\Driver\Manager - El Manager utilizado para enrutar las peticiones de claves de datos a un cluster MongoDB diferente. Por omisión, el Manager y cluster actual es utilizado. + 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. '> - keyVaultNamespace - &string; + string Un nombre de espacio completamente calificado (por ejemplo "databaseName.collectionName") denotando la colección que contiene todas las claves de datos utilizadas para el cifrado y descifrado. Esta opción es requerida. - -'> +'> + kmsProviders - &array; + array - Un documento que contiene la configuración de uno o varios - proveedores KMS, que se utilizan para cifrar las claves de datos. - Los proveedores soportados son "aws", - "azure", "gcp" y - "local", y al menos uno debe ser especificado. + 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 "aws", "azure", "gcp", "kmip" y "local", y se debe especificar al menos uno. Si se especifica un documento vacío para "aws", - "azure", o "gcp", el controlador - intentará configurar el proveedor utilizando + "azure" o "gcp", el + controlador intentará configurar el proveedor utilizando Automatic Credentials. @@ -3278,7 +3190,6 @@ azure: { clientId: , clientSecret: , identityPlatformEndpoint: // Defaults to "login.microsoftonline.com" - } ]]> @@ -3291,7 +3202,6 @@ gcp: { email: , privateKey: |, endpoint: // Defaults to "oauth2.googleapis.com" - } ]]> @@ -3319,8 +3229,7 @@ local: { '> - - Opciones del proveedor <literal>"aws"</literal> @@ -3377,7 +3286,7 @@ local: { keyVersion string - Opcional. Una versión específica de la clave nombrada. Por omisión, se utiliza la versión primaria de la clave. + Opcional. Una versión específica de la clave nombrada. De forma predeterminada, se utiliza la versión primaria de la clave. @@ -3418,12 +3327,12 @@ local: { keyVersion string - Opcional. Una versión específica de la clave nombrada. Por omisión, se utiliza la versión primaria de la clave. + Opcional. Una versión específica de la clave nombrada. De forma predeterminada, se utiliza la versión primaria de la clave. endpoint string - Opcional. Host con puerto opcional. El valor por omisión es "cloudkms.googleapis.com". + Opcional. Host con puerto opcional. El valor predeterminado es "cloudkms.googleapis.com". @@ -3454,28 +3363,22 @@ local: { delegated bool - Opcional. Si es verdadero, esta clave debe ser descifrada por el servidor KMIP. + Opcional. Si es true, esta clave debe ser descifrada por el servidor KMIP.
'> - - - tlsOptions - array - - - Un documento que contiene la configuración TLS de uno o varios - proveedores KMS. - Los proveedores soportados son "aws", - "azure", "gcp" y - "kmip". - Todos los proveedores soportan las siguientes opciones: - - + + tlsOptions + array + + + Un documento que contiene la configuración TLS de uno o varios proveedores KMS. Los proveedores soportados son "aws", "azure", "gcp" y "kmip". Todos los proveedores soportan las siguientes opciones: + + : { tlsCaFile: , @@ -3484,467 +3387,436 @@ local: { tlsDisableOCSPEndpointCheck: } ]]> - - - -'> - - - maxCommitTimeMS - integer - - - El tiempo máximo en milisegundos para permitir que una sola - comando commitTransaction se ejecute. - - - Si se especifica, maxCommitTimeMS debe ser un entero - 32 bits con signo superior o igual a cero. - - - -'> - -readConcern -MongoDB\Driver\ReadConcern - - - Una preocupación de lectura a aplicar a la operación. - - - 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. - - - -'> - -readPreference -MongoDB\Driver\ReadPreference - - - Una preferencia de lectura a utilizar para seleccionar un servidor - para la operación. - - - + + + '> - -session -MongoDB\Driver\Session - - - Una sesión a asociar a la operación. - - - + + maxCommitTimeMS + integer + + + El tiempo máximo en milisegundos para permitir que una sola comando + commitTransaction se ejecute. + + + Si se especifica, maxCommitTimeMS debe ser un entero + 32 bits con signo superior o igual a cero. + + + '> - - - Si se utiliza una "session" que tiene una transacción - en curso, no se puede especificar la opción "readConcern" - o "writeConcern". Intentar hacer esto lanzará una excepción - MongoDB\Driver\Exception\InvalidArgumentException. - En su lugar, debe definir estas opciones cuando se crea la transacción con - MongoDB\Driver\Session::startTransaction. - - + + readConcern + MongoDB\Driver\ReadConcern + + + Una preocupación de lectura a aplicar a la operación. + + + 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. + + + '> - -writeConcern -MongoDB\Driver\WriteConcern - - - Una preocupación de escritura a aplicar a la operación. - - - + + readPreference + MongoDB\Driver\ReadPreference + + + Una preferencia de lectura a utilizar para seleccionar un servidor para la operación. + + + '> - -namespace (string) - - - Un espacio de nombres completamente calificado (ej. "databaseName.collectionName") - - - + + session + MongoDB\Driver\Session + + + Una sesión a asociar a la operación. + + + '> - -db (string) - - - El nombre de la base de datos sobre la cual se ejecutará el comando. - - - + + + Si se utiliza una "session" que tiene una transacción en + curso, no se puede especificar la opción "readConcern" o + "writeConcern". Intentar hacer esto lanzará una excepción + MongoDB\Driver\Exception\InvalidArgumentException + . En su lugar, debe definir estas opciones cuando se crea + la transacción con + MongoDB\Driver\Session::startTransaction. + + '> - -bulk (MongoDB\Driver\BulkWrite) - - - Escritura(s) a ejecutar. - - - + + writeConcern + MongoDB\Driver\WriteConcern + + + Una preocupación de escritura a aplicar a la operación. + + + '> - - bulk (MongoDB\Driver\BulkWriteCommand) + namespace (string) - Escritura(s) a ejecutar. + Un espacio de nombres completamente calificado (ej. "databaseName.collectionName") '> - -command (MongoDB\Driver\Command) - - - El comando a ejecutar. - - - + + db (string) + + + El nombre de la base de datos sobre la cual se ejecutará el comando. + + + '> - - - options - - - + + bulk (MongoDB\Driver\BulkWrite) + + + Escritura(s) a ejecutar. + + + +'> + + bulk (MongoDB\Driver\BulkWriteCommand) + + + Escritura(s) a ejecutar. + + + +'> + + command (MongoDB\Driver\Command) + + + El comando a ejecutar. + + + +'> + + options + + - Opciones de cifrado - - - - Opción - Tipo - Descripción - - - - - algorithm - - string - - - - El algoritmo de cifrado a utilizar. Esta opción es requerida. Especifique una de las siguientes constantes de - ClientEncryption: - - - - MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_DETERMINISTIC - - - MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_RANDOM - - - MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED - - - MongoDB\Driver\ClientEncryption::ALGORITHM_UNINDEXED - - - MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE - - - - - - contentionFactor - - int - - - - El factor de contención para evaluar las consultas con cargas útiles cifradas indexadas. - - - Esta opción se aplica únicamente y solo puede ser especificada cuando - algorithm es - MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED o - MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE. - - - - - keyAltName - - string - - - - Identifica un documento de colección de cofre de claves por keyAltName. Esta opción es mutuamente exclusiva - con keyId y una de las dos es requerida. - - - - - keyId - - MongoDB\BSON\Binary - - - - Identifica una clave de datos por _id. El valor es un UUID (subtipo binario 4). Esta opción es mutuamente - exclusiva con keyAltName y una de las dos es requerida. - - - - - queryType - - string - - - - El tipo de consulta para evaluar las consultas con cargas útiles cifradas indexadas. Especifique una de las siguientes constantes de - ClientEncryption: - - - - MongoDB\Driver\ClientEncryption::QUERY_TYPE_EQUALITY - - - MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE - - - - Esta opción se aplica únicamente y solo puede ser especificada cuando - algorithm es - MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED o - MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE. - - - - - rangeOpts - - array - - - - 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 encryptedFields de la colección objetivo. Para los tipos de campo BSON double y decimal128, - min, max y precision deben ser todos definidos o todos no definidos. - - -
- Opciones de índice de rango - - - - Opción - Tipo - Descripción - - - - - min - - mixed - - Requisito si precision está definido. El valor BSON mínimo del rango. - - - max - - mixed - - Requisito si precision está definido. El valor BSON máximo del rango. - - - sparsity - - int - - Opcional. Entero positivo de 64 bits. - - - precision - - int - - - 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. - - - - trimFactor - int - Opcional. Entero positivo de 32 bits. - - - -
- - - - - + Opciones de cifrado + + + + Opción + Tipo + Descripción + + + + + algorithm + string + + + El algoritmo de cifrado a utilizar. Esta opción es requerida. Especifique + una de las siguientes constantes de + ClientEncryption: + + + MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_DETERMINISTIC + MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_RANDOM + MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED + MongoDB\Driver\ClientEncryption::ALGORITHM_UNINDEXED + MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE + + + + + contentionFactor + int + + + El factor de contención para evaluar las consultas con cargas útiles cifradas + indexadas. + + + Esta opción se aplica únicamente y solo puede ser especificada cuando + algorithm es + MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED + o + MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE. + + + + + keyAltName + string + + + Identifica un documento de colección de cofre de claves por + keyAltName. Esta opción es mutuamente exclusiva + con keyId y una de las dos es requerida. + + + + + keyId + MongoDB\BSON\Binary + + + Identifica una clave de datos por _id. El valor es un UUID + (subtipo binario 4). Esta opción es mutuamente exclusiva con + keyAltName y una de las dos es requerida. + + + + + queryType + string + + + El tipo de consulta para evaluar las consultas con cargas útiles cifradas + indexadas. Especifique una de las siguientes constantes de + ClientEncryption: + + + MongoDB\Driver\ClientEncryption::QUERY_TYPE_EQUALITY + MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE + + + Esta opción se aplica únicamente y solo puede ser especificada cuando + algorithm es + MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED + o MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE. + + + + + rangeOpts + array + + + 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 + encryptedFields de la colección objetivo. Para los + tipos de campo BSON double y decimal128, min, + max y precision deben ser todos + definidos o todos no definidos. + + + + Opciones de índice de rango + + + + Opción + Tipo + Descripción + + + + + min + mixed + + Requisito si precision está definido. El valor + BSON mínimo del rango. + + + + max + mixed + + Requisito si precision está definido. El valor + BSON máximo del rango. + + + + sparsity + int + Opcional. Entero positivo de 64 bits. + + + precision + int + + 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. + + + + trimFactor + int + Opcional. Entero positivo de 32 bits. + + + +
+ + + + + - - - -'> - -query (MongoDB\Driver\Query) - - - La consulta a ejecutar. - - - + + + '> - -typeMap (array) - - - Configuración del mapa de tipos. - - - + + query (MongoDB\Driver\Query) + + + La consulta a ejecutar. + + + '> - -filter (arrayobject) - - - El atributo de la consulta. - Un atributo vacío hará coincidir todos los documentos de la colección. - - - - Al evaluar los criterios de consulta, MongoDB compara los tipos y los valores según sus propias reglas de comparación para los tipos BSON, que difieren de las reglas de comparación y de manipulación de tipos de PHP. Al hacer coincidir un tipo BSON especial, los criterios de consulta deben utilizar la clase BSON (ej.: utilizar MongoDB\BSON\ObjectId para hacer coincidir un ObjectId). - - - - + + typeMap (array) + + + Configuración del mapa de tipos. + + + '> - Retorna un MongoDB\Driver\Cursor en caso de éxito.'> - Retorna un MongoDB\Driver\WriteResult en caso de éxito.'> - Retorna un MongoDB\Driver\BulkWriteCommandResult en caso de éxito.'> - - Lanza una excepción MongoDB\Driver\Exception\InvalidArgumentException si la opción "session" se utiliza con una transacción asociada en combinación con una opción "readConcern" o "writeConcern".'> - Lanza una excepción MongoDB\Driver\Exception\InvalidArgumentException si la opción "session" se utiliza junto con una preocupación de escritura no reconocida.'> - Lanza una excepción MongoDB\Driver\Exception\BulkWriteCommandException en caso de error de escritura (por ejemplo, fallo de comando, error de escritura o preocupación de escritura)'> - Lanza una excepción MongoDB\Driver\BulkWriteException en caso de error de una operación de escritura (un error WriteError y WriteConcern)'> - Lanza una excepción MongoDB\Driver\InvalidArgumentException en caso de error durante el análisis de un argumento.'> - Lanza una excepción MongoDB\Driver\AuthenticationException si se requiere una identificación pero falla'> - Lanza una excepción MongoDB\Driver\ConnectionException si la conexión al servidor falla por una razón distinta a un problema de identificación'> - Lanza una excepción MongoDB\Driver\Exception\UnexpectedValueException 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 libbson.'> - - Levanta una excepción MongoDB\Driver\Exception\LogicException - si la escritura no ha sido reconocida. - + + filter (arrayobject) + + + El atributo de la consulta. + Un atributo vacío hará coincidir todos los documentos de la colección. + + + + Al evaluar los criterios de consulta, MongoDB compara los tipos y los valores según sus propias reglas de comparación para los tipos BSON, que difieren de las reglas de comparación y de manipulación de tipos de PHP. Al hacer coincidir un tipo BSON especial, los criterios de consulta deben utilizar la clase BSON (ej.: utilizar MongoDB\BSON\ObjectId para hacer coincidir un ObjectId). + + + + '> +Retorna un MongoDB\Driver\Cursor en caso de éxito.'> +Retorna un MongoDB\Driver\WriteResult en caso de éxito.'> +Retorna un MongoDB\Driver\BulkWriteCommandResult en caso de éxito.'> + +Lanza una excepción MongoDB\Driver\Exception\InvalidArgumentException si la opción "session" se utiliza con una transacción asociada en combinación con una opción "readConcern" o "writeConcern".'> +Lanza una excepción MongoDB\Driver\Exception\InvalidArgumentException si la opción "session" se utiliza junto con una preocupación de escritura no reconocida.'> +Lanza una excepción MongoDB\Driver\Exception\BulkWriteCommandException en caso de error de escritura (por ejemplo, fallo de comando, error de escritura o preocupación de escritura)'> +Lanza una excepción MongoDB\Driver\Exception\BulkWriteException en caso de error de una operación de escritura (un error WriteError y WriteConcern)'> +Lanza una excepción MongoDB\Driver\Exception\InvalidArgumentException en caso de error durante el análisis de un argumento.'> +Lanza una excepción MongoDB\Driver\Exception\AuthenticationException si se requiere una identificación pero falla'> +Lanza una excepción MongoDB\Driver\Exception\ConnectionException si la conexión al servidor falla por una razón distinta a un problema de identificación'> +Lanza una excepción MongoDB\Driver\Exception\UnexpectedValueException 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 libbson.'> +Levanta una excepción MongoDB\Driver\Exception\LogicExceptionsi la escritura no ha sido reconocida.'> - - - MongoDB\BSON\Decimal128 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. - - + + + MongoDB\BSON\Decimal128 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. + + '> - - - La salida es coherente con la función MongoDB\BSON\toJSON, - que utiliza el formato JSON extendido específico del controlador. Esto no corresponde - necesariamente a las representaciones JSON extendidas - relajadas - o canónicas - utilizadas por MongoDB\BSON\toRelaxedExtendedJSON y - MongoDB\BSON\toCanonicalExtendedJSON, respectivamente. - - - '> + + La salida es coherente con la función MongoDB\BSON\toJSON + , que utiliza el formato JSON extendido específico del controlador. Esto no corresponde + necesariamente a las representaciones JSON extendidas + relajadas + o canónicas + utilizadas por + MongoDB\BSON\toRelaxedExtendedJSON y + MongoDB\BSON\toCanonicalExtendedJSON, respectivamente. + + +'> - - 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 MongoDB\Driver\Manager en un proceso - hijo derivado de un fork. - - - '> + + + 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 MongoDB\Driver\Manager en un proceso hijo derivado + de un fork. + + +'> - - Dado que el tipo entero de PHP es firmado, algunos valores - devueltos por este método pueden aparecer como enteros negativos - en las plataformas de 32 bits. El formateador "%u" de - sprintf puede ser utilizado para obtener una - representación en forma de string del valor decimal no firmado. - - '> + + + 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 + "%u" de sprintf se puede + utilizar para obtener una representación en forma de string del valor decimal sin signo. + + +'> - - La opción readPreference 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. - - - '> + + + La opción "readPreference" 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. + + +'> - - 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á. - - - '> + + + 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á. + + +'> - - 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. - - - '> + + + 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. + + +'> Una petición debe ser creada mediante la función radius_create_request antes de que esta función pueda ser llamada.'> @@ -3958,590 +3830,585 @@ local: { file_descriptor - - El descriptor de archivo, que debe ser ya sea una recurso - de archivo, o un entero. Un entero se asume como un descriptor - de archivo que puede ser pasado directamente a la llamada al sistema - subyacente. - + + El descriptor de fichero, el cual se espera que sea un + resource de fichero o un int. Se asumirá que un int + es un descriptor de fichero que puede ser pasado directamente a la + llamada al sistema subyacente. + - '> +'> - 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. - - '> + + 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. + +'> - - - " ": carácter SP en ASCII - 0x20, un espacio ordinario. - - - - - "\t": carácter HT en ASCII - 0x09, una tabulación. - - - - - "\n": carácter LF en ASCII - 0x0A, un salto de línea (line feed). - - - - - "\r": carácter CR en ASCII - 0x0D, un retorno de carro. - - - - - "\0": carácter NUL en ASCII - 0x00, el octeto NUL. - - - - - "\v": carácter VT en ASCII - 0x0B, una tabulación vertical. - - - - '> + + + " ": carácter SP en ASCII + 0x20, un espacio ordinario. + + + + + "\t": carácter HT en ASCII + 0x09, una tabulación. + + + + + "\n": carácter LF en ASCII + 0x0A, un salto de línea (line feed). + + + + + "\r": carácter CR en ASCII + 0x0D, un retorno de carro. + + + + + "\0": carácter NUL en ASCII + 0x00, el octeto NUL. + + + + + "\v": carácter VT en ASCII + 0x0B, una tabulación vertical. + + + +'> - - - " " (Unicode U+0020), un espacio ordinario. - - - - - "\t" (Unicode U+0009), una tabulación. - - - - - "\n" (Unicode U+000A), un salto de línea. - - - - - "\r" (Unicode U+000D), un retorno de carro. - - - - - "\0" (Unicode U+0000), el octeto NUL. - - - - - "\v" (Unicode U+000B), una tabulación vertical. - - - - - "\f" (Unicode U+000C), un avance de página. - - - - - "\u00A0" (Unicode U+00A0), un ESPACIO INSÉCABLE. - - - - - "\u1680" (Unicode U+1680), una MARCA DE ESPACIO OGHAM. - - - - - "\u2000" (Unicode U+2000), un CUADRADO MEDIO. - - - - - "\u2001" (Unicode U+2001), un CUADRADO. - - - - - "\u2002" (Unicode U+2002), un ESPACIO MEDIO. - - - - - "\u2003" (Unicode U+2003), un ESPACIO CUADRADO. - - - - - "\u2004" (Unicode U+2004), un ESPACIO DE UN-TERCIO-DE-CUADRADO. - - - - - "\u2005" (Unicode U+2005), un ESPACIO DE UN-CUARTO-DE-CUADRADO. - - - - - "\u2006" (Unicode U+2006), un ESPACIO DE UN-SEXTO-DE-CUADRADO. - - - - - "\u2007" (Unicode U+2007), un ESPACIO PARA DÍGITOS. - - - - - "\u2008" (Unicode U+2008), un ESPACIO DE PUNTUACIÓN. - - - - - "\u2009" (Unicode U+2009), un ESPACIO FINO. - - - - - "\u200A" (Unicode U+200A), un ESPACIO PELUDO. - - - - - "\u2028" (Unicode U+2028), un SEPARADOR DE LÍNEA. - - - - - "\u2029" (Unicode U+2029), un SEPARADOR DE PÁRRAFO. - - - - - "\u202F" (Unicode U+202F), un ESPACIO INSÉCABLE ESTRECHO. - - - - - "\u205F" (Unicode U+205F), un ESPACIO MATEMÁTICO MEDIO. - - - - - "\u3000" (Unicode U+3000), un ESPACIO IDEOGRÁFICO. - - - - - "\u0085" (Unicode U+0085), una LÍNEA SIGUIENTE (NEL). - - - - - "\u180E" (Unicode U+180E), un SEPARADOR DE VOCALES MONGOL. - - - - '> + + + " " (Unicode U+0020), un espacio ordinario. + + + + + "\t" (Unicode U+0009), una tabulación. + + + + + "\n" (Unicode U+000A), un salto de línea. + + + + + "\r" (Unicode U+000D), un retorno de carro. + + + + + "\0" (Unicode U+0000), el octeto NUL. + + + + + "\v" (Unicode U+000B), una tabulación vertical. + + + + + "\f" (Unicode U+000C), un avance de página. + + + + + "\u00A0" (Unicode U+00A0), un ESPACIO INSÉCABLE. + + + + + "\u1680" (Unicode U+1680), una MARCA DE ESPACIO OGHAM. + + + + + "\u2000" (Unicode U+2000), un CUADRADO MEDIO. + + + + + "\u2001" (Unicode U+2001), un CUADRADO. + + + + + "\u2002" (Unicode U+2002), un ESPACIO MEDIO. + + + + + "\u2003" (Unicode U+2003), un ESPACIO CUADRADO. + + + + + "\u2004" (Unicode U+2004), un ESPACIO DE UN-TERCIO-DE-CUADRADO. + + + + + "\u2005" (Unicode U+2005), un ESPACIO DE UN-CUARTO-DE-CUADRADO. + + + + + "\u2006" (Unicode U+2006), un ESPACIO DE UN-SEXTO-DE-CUADRADO. + + + + + "\u2007" (Unicode U+2007), un ESPACIO PARA DÍGITOS. + + + + + "\u2008" (Unicode U+2008), un ESPACIO DE PUNTUACIÓN. + + + + + "\u2009" (Unicode U+2009), un ESPACIO FINO. + + + + + "\u200A" (Unicode U+200A), un ESPACIO PELUDO. + + + + + "\u2028" (Unicode U+2028), un SEPARADOR DE LÍNEA. + + + + + "\u2029" (Unicode U+2029), un SEPARADOR DE PÁRRAFO. + + + + + "\u202F" (Unicode U+202F), un ESPACIO INSÉCABLE ESTRECHO. + + + + + "\u205F" (Unicode U+205F), un ESPACIO MATEMÁTICO MEDIO. + + + + + "\u3000" (Unicode U+3000), un ESPACIO IDEOGRÁFICO. + + + + + "\u0085" (Unicode U+0085), una LÍNEA SIGUIENTE (NEL). + + + + + "\u180E" (Unicode U+180E), un SEPARADOR DE VOCALES MONGOL. + + + +'> - Opcionalmente, los caracteres a eliminar también pueden ser especificados utilizando - el parámetro characters. - Basta con listar todos los caracteres que deben ser eliminados. - Con .., es posible especificar un rango creciente de caracteres. + Opcionalmente, los caracteres a eliminar también pueden ser especificados utilizando el + parámetro characters. + Basta con listar todos los caracteres que deben ser eliminados. + Con .., es posible especificar un rango creciente de caracteres. - '> +'> - Opcionalmente, los caracteres a eliminar también pueden ser especificados utilizando - el parámetro characters. - Basta con listar todos los caracteres a eliminar. + Opcionalmente, los caracteres a eliminar también pueden ser especificados utilizando el + parámetro characters. + Basta con listar todos los caracteres a eliminar. - '> +'> - Un argumento opcional que define el codificado utilizado durante - la conversión de caracteres. + Un argumento opcional que define el codificado utilizado durante la conversión de caracteres. - Si se omite, el valor por omisión del parámetro encoding - es el valor de la opción de configuración - default_charset. + Si se omite, el valor predeterminado del parámetro encoding es el valor de la opción de configuración + default_charset + . - 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 - default_charset - ha sido definida incorrectamente para la entrada proporcionada. - - '> - - - format - - - La cadena de formato está compuesta por cero o más directivas: - caracteres ordinarios (excepto %) - que se copian directamente al resultado y - especificaciones de conversión, - cada una con su propio parámetro. - - - - Una especificación de conversión que sigue este prototipo: - %[argnum$][flags][width][.precision]specifier. + 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 default_charset + ha sido definida incorrectamente para la entrada proporcionada. +'> - - Argnum - - Un &integer; seguido de un signo dólar $, - para especificar qué número de argumento tratar en la conversión. - - - - - Banderas - - - - - - Bandera - &Description; - - - - - - - - Justifica el texto a la izquierda dado el ancho del campo; - la justificación a la derecha es el comportamiento por omisión. - - - - + - - Prefija los números positivos con un signo más - +; por omisión solo los números - negativos son prefijados con un signo negativo. - - - - (espacio) - - Rellena el resultado con espacios. - Esto es por omisión. - - - - 0 - - Rellena solo los números a la izquierda con ceros. - Con el especificador s esto también puede - rellenar a la derecha con ceros. - - - - '(char) - - Rellena el resultado con el carácter (char). - - - - - - - + + format + + + La cadena de formato está compuesta por cero o más directivas: + caracteres ordinarios (excepto %) que se + copian directamente al resultado y especificaciones de + conversión, cada una con su propio + parámetro. + - - Ancho - - Sea un entero indicando el número de caracteres (mínimo) - que esta conversión debe producir, o *. - Si * es utilizado, entonces el ancho es proporcionado - como un valor entero adicional precediendo al que se formatea - por el especificador. - - + + Una especificación de conversión que sigue este prototipo: + %[argnum$][flags][width][.precision]specifier. + - - Precisión - - Un punto . seguido opcionalmente - sea de un entero, o de *, - cuya significación depende del especificador: - - - - Para los especificadores e, E, - f y F: - esto es el número de dígitos a mostrar después - de la coma (por omisión, esto es 6). - - - - - Para los especificadores g, G, - h y H: - esto es el número máximo de dígitos significativos a mostrar. - - - - - Para el especificador s: actúa como un punto de corte, - definiendo un límite máximo de caracteres de la cadena. - - - - - - Si el punto es especificado sin un valor explícito para la precisión, - 0 es asumido. Si * es utilizado, la precisión es - proporcionada como un valor entero adicional precediendo al que se formatea + + Argnum + + Un &integer; seguido de un signo dólar $, + para especificar qué número de argumento tratar en la conversión. + + + + + Banderas + + + + + + Bandera + &Description; + + + + + - + + Justifica el texto a la izquierda dado el ancho del campo; + la justificación a la derecha es el comportamiento predeterminado. + + + + + + + Prefija los números positivos con un signo más + +; por defecto solo los + números negativos son prefijados con un signo negativo. + + + + (espacio) + + Rellena el resultado con espacios. + Esto es por defecto. + + + + 0 + + Rellena solo los números a la izquierda con ceros. Con + el especificador s esto también puede rellenar + a la derecha con ceros. + + + + '(char) + + Rellena el resultado con el carácter (char). + + + + + + + + + + Ancho + + Sea un entero indicando el número de caracteres (mínimo) + que esta conversión debe producir, o *. + Si * es utilizado, entonces el ancho es proporcionado + como un valor entero adicional precediendo al que se formatea por el especificador. - - - - - - - - Especificadores - - - - Especificador - &Description; - - - - - % - - Un carácter de porcentaje literal. No se necesita ningún argumento. - - - - b - - El argumento es tratado como un entero y presentado - como un número binario. - - - - c - - El argumento es tratado como un entero y presentado - como el carácter de código ASCII correspondiente. - - - - d - - El argumento es tratado como un entero y presentado - como un número entero decimal (firmado). - - - - e - - El argumento es tratado como una notación científica - (ej. 1.2e+2). - - - - E - - Como el especificador e pero utiliza - una letra mayúscula (por ejemplo 1.2E+2). - - - - f - - 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). - - - - F - - 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). - - - - g - + + + + + Precisión + + Un punto . seguido opcionalmente sea + de un entero, o de *, + cuya significación depende del especificador: + + - Formato general. + Para los especificadores e, E, + f y F + : esto es el número de dígitos a mostrar + después de la coma (por defecto, esto es 6). + + - 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: + Para los especificadores g, G, + h y H + : esto es el número máximo de + dígitos significativos a mostrar. + + - 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. + Para el especificador s: actúa como un punto de corte, + definiendo un límite máximo de caracteres de la cadena. - - - - G - - Como el especificador g pero utiliza - E y f. - - - - h - - Como el especificador g pero utiliza F. - Disponible a partir de PHP 8.0.0. - - - - H - - Como el especificador g pero utiliza - E y F. Disponible a partir de PHP 8.0.0. - - - - o - - El argumento es tratado como un entero y presentado - como un número octal. - - - - s - - El argumento es tratado y presentado como una cadena de caracteres. - - - - u - - El argumento es tratado como un entero y presentado - como un número decimal no firmado. - - - - x - - El argumento es tratado como un entero y presentado - como un número hexadecimal (las letras en minúsculas). - - - - X - - El argumento es tratado como un entero y presentado - como un número hexadecimal (las letras en mayúsculas). - - - - -
- + + + + + Si el punto es especificado sin un valor explícito para la precisión, + 0 es asumido. Si * es utilizado, la precisión es + proporcionada como un valor entero adicional precediendo al que se formatea + por el especificador. + + + + - - - El especificador de tipo c ignora el alineamiento y el tamaño. - - + + + Especificadores + + + + Especificador + &Description; + + + + + % + + Un carácter de porcentaje literal. No se necesita ningún argumento. + + + + b + + El argumento es tratado como un entero y presentado + como un número binario. + + + + c + + El argumento es tratado como un entero y presentado como + el carácter de código ASCII correspondiente. + + + + d + + El argumento es tratado como un entero y presentado como + un número entero decimal (firmado). + + + + e + + El argumento es tratado como una notación científica (ej. 1.2e+2). + + + + E + + Como el especificador e pero utiliza una + letra mayúscula (por ejemplo 1.2E+2). + + + + f + + 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). + + + + F + + 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). + + + + g + + + Formato general. + + + 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: + + + 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. + + + + + G + + Como el especificador g pero utiliza + E y f. + + + + h + + Como el especificador g pero utiliza F. + Disponible a partir de PHP 8.0.0. + + + + H + + Como el especificador g pero utiliza + E y F. Disponible a partir de PHP 8.0.0. + + + + o + + El argumento es tratado como un entero y presentado + como un número octal. + + + + s + + El argumento es tratado y presentado como una cadena de caracteres. + + + + u + + El argumento es tratado como un entero y presentado como + un número decimal no firmado. + + + + x + + El argumento es tratado como un entero y presentado como + un número hexadecimal (las letras en minúsculas). + + + + X + + El argumento es tratado como un entero y presentado como + un número hexadecimal (las letras en mayúsculas). + + + + +
+ - - - 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. - - + + + El especificador de tipo c ignora el alineamiento y el tamaño. + + - - Las variables serán forzadas a un tipo apropiado para el especificador: - - Manejo de tipos - - - - Tipo - Especificadores - - - - - string - s - - - int - - d, - u, - c, - o, - x, - X, - b - - - - float - - e, - E, - f, - F, - g, - G, - h, - H - - - - -
- + + + 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. + + + + + Las variables serán forzadas a un tipo apropiado para el especificador: + + Manejo de tipos + + + + Tipo + Especificadores + + + + + string + s + + + int + + d, + u, + c, + o, + x, + X, + b + + + + float + + e, + E, + f, + F, + g, + G, + h, + H + + + + +
+ - - '> + +'> - format - El formato interpretado para string se describe - en la documentación de la sprintf con las siguientes diferencias: + El formato interpretado para string se describe en + la documentación de la sprintf con + las siguientes diferencias: La función no tiene en cuenta el contexto local. @@ -4572,34 +4439,37 @@ local: { '> - - Anterior a PHP 8.0.0, si needle 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 + Anterior a PHP 8.0.0, si needle 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, needle debe ser explícitamente convertido a una cadena de caracteres, o debe realizarse una llamada explícita a chr. -'> +'> + + 8.0.0 needle acepta ahora una cadena vacía. '> - -5.6.0 - - El valor por omisión para el parámetro encoding - ha sido modificado para ser el valor de la opción de configuración - default_charset. - - + + 5.6.0 + + El valor predeterminado para el parámetro encoding ha sido modificado + para ser el valor de la opción de configuración + default_charset + . + + '> - 8.2.0 @@ -4609,7 +4479,7 @@ local: { '> - 8.2.0 @@ -4620,7 +4490,7 @@ local: { '> - @@ -4668,7 +4538,8 @@ local: { '> - @@ -4708,7 +4579,7 @@ local: { 8.0.0 - Lanza una ArgumentCountError cuando se proporcionan menos argumentos de los requeridos; + Lanza una ValueError cuando se proporcionan menos argumentos de los requeridos; anteriormente, esta función emitía un E_WARNING. @@ -4716,29 +4587,30 @@ local: { '> - -A partir de PHP 8.0.0, se lanza una ValueError si el número de argumentos es nulo. -Anterior a PHP 8.0.0, se emitía un E_WARNING en su lugar. - - -A partir de PHP 8.0.0, se lanza una ValueError si [width] es inferior a cero o superior a PHP_INT_MAX. -Anterior a PHP 8.0.0, se emitía un E_WARNING en su lugar. - - -A partir de PHP 8.0.0, se lanza una ValueError si [precision] es inferior a cero o superior a PHP_INT_MAX. -Anterior a PHP 8.0.0, se emitía un E_WARNING en su lugar. - - -A partir de PHP 8.0.0, se lanza una ArgumentCountError cuando se proporcionan menos argumentos de los requeridos. -Anterior a PHP 8.0.0, se devolvía &false; y se emitía un E_WARNING en su lugar. - + A partir de PHP 8.0.0, se lanza una ValueError si el número de argumentos es nulo. Anterior a + PHP 8.0.0, se emitía un E_WARNING en su lugar. + + + A partir de PHP 8.0.0, se lanza una ValueError si [width] es inferior a cero o superior a PHP_INT_MAX. + Anterior a PHP 8.0.0, se emitía un E_WARNING en su lugar. + + + A partir de PHP 8.0.0, se lanza una ValueError si [precision] es inferior a cero o superior a PHP_INT_MAX. + Anterior a PHP 8.0.0, se emitía un E_WARNING en su lugar. + + + A partir de PHP 8.0.0, se lanza una ArgumentCountError cuando se proporcionan menos argumentos de los requeridos. Anterior a + PHP 8.0.0, se devolvía &false; y se emitía un E_WARNING en su lugar. + '> - A partir de PHP 8.0.0, se lanza un ValueError si el número de argumentos es cero. - Anterior a PHP 8.0.0, se emitía un E_WARNING en su lugar. + A partir de PHP 8.0.0, se lanza un ValueError si el número de argumentos es cero. Anterior a + PHP 8.0.0, se emitía un E_WARNING en su lugar. A partir de PHP 8.0.0, se lanza un ValueError si [width] es menor que cero o mayor que PHP_INT_MAX. @@ -4749,58 +4621,60 @@ Anterior a PHP 8.0.0, se devolvía &false; y se emitía un E_WARNINGE_WARNING en su lugar. - A partir de PHP 8.0.0, se lanza un ValueError cuando se proporcionan menos argumentos de los requeridos. - Anterior a PHP 8.0.0, se devolvía &false; y se emitía un E_WARNING en su lugar. + A partir de PHP 8.0.0, se lanza un ValueError cuando se proporcionan menos argumentos de los requeridos. Anterior a + PHP 8.0.0, se devolvía &false; y se emitía un E_WARNING en su lugar. '> - Devuelve un valor inferior a 0 si string1 es inferior a string2; un valor superior a 0 si string1 es superior a string2, y 0 si son - iguales. - No se puede deducir ningún significado particular de este valor, + iguales. No + se puede deducir ningún significado particular de este valor, excepto su signo. '> - - - -filter - - - El filtro a aplicar. - Puede ser un filtro de validación utilizando una de las constantes - FILTER_VALIDATE_*, un filtro de - limpieza utilizando una de las constantes - FILTER_SANITIZE_* o FILTER_UNSAFE_RAW, - o un filtro personalizado utilizando FILTER_CALLBACK. - - - El valor por omisión es FILTER_DEFAULT, - que es un alias de FILTER_UNSAFE_RAW. - - - + + + + filter + + + El filtro a aplicar. + Puede ser un filtro de validación utilizando una de las constantes + FILTER_VALIDATE_* + , un filtro de limpieza utilizando una de las constantes + FILTER_SANITIZE_* + o FILTER_UNSAFE_RAW, o un filtro personalizado utilizando + FILTER_CALLBACK. + + + El valor predeterminado es FILTER_DEFAULT, + que es un alias de FILTER_UNSAFE_RAW + . + + + '> - - + -Las fuentes de aleatoriedad por orden de prioridad son las siguientes: + Las fuentes de aleatoriedad por orden de prioridad son las siguientes: - + Linux: getrandom(), /dev/urandom - - - + + + FreeBSD >= 12 (PHP >= 7.3): getrandom(), /dev/urandom @@ -4839,41 +4713,41 @@ Las fuentes de aleatoriedad por orden de prioridad son las siguientes: Solaris (PHP >= 8.1): getrandom(), /dev/urandom - - - - Cualquier combinación de un sistema operativo y una versión de PHP no mencionada anteriormente: - /dev/urandom. - - - - - Si ninguna de las fuentes de aleatoriedad está disponible o todas fallan al generar - aleatoriedad, se lanzará una excepción de tipo Random\RandomException. - - + + + + Cualquier combinación de un sistema operativo y una versión de PHP no mencionada anteriormente: /dev/urandom. + + + + + Si ninguna de las fuentes de aleatoriedad está disponible o todas fallan al generar aleatoriedad, se lanzará + una excepción de tipo Random\RandomException + . + + '> - - - Si no se encuentra ninguna fuente de datos aleatorios, se lanzará una - Random\RandomException. - - + + + Si no se encuentra ninguna fuente de datos aleatorios, se lanzará + una Random\RandomException. + + '> - - - Aunque esta función fue añadida en PHP 7.0, una - implementación en espacio de usuario - está disponible para PHP 5.2 hasta 5.6, inclusive. - - + + + Aunque esta función fue añadida en PHP 7.0, una + implementación en espacio de usuario + está disponible para PHP 5.2 hasta 5.6, inclusive. + + '> - - + Cualquier Throwable lanzado por el método Random\Engine::generate @@ -4882,27 +4756,27 @@ Las fuentes de aleatoriedad por orden de prioridad son las siguientes: '> - - + Si la URI resultante es inválida, se lanza una excepción Uri\InvalidUriException. - '> +'> - Si la URL resultante es inválida, se lanza una excepción Uri\WhatWg\InvalidUrlException. - '> +'> - + - Esta función ha sido - ELIMINADA en PECL uopz 5.0.0.'> +ELIMINADA en PECL uopz 5.0.0.'> - - + + parser @@ -4911,12 +4785,12 @@ xmlns="http://docbook.org/ns/docbook">Esta función ha sido '> - - Si &null; se pasa, el controlador se reinicia a su estado por omisión. + + Si &null; se pasa, el controlador se reinicia a su estado predeterminado. - Una cadena vacía también reiniciará el controlador, - sin embargo esta funcionalidad está deprecada a partir de PHP 8.4.0. + Una cadena vacía también reiniciará el controlador, sin embargo + esta funcionalidad está deprecada a partir de PHP 8.4.0. @@ -4932,21 +4806,21 @@ xmlns="http://docbook.org/ns/docbook">Esta función ha sido Esta funcionalidad está deprecada a partir de PHP 8.4.0. - + - 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 xml_set_object debe ser llamado antes - de definir un método como cadena como devolución de llamada. + 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 xml_set_object 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 callable adecuado para el método. '> - + parser @@ -4958,7 +4832,7 @@ xmlns="http://docbook.org/ns/docbook">Esta función ha sido 8.4.0 - Pasar un string no callable a + Pasar un valor no callable de tipo string a handler ahora está obsoleto; utilice un callable apropiado para los métodos, o &null; para reinicializar el gestor. @@ -4971,41 +4845,41 @@ xmlns="http://docbook.org/ns/docbook">Esta función ha sido '> - + 8.0.0 parser ahora espera una instancia de XMLParser - en lugar de un resource xml. + ; anteriormente, se esperaba un recurso xml de tipo resource válido. '> - - - Todos los flujos clientes cifrados activan ahora la verificación por pares por omisión. - Por omisión, esto utilizará el CA OpenSSL por omisión para verificar el par - de certificados. En la mayoría de los casos, no se necesita realizar ninguna modificación - para comunicarse con servidores y certificados SSL válidos, sabiendo que los distribuidores - configuran generalmente OpenSSL para utilizar los CA conocidos. - + + + Todos los flujos clientes cifrados activan ahora la verificación por pares por defecto. + Por defecto, esto utilizará el paquete de CA predeterminado de OpenSSL para verificar el + par de certificados. En la mayoría de los casos, no se necesita realizar ninguna modificación + para comunicarse con servidores y certificados SSL válidos, sabiendo que los + distribuidores configuran generalmente OpenSSL para utilizar los CA conocidos. + - - El CA por omisión puede ser sobrescrito a nivel global utilizando las + + El paquete de CA predeterminado puede ser sobrescrito a nivel global utilizando las opciones de configuración openssl.cafile o openssl.capath, o mediante una solicitud básica utilizando las opciones de contexto cafile o - capath. - + capath + . + - - Aunque no se recomienda en general, es posible desactivar la - verificación de certificados por pares para una solicitud definiendo la - opción de contexto verify_peer - a &false;, y para desactivar la validación del nombre de los pares, configurando - la opción de contexto - verify_peer_name + + Aunque no se recomienda en general, es posible desactivar la verificación de certificados + por pares para una solicitud definiendo la opción de contexto + verify_peer + a &false;, y para desactivar la validación del nombre de los pares, configurando la opción de + contexto verify_peer_name a &false;. - + '> - - + + @@ -11,37 +10,37 @@ PHP, que significa PHP: Preprocesador de Hipertexto, es un lenguaje de programación de propósito general, - de código abierto y ampliamente utilizado, especialmente adecuado para el desarrollo web y - que se puede incrustar en HTML. Su sintaxis se basa en C, Java y Perl, y es fácil de aprender. - El objetivo principal del lenguaje es permitir a los desarrolladores web escribir páginas web - dinámicas rápidamente, pero se puede hacer mucho más con PHP. + de código abierto y ampliamente utilizado, especialmente adecuado para el + desarrollo web y que se puede incrustar en HTML. Su sintaxis se basa en C, + Java y Perl, y es fácil de aprender. El objetivo principal del lenguaje es + permitir a los desarrolladores web escribir páginas web dinámicas + rápidamente, pero se puede hacer mucho más con PHP. - - Este manual consiste principalmente en una + Este manual consta principalmente de una referencia de funciones, aunque también contiene una referencia del lenguaje, explicaciones - de algunas de las características - importantes de PHP, y otra información - suplementaria. + de algunas de las principales características + de PHP, y otra información suplementaria. - - Este manual incluye información sobre las dos versiones principales más recientes de PHP (versiones 7 y 8). - No se incluye información sobre extensiones que ya no forman parte de estas versiones de PHP ni sobre cambios - en funciones de versiones anteriores. Los archivos de versiones antiguas del manual, que documentan lanzamientos + Este manual incluye información que cubre las dos versiones principales más + recientes de PHP (versiones 7 y 8). No se incluye información sobre + extensiones que ya no están incluidas en esas versiones de PHP ni sobre + cambios en funciones de versiones anteriores del manual. Los archivos + históricos de versiones anteriores del manual, que documentan lanzamientos previos de PHP, están disponibles en la sección "Más documentación" en la - página de "Documentación" del sitio web de PHP. + página de "Documentación" del sitio web + de PHP. - - Este manual se puede descargar en diferentes formatos en &url.php.doc.downloads;. Puede encontrarse más información sobre cómo se desarrolla este manual en el - apéndice "Acerca de este manual". Si está - interesado en la Historia de PHP, + apéndice 'Acerca del manual'. Si está + interesado en la historia de PHP, visite el apéndice correspondiente.