PHP 8.2 的核心高级特性，包括只读类、类型系统增强

1. 引言

PHP 8.2 于 2022 年 12 月正式发布，作为 PHP 8 系列的重要版本，它带来了多项令人兴奋的新特性与改进。对于追求高性能、高可维护性的开发者而言，PHP 8.2 不仅是一次语法层面的升级，更是一次工程实践能力的跃升。

本文将深入探讨 PHP 8.2 的核心高级特性，包括只读类、类型系统增强、独立 null/false/true 类型、动态属性弃用等，并结合实际场景给出性能优化与最佳实践建议。无论你是正在迁移旧项目，还是准备在新项目中采用 PHP 8.2，本文都能为你提供系统性的技术参考。

2. PHP 8.2 核心新特性详解

2.1 只读类（Readonly Classes）

PHP 8.2 引入了只读类，这是对 PHP 8.1 只读属性的重要扩展。只读类中的所有实例属性都自动变为只读，且属性类型必须显式声明。

php 复制代码

readonly class UserProfile
{
    public string $name;
    public int $age;

    public function __construct(string $name, int $age)
    {
        $this->name = $name;
        $this->age = $age;
    }
}

$profile = new UserProfile('Alice', 30);
// $profile->name = 'Bob'; // 抛出 Error: Cannot modify readonly property

关键约束：

只读类不能定义静态属性。
只读类不支持动态属性。
只读属性不能在初始化后被修改，包括在克隆时。
只读类可以被继承，但子类也必须声明为只读。

适用场景： DTO（数据传输对象）、值对象、配置对象等不可变数据结构的建模。

2.2 独立类型：null、false、true

PHP 8.2 允许 null、false、true 作为独立的类型声明，这大大增强了类型系统的表达能力。

php 复制代码

function findUser(int $id): User|null
{
    // 返回 User 或 null
}

function isAdmin(User $user): true|false
{
    return $user->role === 'admin';
}

function getStatus(): true
{
    return true; // 只能返回 true
}

注意： null 不能单独作为属性类型，但可以作为参数和返回类型。false 和 true 作为独立类型时，不能与 bool 混用。

2.3 动态属性弃用（Deprecation of Dynamic Properties）

PHP 8.2 将动态属性标记为弃用。在 PHP 8.2 中，向未声明属性的对象赋值会触发 Deprecated 警告；在 PHP 9.0 中将彻底移除该能力。

php 复制代码

class User
{
    public string $name;
}

$user = new User();
$user->email = 'alice@example.com'; // Deprecated: Creation of dynamic property

解决方案：

显式声明所有属性。
使用 #[AllowDynamicProperties] 属性显式允许动态属性。
实现 __set() / __get() 魔术方法。

php 复制代码

#[AllowDynamicProperties]
class LegacyModel
{
    // 允许动态属性
}

2.4 类型系统增强：DNF 类型

PHP 8.2 支持 DNF（Disjunctive Normal Form，析取范式）类型，即联合类型与交集类型的组合。

php 复制代码

function process((A&B)|C $value): void
{
    // $value 必须是 A 和 B 的交集，或者是 C
}

规则：

交集类型必须用括号包裹。
联合类型中的每个成员可以是交集类型。
不能将 null 与交集类型直接组合，需写成 (A&B)|null。

2.5 常量在 trait 中的支持

PHP 8.2 允许在 trait 中定义常量，并且 trait 可以定义抽象常量。

php 复制代码

trait HttpStatus
{
    public const OK = 200;
    public const NOT_FOUND = 404;

    abstract public const ERROR_CODE;
}

class ApiResponse
{
    use HttpStatus;

    public const ERROR_CODE = 500;
}

3. 新函数与语法糖

3.1 新增函数

PHP 8.2 新增了多个实用函数：

php 复制代码

// 返回 true 如果值是合法的 ini 大小表示
var_dump(ini_parse_quantity('1G')); // int(1073741824)

// 返回 true 如果字符串是有效的 UTF-8
var_dump(mb_validate_encoding('你好', 'UTF-8')); // bool(true)

// 返回当前进程的 CPU 时间
$cpuTime = get_cpu_time();

3.2 只读类与枚举的组合

只读类与枚举结合可以构建强大的领域模型：

php 复制代码

enum OrderStatus: string
{
    case Pending = 'pending';
    case Paid = 'paid';
    case Shipped = 'shipped';
}

readonly class Order
{
    public function __construct(
        public string $orderId,
        public OrderStatus $status,
        public float $total,
    ) {}
}

3.3 随机数生成器改进

PHP 8.2 引入了新的随机数生成接口，替代旧的 rand() 和 mt_rand()：

php 复制代码

use Random\Randomizer;
use Random\Engine\Mt19937;

$randomizer = new Randomizer(new Mt19937(1234));
$randomInt = $randomizer->getInt(1, 100);
$randomString = $randomizer->getBytesFromString('abcdef', 8);

