Skip to content

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_args INI 配置,用于统一控制错误信息中函数参数的显示,默认关闭。

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://filter URL 中未配置限制却使用超过 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 等模块得到补充。
  • 多项废弃和默认行为变化,需要在升级前认真检查。

对业务项目来说,升级的重点不是马上使用所有新语法,而是先确认旧代码和依赖能够稳定运行。兼容性验证通过后,再逐步引入新特性会更稳妥。

参考资料 ​

Last updated: