PHP 8.6 正式发布

前言
PHP 8.6.0 于 2026 年 11 月 19 日正式发布。这次更新既带来了部分函数应用、\Time\Duration、Io\Poll 和 clamp() 等实用功能,也包含一些废弃项和向后兼容性变化。
简单来说,PHP 8.6 主要围绕以下几个方向改进:
- 让代码写起来更简洁,例如部分函数应用和
clamp()。 - 让类型表达更清楚,例如
SortDirection枚举和只读属性默认值。 - 改善大量连接的
I/O监听能力,为事件循环库提供统一的底层API。 - 让流操作、反射和错误信息更容易处理。
- 收紧一些容易产生歧义或隐藏错误的旧写法。
TIP
本文中的新语法和新 API 需要 PHP 8.6.0 或更高版本。部分扩展功能还依赖扩展是否启用,以及 PHP 编译时使用的底层库版本。
核心语言与新 API
部分函数应用:先固定一部分参数
部分函数应用(Partial Function Application)允许在调用函数时,先固定一部分参数,剩下的参数以后再看情况传入。得到的结果是一个闭包,原函数要等到闭包被调用时才会真正执行。
PHP 8.6 提供了两种占位符:
?:表示缺少一个参数。...:表示剩余参数都暂时不传。
php
<?php
function add(int $a, int $b, int $c = 0): int
{
return $a + $b + $c;
}
// 固定第一个参数,还缺一个参数
$addOne = add(1, ?);
var_dump($addOne(5)); // int(6)
// 固定第一个参数,剩余参数由调用者提供
$addToOne = add(1, ...);
var_dump($addToOne(2, 3)); // int(6)
// 内部函数同样可以使用
$stripSpaces = str_replace(' ', '', ?);
var_dump($stripSpaces('a b c')); // string(3) "abc"以前遇到类似需求,通常要手动写一个闭包或箭头函数。现在可以直接基于已有函数生成新的可调用对象,代码更短,也更直观。
需要注意:? 只代表一个参数,不代表“剩下的所有参数”;需要保留剩余参数时,应使用 ...。
\Time\Duration:更准确地表示时长
PHP 8.6 新增了 \Time\Duration 类,用来表示一段固定的时长,例如超时时间、重试间隔或程序耗时,精度可以达到纳秒。
php
<?php
use Time\Duration;
$timeout = Duration::fromSeconds(2)->add(Duration::fromMilliseconds(500));
printf("%d.%09d seconds\n", $timeout->seconds, $timeout->nanoseconds,);// 2.500000000 seconds
var_dump($timeout > Duration::fromSeconds(2)); // bool(true)Duration 对象是不可变的,支持比较和常见的时长运算:
fromSeconds()、fromMilliseconds():创建时长。add()、sub():增加或减去时长。multiplyBy()、divideBy():乘法或除法运算。negate()、absolute():取相反数或绝对值。compare():用于排序比较。
它和 DateInterval 的用途不完全相同。DateInterval 可以包含年、月、日等日历单位,而 Duration 只表示固定长度,不涉及“一个月到底有多少天”这样的问题。
如果时长超出大约 292 年的可表示范围,或者传入的 ISO 8601 时长字符串无效,会抛出 Time\TimeException。
clamp():把值限制在指定范围内
以前要把数值限制在某个区间,常见写法是嵌套 max() 和 min()。PHP 8.6 新增的 clamp() 可以直接表达这个意图。
php
<?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)它的规则很简单:
- 值在范围内:返回原值。
- 值小于最小值:返回最小值。
- 值大于最大值:返回最大值。
除了数字,只要值支持比较,也可以使用 clamp(),例如前面介绍的 \Time\Duration。
SortDirection:统一表示排序方向
过去不同项目可能分别使用 SORT_ASC、布尔值、字符串或自定义枚举表示排序方向。PHP 8.6 新增内置枚举 SortDirection,统一提供两个 case:
SortDirection::Ascending:升序。SortDirection::Descending:降序。
php
<?php
function sortNames(array $names, SortDirection $direction = SortDirection::Ascending): array {
match($direction)
{
SortDirection::Ascending => sort($names),
SortDirection::Descending => rsort($names),
};
return $names;
}
print_r(sortNames(['Alice', 'Carol', 'Bob'],SortDirection::Descending));使用枚举作为参数类型后,传入无关整数或其他错误值时,可以更早暴露类型错误。它更适合作为公共 API 的参数类型,减少不同库之间重复定义排序方向的问题。
只读属性支持默认值
PHP 8.6 允许实例 readonly 属性直接声明默认值,readonly class 中的属性也支持。
php
<?php
class Config
{
public readonly int $timeout = 30;
}
$config = new Config();
var_dump($config->timeout); // int(30)这个特性适合表示固定配置值,不必为了赋值再写一个构造函数。
需要特别注意:默认值也算作属性初始化。因此,属性使用默认值后,构造函数不能再次给它赋值。
I/O 与错误处理
Io\Poll:为大量流监听提供统一 API
PHP 8.6 新增 Io\Poll API,用来监听大量流的可读、可写等事件。它会根据操作系统选择可用的底层机制,例如:
- Linux 的
epoll。 - BSD、macOS 的
kqueue。 - event ports。
- Windows 的
WSAPoll。
下面是一个简化的 TCP 回显服务器示例:
php
<?php
use Io\Poll\{Context, Event};
$server = stream_socket_server('tcp://0.0.0.0:8080');
$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);
}
}
}传统 stream_select() 在部分平台上会受到描述符数量等限制。Io\Poll 更重要的作用,是给 ReactPHP、AMPHP 等事件循环库提供统一的基础设施。
对普通业务项目来说,一般不会直接编写这种底层循环。更实际的影响是:相关框架和库适配后,应用可以间接获得更好的 I/O 扩展能力。
新的流错误处理 API
PHP 8.6 新增了一套结构化流错误处理 API,主要包括:
StreamError:保存具体错误信息。StreamException:流操作异常。StreamErrorCode:错误代码枚举。StreamErrorMode:错误处理模式。stream_last_errors():读取流操作保存的错误。stream_clear_errors():清除保存的错误。
下面通过流上下文,把文件读取错误配置为异常模式:
php
<?php
$context = stream_context_create([
'stream' => [
'error_mode' => StreamErrorMode::Exception,
]
]);
try{
$config = file_get_contents(
__DIR__ . '/missing-config.json',
context: $context,
);
}catch(StreamException $e)
{
foreach($e->getErrors() as $error)
{
printf(
"[%s] %s (%s)\n",
$error->code->name,
$error->message,
$error->wrapperName,
);
}
}以前主要依赖警告、false 返回值和 error_get_last()。新 API 可以提供结构化的错误代码、包装器名称和错误信息,更适合统一记录日志或交给自定义错误处理器。
这不是说升级后所有流操作都会自动抛出异常,具体行为仍要通过流上下文中的 error_mode、error_store 等选项进行配置。
反射与其他语言改进
参数支持独立 DocComment
PHP 8.6 允许直接在参数前编写 DocComment,再通过 ReflectionParameter::getDocComment() 读取。
php
<?php
class ArticleRepository
{
public function search(
/** 搜索关键词 */
string $keyword,
/** 最多返回多少条记录 */
int $limit = 10,
): array {
return [];
}
}
$parameter = new ReflectionParameter(
[ArticleRepository::class, 'search'],
'keyword',
);
var_dump($parameter->getDocComment());这样可以把参数说明放在参数旁边,不必只在整个方法的 DocComment 中重复写 @param。
更方便地判断属性是否可读写
在只读属性、非对称可见性和属性钩子加入 PHP 后,仅判断属性是不是 public,已经不能说明它当前能否读取或写入。
PHP 8.6 新增:
ReflectionProperty::isReadable()。ReflectionProperty::isWritable()。
php
<?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 $name)
{
$property = new ReflectionProperty(NewsEntry::class, $name);
printf(
"%s: readable=%s, writable=%s\n",
$name,
$property->isReadable(null, $entry) ? 'yes' : 'no',
$property->isWritable(null, $entry) ? 'yes' : 'no',
);
}这两个方法会结合属性可见性、初始化状态、属性钩子和魔术方法等信息进行判断,比只看 public 更准确。
其他值得了解的语言变化
PHP 8.6 还包含以下改进:
#[\Override]现在可以用于类常量和枚举 case。如果父类或接口中没有对应常量,会产生编译错误。- 枚举现在可以定义
__debugInfo(),自定义var_dump()时显示的信息。 - 常量或类常量中保存的对象,现在可以直接修改属性,例如
CONFIG->debug = true。 WeakMap支持在键尚不存在时直接进行引用赋值。ReflectionAttribute和ReflectionConstant等反射 API 也得到补充。
其中 #[\Override] 的扩展示例:
php
<?php
interface HasVersion
{
const VERSION = '1.0';
}
class Package implements HasVersion
{
#[\Override]
const VERSION = '2.0';
}
echo Package::VERSION; // 2.0它可以帮助开发者更早发现“以为覆盖了父类常量,实际名称写错”的问题。
扩展、工具函数与性能优化
常用扩展和工具改进
PHP 8.6 的扩展更新较多,下面列出比较值得关注的部分。
URI 与 URL
- 新增
Uri\Rfc3986\UriBuilder和Uri\WhatWg\UrlBuilder,用于根据各个组成部分构建 URI 或 URL。 - 新增 URI 类型、主机类型和特殊协议判断方法。
- 新增
Uri\WhatWg\url_percent_encode()。
Sodium 与 TLS
Sodium增加X-Wing、ML-KEM-768等密钥封装功能,以及IP 地址加密、SHAKE和TurboSHAKE等接口。- 部分
Sodium新接口要求 PHP 编译时使用libsodium 1.0.22 或更高版本。 TLS流支持会话恢复、外部预共享密钥和TLS 1.3 early data(0-RTT)。
这些能力并不只取决于 PHP 版本,还要检查当前构建所用的 libsodium、OpenSSL 等底层库。
MySQLi、Zip 和 Intl
- 新增
mysqli::quote_string(),行为与PDO::quote()类似,会对字符串转义并加上引号。 - 新增
ZipArchive::openString()和closeString(),方便处理内存中的压缩包。 - 新增
grapheme_strrev(),按照字素簇反转字符串。 - 新增
IntlNumberRangeFormatter,用于格式化数字区间。 - 部分 Intl 功能对 ICU 版本有要求。
JSON 和错误信息
- JSON 错误信息现在会包含输入中的错误位置。
- 新增
error_include_argsINI 配置,用于统一控制错误信息中函数参数的显示,默认关闭。
pack() 和 unpack() 支持字节序修饰符
整数和浮点格式码现在可以使用:
<:小端字节序。>:大端字节序。
php
<?php
echo bin2hex(pack('l>', 1)), PHP_EOL; // 00000001
echo bin2hex(pack('l<', 1)), PHP_EOL; // 01000000
echo bin2hex(pack('f>', 1.5)), PHP_EOL; // 3fc00000
var_dump(unpack('s>value', "\xff\xfe")); // value => -2这对处理二进制协议、文件格式和网络数据很有帮助,不必再额外做部分字节序转换。
性能优化
PHP 8.6 还包含多项内部性能改进:
- 使用一等可调用语法或部分函数应用作为
array_map()回调时,可编译为等效循环,减少中间闭包和回调开销。 - 只使用
%s、%d的printf()可编译为等效的字符串插值。 - 已知构造函数的参数传递更加高效。
- 新增无状态闭包缓存。
- 改进 JSON 数组和对象编码,以及
JSON_PRETTY_PRINT缩进生成的性能。 - 改进部分数组、字符串函数和 ZTS 构建的性能。
这些优化不需要业务代码专门调用新 API,但实际收益取决于代码结构和运行环境。升级前如果想确认性能变化,最好使用自己的业务场景进行基准测试,不要只看单项微基准。
废弃项与向后兼容性变化
新功能决定“能怎么写”,兼容性变化决定“旧代码还能不能正常工作”。升级前这一节更值得重点检查。
重点废弃项
在 finally 中使用 return
这种写法现在会被废弃,因为它可能吞掉异常,或者覆盖 try、catch 中原本要返回的值。
php
<?php
function loadConfig(): array
{
try{
throw new RuntimeException('配置文件读取失败');
}finally
{
// PHP 8.6 中已废弃,并且会隐藏上面的异常
return [];
}
}应把 return 移到 finally 外,让异常和返回值按正常流程处理。finally 只负责释放资源、关闭连接等清理工作。
如果不需要清理资源,可以直接去掉 finally。下面是一个读取 JSON 配置文件的正确示例:
php
<?php
function loadConfig(): array
{
$path = __DIR__ . '/config.json';
if(!is_file($path))
{
throw new RuntimeException('配置文件不存在');
}
$content = file_get_contents($path);
if($content === false)
{
throw new RuntimeException('配置文件读取失败');
}
$config = json_decode(
$content,
true,
512,
JSON_THROW_ON_ERROR,
);
if(!is_array($config))
{
throw new RuntimeException('配置文件内容必须是对象或数组');
}
return $config;
}
try{
$config = loadConfig();
print_r($config);
}catch(Throwable $e)
{
echo '加载配置失败:' . $e->getMessage();
}这样,文件不存在、读取失败或 JSON 格式错误时,异常都会交给调用方处理,不会被 finally 中的 return 隐藏。
构造函数和析构函数返回值
- 从
__construct()或__destruct()返回具体值会被废弃。 - 使用
yield把它们变成生成器也会被废弃。 - 只写
return;来提前结束方法仍然允许。
部分名称和旧别名
- 使用
let或is作为类、接口、trait、枚举、函数或常量名称会被废弃。 - 常量名
_、类常量名namespace、函数名readonly等用法会被废弃。 is_double()、is_long()、is_integer()和doubleval()被废弃,应分别使用is_float()、is_int()和floatval()。spl_object_hash()被废弃,建议使用spl_object_id()。
字符串、数组和排序相关
mb_ereg()、mb_split()等 mbstring 正则函数被废弃,可改用带u修饰符的 PCRE 函数。strcoll()和SORT_LOCALE_STRING被废弃,建议使用 Intl 扩展的Collator。- 向
array_walk()、array_walk_recursive()、http_build_query()等函数直接传对象会被废弃,应先根据需要使用get_object_vars()转换。
其他废弃项
- 继续向
define()传第三个参数会被废弃。 - 在
php://filterURL 中未配置限制却使用超过 16 个过滤器,会触发废弃通知。 - 未同时实现
create_sid()和validateId()的自定义 Session 处理器会被废弃。 metaphone()、mysqli_get_charset()、mysqli_stmt_init()等函数也被列入废弃范围。
完整清单应以官方迁移指南为准,不要只检查这里列出的项目。
需要重点测试的行为变化
trim() 默认去除换页符
PHP 8.6 中,trim()、ltrim() 和 rtrim() 的默认字符列表新增换页符 \f。
php
<?php
var_dump(trim("\f hello \f"));
// PHP 8.6:string(5) "hello"
// PHP 8.5 及之前:保留两端的 \f如果业务把 \f 当作有效内容,升级后需要显式指定第二个参数,避免依赖默认字符列表。
Session 默认配置更安全
PHP 8.6 调整了部分默认值:
session.use_strict_mode默认启用。session.cookie_httponly默认启用。session.cookie_samesite默认设置为Lax。
这有利于安全,但如果项目依赖旧 Session 行为、跨站 Cookie 或自定义 Session ID 逻辑,升级后必须实际测试登录和会话流程。
流操作失败返回值更明确
fclose()、file_put_contents() 和 copy() 在刷新或关闭流失败时,现在会返回 false,不再静默忽略部分失败。
如果业务涉及文件上传、日志写入或导出文件,应检查返回值,避免把写入失败误判为成功。
更多非法参数会抛出 ValueError
一些过去可能静默截断或忽略非法输入的函数,现在会对越界值、非法标志或包含 NUL 字节的字符串抛出 ValueError。调用这些函数时,不应只检查返回值,还要确认异常处理是否完整。
unpack() 格式名称的变化
< 和 > 紧跟在支持的格式码后面时,会被当作字节序修饰符,而不是数组键名的一部分。
php
<?php
var_dump(unpack('s<value', "\x01\x00"));
// PHP 8.6 的键名是 value,不再是 <value如果旧代码已经使用类似格式字符串,升级后需要检查读取的数组键名。
其他行为变化
官方迁移指南还列出了魔术属性、array_intersect()、preg_grep()、PostgreSQL 持久连接、Phar、SOAP 等细节变化。普通项目不一定都会遇到,但使用相关功能时应逐项核对。
升级建议与总结
建议按这个顺序升级
第一步:确认依赖是否支持
先在开发和测试环境检查 PHP 版本、扩展和 Composer 依赖:
bash
php -v
php -m
composer check-platform-reqs如果框架、ORM、图片处理库或扩展尚未声明支持 PHP 8.6,不要直接升级生产环境。
第二步:开启并收集废弃通知
在测试环境记录废弃通知,重点搜索:
finally中的return。- 已废弃的函数别名和 mbstring 正则函数。
- 直接传对象的数组或查询函数。
- 自定义 Session 处理器。
- 旧格式的
pack()、unpack()字符串。
不要只看页面能否打开,还要运行后台任务、定时任务、队列消费者和文件处理流程。
第三步:运行完整测试
重点覆盖:
- 登录、Cookie 和 Session。
- 文件上传、下载和导出。
- 数据库连接与持久连接。
- JSON、字符串和二进制数据处理。
- 异常捕获和错误日志。
如果项目缺少自动测试,至少整理一份关键业务流程清单,逐项人工验证。
第四步:测试扩展和性能
确认扩展版本及底层库满足要求。需要性能数据时,使用接近真实业务的请求和数据量进行对比,同时观察错误率、内存占用和响应时间。
第五步:灰度升级并准备回退
先在少量生产实例上验证,确认日志和监控正常后再扩大范围。升级前保留旧 PHP 环境和可执行的回退方案,避免出现问题时只能临时排查。
总结
PHP 8.6 的重点可以概括为:
- 部分函数应用让回调和函数复用更简洁。
Duration、clamp()和SortDirection让常见逻辑表达得更清楚。Io\Poll和流错误 API 改善了底层 I/O 与错误处理能力。- 反射、URI、Sodium、TLS、Intl、Zip 等模块得到补充。
- 多项废弃和默认行为变化,需要在升级前认真检查。
对业务项目来说,升级的重点不是马上使用所有新语法,而是先确认旧代码和依赖能够稳定运行。兼容性验证通过后,再逐步引入新特性会更稳妥。
