Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions public/releases/8.6/common.php
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@
const LANGUAGES = [
'en' => 'English',
'ru' => 'Русский',
'zh' => '简体中文',
];

function common_header(string $description): void {
Expand Down
83 changes: 83 additions & 0 deletions public/releases/8.6/languages/zh.php
Original file line number Diff line number Diff line change
@@ -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-&gt;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>&lt;</code> 和 <code>&gt;</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>',
];
5 changes: 5 additions & 0 deletions public/releases/8.6/zh.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
<?php

$lang = 'zh';

require_once __DIR__ . '/release.inc';
Loading