PHP 8.6 更新详解:新特性、废弃项与升级注意事项
发布时间: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()
);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)。
三、行为变更与不兼容(容易踩坑)
这部分不会抛废弃警告,逻辑直接改变,是升级最容易出bug的地方
Session 默认配置更安全:8.6 起会话默认开启更严格的安全策略:session.use_strict_mode 开启(缓解会话固定);session.cookie_httponly 开启;session.cookie_samesite 设为 Lax。自定义会话处理器:未同时实现 create_sid() 和 validateId() 的保存处理器现在废弃;仅实现 SessionHandlerInterface 而缺少这两个方法的类会发出 E_WARNING。PHP 9.0 中这两个方法将并入 SessionHandlerInterface 成为必需方法,应尽早补齐。
字符串裁剪行为变化:trim()、ltrim()、rtrim() 默认现在也会去除换页符 \f(form feed)。如果业务里依赖保留首尾 \f,需要显式传入字符集参数。
流关闭/写入失败更诚实:fclose()、file_put_contents()、copy() 在刷新或关闭流失败时现在返回 false,而不是静默忽略失败。依赖「永远成功」的代码需要补返回值检查。
越界/非法参数抛 ValueError:许多函数对越界数值、非法标志位、含 NUL 字节的字符串,现在抛 ValueError,而不是静默截断或忽略。
php://filter 链长度限制:过滤器链超过 16 个且未设置 filter.max_filter_count 上下文选项时发出废弃提示。超长过滤链本身是一类「本地文件包含/任意文件读 → RCE」攻击的基础;确需更多过滤器应改用 stream_filter_append() / stream_filter_prepend(),或通过上下文选项显式上调上限。
其他:error_include_args INI 选项:错误消息可统一附带函数参数,便于定位。部分 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 移除,本次清理得越早,未来大版本升级成本越低。
参考资料
上一篇:Debian 13 全方位命令手册(适配阿里云ECS、建站、Swap、CMS运维)
下一篇:已经是最后一篇
文章评论