PHP 8.6 正式发布

PHP 8.6 正式发布

PHP 8.6 已于 2026 年 11 月 19 日正式发布。本文介绍该版本的新特性、默认设置变更和弃用事项。

部分函数应用

部分函数应用(Partial Function Application,PFA)允许预先传入部分参数,得到一个接收其余参数的闭包。? 为稍后传入的单个参数占位,... 则为所有剩余参数占位。

$makeSlug = str_replace(' ', '-', ?);

$makeSlug('Hello World'); // Hello-World

$titles = array_map(strtolower(?), $titles);

生成的闭包保留原函数对应的参数名称、类型和默认值。预先传入的参数在创建闭包时求值。每个 ? 都会成为闭包的必填参数,即使原函数中的对应参数是可选的。

clamp() 函数

新函数 clamp() 会直接返回处于指定范围内的值。值低于下限时返回下限,高于上限时返回上限。

clamp(10, min: 0, max: 100);  // 10
clamp(101, min: 0, max: 100); // 100
clamp(-1, min: 0, max: 100);  // 0

clamp() 支持任何可比较的类型,包括字符串和 DateTime 对象。传入的 $min 大于 $max 时会抛出 ValueError。它可以替代常见的 min(max($value, $min), $max) 写法,避免混淆 min() 和 max() 的调用顺序。

Duration 类

PHP 8.6 新增 Time\Duration,这是一个 final readonly 类,以纳秒精度表示秒表所测的时长。该类提供按不同时间单位创建实例的工厂方法,支持时长运算和比较。

use Time\Duration;

$oneSecond = Duration::fromSeconds(1);
$halfSecond = $oneSecond->divideBy(2);
$total = $oneSecond->add($halfSecond);

$delay = Duration::fromMilliseconds(100)->multiplyBy(2 ** $attempt);

$total > $delay; // comparison operators work

Duration 实例也可以从 ISO 8601 时长字符串创建。该类旨在为 PHP 核心函数和新的轮询 API 提供通用的时长类型,替代单独传递的整数和浮点数。完整的方法列表见 Duration RFC。

readonly 属性的默认值

从 PHP 8.6 起,readonly 属性可以声明默认值。此前这种写法会触发编译时错误。PHP 8.4 引入了只提供 get 钩子的接口属性,此前用固定值实现这类属性需要额外处理。

final readonly class CreateBooksTable implements Migration
{
    public string $name = '2026_01_01_create_books_table';
}

这项 RFC 仅解除对声明默认值的限制。readonly 属性在完成初始化后仍然禁止重新赋值。

类常量支持 #[\Override]

PHP 8.3 为方法引入 #[\Override] 特性,PHP 8.5 将支持范围扩展至属性。PHP 8.6 进一步支持将它用于类常量和枚举项。带有该特性的常量必须覆盖父类或接口中的 public 或 protected 常量,缺少对应常量会触发致命错误。

class Base
{
    protected const VERSION = '1.0';
}

class Child extends Base
{
    #[\Override]
    public const VERSION = '2.0'; // OK

    #[\Override]
    public const VERSOIN = '2.0'; // Fatal error: Child::VERSOIN has #[\Override] attribute, but no matching parent constant exists
}

写入常量所引用对象的属性

从 PHP 8.1 起,全局常量可以保存通过 new 创建的对象。此前,对该对象的属性赋值会触发 Cannot use temporary expression in write context 错误。PHP 8.6 允许对全局常量和类常量引用的对象写入属性,也可以对其属性使用 isset() 和 unset()。

const SETTINGS = new stdClass();

SETTINGS->timeout = 30;

var_dump(SETTINGS->timeout); // int(30)

常量本身依然不可变,因此 SETTINGS 始终指向同一个对象。通过常量写入数组元素仍然会报错。

函数参数的文档注释

文档注释现在可以直接写在参数声明处,并通过 ReflectionParameter::getDocComment() 读取。这样可以省去在函数上方的 @param 标签中重复填写参数名。

function search(
    /** Terms to search for in the database */
    string $query,
    /** Maximum number of entries to return */
    int $limit = 10,
): array {
    // ...
}

静态分析工具和 IDE 可以直接从参数读取注释。

轮询 API

新的 Io\Poll 命名空间为各平台的轮询机制提供了统一接口,包括 Linux 的 epoll、BSD 和 macOS 的 kqueue、Solaris 的 event ports,以及 Windows 的 WSAPoll。用 PHP 构建事件循环或异步运行时时,可以用这套接口替代 stream_select()。

use Io\Poll\{Context, Event};
use Time\Duration;

$poll = new Context();
$server = stream_socket_server('tcp://0.0.0.0:8080');
stream_set_blocking($server, false);

$poll->add(new StreamPollHandle($server), [Event::Read], ['type' => 'server']);

while (true) {
    foreach ($poll->wait(Duration::fromSeconds(1)) as $watcher) {
        if ($watcher->hasTriggered(Event::Read)) {
            // accept the connection
        }
    }
}

