PHP 8.6 发布公告

Lobsters Hottest 新闻

摘要

PHP 8.6 计划于 2026 年 11 月 19 日发布,引入了多项重要的语言特性,包括 Partial Function Application(部分函数应用)、新的 Time\Duration 类、面向事件循环库的可扩展 Io\Poll API、clamp() 函数、SortDirection 枚举以及 readonly 属性默认值。

<p><a href="https://lobste.rs/s/xn50o0/php_8_6_release_announcement">评论</a></p>
查看原文
查看缓存全文

缓存时间: 2026/11/19 11:00

# PHP 8.6 正式发布 来源:https://www.php.net/releases/8.6/en.php 将于 2026 年 11 月 19 日发布 ## 更快、更安全、更强大 **PHP 8.6 是 PHP 语言的一次重大更新**,新增功能包括**部分函数应用(Partial Function Application)**、全新的 **Duration 类**、**Polling API** 以及全新的 `clamp()` 函数。 PHP 8.6 尚未发布,将于 2026 年 11 月 19 日发布。 ## PHP 8.6 的核心特性 **表达力更强的代码**、**更严格的类型**,以及**可扩展的 I/O**。 [部分函数应用 Partial Function Application](https://www.php.net/releases/8.6/en.php#partial-function-application) 允许预先提供函数的部分参数,返回一个接受剩余参数的 Closure。 [全新的 `\Time\Duration` 类](https://www.php.net/releases/8.6/en.php#duration-class) Duration 类表示秒表所测量的已流逝时间。 [Polling API](https://www.php.net/releases/8.6/en.php#polling-api) 使用 epoll、kqueue 及其他原生机制实现可扩展的 I/O 多路复用,供 ReactPHP、AMPHP 等事件循环库使用。 [全新的 `clamp()` 函数](https://www.php.net/releases/8.6/en.php#clamp-function) 确保给定值(数值或其他类型)落在指定范围内,否则返回最接近的边界值。 [全新的 `SortDirection` 枚举](https://www.php.net/releases/8.6/en.php#sort-direction-enum) 一种标准、类型安全的表达排序方式,可在各库之间共享。 [只读属性默认值](https://www.php.net/releases/8.6/en.php#readonly-property-defaults) 允许 readonly 属性声明默认值,固定值不必再在构造函数中赋值。 ## 部分函数应用(Partial Function Application) 允许预先提供函数的部分参数,用 `?` 和 `...` 占位符表示其余参数。结果是一个 Closure,只有在剩余参数传入后才会真正调用该函数。 ```php $versions = ['8.4', '8.5', '8.6', '8.7', '9.0']; $supportsPfa = array_filter( $versions, fn ($version) => version_compare($version, '8.6', '>='), ); ``` ```php $versions = ['8.4', '8.5', '8.6', '8.7', '9.0']; $supportsPfa = array_filter( $versions, version_compare(?, '8.6', '>='), ); ``` ## 全新的 `\Time\Duration` 类 Duration 类表示秒表所测量的已流逝时间。它的表示方式与任何具体时间及时区无关,可表示超过 250 年的跨度且精确到纳秒。这使它非常适合以富有表达力的方式表示超时时间或基准测试耗时。 ```php /** * All delays are in microseconds. */ function backoff( int $baseDelay, int $step, int $attempt, ): void { $delay = $baseDelay + ($step * (2 ** $attempt)); // Wait at most 30 seconds. usleep(min($delay, 30_000_000)); } // 1 second base delay, plus 100 milliseconds // doubling with each attempt. backoff(1_000_000, 100_000, $attempt); ``` ```php use Time\Duration; function backoff( Duration $baseDelay, Duration $step, int $attempt, ): void { $delay = $baseDelay->add($step->multiplyBy(2 ** $attempt)); // Durations are comparable, so min() works directly. $delay = min($delay, Duration::fromSeconds(30)); time_nanosleep($delay->seconds, $delay->nanoseconds); } backoff( Duration::fromSeconds(1), Duration::fromMilliseconds(100), $attempt, ); // Preconfigure the delays using Partial Function Application. $waitBeforeRetry = backoff( Duration::fromSeconds(1), Duration::fromMilliseconds(100), attempt: ?, ); $waitBeforeRetry($attempt); ``` ## Polling API 全新的 `Io\Poll` API 使用各平台上最合适的机制(epoll、kqueue、event ports 或 WSAPoll)高效监控大量流,不受 `stream_select()` 的可扩展性限制。它被设计为 ReactPHP、AMPHP 等事件循环库可以构建于其上的公共基础。 ```php $server = stream_socket_server('tcp://0.0.0.0:8080'); $clients = []; while (true) { $read = [$server, ...$clients]; $write = $except = null; // Based on select(), which typically can't handle // more than 1024 connections stream_select($read, $write, $except, null); foreach ($read as $stream) { if ($stream === $server) { $clients[] = stream_socket_accept($server); continue; } $data = fread($stream, 8192); if ($data === '' || $data === false) { $key = array_search($stream, $clients, true); unset($clients[$key]); fclose($stream); } else { fwrite($stream, $data); } } } ``` ```php use Io\Poll\{Context, Event}; $server = stream_socket_server('tcp://0.0.0.0:8080'); // Automatically uses epoll, kqueue, event ports, or WSAPoll $poll = new Context(); $poll->add(new StreamPollHandle($server), [Event::Read]); while (true) { foreach ($poll->wait() as $watcher) { $stream = $watcher->getHandle()->getStream(); if ($stream === $server) { $client = stream_socket_accept($server); $poll->add( new StreamPollHandle($client), [Event::Read], ); continue; } $data = fread($stream, 8192); if ($data === '' || $data === false) { $watcher->remove(); fclose($stream); } else { fwrite($stream, $data); } } } ``` ## 流错误处理 流操作现在可以配置为抛出 `StreamException`,或者静默失败而不发出警告。错误以结构化的 `StreamError` 对象报告,包含 `StreamErrorCode` 枚举实例、包装器名称以及受影响的路径或 URL,之后也可以通过 `stream_last_errors()` 获取,或传递给自定义错误处理器。 ```php $config = @file_get_contents('/etc/app/config.json'); if ($config === false) { // Only an unstructured message string is available $error = error_get_last(); log_error($error['message']); } ``` ```php $context = stream_context_create([ 'stream' => [ 'error_mode' => StreamErrorMode::Exception, ], ]); try { $config = file_get_contents( '/etc/app/config.json', context: $context, ); } catch (StreamException $e) { foreach ($e->getErrors() as $error) { // $error->code is a StreamErrorCode enum case log_error( $error->code->name, $error->message, $error->wrapperName, ); } } ``` ## 全新的 `clamp()` 函数 确保给定值(数值或其他类型)落在指定范围内,否则返回最接近的边界值。 ```php var_dump(max(0, min(-10, 100))); // int(0) var_dump(max(0, min(50, 100))); // int(50) var_dump(max(0, min(110, 100))); // int(100) ``` ```php var_dump(clamp(-10, 0, 100)); // int(0) var_dump(clamp(50, 0, 100)); // int(50) var_dump(clamp(110, 0, 100)); // int(100) // Any comparable value works with clamp(). This // includes the new Duration class. var_dump(clamp( \Time\Duration::fromSeconds(30), min: \Time\Duration::fromMinutes(1), max: \Time\Duration::fromMinutes(10), )->seconds); // int(60) ``` ## 全新的 `SortDirection` 枚举 `SortDirection` 枚举提供了共享的、类型安全的排序表达方式,包含 `Ascending` 和 `Descending` 两个实例。此前,每个库都必须自行定义排序方向的表示方式,导致不兼容的整数、字符串、布尔值和自定义枚举混杂。由于 `SortDirection` 内置于 PHP,库可以在其公开 API 中直接接受它,无需编写适配代码。 在 [The PHP Foundation 的博客](https://thephp.foundation/blog/2026/11/03/stdlib-investment/)中了解更多相关信息。 ```php class QueryBuilder { private array $orderBy = []; public function orderBy( string $column, int $direction = SORT_ASC, ): static { $this->orderBy[] = $column . ' ' . match ($direction) { SORT_ASC => 'ASC', SORT_DESC => 'DESC', }; return $this; } } $qb->orderBy('name', SORT_DESC); $qb->orderBy('name', SORT_STRING); // Accepted by the signature, then fails inside the method: // UnhandledMatchError: Unhandled match case 2 ``` ```php class QueryBuilder { private array $orderBy = []; public function orderBy( string $column, SortDirection $direction = SortDirection::Ascending, ): static { $this->orderBy[] = $column . ' ' . match ($direction) { SortDirection::Ascending => 'ASC', SortDirection::Descending => 'DESC', }; return $this; } } $qb->orderBy('name', SortDirection::Descending); $qb->orderBy('name', SORT_STRING); // TypeError: QueryBuilder::orderBy(): Argument #2 ($direction) // must be of type SortDirection, int given ``` 函数和方法参数现在可以拥有自己的 DocComment,可通过全新的 `ReflectionParameter::getDocComment()` 方法获取。这样每个参数都可以在紧挨其声明处进行文档说明,而不必在 `@param` 标签中重复其名称和类型。 ```php class DB { /** * Returns up to $limit items matching the $query. * * @param string $query Terms to search * @param int $limit Maximum number of results */ public function search(string $query, int $limit = 10): array { return []; } } // Parameter descriptions can only be extracted // by parsing the function's DocComment. ``` ```php class DB { /** * Returns up to $limit items matching the $query. */ public function search( /** Terms to search */ string $query, /** Maximum number of results */ int $limit = 10, ): array { return []; } } var_dump( new ReflectionParameter([DB::class, 'search'], 'query') ->getDocComment(), ); // string(22) "/** Terms to search */" ``` ## 全新的 `ReflectionProperty::isReadable()` 和 `ReflectionProperty::isWritable()` 方法 有了 readonly 属性、非对称可见性和属性钩子之后,仅检查属性是否为 public 已不足以判断它能否被读取或写入。这两个新方法会直接针对给定作用域回答这个问题,也可以针对特定对象,并考虑可见性、初始化状态、钩子和魔术方法。 ```php class NewsEntry { public string $title = 'PHP 8.6 released!'; public private(set) string $slug = 'php-86-released'; } $entry = new NewsEntry(); foreach (['title', 'slug'] as $item) { $property = new ReflectionProperty(NewsEntry::class, $item); printf( "%s: isReadable=%s isWritable=%s\n", $item, $property->isReadable(null, $entry) ? 'yes' : 'no', $property->isWritable(null, $entry) ? 'yes' : 'no', ); } // title: isReadable=yes isWritable=yes // slug: isReadable=yes isWritable=no ``` ## 只读属性默认值 实例 readonly 属性(包括 readonly 类中的属性)现在可以声明默认值。这让实现具有固定值的只读接口属性变得很简单,此前这类属性必须在构造函数中赋值。默认值被视为属性的初始化,因此构造函数无法覆盖它。 ```php interface Rule { public string $parser { get; } } final readonly class SlugRule implements Rule { public string $parser; public function __construct() { $this->parser = SlugParser::class; } } ``` ```php interface Rule { public string $parser { get; } } final readonly class SlugRule implements Rule { public string $parser = SlugParser::class; } ``` ## 其他特性与改进 - `#[\Override]` 特性现在可以应用于类常量和枚举实例。 - 枚举现在可以实现 `__debugInfo()` 魔术方法。 - 存储在常量中的对象属性现在可以直接修改,例如 `Config::DEFAULTS->timeout = 30`。 - 新增 `Uri\Rfc3986\UriBuilder` 和 `Uri\WhatWg\UrlBuilder` 类,用于根据各组成部分构建 URI,同时新增了检测 URI 和主机类型的类以及 `Uri\WhatWg\url_percent_encode()` 函数。 - Sodium 扩展新增了后量子密钥封装(X-Wing 和 ML-KEM-768)、IP 地址加密,以及 SHAKE 和 TurboSHAKE 可扩展输出函数。 - TLS 流现在支持会话恢复、外部预共享密钥以及 TLS 1.3 早期数据(0-RTT)。 - 新增 `mysqli::quote_string()` 方法,对字符串转义并加上引号,与 `PDO::quote()` 保持一致。 - `pack()` 和 `unpack()` 现在接受整数和浮点格式码上的 `<` 和 `>` 字节序修饰符。 - JSON 错误消息现在包含错误在输入中的位置。 - 新的 `error_include_args` INI 设置可统一在错误消息中包含函数参数。 - 新增 `grapheme_strrev()` 函数,按字素簇反转字符串;新增 `IntlNumberRangeFormatter` 类,用于格式化数字范围。 - 新增 `ZipArchive::openString()` 和 `ZipArchive::closeString()` 方法,用于处理内存中的压缩包。 - 性能改进包括:将使用一级函数调用或部分函数应用回调的 `array_map()` 编译为循环、更快的 `printf()` 调用、无状态闭包的缓存以及更快的 JSON 编码。 ## 废弃项与向后兼容性破坏 - `finally` 块中使用 `return` 现已废弃,因为它会静默丢弃异常并覆盖 `try` 或 `catch` 块返回的值。 - 从 `__construct()` 或 `__destruct()` 返回值现已废弃,将它们声明为生成器同样废弃。为 `__debugInfo()` 声明可空返回类型也已废弃。 - 将 `let` 或 `is` 用作类、函数或常量的名称现已废弃。将 `_` 用作常量名、`namespace` 用作类常量名或 `readonly` 用作函数名同样废弃。 - mbstring 正则表达式函数(如 `mb_ereg()` 和 `mb_split()`)已废弃,因为底层的 Oniguruma 库已不再维护。可改用带 `u` 修饰符的 PCRE 函数。 - `is_double()`、`is_long()`、`is_integer()` 和 `doubleval()` 别名已废弃,请改用 `is_float()`、`is_int()` 和 `floatval()`。 - `spl_object_hash()` 已废弃,改用 `spl_object_id()`;`spl_classes()` 已废弃,改用 `ReflectionExtension::getClassNames()`。 - 向 `array_walk()`、`array_walk_recursive()`、`http_build_query()`、`mb_convert_variables()` 以及压缩函数和过滤器传入本应为数组的对象现已废弃。请先用 `get_object_vars()` 转换对象。 - `strcoll()` 和 `SORT_LOCALE_STRING` 排序标志已废弃,请改用 intl 扩展中的 `Collator` 类。 - 向 `define()` 传入第三个参数现已废弃;当 `$allow_string` 为 `false` 时以字符串形式类名调用 `is_a()` 或 `is_subclass_of()` 同样废弃。 - 在 `php://filter` URL 中使用超过 16 个过滤器而未设置 `filter.max_filter_count` 上下文选项现已废弃。 - 会话默认更加安全:`session.use_strict_mode` 和 `session.cookie_httponly` 已启用,`session.cookie_samesite` 被设置为 `Lax`。 - 未同时实现 `create_sid()` 和 `validateId()` 的自定义会话处理器现已废弃。 - `metaphone()`、`mysqli_get_charset()` 和 `mysqli_stmt_init()` 函数现已废弃,同时废弃的还有 `SplFileObject` 的 CSV 方法以及 `ArrayIterator` 的排序、标志和序列化方法。 - `trim()`、`ltrim()` 和 `rtrim()` 现在默认也会去除换页符(`\f`)。 - `fclose()`、`file_put_contents()` 和 `copy()` 在刷新或关闭流失败时现在返回 `false`,而不是静默忽略失败。 - 许多函数现在对超出范围的值、无效标志或字符串抛出 `ValueError`。

相似文章

PHP 8.5.13

Hacker News Top

PHP 8.5.13(附带 PHP 8.6.0 变更日志详情)已发布,包含大量 bug 修复、内存泄漏修正、弃用项以及 PHP 运行时的虚拟机/编译器改进。

即将发布的 PHP 重大安全更新(2026 年 11 月 18 日)

Lobsters Hottest

PHP 安全团队宣布将于 2026 年 11 月 19 日发布一次重大安全更新,影响所有受支持的 PHP 版本;同时,PHP 8.6.0 候选版本发布周期也已启动,Windows 构建版本也进行了更新,修复了一个 Brotli 漏洞。

PHP 8.2.35

Hacker News Top

PHP 解释器宣布发布 PHP 8.2.35 补丁版本,php/php-src 仓库提供了这一流行 Web 脚本语言的构建、测试和安装说明。

PHP 即将发布关键安全更新

Hacker News Top

PHP 团队宣布即将发布一项关键安全更新,修复两个 CVSS 评分为 9.2 的漏洞,定于 2026 年 10 月 21 日发布,建议用户提前做好及时更新的准备。