diff --git a/public/releases/8.6/common.php b/public/releases/8.6/common.php index c54f4c8f58..35f54b4282 100644 --- a/public/releases/8.6/common.php +++ b/public/releases/8.6/common.php @@ -9,6 +9,7 @@ const LANGUAGES = [ 'en' => 'English', 'ru' => 'Русский', + 'zh' => '简体中文', ]; function common_header(string $description): void { diff --git a/public/releases/8.6/languages/zh.php b/public/releases/8.6/languages/zh.php new file mode 100644 index 0000000000..e89d00cb13 --- /dev/null +++ b/public/releases/8.6/languages/zh.php @@ -0,0 +1,83 @@ + 'PHP 8.6 是 PHP 语言的一次重大更新,新增了 Partial Function Application、Duration 类、Polling API 和 clamp() 函数等功能。', + 'main_title' => '更智能、更快速,为未来而生。', + 'main_subtitle' => '

PHP 8.6 是 PHP 语言的一次重大更新,新增了 Partial Function Application、Duration 类、Polling API 和 clamp() 函数等功能。

', + + 'whats_new' => '8.6 中的新特性', + 'upgrade_now' => '升级到 PHP 8.6', + 'old_version' => 'PHP 8.5 及更早版本', + 'badge_new' => '新增', + 'documentation' => '文档', + 'released' => '将于 2026 年 11 月 19 日发布', + 'release_unavailable_reason' => 'PHP 8.6 尚未发布,将于 2026 年 11 月 19 日发布。', + 'key_features' => 'PHP 8.6 的主要特性', + 'key_features_description' => '

更快、更简洁、为开发者而生。

', + + 'features_pfa_description' => '

允许预先提供函数的部分参数,并返回一个接收其余参数的 Closure。

', + 'features_readonly_property_defaults_description' => '

允许为 readonly 属性声明默认值,无需再在构造函数中为其赋予固定值。

', + 'features_polling_api_description' => '

通过 epoll、kqueue 等原生机制提供可扩展的 I/O 多路复用,可供 ReactPHP、AMPHP 等事件循环库使用。

', + 'features_clamp_description' => '

确保给定值处于指定范围内,既适用于数值,也适用于其他类型的值。

', + 'features_duration_description' => '

Duration 类用于表示像秒表一样测量的经过时间。

', + 'features_sort_direction_description' => '

提供标准且类型安全的排序方向表示方式,可供不同的库共同使用。

', + + 'pfa_title' => 'Partial Function Application', + 'pfa_description' => '允许预先提供函数的部分参数,并用 ? 和 ... 为其余参数占位。返回结果是一个 Closure,只有在向其传入剩余参数后,才会调用原函数。', + 'readonly_property_defaults_title' => 'readonly 属性默认值', + 'readonly_property_defaults_description' => '现在可以为实例的 readonly 属性声明默认值,包括 readonly 类中的属性。这让实现具有固定值的仅可读接口属性变得更简单,而此前必须在构造函数中为这些属性赋值。声明默认值即完成了属性初始化,因此构造函数无法再覆盖该值。', + 'polling_api_title' => 'Polling API', + 'polling_api_description' => '全新的 Io\Poll API 使用各平台上最合适的机制(epoll、kqueue、event ports 或 WSAPoll)高效地同时监控大量流,突破了 stream_select() 的可扩展性限制。它旨在为 ReactPHP、AMPHP 等事件循环库提供通用基础。', + 'clamp_title' => '新增 clamp() 函数', + 'clamp_description' => '确保给定值处于指定范围内,既适用于数值,也适用于其他类型的值。如果超出范围,则返回最接近的边界值。', + 'duration_title' => '新增 \Time\Duration 类', + 'duration_description' => 'Duration 类用于表示像秒表一样测量的经过时间。它不依赖具体时刻或时区,能够以纳秒精度表示超过 250 年的时间跨度,非常适合清晰地表达超时时长或基准测试耗时。', + 'sort_direction_title' => '新增 SortDirection 枚举', + 'sort_direction_description' => '

SortDirection 枚举通过 Ascending 和 Descending 两个枚举项,提供通用且类型安全的排序方向表示方式。此前,各个库必须自行定义排序方向,导致整数、字符串、布尔值和自定义枚举等互不兼容的表示方式混杂使用。由于 SortDirection 内置于 PHP,库可以直接在公共 API 中接收它,无需编写适配代码。

可在 The PHP Foundation 的博客中进一步了解此特性。

', + 'stream_error_handling_title' => '流错误处理', + 'stream_error_handling_description' => '现在可以将流操作配置为在出错时抛出 StreamException,或静默失败,而不再发出警告。错误以结构化的 StreamError 对象形式报告,其中包含 StreamErrorCode 枚举项、封装器名称以及受影响的路径或 URL。还可以稍后通过 stream_last_errors() 获取这些错误,或将其传递给自定义错误处理函数。', + 'doc_comments_title' => '函数参数的 DocComments', + 'doc_comments_description' => '函数和方法的参数现在可以拥有各自的 DocComments,并可通过新增的 ReflectionParameter::getDocComment() 方法获取。这样就能直接在每个参数的声明旁编写文档,无需在 @param 标签中重复参数名称和类型。', + 'isreadable_iswriteable_title' => '新增 ReflectionProperty::isReadable() 和 ReflectionProperty::isWritable() 方法', + 'isreadable_iswriteable_description' => '随着 readonly 属性、不对称可见性和属性钩子的引入,仅检查属性是否为 public 已不足以判断它能否被读取或写入。这两个新方法可以直接判断属性在给定作用域下是否可读或可写,也可以针对特定对象进行判断,并综合考虑可见性、初始化状态、钩子和魔术方法。', + + 'new_classes_title' => '更多特性与改进', + 'new_override_constants' => '#[\Override] 注解现在可以用于类常量和枚举项。', + 'new_enum_debug_info' => '枚举现在可以实现 __debugInfo() 魔术方法。', + 'new_const_object_writes' => '现在可以直接修改常量所存储对象的属性,例如 Config::DEFAULTS->timeout = 30。', + 'new_uri_builder' => '新增 Uri\Rfc3986\UriBuilder 和 Uri\WhatWg\UrlBuilder 类,可根据各组成部分构建 URI,同时新增了用于检测 URI 类型和主机类型的方法,以及 Uri\WhatWg\url_percent_encode() 函数。', + 'new_sodium' => 'Sodium 扩展新增了后量子密钥封装(X-Wing 和 ML-KEM-768)、IP 地址加密,以及 SHAKE 和 TurboSHAKE 可扩展输出函数。', + 'new_tls' => 'TLS 流现在支持会话恢复、外部预共享密钥和 TLS 1.3 早期数据(0-RTT)。', + 'new_mysqli_quote_string' => '新增 mysqli::quote_string() 方法,用于转义字符串并为其加上引号,行为与 PDO::quote() 一致。', + 'new_pack_endianness' => 'pack() 和 unpack() 现在支持在整数和浮点数格式码上使用 < 和 > 字节序修饰符。', + 'new_json_error_location' => 'JSON 错误消息现在会包含错误在输入内容中的位置。', + 'new_error_include_args' => '新增 error_include_args INI 设置,用于统一控制在错误消息中包含函数参数。', + 'new_intl' => '新增 grapheme_strrev() 函数,可按字素簇反转字符串;新增 IntlNumberRangeFormatter 类,用于格式化数值范围。', + 'new_zip' => '新增 ZipArchive::openString() 和 ZipArchive::closeString() 方法,用于处理内存中的归档文件。', + 'new_performance' => '性能改进包括:将使用 first-class callable 或 Partial Function Application 回调的 array_map() 调用编译为循环、加快 printf() 调用、缓存无状态闭包,以及加快 JSON 编码。', + + 'bc_title' => '弃用与向后不兼容的变更', + 'bc_return_in_finally' => '在 finally 块中使用 return 现已弃用,因为它会静默丢弃异常,并覆盖 try 或 catch 块的返回值。', + 'bc_constructor_return' => '从 __construct() 或 __destruct() 返回值的行为现已弃用,将它们用作生成器的行为也已弃用。为 __debugInfo() 声明可空返回类型也已弃用。', + 'bc_reserved_identifiers' => '将 let 或 is 用作类名、函数名或常量名现已弃用。将 _ 用作常量名、将 namespace 用作类常量名,以及将 readonly 用作函数名也已弃用。', + 'bc_mbregex' => '由于底层的 Oniguruma 库已停止维护,mb_ereg() 和 mb_split() 等 mbstring 正则表达式函数现已弃用。可改用带 u 修饰符的 PCRE 函数。', + 'bc_type_aliases' => 'is_double()、is_long()、is_integer() 和 doubleval() 这些别名现已弃用。请改用 is_float()、is_int() 和 floatval()。', + 'bc_spl_object_hash' => 'spl_object_hash() 现已弃用,请改用 spl_object_id();spl_classes() 也已弃用,请改用 ReflectionExtension::getClassNames()。', + 'bc_objects_as_arrays' => '向 array_walk()、array_walk_recursive()、http_build_query()、mb_convert_variables() 以及压缩函数和过滤器中应接收数组的位置传入对象,现已弃用。请先使用 get_object_vars() 将对象转换为数组。', + 'bc_strcoll' => 'strcoll() 和 SORT_LOCALE_STRING 排序标志现已弃用。请改用 intl 扩展的 Collator 类。', + 'bc_ignored_arguments' => '向 define() 传入第三个参数现已弃用。在 $allow_string 为 false 时,使用类名字符串调用 is_a() 或 is_subclass_of() 也已弃用。', + 'bc_php_filter' => '在未设置 filter.max_filter_count 上下文选项的情况下,在 php://filter URL 中使用超过 16 个过滤器的行为现已弃用。', + 'bc_session_defaults' => '会话的默认配置现在更加安全:默认启用 session.use_strict_mode 和 session.cookie_httponly,并将 session.cookie_samesite 设为 Lax。', + 'bc_session_handlers' => '未同时实现 create_sid() 和 validateId() 的自定义会话处理器现已弃用。', + 'bc_other_deprecations' => 'metaphone()、mysqli_get_charset() 和 mysqli_stmt_init() 函数现已弃用。此外,SplFileObject 的 CSV 方法,以及 ArrayIterator 的排序、标志和序列化方法也已弃用。', + 'bc_trim_form_feed' => 'trim()、ltrim() 和 rtrim() 现在默认也会移除换页符(\f)。', + 'bc_stream_close_errors' => '当刷新或关闭流失败时,fclose()、file_put_contents() 和 copy() 现在会返回 false,而不再静默忽略失败。', + 'bc_value_errors' => '对于超出范围的值、无效标志或包含 NUL 字节的字符串,许多函数现在会抛出 ValueError,而不再静默截断或忽略它们。', + + 'footer_title' => '更好的语法、更高的性能以及更强的类型安全性。', + 'footer_description' => '

完整的变更列表记录在 ChangeLog 中。

如需查看详细的新特性与向后不兼容的变更,请查阅迁移指南。

', +]; diff --git a/public/releases/8.6/zh.php b/public/releases/8.6/zh.php new file mode 100644 index 0000000000..522aa96600 --- /dev/null +++ b/public/releases/8.6/zh.php @@ -0,0 +1,5 @@ +