摘要:PHP 8.6 正式发布,本文详解新版本核心更新:部分函数应用(PFA)、Time\Duration 时长类、Io\Poll 轮询 API、clamp () 函数、SortDirection 枚举、readonly 属性默认值等新特性,并梳理废弃函数、不兼容变更与生产升级注意事项...
发布时间:2026 年 11 月 19 日(GA) 定位:PHP 8.x 系列的一次功能型小版本更新,主线围绕「更具表达力的语法、更强的类型安全、可扩展的 I/O」三个方向。
PHP 8.6 的口号是 Faster, Safer, More Powerful(更快、更安全、更强大)。相比 8.4、8.5 偏类型与语法打磨,8.6 引入了几个重量级语言特性(部分函数应用、时长类、轮询 API),同时继续为 PHP 9.0 清理历史包袱:一批老旧函数、别名和不安全行为被标记为废弃(Deprecated)。
下面按「新特性 → 废弃项 → 行为变更 → 升级建议」四部分展开,代码均可直接对照阅读。
一、核心新特性
1. 部分函数应用(Partial Function Application,PFA)—— 本次最重磅
这是 8.6 在语言层面最受关注的特性。调用函数时,用 ? 占位单个未提供的参数,用 ... 占位剩余全部参数;此时函数不会立即执行,而是返回一个 Closure,等补齐缺失参数后才真正调用。
function add(int $a, int $b, int $c = 0): int
{
return $a + $b + $c;
}
// "?" 只替换一个参数:先固定 $a = 1,返回闭包等待 $b
$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"典型收益:在 array_map、array_filter 等高阶函数里,不再需要写 fn($v) => str_replace(' ', '', $v) 这种薄包装箭头函数,直接把「预绑定部分参数的可调用对象」传进去即可。
$versions = ['8.4', '8.5', '8.6', '8.7', '9.0']; // 旧写法:需要显式箭头函数 // $supports = array_filter($versions, fn($v) => version_compare($v, '8.6', '>=')); // PHP 8.6:用 PFA 预固定基准版本与比较方向 $supports = array_filter( $versions, version_compare(?, '8.6', '>='), );
2. 新增 Time\Duration 时长类
Time\Duration 表示「秒表测出来的一段经过时间」,与具体日期、时区无关;支持纳秒精度,可表示超过 250 年的区间。非常适合用来表达超时时间、退避等待、基准计时等场景,替代过去到处传递「微秒整数」的写法。
use Time\Duration;
function backoff(Duration $baseDelay, Duration $step, int $attempt): void
{
// 时长对象可直接相加、按倍数放大,也支持比较(min/max 可用)
$delay = $baseDelay->add($step->multiplyBy(2 ** $attempt));
$delay = min($delay, Duration::fromSeconds(30)); // 最多等 30 秒
time_nanosleep($delay->seconds, $delay->nanoseconds);
}
backoff(
Duration::fromSeconds(1),
Duration::fromMilliseconds(100),
$attempt,
);
// 还能和 PFA 组合:预先固定前两个参数,只留重试次数
$waitBeforeRetry = backoff(
Duration::fromSeconds(1),
Duration::fromMilliseconds(100),
attempt: ?,
);
$waitBeforeRetry($attempt);3. 新增 Polling API(Io\Poll)
新的 I/O 多路复用 API,底层自动选用各平台最优机制(Linux epoll、BSD/macOS kqueue、Solaris event ports、Windows WSAPoll),突破了老的 stream_select() 通常只能处理 1024 个连接的扩展性限制。它定位为事件循环库(ReactPHP、AMPHP 等)的公共底座。
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);
}
}
}对普通业务开发者而言,短期内主要是间接受益:异步/常驻内存框架升级后能支撑更多并发连接。
4. 新增 clamp() 数值区间收敛函数
把一个值限制在 [min, max] 区间内:低于下限返回下限,高于上限返回上限,区间内原样返回。支持任意可比较类型(包括上面的 Duration)。
var_dump(clamp(-10, 0, 100)); // int(0) var_dump(clamp(50, 0, 100)); // int(50) var_dump(clamp(110, 0, 100)); // int(100) // 也可用于时长等可比较对象 var_dump(clamp( \Time\Duration::fromSeconds(30), min: \Time\Duration::fromMinutes(1), max: \Time\Duration::fromMinutes(10), )->seconds); // int(60)
等价于过去的 max($min, min($max, $value)),语义更直观、不易写反。
5. 新增内置 SortDirection 枚举
过去每个库都自己定义排序方向,混用整数(SORT_ASC/SORT_DESC)、字符串、布尔值、自定义枚举,类型互不兼容。8.6 把排序方向收进核心枚举:SortDirection::Ascending / SortDirection::Descending。
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);类型约束后,误传 SORT_STRING 这类无关常量会直接抛 TypeError,而不是运行到 match 里才报 UnhandledMatchError。
6. readonly 属性支持默认值
实例化 readonly 属性(包括 readonly 类中的属性)现在可以直接声明默认值,不必再跑到构造函数里赋值。默认值即视为「已初始化」,构造函数不能再覆盖它。
class Config
{
public readonly int $timeout = 30;
}
$config = new Config();
var_dump($config->timeout); // int(30)适合实现「取值接口 + 固定常量」的场景:
interface Rule
{
public string $parser { get; }
}
final readonly class SlugRule implements Rule
{
// 旧写法需要在 __construct() 里 $this->parser = SlugParser::class;
public string $parser = SlugParser::class;
}7. #[\Override] 扩展到类常量与枚举 case
此前 #[\Override] 只能用于方法和属性;8.6 起类常量、枚举 case 也可标记。若父类/接口中不存在同名常量,编译期直接报错,防止无意中「新写了一个常量」而不是覆盖父类定义。
interface HasVersion
{
const VERSION = '1.0';
}
class Package implements HasVersion
{
#[\Override]
const VERSION = '2.0';
// 下面这行会致命错误:父类不存在同名常量
// #[\Override]
// const NAME = 'package';
}8. 流错误处理 API(结构化错误对象)
流操作现在可以配置为抛 StreamException 或静默失败,而不是只发一条 warning。错误以结构化的 StreamError 对象返回,包含 StreamErrorCode 枚举、封装器名称、受影响路径/URL;也可用 stream_last_errors() 事后取回,或交给自定义错误处理器。
$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 是 StreamErrorCode 枚举实例
log_error($error->code->name, $error->message, $error->wrapperName);
}
}9. 反射增强
参数级 DocComment:函数/方法参数可以挂自己的注释,通过
ReflectionParameter::getDocComment()读取,不必再从函数注释里解析@param。
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()/isWritable():在 readonly、不对称可见性(private(set))、属性钩子存在的前提下,仅判断public已不足以判断能否读写。新方法结合可见性、初始化状态、钩子和魔术方法,直接回答「在指定作用域(可选指定对象)下是否可读/可写」。
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=no10. 其他值得关注的改进
| 类别 | 内容 |
|---|---|
| 常量对象可变 | 存放在常量/类常量里的对象,可直接 CONFIG->debug = true; 修改属性(旧版报「临时表达式不能写上下文」)。 |
| WeakMap 引用赋值 | WeakMap 允许引用赋值,键不必预先存在。 |
枚举 __debugInfo() | 枚举现在可以定义 __debugInfo() 魔术方法,旧版会致命错误。 |
pack()/unpack() 大小端 | 整数与浮点格式码后支持 <(小端)/ >(大端)修饰符。 |
| URI 构建器 | 新增 Uri\Rfc3986\UriBuilder、Uri\WhatWg\UrlBuilder,以及 URI/主机类型判断方法和 url_percent_encode()。 |
| Sodium 扩展 | 加入后量子密钥封装(X-Wing、ML-KEM-768)、IP 地址加密、SHAKE / TurboSHAKE 可扩展输出函数。 |
| TLS | 流支持会话恢复、外部 PSK、TLS 1.3 早期数据(0-RTT)。 |
| MySQLi | 新增 mysqli::quote_string(),行为对齐 PDO::quote()。 |
| JSON | 错误消息现在包含错误在输入中的位置。 |
| INI | 新增 error_include_args,错误消息中统一带上函数参数。 |
| Intl | 新增 grapheme_strrev()(按字形簇反转字符串)、IntlNumberRangeFormatter(数字区间格式化)等。 |
| Zip | 新增 ZipArchive::openString() / closeString(),处理内存中的压缩包。 |
| 性能 | 首类可调用或 PFA 回调形式的 array_map() 被编译为循环;printf() 更快;无状态闭包可缓存;JSON 编码提速。 |
二、废弃(Deprecated)清单
说明:废弃项在 8.6 中会发出
E_DEPRECATED提示,通常在 PHP 9.0 中移除或改为致命错误。升级时应先在测试环境开启废弃提示,逐项清理。
1. 核心语言
finally块中使用return:会静默吞掉try/catch抛出的异常,或覆盖其返回值。应把return移出finally。
function getConfig(): array
{
try {
return loadConfig(); // 文件缺失时会抛异常
} finally {
return []; // 已废弃:异常被吞掉,调用方只拿到 []
}
}__construct()/__destruct()返回值:构造/析构方法不能声明返回类型,返回值在正常流程中根本观测不到;让它们成为生成器(yield)同样废弃。无值的return;(跳过剩余逻辑)仍然允许。__debugInfo()声明可空返回类型:?array返回类型废弃,应声明为array。保留标识符相关:
函数命名为
readonly废弃;let、is作为类/接口/trait/枚举/函数/常量名(含define()、class_alias()别名、use别名)废弃——为未来的块级作用域(let)和模式匹配(is)预留关键字;_作为常量名(const/define())或use别名废弃(8.4 已废弃_作类名,本次扩展到常量;名为_的函数,如_()gettext 别名,不受影响);类常量命名为
namespace废弃(方法、静态属性同名不受影响)。define()第三个参数:大小写不敏感常量早在 8.0 已移除,该参数一直被忽略;显式传false现在发废弃提示,传true继续发警告并提示 9.0 将变为错误。直接省略该参数。is_a()/is_subclass_of()传字符串且$allow_string = false:此情形恒返回false,属于明显 bug。需要避免触发自动加载时,先class_exists($name, false)检查,再以allow_string: true调用。模糊类型转换(fuzzy casts)进入弃用阶段:如
(int) "123abc"、(float) "12.5foo"、(object) 42这类不严格的转换在 8.6 发出E_DEPRECATED,PHP 9.0 将抛TypeError。合法转换(带空白的数字、科学计数法)不受影响。
2. 类型判断函数别名
旧的非规范类型名别名被废弃,改用规范名称:
| 废弃 | 替代 |
|---|---|
is_double() | is_float() |
is_long() | is_int() |
is_integer() | is_int() |
doubleval() | floatval() |
3. SPL 相关
spl_object_hash()废弃 → 用spl_object_id()。自 8.1 起前者返回值只是后者的格式化字符串,且名称有误导性(并非由对象内容算出),字符串形式还可能因数字字符串松散比较而误判相等。spl_classes()废弃 → 用ReflectionExtension::getClassNames()。ArrayIterator一批方法废弃(对应的ArrayObject方法不受影响):排序类:
asort()、ksort()、uasort()、uksort()、natsort()、natcasesort()标志类:
getFlags()、setFlags()序列化类:
serialize()、unserialize()SplFileObject的 CSV 方法废弃:fgetcsv()、fputcsv()、setCsvControl()、getCsvControl()。改用流上的fgetcsv()/fputcsv()。
4. MBString:mbregex 整套废弃
底层 Oniguruma 库已于 2025 年 4 月停止维护,整套多字节正则函数在 8.6 废弃,PHP 9.0 移除。绝大多数场景可用带 u 修饰符的 PCRE 函数替代。
涉及函数:mb_ereg()、mb_ereg_match()、mb_ereg_replace()、mb_ereg_replace_callback()、mb_ereg_search() 系列、mb_eregi()、mb_eregi_replace()、mb_split()、mb_regex_encoding()、mb_regex_set_options() 等;常量 MB_ONIGURUMA_VERSION 与 INI mbstring.regex_retry_limit、mbstring.regex_stack_limit 一并废弃。
5. MySQLi
mysqli_get_charset()/mysqli::get_charset()废弃,无直接替代;取当前字符集名用mysqli_character_set_name()/mysqli::character_set_name()。mysqli_stmt_init()/mysqli::stmt_init()废弃 → 直接用mysqli_prepare()/mysqli::prepare()一步完成预处理;不带query参数调用mysqli_stmt构造函数同样废弃。
6. 「把对象当数组传参」废弃
一批原本会把对象静默解释为「可见属性数组」的函数,传入对象参数现在废弃。应先用 get_object_vars() 转成数组再传入:
array_walk()、array_walk_recursive()的数组参数;http_build_query()的data参数(其值中遇到对象也会提示);mb_convert_variables()的vars参数;Bzip2 / Zlib 流过滤器参数,以及
deflate_init()/inflate_init()的options参数。
7. 本地化比较
strcoll()废弃 → 用 intl 扩展的Collator::compare()。排序函数的
SORT_LOCALE_STRING标志废弃 → 用Collator::sort()/asort()/sortWithSortKeys()。
原因:setlocale() 是全局进程状态、可被任意库改动,且该比较不保证二进制安全,部分语言环境排序规则也不正确。
8. 其他废弃函数
metaphone():1990 年原始算法,仅限英语且早已被 Double Metaphone、Metaphone 3 取代;语音算法更适合用户态库实现。反射相关:对不属于声明类的对象调用
ReflectionProperty::setValue()/setRawValue()废弃;调用静态方法时向ReflectionMethod::invoke()/invokeArgs()传对象废弃(静态方法无$this,应传null)。
三、行为变更与不兼容(容易踩坑)
1. Session 默认配置更安全
8.6 起会话默认开启更严格的安全策略:
session.use_strict_mode开启(缓解会话固定);session.cookie_httponly开启;session.cookie_samesite设为Lax。
自定义会话处理器:未同时实现 create_sid() 和 validateId() 的保存处理器现在废弃;仅实现 SessionHandlerInterface 而缺少这两个方法的类会发出 E_WARNING。PHP 9.0 中这两个方法将并入 SessionHandlerInterface 成为必需方法,应尽早补齐。
2. 字符串裁剪行为变化
trim()、ltrim()、rtrim() 默认现在也会去除换页符 \f(form feed)。如果业务里依赖保留首尾 \f,需要显式传入字符集参数。
3. 流关闭/写入失败更诚实
fclose()、file_put_contents()、copy() 在刷新或关闭流失败时现在返回 false,而不是静默忽略失败。依赖「永远成功」的代码需要补返回值检查。
4. 越界/非法参数抛 ValueError
许多函数对越界数值、非法标志位、含 NUL 字节的字符串,现在抛 ValueError,而不是静默截断或忽略。
5. php://filter 链长度限制
过滤器链超过 16 个且未设置 filter.max_filter_count 上下文选项时发出废弃提示。超长过滤链本身是一类「本地文件包含/任意文件读 → RCE」攻击的基础;确需更多过滤器应改用 stream_filter_append() / stream_filter_prepend(),或通过上下文选项显式上调上限。
6. 其他
error_include_argsINI 选项:错误消息可统一附带函数参数,便于定位。部分 GMP 位移/幂运算在右操作数为浮点且转整数丢精度时,发出废弃提示。
四、升级建议
生产环境暂缓:8.6 刚发布,第三方扩展(redis、memcached、imagick、加密扩展等)和框架的适配需要时间;本地开发、CI 可以先行尝鲜。
先扫废弃提示:在测试环境把
error_reporting设为包含E_DEPRECATED,跑一遍核心业务,重点排查:finally返回、mbregex、is_double/is_long等别名、对象当数组传参、自定义 Session 处理器。框架与扩展优先验证:Laravel、ThinkPHP、YzmCMS 等老项目重点检查扩展兼容性和弃用 API;常驻内存/异步框架关注 Polling API 与流错误处理的变化。
新特性按需采用:PFA、
Duration、clamp()、SortDirection可以在新代码中使用;Io\Poll主要由框架/库作者对接,业务代码一般不直接调用。关注 PHP 9.0 路线:8.6 标记的废弃项大多在 9.0 移除,本次清理得越早,未来大版本升级成本越低。
参考资料
PHP 官方发布公告:https://www.php.net/releases/8.6/en.php
新特性手册:https://www.php.net/manual/en/migration86.new-features.php
废弃特性手册:https://www.php.net/manual/en/migration86.deprecated.php
源码升级指南(UPGRADING):https://github.com/php/php-src/tree/PHP-8.6
