PHP 8.6 发布公告
摘要
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
PHP 8.5.13(附带 PHP 8.6.0 变更日志详情)已发布,包含大量 bug 修复、内存泄漏修正、弃用项以及 PHP 运行时的虚拟机/编译器改进。
即将发布的 PHP 重大安全更新(2026 年 11 月 18 日)
PHP 安全团队宣布将于 2026 年 11 月 19 日发布一次重大安全更新,影响所有受支持的 PHP 版本;同时,PHP 8.6.0 候选版本发布周期也已启动,Windows 构建版本也进行了更新,修复了一个 Brotli 漏洞。
PHP 8.2.35
PHP 解释器宣布发布 PHP 8.2.35 补丁版本,php/php-src 仓库提供了这一流行 Web 脚本语言的构建、测试和安装说明。
PHP 即将发布关键安全更新
PHP 团队宣布即将发布一项关键安全更新,修复两个 CVSS 评分为 9.2 的漏洞,定于 2026 年 10 月 21 日发布,建议用户提前做好及时更新的准备。
今日 PHP 安全更新,以及我们如何加强 PHP 安全性
PHP 8.x 全系发布紧急安全更新,修复两个远程代码执行漏洞;因协调披露流程泄露导致 PoC 提前扩散,PHP Foundation 与 Wiz 公布了完整披露时间线。