PHP 8.6 更新详解:新特性、废弃项与升级注意事项

袁志蒙 144次浏览

摘要: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=no

10. 其他值得关注的改进

类别内容
常量对象可变存放在常量/类常量里的对象,可直接 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_args INI 选项:错误消息可统一附带函数参数,便于定位。

  • 部分 GMP 位移/幂运算在右操作数为浮点且转整数丢精度时,发出废弃提示。


四、升级建议

  1. 生产环境暂缓:8.6 刚发布,第三方扩展(redis、memcached、imagick、加密扩展等)和框架的适配需要时间;本地开发、CI 可以先行尝鲜。

  2. 先扫废弃提示:在测试环境把 error_reporting 设为包含 E_DEPRECATED,跑一遍核心业务,重点排查:finally 返回、mbregex、is_double/is_long 等别名、对象当数组传参、自定义 Session 处理器。

  3. 框架与扩展优先验证:Laravel、ThinkPHP、YzmCMS 等老项目重点检查扩展兼容性和弃用 API;常驻内存/异步框架关注 Polling API 与流错误处理的变化。

  4. 新特性按需采用:PFA、Duration、clamp()、SortDirection 可以在新代码中使用;Io\Poll 主要由框架/库作者对接,业务代码一般不直接调用。

  5. 关注 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

随机内容
表情
点击进行验证
共0条评论
  • 这篇文章还没有收到评论,赶紧来抢沙发吧~