diff --git a/language/predefined/interfaces.xml b/language/predefined/interfaces.xml index 958f06779..9b4c6b91f 100644 --- a/language/predefined/interfaces.xml +++ b/language/predefined/interfaces.xml @@ -1,5 +1,5 @@ - + + + + + La enumeración SortDirection + SortDirection + + +
+ &reftitle.intro; + + La enumeración SortDirection se utiliza para + especificar la dirección en la que se ordenan los valores. + + + + A partir de PHP 8.6.0, ninguna de las funciones incluidas con PHP acepta un + SortDirection. Por ejemplo, + array_multisort sigue esperando + SORT_ASC o SORT_DESC. + + +
+ +
+ &reftitle.enumsynopsis; + + + SortDirection + + + Ascending + + + + Descending + + +
+ +
+ &reftitle.examples; + + Ordenar nombres con <enumname>SortDirection</enumname> + + sort($names), + SortDirection::Descending => rsort($names), + }; + + return $names; +} + +$names = ['Charlie', 'Alice', 'Bob']; + +print_r(sortNames($names, SortDirection::Descending)); +]]> + + &example.outputs; + + Charlie + [1] => Bob + [2] => Alice +) +]]> + + +
+ +
+ &reftitle.seealso; + + Ordenación de arrays + Enumeraciones + +
+
+
+ diff --git a/language/types/integer.xml b/language/types/integer.xml index 5f175b1eb..19938e23f 100644 --- a/language/types/integer.xml +++ b/language/types/integer.xml @@ -1,5 +1,5 @@ - + Los enteros @@ -120,6 +120,34 @@ var_dump($large_number); // float(5.0E+19) var_dump(PHP_INT_MAX + 1); // sistema de 32 bits: float(2147483648) // sistema de 64 bits: float(9.2233720368548E+18) ?> +]]> + + + + + Un literal int negativo es un literal positivo al que se le + aplica el operador de negación. + Esto significa que PHP_INT_MIN no puede escribirse como + literal: en -9223372036854775808, el literal + 9223372036854775808 está fuera de los límites del tipo + int en los sistemas de 64 bits, por lo que se interpreta como un + float antes de ser negado. + Lo mismo se aplica a -2147483648 en los sistemas de 32 bits. + Utilice en su lugar PHP_INT_MIN, o una expresión como + -9223372036854775807 - 1. + + + + El <type>int</type> más pequeño + + ]]> diff --git a/reference/hash/functions/hash-file.xml b/reference/hash/functions/hash-file.xml index 53fb5adb8..630d84623 100644 --- a/reference/hash/functions/hash-file.xml +++ b/reference/hash/functions/hash-file.xml @@ -1,5 +1,5 @@ - + @@ -53,9 +53,17 @@ options - Un array de opciones para los diversos algoritmos de hash. - Actualmente, solo el parámetro "seed" es - soportado para las variantes MurmurHash. + Un array de opciones para los diversos algoritmos de hash: + + + 'seed' (int) + Soportado por MurmurHash3 y las variantes de XXHash. + + + 'secret' (string) + Soportado por xxh3 y xxh128. + + diff --git a/reference/hash/functions/hash-init.xml b/reference/hash/functions/hash-init.xml index 2b300da0a..8c93ab179 100644 --- a/reference/hash/functions/hash-init.xml +++ b/reference/hash/functions/hash-init.xml @@ -1,5 +1,5 @@ - + @@ -60,9 +60,17 @@ options - Un array de opciones para los algoritmos diversos de hachado. - Actualmente, solo el parámetro "seed" es - soportado para las variantes MurmurHash. + Un array de opciones para los algoritmos diversos de hachado: + + + 'seed' (int) + Soportado por MurmurHash3 y las variantes de XXHash. + + + 'secret' (string) + Soportado por xxh3 y xxh128. + + @@ -121,14 +129,6 @@ El parámetro options ha sido añadido. - 7.2.0 - El uso de funciones de hachado no criptográficas (adler32, crc32, crc32b, fnv132, fnv1a32, fnv164, fnv1a64, joaat) con HASH_HMAC ha sido desactivado. - - - 7.2.0 - - Retorna una HashContext en lugar de un recurso. - 8.0.0 Levanta una excepción ValueError ahora si el @@ -139,6 +139,16 @@ E_WARNING era emitido. + + 7.2.0 + El uso de funciones de hachado no criptográficas (adler32, crc32, crc32b, fnv132, fnv1a32, fnv164, fnv1a64, joaat) con HASH_HMAC ha sido desactivado. + + + 7.2.0 + + Retorna una HashContext en lugar de un recurso. + + diff --git a/reference/hash/functions/hash.xml b/reference/hash/functions/hash.xml index 3a29a8539..af2cf116e 100644 --- a/reference/hash/functions/hash.xml +++ b/reference/hash/functions/hash.xml @@ -1,5 +1,5 @@ - + @@ -52,9 +52,17 @@ options - Un array de opciones para los diversos algoritmos de hachado. - Actualmente, solo el parámetro "seed" es - soportado para las variantes MurmurHash. + Un array de opciones para los diversos algoritmos de hachado: + + + 'seed' (int) + Soportado por MurmurHash3 y las variantes de XXHash. + + + 'secret' (string) + Soportado por xxh3 y xxh128. + + diff --git a/reference/intl/dateformatter-constants.xml b/reference/intl/dateformatter-constants.xml index 5f1630b0a..cdc07fab8 100644 --- a/reference/intl/dateformatter-constants.xml +++ b/reference/intl/dateformatter-constants.xml @@ -1,6 +1,6 @@ - +
&reftitle.constants; @@ -137,7 +137,7 @@ int - Calendario no gregoriano + El calendario por omisión de la configuración local diff --git a/reference/intl/dateformatter/create.xml b/reference/intl/dateformatter/create.xml index 36451ca9a..75c9cf4f3 100644 --- a/reference/intl/dateformatter/create.xml +++ b/reference/intl/dateformatter/create.xml @@ -1,5 +1,5 @@ - + @@ -62,6 +62,14 @@ La configuración local a utilizar para formatear y analizar o &null; para utilizar el valor especificado en la configuración ini intl.default_locale. + + Se aceptan tanto en_US como en-US. + La configuración local puede incluir palabras clave de ICU, como + fa_IR@calendar=persian, pero la palabra clave + calendar solo modifica el calendario utilizado cuando + calendar es + IntlDateFormatter::TRADITIONAL. + @@ -73,6 +81,7 @@ long, full). Es una de las constantes IntlDateFormatter. + El valor por omisión es IntlDateFormatter::FULL. @@ -120,15 +129,36 @@ y si &null; es proporcionado en el argumento timezone, la zona horaria también será utilizada. + + IntlDateFormatter::GREGORIAN utiliza siempre el + calendario gregoriano, incluso si la configuración local tiene una palabra + clave calendar. + IntlDateFormatter::TRADITIONAL utiliza el calendario + por omisión de la configuración local: el indicado por su palabra clave + calendar si existe, o en caso contrario el que ICU + define para la región de la configuración local (por ejemplo persa para + fa_IR y budista para th_TH, pero + gregoriano para en_US). Este último depende de la + versión de ICU. Los tipos de calendario disponibles para una configuración + local se enumeran mediante + IntlCalendar::getKeywordValuesForLocale. + pattern - - El patrón a utilizar para el formato o el análisis. + + El patrón opcional a utilizar para el formato o el análisis. Si se + proporciona, se utiliza en lugar del formato determinado por + dateType y timeType. Los patrones disponibles están documentados en &url.icu.datepattern;. - + + + Un patrón no contiene ninguna zona horaria: la hora que muestra, y el + nombre que muestran las letras z, son los del + parámetro timezone. + @@ -261,6 +291,45 @@ El primer formato se muestra con el patrón: 12/31/1969 El segundo formato se muestra con el patrón: 12/31/1969 ]]> + + Calendario de la configuración local y zona horaria con un patrón + +format($timestamp), "\n"; +} + +$formatter = new IntlDateFormatter( + 'en_US', + IntlDateFormatter::FULL, + IntlDateFormatter::FULL, + 'Asia/Singapore', + null, + 'yyyy-MM-dd HH:mm zzzz' +); +echo $formatter->format(gmmktime(21, 0, 0, 6, 1, 2024)), "\n"; +]]> + + &example.outputs; + + + + diff --git a/reference/openssl/functions/openssl-pbkdf2.xml b/reference/openssl/functions/openssl-pbkdf2.xml index 706ca9b51..d0545c88f 100644 --- a/reference/openssl/functions/openssl-pbkdf2.xml +++ b/reference/openssl/functions/openssl-pbkdf2.xml @@ -1,5 +1,5 @@ - + @@ -54,12 +54,10 @@ iterations - + El número de iteraciones deseado. - El NIST - recomienda al menos 1 000. A partir de 2023, el OWASP recomienda 600 000 iteraciones para - PBKDF2-HMAC-SHA256 y 210 000 para PBKDF2-HMAC-SHA512. - + A partir de 2026, el OWASP recomienda 600 000 iteraciones para HMAC-SHA256 y 220 000 para HMAC-SHA512. +