wait() 的超时参数采用 Time\Duration 类型。StreamPollHandle 是用于封装流资源的全局类。RFC 指出,这套 API 主要服务于信号处理和 PHP-FPM 改进等内部需求,其次面向用 PHP 实现的异步框架。

SortDirection 枚举

SortDirection 枚举提供 Ascending 和 Descending 两个枚举项,用统一且类型安全的方式表示排序方向。此前,各个库分别定义排序方向,形成了整数、字符串、布尔值及自定义枚举等彼此不兼容的表示方式。由于 SortDirection 已内置于 PHP,库可以在公共 API 中直接接收该类型,省去适配代码。

$query->orderBy('created_at', SortDirection::Descending);

枚举可以实现 __debugInfo()

PHP 8.1 引入枚举时限制了多数魔术方法的定义。由于 __debugInfo() 无需额外状态,PHP 8.6 允许枚举实现这一方法,以自定义 var_dump() 的输出。

enum Status: int
{
    case Ok = 200;

    public function __debugInfo(): array
    {
        return [__CLASS__ . '::' . $this->name . ' = ' . $this->value];
    }
}

流错误处理

PHP 为流操作提供了统一的错误模型。新增的上下文选项 error_mode 可以选择沿用原有警告机制、抛出异常或静默处理。stream_last_errors() 则返回上一次操作的结构化 StreamError 对象。

$context = stream_context_create([
    'stream' => ['error_mode' => StreamErrorMode::Exception],
]);

try {
    $stream = fopen('/nonexistent/file.txt', 'r', false, $context);
} catch (StreamException $e) {
    foreach ($e->getErrors() as $error) {
        echo $error->code->name . ': ' . $error->message;
    }
}

URI 扩展的后续改进

PHP 8.5 引入的 URI 扩展增加了构建器类。现在可以直接根据各个组成部分构建 URI,省去逐个组件创建中间对象的步骤。

$uri = new Uri\Rfc3986\UriBuilder()
    ->setScheme('https')
    ->setHost('example.com')
    ->setPath('/foo/bar')
    ->build();

两个 URI 类都新增了 getHostType()。Uri\Rfc3986\Uri 还新增了 getUriType(),Uri\WhatWg\Url 则新增了 isSpecialScheme()。新函数 Uri\WhatWg\url_percent_encode() 可以按 URL 组件对字符串进行百分号编码,具体组件通过 UrlPercentEncodingMode 枚举选择。

JSON 错误消息包含行号和列号

json_last_error_msg() 和 JsonException 的错误消息现在会包含解析失败位置的行号和列号。

$json = '{
    "key1": "value1",
    "key2" "value2"
}';

json_validate($json);  // false
json_last_error_msg(); // "Syntax error near location 3:12"

PHP 8.6 之前,这条错误消息只有 Syntax error。

在警告消息中显示函数参数

新增的 error_include_args INI 设置可以在内置函数发出的警告中显示该函数收到的参数。RFC 给出了以下示例。

// Before
Warning: chmod(): Operation not permitted in /app/chmod.php on line 5

// With error_include_args=1
Warning: chmod('/', 511): Operation not permitted in /app/chmod.php on line 5

该设置默认关闭。参数的显示格式与异常堆栈跟踪一致。使用 #[\SensitiveParameter] 标记的参数会被隐藏,长字符串则会根据 zend.exception_string_param_max_len 的设置截断。

通过反射判断属性能否读写

ReflectionProperty::isPublic() 只反映属性是否声明为 public。PHP 8.1 引入只读属性、PHP 8.4 引入不对称可见性之后,判断属性能否写入还需要考虑这些规则。新增的 isReadable() 和 isWritable() 可以判断给定作用域是否允许读取或写入属性,其中 null 表示全局作用域。

class Post
{
    public function __construct(
        public private(set) string $title,
    ) {}
}

$property = new ReflectionProperty(Post::class, 'title');

$property->isReadable(null);       // true
$property->isWritable(null);       // false
$property->isWritable(Post::class); // true

第二个参数可以传入具体对象,以便将对象的状态也纳入判断,例如只读属性是否已经初始化。

更安全的会话默认设置

新安装的 PHP 会采用 php.ini 中的三项新会话默认值。

设置项 旧默认值 新默认值
session.use_strict_mode 0 1
session.cookie_httponly 0 1
session.cookie_samesite 未设置 Lax

Laravel 自行管理会话 Cookie,因此大部分 Laravel 应用不受影响。使用 PHP 原生会话且依赖旧默认值的应用,应查阅会话默认设置 RFC。

性能改进

