PHP 8.6 正式发布
PHP 8.6 已于 2026 年 11 月 19 日正式发布。本文介绍该版本的新特性、默认设置变更和弃用事项。
部分函数应用
部分函数应用(Partial Function Application,PFA)允许预先传入部分参数,得到一个接收其余参数的闭包。? 为稍后传入的单个参数占位,... 则为所有剩余参数占位。
php
$makeSlug = str_replace(' ', '-', ?);
$makeSlug('Hello World'); // Hello-World
$titles = array_map(strtolower(?), $titles);
生成的闭包保留原函数对应的参数名称、类型和默认值。预先传入的参数在创建闭包时求值。每个 ? 都会成为闭包的必填参数,即使原函数中的对应参数是可选的。
clamp() 函数
新函数 clamp() 会直接返回处于指定范围内的值。值低于下限时返回下限,高于上限时返回上限。
php
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 类,以纳秒精度表示秒表所测的时长。该类提供按不同时间单位创建实例的工厂方法,支持时长运算和比较。
php
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 钩子的接口属性,此前用固定值实现这类属性需要额外处理。
php
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 常量,缺少对应常量会触发致命错误。
php
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()。
php
const SETTINGS = new stdClass();
SETTINGS->timeout = 30;
var_dump(SETTINGS->timeout); // int(30)
常量本身依然不可变,因此 SETTINGS 始终指向同一个对象。通过常量写入数组元素仍然会报错。
函数参数的文档注释
文档注释现在可以直接写在参数声明处,并通过 ReflectionParameter::getDocComment() 读取。这样可以省去在函数上方的 @param 标签中重复填写参数名。
php
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()。
php
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 中直接接收该类型,省去适配代码。
php
$query->orderBy('created_at', SortDirection::Descending);
枚举可以实现 __debugInfo()
PHP 8.1 引入枚举时限制了多数魔术方法的定义。由于 __debugInfo() 无需额外状态,PHP 8.6 允许枚举实现这一方法,以自定义 var_dump() 的输出。
php
enum Status: int
{
case Ok = 200;
public function __debugInfo(): array
{
return [__CLASS__ . '::' . $this->name . ' = ' . $this->value];
}
}
流错误处理
PHP 为流操作提供了统一的错误模型。新增的上下文选项 error_mode 可以选择沿用原有警告机制、抛出异常或静默处理。stream_last_errors() 则返回上一次操作的结构化 StreamError 对象。
php
$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,省去逐个组件创建中间对象的步骤。
php
$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 的错误消息现在会包含解析失败位置的行号和列号。
php
$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 给出了以下示例。
text
// 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 表示全局作用域。
php
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://filterURL 中使用超过 16 个过滤器。 - 由于上游 Oniguruma 库已停止维护,
mb_ereg*系列函数和mb_split()已弃用(见相关 RFC)。
list() 语言结构的弃用提案未获通过,因此 list() 未被弃用。 PHP 8.6 正式发布