From bd5ee795cb2b6b7b1ab2a5cec66a2e431f507b42 Mon Sep 17 00:00:00 2001 From: Waldo Malqui Date: Tue, 29 Sep 2026 00:07:23 -0500 Subject: [PATCH 1/3] [Review] Review and refine appendices/migration72 translation files --- appendices/migration72/constants.xml | 7 ++--- appendices/migration72/deprecated.xml | 27 ++++++++-------- appendices/migration72/incompatible.xml | 39 ++++++++++++------------ appendices/migration72/new-features.xml | 33 ++++++++++++-------- appendices/migration72/new-functions.xml | 5 ++- appendices/migration72/other-changes.xml | 36 +++++++++++++++------- 6 files changed, 83 insertions(+), 64 deletions(-) diff --git a/appendices/migration72/constants.xml b/appendices/migration72/constants.xml index d0b892a3b0..e77b87e6dc 100644 --- a/appendices/migration72/constants.xml +++ b/appendices/migration72/constants.xml @@ -1,7 +1,6 @@ - - - + + Nuevas constantes globales @@ -117,7 +116,7 @@ - <link linkend="book.password">Tabla de hash de contraseña</link> + <link linkend="book.password">Hash de contraseñas</link> diff --git a/appendices/migration72/deprecated.xml b/appendices/migration72/deprecated.xml index 5e345248bd..4daf470799 100644 --- a/appendices/migration72/deprecated.xml +++ b/appendices/migration72/deprecated.xml @@ -1,7 +1,6 @@ - - - + + Funcionalidades obsoletas en PHP 7.2.x @@ -71,8 +70,8 @@ string(11) "INEXISTENTE" Directiva ini <parameter>track_errors</parameter> y variable <literal>$php_errormsg</literal> - Cuando la directiva ini track_errors está activada, una - variable $php_errormsg es creada en el ámbito local cuando + Cuando la directiva ini track_errors está activada, se crea + una variable $php_errormsg en el ámbito local cuando ocurre un error no fatal. Dado que el método preferido de obtener ese tipo de información de errores es usando error_get_last, esta característica ha sido marcada como obsoleta. @@ -93,7 +92,7 @@ string(11) "INEXISTENTE" Directiva ini <parameter>mbstring.func_overload</parameter> - Debido a los problemas de interoperabilidad de funciones basadas en cadenas usadas en + Debido a los problemas de interoperabilidad de funciones basadas en string usadas en entornos con esta directiva activada, ha sido marcada como obsoleta. @@ -116,7 +115,7 @@ string(11) "INEXISTENTE" Debido a los problemas de seguridad de ello, el uso de parse_str sin un segundo parámetro ha sido marcado como obsoleto. Esta función siempre debe ser usada con dos argumentos, ya que - el segundo argumento provoca que la cadena de consulta sea interpretada a un array. + el segundo argumento provoca que la cadena de consulta sea interpretada como un array. @@ -124,10 +123,10 @@ string(11) "INEXISTENTE" Función <function>gmp_random</function> - Esta función genera un número aleatorio dentro de rango que es + Esta función genera un número aleatorio dentro de un rango que es calculado por un método no expuesto y dependiente de la plataforma. Por ello, - esta función ha sido ahora marcado como obsoleto. El método preferido de generar un - número aleatorio usando la extensión GMP extension es usando + esta función ha sido ahora marcada como obsoleta. El método preferido para generar un + número aleatorio usando la extensión GMP es usando gmp_random_bits y gmp_random_range. @@ -144,12 +143,12 @@ string(11) "INEXISTENTE" - <function>assert</function> con una cadena como argumento + <function>assert</function> con un argumento string - Usar assert con una cadena como argumento requería que la cadena - fuera evaluada. Debido al potencial para ejecución remota - de código, el uso de assert con una cadena como argumento ha sido + Usar assert con un argumento string requería que el string + fuera evaluado. Debido al potencial para ejecución remota + de código, el uso de assert con un argumento string ha sido marcado como obsoleto en favor del uso de expresiones booleanas. diff --git a/appendices/migration72/incompatible.xml b/appendices/migration72/incompatible.xml index 77076f20f4..331bf39e11 100644 --- a/appendices/migration72/incompatible.xml +++ b/appendices/migration72/incompatible.xml @@ -1,7 +1,6 @@ - - - + + Cambios incompatibles con versiones anteriores @@ -38,7 +37,8 @@ var_dump(number_format(-0.01)); // ahora muestra string(1) "0" en lugar de strin - Esto significa que las claves representadas por un entero (o un entero en forma de texto) de un array convertido en objeto ahora son accesibles: + Esto significa que las claves representadas por un entero (o un entero en forma de texto) de un array convertido + en objeto ahora son accesibles: @@ -115,8 +115,7 @@ int(1) Anteriormente, pasar &null; a la función get_class devolvía el nombre de la clase en curso. Este comportamiento ha sido eliminado, se muestra un error E_WARNING en su lugar. - Para recuperar el mismo comportamiento que antes, el argumento debería - simplemente ser eliminado. + Para recuperar el mismo comportamiento que antes, el argumento debería simplemente ser eliminado. @@ -126,8 +125,7 @@ int(1) Se emitirá un E_WARNING al intentar utilizar la función count en un - tipo no contable (esto incluye la función alias - sizeof). + tipo no contable (esto incluye la función alias sizeof). @@ -172,9 +170,7 @@ int(2) Hash ha sido actualizada para utilizar los objetos en lugar de recursos. El cambio debería ser transparente para los desarrolladores PHP, excepto donde se hayan realizado verificaciones con - is_resource - (será necesario reemplazar por - is_object). + is_resource (será necesario reemplazar por is_object). @@ -249,7 +245,8 @@ int(2) Verificación de los valores por defecto de las propiedades de los traits - Los controles de compatibilidad en los valores por defecto de las propiedades de trait ya no realizarán la conversión. + Los controles de compatibilidad en los valores por defecto de las propiedades + de trait ya no realizarán la conversión. @@ -258,7 +255,8 @@ int(2) El nombre object estaba anteriormente soft-reservado en PHP 7.0. - Ahora está reservado, prohibiendo su uso como nombre de clase, trait o interfaz. + Ahora está reservado, prohibiendo su uso como nombre de clase, trait o + interfaz. @@ -298,12 +296,13 @@ int(2) - Funciones de hachage y hachages no criptográficos + Funciones hash y hashes no criptográficos Las funciones hash_hmac, hash_hmac_file, - hash_pbkdf2, y hash_init (con - HASH_HMAC) ya no aceptan hachages no criptográficos. + hash_pbkdf2 y hash_init (con + HASH_HMAC) ya no aceptan hashes no + criptográficos. @@ -311,9 +310,10 @@ int(2) Opciones de la función <function>json_decode</function> - La opción JSON_OBJECT_AS_ARRAY de la función - json_decode ahora se utiliza si el segundo parámetro - (assoc) es &null;. Anteriormente JSON_OBJECT_AS_ARRAY siempre fue ignorado. + La opción de la función json_decode, + JSON_OBJECT_AS_ARRAY, ahora se utiliza si el segundo parámetro + (assoc) es &null;. Anteriormente, JSON_OBJECT_AS_ARRAY siempre + se ignoraba. @@ -355,6 +355,7 @@ int(2) se decodifican URL por razones de seguridad. + - - + + Nuevas características @@ -35,9 +34,9 @@ test(new stdClass()); Carga de extensiones por nombre - Las extensiones compartidas ya no requieren que se especifique su extensión de archivo + Las extensiones compartidas ya no requieren que se especifique su extensión de fichero (.so para Unix o .dll para Windows) para - ser cargadas. Esto está habilitado en el archivo php.ini, así como en la + ser cargadas. Esto está habilitado en el fichero php.ini, así como en la función dl. @@ -76,7 +75,8 @@ abstract class B extends A La biblioteca moderna de criptografía Sodium se ha convertido en una extensión del núcleo en PHP. - Para una referencia completa de funciones, consulte el capítulo Sodium. + Para una referencia completa de funciones, consulte el capítulo + Sodium. @@ -160,7 +160,9 @@ $db->quote('über', PDO::PARAM_STR | PDO::PARAM_STR_NATL); El método PDOStatement::debugDumpParams ha sido actualizado para incluir el SQL que se envía a la base de datos, donde se mostrará la consulta completa y sin procesar - (incluyendo los marcadores de posición reemplazados con sus valores vinculados). Esto se ha añadido para ayudar en la depuración de preparaciones emuladas (y por lo tanto solo estará disponible cuando las preparaciones emuladas estén activadas). + (incluyendo los marcadores de posición reemplazados con sus valores vinculados). Esto se ha añadido para ayudar en la + depuración de preparaciones emuladas (y por lo tanto solo estará disponible cuando las preparaciones + emuladas estén activadas). @@ -168,7 +170,8 @@ $db->quote('über', PDO::PARAM_STR | PDO::PARAM_STR_NATL); Soporte para operaciones extendidas en <link linkend="book.ldap">LDAP</link> - Se ha añadido soporte para EXOP a la extensión LDAP. Esto se ha hecho exponiendo las siguientes funciones y constantes: + Se ha añadido soporte para EXOP a la extensión LDAP. Esto se ha hecho exponiendo + las siguientes funciones y constantes: @@ -224,7 +227,8 @@ $db->quote('über', PDO::PARAM_STR | PDO::PARAM_STR_NATL); Adiciones de Información de Dirección a la extensión <link linkend="book.sockets">Sockets</link> - La extensión de sockets ahora tiene la capacidad de buscar información de direcciones, así como conectarse a ella, enlazarse a ella y explicarla. Se han añadido las siguientes cuatro + La extensión de sockets ahora tiene la capacidad de buscar información de direcciones, así como conectarse a ella, enlazarse + a ella y explicarla. Se han añadido las siguientes cuatro funciones para esto: @@ -257,7 +261,8 @@ $db->quote('über', PDO::PARAM_STR | PDO::PARAM_STR_NATL); Los tipos de parámetros de métodos sobrescritos y de implementaciones de interfaces - ahora pueden ser omitidos. Esto sigue siendo conforme con LSP, ya que los tipos de parámetros son contravariantes. + ahora pueden ser omitidos. Esto sigue siendo conforme con LSP, ya que los tipos de + parámetros son contravariantes. @@ -280,7 +285,7 @@ class B implements A - Permitir una coma final para namespaces agrupados + Permitir una coma final para espacios de nombres agrupados Ahora se puede añadir una coma final a la sintaxis de uso agrupado introducida en @@ -325,7 +330,8 @@ use Foo\Bar\{ La extensión EXIF se ha actualizado para soportar una gama mucho más amplia de formatos. Esto significa que sus etiquetas específicas de formato ahora se traducen correctamente al analizar imágenes - con la función exif_read_data. Los siguientes nuevos formatos ahora son soportados: + con la función exif_read_data. Los siguientes nuevos formatos ahora + son soportados: @@ -432,7 +438,8 @@ use Foo\Bar\{ Se ha añadido soporte de lectura y escritura para archivos cifrados (requiere libzip 1.2.0). - La clase ZipArchive ahora implementa la interfaz Countable. + La clase ZipArchive ahora implementa la interfaz + Countable. El flujo zip:// ahora acepta una opción de contexto 'password'. diff --git a/appendices/migration72/new-functions.xml b/appendices/migration72/new-functions.xml index fa0acfaac0..05fe864834 100644 --- a/appendices/migration72/new-functions.xml +++ b/appendices/migration72/new-functions.xml @@ -1,7 +1,6 @@ - - - + + Nuevas funciones diff --git a/appendices/migration72/other-changes.xml b/appendices/migration72/other-changes.xml index 945833fbee..6d051cc986 100644 --- a/appendices/migration72/other-changes.xml +++ b/appendices/migration72/other-changes.xml @@ -1,7 +1,7 @@ - - + + Otros cambios @@ -10,16 +10,18 @@ Las funciones utf8_encode y - utf8_decode han sido trasladadas a la extensión estándar como funciones de string, mientras que antes la extensión XML era requerida para que estuvieran disponibles. + utf8_decode han sido trasladadas a la extensión estándar como funciones de string, + mientras que antes la extensión XML era requerida para que estuvieran disponibles. + Cambio para <function>mail</function> y <function>mb_send_mail</function> El parámetro $additional_headers de mail y mb_send_mail - acepta ahora un array en lugar de un string. + acepta ahora también un array en lugar de un string. @@ -42,17 +44,21 @@ - Unix: El argumento de configuración --with-pdo-oci ya no necesita la versión de Oracle Instant Client. + Unix: El argumento de configuración --with-pdo-oci ya no necesita la versión + de Oracle Instant Client. - Unix: El argumento de configuración --enable-gd-native-ttf ha sido eliminado. No ha sido utilizado desde PHP 5.5.0. + Unix: El argumento de configuración --enable-gd-native-ttf ha sido eliminado. + No ha sido utilizado desde PHP 5.5.0. - Windows: El argumento de configuración --with-config-profile ha sido añadido. Esto puede ser utilizado para guardar configuraciones específicas, un poco como el fichero mágico config.nice.bat. + Windows: El argumento de configuración --with-config-profile ha sido añadido. + Esto puede ser utilizado para guardar configuraciones específicas, un poco como el fichero mágico + config.nice.bat. @@ -64,12 +70,14 @@ - imageantialias está también disponible si se construye con libgd del sistema. + imageantialias está también disponible si se construye con + libgd del sistema. - imagegd almacena imágenes TrueColor como imágenes TrueColor reales. Anteriormente, eran convertidas a paleta. + imagegd almacena imágenes TrueColor como imágenes TrueColor reales. + Anteriormente, eran convertidas a paleta. @@ -79,7 +87,11 @@ Traslado de <link linkend="book.mcrypt">MCrypt</link> a PECL - La extensión MCrypt ha sido trasladada del núcleo a PECL. Dado que la biblioteca mcrypt no ha visto actualizaciones desde 2007, su uso está fuertemente desaconsejado. En su lugar, debe utilizarse OpenSSL o la extensión Sodium. + La extensión MCrypt ha sido trasladada del núcleo a PECL. + Dado que la biblioteca mcrypt no ha visto actualizaciones desde 2007, su uso está + fuertemente desaconsejado. En su lugar, debe utilizarse OpenSSL + o la extensión + Sodium. @@ -88,9 +100,11 @@ Pasar "user" a - session_module_name ahora provoca un error de nivel E_RECOVERABLE_ERROR. Anteriormente, esto era ignorado silenciosamente. + session_module_name ahora provoca un error de nivel + E_RECOVERABLE_ERROR. Anteriormente, esto era ignorado silenciosamente. +