PHP 8.6 优化了多种常见代码的编译和执行。

  • 当回调使用一等可调用语法或部分函数应用时,array_map() 会被编译为等价的 foreach 循环,省去中间闭包的创建。例如 array_map(strtolower(...), $names)。
  • 仅使用 %s 和 %d 格式说明符的 printf() 调用会被编译为字符串插值。
  • 无状态闭包会被缓存并重复使用,省去每次求值时的创建开销。这里的无状态闭包指未捕获外部变量、也未声明静态变量的 static 闭包。
  • 属性解析机制现在区分读取和写入。在每个调用位置完成首次写入后,后续写入 private(set) 和 protected(set) 属性的开销与写入 public 属性相同。
  • JIT 现已支持 Apple Silicon 上的线程安全(ZTS)构建。
  • json_encode() 加快了数组和对象的编码,以及使用 JSON_PRETTY_PRINT 时的缩进生成。

其他新增功能

  • grapheme_strrev() 按字素簇反转字符串,保留组合字符和表情符号的完整性。
  • pack() 和 unpack() 支持在有符号整数和浮点数的格式码上使用字节序修饰符 < 和 >。
  • mysqli::quote_string() 和 mysqli_quote_string() 会转义字符串,并在其两端加上单引号,行为与 PDO::quote() 相同。
  • ZipArchive::openString() 和 ZipArchive::closeString() 可在内存中读取和写入 ZIP 归档。
  • 流套接字可通过新的 Openssl\Session 类恢复 TLS 会话,并支持 TLS 1.3 早期数据,以及保活、延迟关闭和缓冲区大小等上下文选项。
  • 使用 libsodium 1.0.22 或更高版本构建 PHP 时,Sodium 扩展提供 ML-KEM768 和 X-Wing 后量子密钥封装函数。
  • Intl 扩展新增 IntlNumberRangeFormatter、Locale::getDisplayKeyword() 和 Locale::getDisplayKeywordValue()。
  • 将 ini_get_all() 的 $details 设为 true 时,结果会包含每个配置指令的内置默认值。
  • 内置开发服务器支持使用 HTTP QUERY 方法的请求。

向后不兼容的变更

完整列表见 UPGRADING 文件。以下变更较可能影响应用代码。

  • trim()、ltrim() 和 rtrim() 默认也会移除换页符(\f)。
  • 流刷新或关闭失败时,fclose()、file_put_contents() 和 copy() 现在会返回 false。旧版本会忽略这类失败。
  • unpack() 会把格式码后的 < 或 > 解释为字节序修饰符。例如,格式 s<value 在旧版本中生成键名 <value,在 PHP 8.6 中生成键名 value。
  • 对于空会话,session_encode() 在旧版本中返回 false,在 PHP 8.6 中返回空字符串。
  • preg_grep() 遇到 PCRE 错误时,旧版本会返回部分结果组成的数组,PHP 8.6 返回 false。
  • 许多函数现在会在参数无效或字符串包含 NUL 字节时抛出 ValueError,包括 getenv()、putenv()、setlocale()、parse_str()、stat() 和 file_exists()。
  • 发生严重的内存耗尽错误时,PHP 8.6 会调用 abort(),进程退出码由 1 变为 134。

弃用项

PHP 8.6 的弃用 RFC 与多份独立 RFC 涉及以下弃用项。

  • 在 finally 块中执行 return。这可能导致异常被静默丢弃。
  • 从 __construct() 或 __destruct() 返回值,或者将其中任一方法用作生成器。仍可使用无返回值的 return;(见相关 RFC)。
  • 将 is 或 let 用作类名、函数名或常量名,以及将 _ 用作常量名。这些名称为未来的模式匹配和块级作用域提案预留。
  • 将 namespace 用作类常量名,将 readonly 用作函数名,以及向 define() 传入第三个参数。
  • is_double()、is_integer()、is_long() 和 doubleval()。对应的替代函数为 is_float()、is_int() 和 floatval()。
  • spl_object_hash(),可改用 spl_object_id()。
  • strcoll() 和 SORT_LOCALE_STRING 标志,可改用 Collator 类。
  • spl_classes()、metaphone()、mysqli_get_charset() 和 mysqli_stmt_init()。
  • ArrayIterator 从 ArrayObject 继承的标志、排序和序列化方法,以及 SplFileObject 的 CSV 方法。
  • 向 array_walk()、http_build_query() 和 mb_convert_variables() 传入对象。
  • 在 $allow_string 为 false 时向 is_a() 或 is_subclass_of() 传入字符串。
  • 缺少 create_sid() 或 validateId() 任一方法的会话处理器。
  • 在未显式设置新增的 filter.max_filter_count 上下文选项时,在 php://filter URL 中使用超过 16 个过滤器。
  • 由于上游 Oniguruma 库已停止维护,mb_ereg* 系列函数和 mb_split() 已弃用(见相关 RFC)。

list() 语言结构的弃用提案未获通过,因此 list() 未被弃用。
PHP 8.6 正式发布

posted @ 2026-11-20 08:23  JaguarJack  阅读(13)  评论(0)    收藏  举报