[web-php] master: Add Chinese translation of 8.6 release webpage (#2071)
| From: | Weilin Du via GitHub | Date: | Wed, 18 Nov 2026 07:05:31 +0000 |
| Subject: | [web-php] master: Add Chinese translation of 8.6 release webpage (#2071) | ||
| Groups: | php.webmaster | ||
| Request: | Send a blank email to php-webmaster+get-34209@lists.php.net to get a copy of this message | ||
Author: Weilin Du (LamentXU123)
Committer: GitHub (web-flow)
Pusher: saundefined
Date: 2026-11-18T10:05:28+03:00
Commit: https://github.com/php/web-php/commit/383be4bb903540335ab264ae754229b0acc26ee5
Raw diff: https://github.com/php/web-php/commit/383be4bb903540335ab264ae754229b0acc26ee5.diff
Add Chinese translation of 8.6 release webpage (#2071)
Co-authored-by: Luffy <lufei@php.net>
Changed paths:
A public/releases/8.6/languages/zh.php
A public/releases/8.6/zh.php
M public/releases/8.6/common.php
Diff:
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
+
+/**
+ * En-revision: 3a119ea0972f5773f09f8e103951f36c6b481b10
+ */
+
+return [
+ 'common_header' => 'PHP 8.6 是 PHP 语言的一次重大更新,新增了
Partial Function Application、Duration 类、Polling API 和 clamp() 函数等功能。',
+ 'main_title' => '更智能、更快速,为未来而生。',
+ 'main_subtitle' => '<p><strong>PHP 8.6 是 PHP
语言的一次重大更新</strong>,新增了 <strong>Partial Function
Application</strong>、<strong>Duration</strong> 类、<strong>Polling
API</strong> 和 <strong>clamp()</strong> 函数等功能。</p>',
+
+ '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' =>
'<p><strong>更快</strong>、<strong>更简洁</strong>、<strong>为开发者而生</strong>。</p>',
+
+ 'features_pfa_description' =>
'<p>允许预先提供函数的部分参数,并返回一个接收其余参数的
Closure。</p>',
+ 'features_readonly_property_defaults_description' => '<p>允许为
readonly
属性声明默认值,无需再在构造函数中为其赋予固定值。</p>',
+ 'features_polling_api_description' => '<p>通过 epoll、kqueue
等原生机制提供可扩展的 I/O 多路复用,可供 ReactPHP、AMPHP
等事件循环库使用。</p>',
+ 'features_clamp_description' =>
'<p>确保给定值处于指定范围内,既适用于数值,也适用于其他类型的值。</p>',
+ 'features_duration_description' => '<p>Duration
类用于表示像秒表一样测量的经过时间。</p>',
+ 'features_sort_direction_description' =>
'<p>提供标准且类型安全的排序方向表示方式,可供不同的库共同使用。</p>',
+
+ 'pfa_title' => 'Partial Function Application',
+ 'pfa_description' => '允许预先提供函数的部分参数,并用
<code>?</code> 和 <code>...</code>
为其余参数占位。返回结果是一个
Closure,只有在向其传入剩余参数后,才会调用原函数。',
+ 'readonly_property_defaults_title' => 'readonly 属性默认值',
+ 'readonly_property_defaults_description' => '现在可以为实例的
readonly 属性声明默认值,包括 readonly
类中的属性。这让实现具有固定值的仅可读接口属性变得更简单,而此前必须在构造函数中为这些属性赋值。声明默认值即完成了属性初始化,因此构造函数无法再覆盖该值。',
+ 'polling_api_title' => 'Polling API',
+ 'polling_api_description' => '全新的 <code>Io\Poll</code> API
使用各平台上最合适的机制(epoll、kqueue、event ports 或
WSAPoll)高效地同时监控大量流,突破了 <code>stream_select()</code>
的可扩展性限制。它旨在为 ReactPHP、AMPHP 等事件循环库提供通用基础。',
+ 'clamp_title' => '新增 <code>clamp()</code> 函数',
+ 'clamp_description' =>
'确保给定值处于指定范围内,既适用于数值,也适用于其他类型的值。如果超出范围,则返回最接近的边界值。',
+ 'duration_title' => '新增 <code>\Time\Duration</code>
类',
+ 'duration_description' => 'Duration
类用于表示像秒表一样测量的经过时间。它不依赖具体时刻或时区,能够以纳秒精度表示超过
250 年的时间跨度,非常适合清晰地表达超时时长或基准测试耗时。',
+ 'sort_direction_title' => '新增 <code>SortDirection</code>
枚举',
+ 'sort_direction_description' =>
'<p><code>SortDirection</code> 枚举通过
<code>Ascending</code> 和 <code>Descending</code>
两个枚举项,提供通用且类型安全的排序方向表示方式。此前,各个库必须自行定义排序方向,导致整数、字符串、布尔值和自定义枚举等互不兼容的表示方式混杂使用。由于
<code>SortDirection</code> 内置于 PHP,库可以直接在公共 API
中接收它,无需编写适配代码。</p><p>可在 <a href="https://thephp.foundation/blog/2026/11/03/stdlib-investment/"
target="_blank" rel="noopener noreferrer">The PHP Foundation
的博客</a>中进一步了解此特性。</p>',
+ 'stream_error_handling_title' => '流错误处理',
+ 'stream_error_handling_description' =>
'现在可以将流操作配置为在出错时抛出
<code>StreamException</code>,或静默失败,而不再发出警告。错误以结构化的
<code>StreamError</code> 对象形式报告,其中包含
<code>StreamErrorCode</code> 枚举项、封装器名称以及受影响的路径或
URL。还可以稍后通过 <code>stream_last_errors()</code>
获取这些错误,或将其传递给自定义错误处理函数。',
+ 'doc_comments_title' => '函数参数的 DocComments',
+ 'doc_comments_description' =>
'函数和方法的参数现在可以拥有各自的 DocComments,并可通过新增的
<code>ReflectionParameter::getDocComment()</code>
方法获取。这样就能直接在每个参数的声明旁编写文档,无需在
<code>@param</code> 标签中重复参数名称和类型。',
+ 'isreadable_iswriteable_title' => '新增
<code>ReflectionProperty::isReadable()</code> 和
<code>ReflectionProperty::isWritable()</code> 方法',
+ 'isreadable_iswriteable_description' => '随着 readonly
属性、不对称可见性和属性钩子的引入,仅检查属性是否为 public
已不足以判断它能否被读取或写入。这两个新方法可以直接判断属性在给定作用域下是否可读或可写,也可以针对特定对象进行判断,并综合考虑可见性、初始化状态、钩子和魔术方法。',
+
+ 'new_classes_title' => '更多特性与改进',
+ 'new_override_constants' => '<code>#[\Override]</code>
注解现在可以用于类常量和枚举项。',
+ 'new_enum_debug_info' => '枚举现在可以实现
<code>__debugInfo()</code> 魔术方法。',
+ 'new_const_object_writes' =>
'现在可以直接修改常量所存储对象的属性,例如
<code>Config::DEFAULTS->timeout = 30</code>。',
+ 'new_uri_builder' => '新增 <code>Uri\Rfc3986\UriBuilder</code>
和 <code>Uri\WhatWg\UrlBuilder</code> 类,可根据各组成部分构建
URI,同时新增了用于检测 URI 类型和主机类型的方法,以及
<code>Uri\WhatWg\url_percent_encode()</code> 函数。',
+ 'new_sodium' => 'Sodium 扩展新增了后量子密钥封装(X-Wing 和
ML-KEM-768)、IP 地址加密,以及 SHAKE 和 TurboSHAKE 可扩展输出函数。',
+ 'new_tls' => 'TLS 流现在支持会话恢复、外部预共享密钥和 TLS
1.3 早期数据(0-RTT)。',
+ 'new_mysqli_quote_string' => '新增
<code>mysqli::quote_string()</code>
方法,用于转义字符串并为其加上引号,行为与
<code>PDO::quote()</code> 一致。',
+ 'new_pack_endianness' => '<code>pack()</code> 和
<code>unpack()</code> 现在支持在整数和浮点数格式码上使用
<code><</code> 和 <code>></code> 字节序修饰符。',
+ 'new_json_error_location' => 'JSON
错误消息现在会包含错误在输入内容中的位置。',
+ 'new_error_include_args' => '新增
<code>error_include_args</code> INI
设置,用于统一控制在错误消息中包含函数参数。',
+ 'new_intl' => '新增 <code>grapheme_strrev()</code>
函数,可按字素簇反转字符串;新增 <code>IntlNumberRangeFormatter</code>
类,用于格式化数值范围。',
+ 'new_zip' => '新增 <code>ZipArchive::openString()</code> 和
<code>ZipArchive::closeString()</code>
方法,用于处理内存中的归档文件。',
+ 'new_performance' => '性能改进包括:将使用 first-class callable 或
Partial Function Application 回调的 <code>array_map()</code>
调用编译为循环、加快 <code>printf()</code>
调用、缓存无状态闭包,以及加快 JSON 编码。',
+
+ 'bc_title' => '弃用与向后不兼容的变更',
+ 'bc_return_in_finally' => '在 <code>finally</code> 块中使用
<code>return</code> 现已弃用,因为它会静默丢弃异常,并覆盖
<code>try</code> 或 <code>catch</code> 块的返回值。',
+ 'bc_constructor_return' => '从 <code>__construct()</code> 或
<code>__destruct()</code>
返回值的行为现已弃用,将它们用作生成器的行为也已弃用。为
<code>__debugInfo()</code> 声明可空返回类型也已弃用。',
+ 'bc_reserved_identifiers' => '将 <code>let</code> 或
<code>is</code> 用作类名、函数名或常量名现已弃用。将
<code>_</code> 用作常量名、将 <code>namespace</code>
用作类常量名,以及将 <code>readonly</code>
用作函数名也已弃用。',
+ 'bc_mbregex' => '由于底层的 Oniguruma
库已停止维护,<code>mb_ereg()</code> 和 <code>mb_split()</code> 等
mbstring 正则表达式函数现已弃用。可改用带 <code>u</code> 修饰符的
PCRE 函数。',
+ 'bc_type_aliases' =>
'<code>is_double()</code>、<code>is_long()</code>、<code>is_integer()</code>
和 <code>doubleval()</code> 这些别名现已弃用。请改用
<code>is_float()</code>、<code>is_int()</code> 和
<code>floatval()</code>。',
+ 'bc_spl_object_hash' => '<code>spl_object_hash()</code>
现已弃用,请改用
<code>spl_object_id()</code>;<code>spl_classes()</code>
也已弃用,请改用 <code>ReflectionExtension::getClassNames()</code>。',
+ 'bc_objects_as_arrays' => '向
<code>array_walk()</code>、<code>array_walk_recursive()</code>、<code>http_build_query()</code>、<code>mb_convert_variables()</code>
以及压缩函数和过滤器中应接收数组的位置传入对象,现已弃用。请先使用
<code>get_object_vars()</code> 将对象转换为数组。',
+ 'bc_strcoll' => '<code>strcoll()</code> 和
<code>SORT_LOCALE_STRING</code> 排序标志现已弃用。请改用 intl 扩展的
<code>Collator</code> 类。',
+ 'bc_ignored_arguments' => '向 <code>define()</code>
传入第三个参数现已弃用。在 <code>$allow_string</code> 为
<code>false</code> 时,使用类名字符串调用 <code>is_a()</code> 或
<code>is_subclass_of()</code> 也已弃用。',
+ 'bc_php_filter' => '在未设置
<code>filter.max_filter_count</code> 上下文选项的情况下,在
<code>php://filter</code> URL 中使用超过 16
个过滤器的行为现已弃用。',
+ 'bc_session_defaults' =>
'会话的默认配置现在更加安全:默认启用
<code>session.use_strict_mode</code> 和
<code>session.cookie_httponly</code>,并将
<code>session.cookie_samesite</code> 设为 <code>Lax</code>。',
+ 'bc_session_handlers' => '未同时实现
<code>create_sid()</code> 和 <code>validateId()</code>
的自定义会话处理器现已弃用。',
+ 'bc_other_deprecations' =>
'<code>metaphone()</code>、<code>mysqli_get_charset()</code> 和
<code>mysqli_stmt_init()</code>
函数现已弃用。此外,<code>SplFileObject</code> 的 CSV 方法,以及
<code>ArrayIterator</code> 的排序、标志和序列化方法也已弃用。',
+ 'bc_trim_form_feed' =>
'<code>trim()</code>、<code>ltrim()</code> 和
<code>rtrim()</code>
现在默认也会移除换页符(<code>\f</code>)。',
+ 'bc_stream_close_errors' =>
'当刷新或关闭流失败时,<code>fclose()</code>、<code>file_put_contents()</code>
和 <code>copy()</code> 现在会返回
<code>false</code>,而不再静默忽略失败。',
+ 'bc_value_errors' => '对于超出范围的值、无效标志或包含 NUL
字节的字符串,许多函数现在会抛出
<code>ValueError</code>,而不再静默截断或忽略它们。',
+
+ 'footer_title' =>
'更好的语法、更高的性能以及更强的类型安全性。',
+ 'footer_description' => '<p
class="first-paragraph">完整的变更列表记录在 <a
href="/ChangeLog-8.php#PHP_8_6" target="_blank">ChangeLog</a>
中。</p><p>如需查看详细的新特性与向后不兼容的变更,请查阅<a
href="/manual/zh/migration86.php"
target="_blank">迁移指南</a>。</p>',
+];
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 @@
+<?php
+
+$lang = 'zh';
+
+require_once __DIR__ . '/release.inc';