4. 性能优化实战

4.1 JIT 编译优化

PHP 8.2 对 JIT（Just-In-Time）编译器进行了持续优化。合理配置 JIT 可以显著提升 CPU 密集型任务的性能。

ini 复制代码

; php.ini 配置
opcache.enable=1
opcache.jit=tracing
opcache.jit_buffer_size=128M

适用场景： 数学计算、图像处理、数据解析等 CPU 密集型任务。

4.2 使用只读类减少内存开销

只读类由于属性不可变，PHP 引擎可以进行更多优化，减少内存占用和拷贝开销。

php 复制代码

// 大量创建不可变对象时，只读类更高效
readonly class Point
{
    public function __construct(
        public float $x,
        public float $y,
    ) {}
}

$points = [];
for ($i = 0; $i < 100000; $i++) {
    $points[] = new Point($i, $i * 2);
}

4.3 避免动态属性带来的性能损耗

动态属性不仅会触发弃用警告，还会带来额外的哈希查找开销。显式声明属性可以提升属性访问速度。

php 复制代码

// 不推荐：动态属性
class Config
{
    // 隐式动态属性
}

// 推荐：显式声明
class Config
{
    public string $host;
    public int $port;
    public string $username;
    public string $password;
}

4.4 OpCache 调优

ini 复制代码

opcache.memory_consumption=256
opcache.interned_strings_buffer=32
opcache.max_accelerated_files=20000
opcache.revalidate_freq=0
opcache.validate_timestamps=0  ; 生产环境关闭文件时间戳检查

5. 类型安全与静态分析

5.1 严格类型声明

php 复制代码

declare(strict_types=1);

function calculateTotal(float $price, int $quantity): float
{
    return $price * $quantity;
}

// 传入字符串会抛出 TypeError
// calculateTotal('10.5', 3);

5.2 与 PHPStan / Psalm 集成

PHP 8.2 的类型系统增强为静态分析工具提供了更精确的推断基础：

php 复制代码

/**
 * @param array{name: string, age: int} $data
 * @return UserProfile
 */
function createProfile(array $data): UserProfile
{
    return new UserProfile($data['name'], $data['age']);
}

5.3 使用 DNF 类型提升代码可读性

php 复制代码

interface Cacheable {}
interface Serializable {}

function persist(Cacheable&Serializable|array $data): void
{
    // 处理逻辑
}

6. 从 PHP 8.0/8.1 迁移到 8.2 的注意事项

6.1 动态属性迁移清单

运行 php -l 检查语法错误。
使用静态分析工具扫描动态属性使用。
为遗留代码添加 #[AllowDynamicProperties]。
逐步重构为显式属性声明。

6.2 兼容性检查

bash 复制代码

# 检查扩展兼容性
php -m

# 运行测试套件
phpunit --testdox

6.3 常见破坏性变更

utf8_encode() / utf8_decode() 已弃用。
strftime() 已弃用。
${var} 字符串插值语法已弃用，使用 {$var}。

7. 实战案例：构建高性能 API 服务

7.1 项目结构

text 复制代码

app/
├── src/
│   ├── Controller/
│   ├── DTO/
│   ├── Service/
│   └── Repository/
├── config/
└── public/
    └── index.php

7.2 使用只读类构建 DTO

php 复制代码

readonly class CreateUserRequest
{
    public function __construct(
        public string $name,
        public string $email,
        public string $password,
    ) {}

    public static function fromArray(array $data): self
    {
        return new self(
            name: $data['name'],
            email: $data['email'],
            password: $data['password'],
        );
    }
}

7.3 结合枚举与只读类

php 复制代码

enum UserRole: string
{
    case Admin = 'admin';
    case Editor = 'editor';
    case Viewer = 'viewer';
}

readonly class User
{
    public function __construct(
        public int $id,
        public string $name,
        public UserRole $role,
    ) {}

    public function isAdmin(): bool
    {
        return $this->role === UserRole::Admin;
    }
}

7.4 性能基准测试

php 复制代码

$start = hrtime(true);

// 业务逻辑
$users = $repository->findAll();

$end = hrtime(true);
$elapsedMs = ($end - $start) / 1_000_000;

echo "执行耗时: {$elapsedMs} ms" . PHP_EOL;

8. 总结与展望

PHP 8.2 在类型系统、不可变数据结构、性能优化等方面为开发者提供了强大的工具。只读类让不可变设计模式更加优雅，独立类型声明提升了代码的自文档化程度，动态属性的弃用则推动代码向更规范的方向演进。

在实际项目中，建议团队逐步采用这些新特性，配合静态分析工具和自动化测试，构建健壮、高性能的 PHP 应用。随着 PHP 8.3、8.4 的持续演进，PHP 语言正在不断现代化，值得每一位开发者持续关注与学习。