PHP 8.6 正式发布:修复陈旧安全漏洞并引入多项实用功能

PHP 8.6 正式发布:修复陈旧安全漏洞并引入多项实用功能

PHP 8.6 版本本周面向全球服务器发布。自 PHP 8.4 在 2024 年锁定 11 月为固定发布日之后,此次更新不仅带来了新功能,还清理了部分代码缺陷。通常来说,这些 bug 比较轻微,无需在年中做紧急补丁修复,但在通往 8.6 版本的进程中,出现了一个棘手的安全问题:被称为 PHP2Shell 的两处漏洞。

这两个漏洞借助 AI 工具得以发现。它们存在于 PHP 系统中已长达数年,自 2012 年 5.4 版本发布起便埋下隐患,可能为攻击者打开大门。10 月底,各版本的漏洞修复补丁陆续放出。当时,PHP 官方小组已发布了 8.6 版本的第三个候选版本(RC3)。

RC4 于 10 月 21 日解决了 8.6 版本中的 PHP2Shell 问题。随后的小幅修复使开发工作一直持续到 11 月 11 日,即 RC7 版本,最终定稿为 PHP 8.6。

在安全威胁解除后,值得关注的是 8.6 版本中更直观的功能改进。

PHP 8.6 的新特性与优化

新增 TimeDuration 类

PHP 8.6 引入的 Duration 类为时间计算带来了一种类似秒表的功能。它避开了日历和时钟测量中常见的复杂性,比如说不同月份天数差异、夏令时调整及时区转换等问题。

Duration 支持以纳秒为单位做测量。在 64 位系统上,其数值范围可超过 92 亿秒。能直接操作这些数字,避免了浮点数计算可能带来的精度误差,特别实用。

// 休眠半秒
$half = TimeDuration::fromMilliseconds(500);
time_nanosleep($half->seconds, $half->nanoseconds);

除了上述毫秒捕获方法外,该类还包含以下基础方法:

  • fromNanoseconds()
  • fromMicroseconds()
  • fromSeconds()
  • fromMinutes()
  • fromHours()

该类内置了多种计算数值的方法。以下是两个示例:

// 减法
$remaining = TimeDuration::fromSeconds(10)->sub(TimeDuration::fromMilliseconds(2500));
show(’10 s – 2.5 s’, $remaining);
// 输出: 10 s – 2.5 s: 7.500000000
// 乘法
$total = TimeDuration::fromMilliseconds(1500)->multiplyBy(4);
show(‘1.5 s × 4’, $total);
// 输出: 1.5 s × 4: 6.000000000

新的数学函数 clamp()

与 C++、Java、Rust、Ruby 甚至 CSS 一样,PHP 现在拥有了 clamp() 函数。该函数用于评估数值是不是落在由最小值和最大值定义的范围内。

如果测试值位于最小和最大限制之内,函数返回该值;否则,返回最接近该值的边界(最小值或最大值)。

示比如说下:

// “min:” 和 “max:” 的写法是可选的
echo clamp(5, min: 1, max: 10); // 5 – 在范围内
echo clamp(15, 1, 10); // 10 – 最接近 15
// 不限于数字
clamp(“b”, “a”, “c”) // “b”

该函数还可以配合上述 Duration 类做比较操作。

部分函数应用

使用 ? 和/或 … 作为占位符,可以使函数调用看起来像一个闭包。只有当剩余参数提供时,函数才会被实际调用:

$replaceWhitespace = str_replace(‘ ‘, ?, ?);
echo $replaceWhitespace(‘+’, ‘ Hello World ‘);
// 输出: +Hello+World+

结合管道运算符,可以更高效地处理数据流,该运算符要求右侧为接收单个参数的可调用对象:

echo ‘ Hello-World ‘
|> trim(…) // 该行自 PHP 8.5 起已可用
|> str_replace(‘-‘, ‘ ‘, ?)
|> strtoupper(…)
|> str_pad(?, 13, ‘!’, STR_PAD_BOTH);
// 输出: !HELLO WORLD!

只读属性默认值

只读属性在 PHP 8.1 中引入,设计初衷是运行时初始化一次后保持不变。鉴于常量已承担类似角色,为只读属性提供默认值曾显得多余。

但 PHP 8.4 引入了属性钩子,让在接口中声明属性成为可能。PHP 8.6 进一步简化了实现,允许在不构造函数赋值的情况下,定义具有固定值的 get-only 接口属性。

官方文档常用此例展示新用法:

interface Question {
public int $answer { get; }
}
class UltimateQuestion implements Question {
public readonly int $answer = 42; // PHP 8.6 之前会导致致命错误
}

函数参数 DocComments

PHP 8.6 允许在函数和方法参数声明旁直接添加 DocComments,无需在上方使用 @params 块。开发者可通过新增的 ReflectionParameter::getDocComment() 方法读取这些注释。

以下是传统处理方式的示例:

class Staff
{
/**
* 当姓名和部门 ID 匹配时返回员工详情
*
* @param string $name 员工姓名
* @param int $department 部门 ID
*/
public function search(string $name, int $department): array
{
return [];
}
}

现在可以这样写:

class Staff
{
/**
* 当姓名和部门 ID 匹配时返回员工详情
*/
public function search(
/** 员工姓名 */
string $name,
/** 部门 ID */
int $department
): array {
return [];
}
}
var_dump(
new ReflectionParameter([Staff::class, ‘search’], ‘name’)
->getDocComment(),
);
// string(20) “/** 员工姓名 */”

统一排序方向的枚举

熟悉 PHP 内置排序函数的人会发现,控制排序方向(升序或降序)的参数命名杂乱无章。array_multisort() 和 scandir() 使用不同的整数常量,部分场景使用字符串 “ASC” 和 “DESC”而 rsort() 仅作为 sort() 的反向操作存在。

PHP 8.6 全局命名空间中新增了 SortDirection 枚举,旨在规范这一混乱局面。定义如下:

enum SortDirection {
case Ascending;
case Descending;
}

需要注意的是,目前 PHP 的内置排序函数尚未支持将这些枚举作为参数。该枚举目前主要供自定义排序代码及第三方库开发者使用。

mysqli::quote_string() 方法

对于使用 MySQL 增强扩展(mysqli)的用户,新增的 mysqli::quote_string() 方法可转义字符串并包裹在引号中,功能类似 PDO::quote()。

该方法作用类似于 mysqli::real_escape_string(),但返回值被单引号包裹,插入数据库前无需额外添加引号。

官方文档示例(处理含特殊标点的城市名):

$mysqli = mysqli_connect(“localhost”, “my_user”, “my_password”, “world”);
$city = “‘s-Hertogenbosch”;
$query = sprintf(“SELECT CountryCode FROM City WHERE name=%s”, mysqli_quote_string($mysqli, $city));

类常量的 #[Override] 特性

#[Override] 特性现可用于类常量,与方法和属性保持一致。这用于重写父类中同名的元素,或实现接口中定义的方法、属性或类常量。

官方文档示例:

class Base {
protected const FOO = ‘foo’;
}
final class Extended extends Base {
#[Override]
protected const BOO = ‘boo’;
}

PHP 8.6 中的弃用项

新版 PHP 通常包含标记为将在未来版本中移除的功能。这些弃用特性通常在主要更新中移除,对于近年来的多数弃用项,预计将在 9.0 版本中彻底移除。

命名规范调整

从本版本开始,某些命名习惯将被逐步淘汰。

发表评论