PHP 8 新特性：构造器属性提升与实战

1. 引言

PHP 8.0 于 2020 年 11 月正式发布，带来了大量令人兴奋的新特性，其中「构造器属性提升」（Constructor Property Promotion）堪称日常开发中提升效率最明显的一项。它让原本需要「声明属性 + 构造函数参数 + 手动赋值」三件套才能完成的样板代码，压缩成一行简洁的语法。

本文将从基础语法讲起，逐步深入到与 readonly、枚举类型的组合用法，并通过重构一个真实用户实体类，带你完整掌握这一特性的实战技巧与兼容性注意事项。

2. 构造器属性提升语法

2.1 传统写法的问题

在 PHP 8.0 之前，定义一个带有属性的实体类，通常需要这样写：

class User
{
private string $name;
private string $email;
private int $age;

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

每个属性都要经历「声明 → 参数接收 → 赋值」三步，属性一多，代码就变得冗长且重复，维护成本也随之上升。

2.2 属性提升的简洁写法

构造器属性提升允许直接在构造函数参数列表中声明属性并自动赋值：

class User
{
public function __construct(
private string $name,
private string $email,
private int $age,
) {}
}

短短几行就完成了与上面完全等价的功能。PHP 会自动将参数提升为类属性，并在构造时完成赋值。

2.3 语法要点

• 提升的属性必须带有可见性修饰符（public / protected / private），否则会被当作普通参数。
• 可以同时使用类型声明、默认值、可变参数等，与普通参数规则一致。
• 提升属性与类中显式声明的属性不能重名，否则会报错。
• 构造函数体内仍可编写额外逻辑，提升语法与普通逻辑可以共存。

class Product
{
public function __construct(
public readonly string $sku,
protected float $price,
private ?string $description = null,
) {
// 构造函数体内仍可执行额外初始化逻辑
if ($price < 0) {
throw new InvalidArgumentException('价格不能为负数');
}
}
}

3. 与 readonly 结合使用

3.1 readonly 属性简介

PHP 8.1 引入了 readonly 修饰符，声明后的属性只能在初始化时赋值一次，之后不可修改，非常适合表达不可变对象。

3.2 组合写法

构造器属性提升与 readonly 是天作之合，可以写出极其简洁的不可变对象：

class Money
{
public function __construct(
public readonly int $amount,
public readonly string $currency,
) {}
}

$money = new Money(100, 'CNY');
// $money->amount = 200; // 报错：Cannot modify readonly property

3.3 注意事项

• readonly 属性不能有默认值（默认值相当于在声明处赋值，与 readonly 语义冲突）。
• readonly 属性不能被 unset()。
• 若类中所有属性都是 readonly，可以考虑将整个类声明为 readonly class（PHP 8.2+），进一步简化。

readonly class Point
{
public function __construct(
public float $x,
public float $y,
) {}
}

4. 与枚举类型配合的领域建模

4.1 枚举类型简介

PHP 8.1 引入了原生枚举（Enum），让领域建模中的状态、类型等概念有了类型安全的表达方式。

4.2 组合实战

将构造器属性提升与枚举结合，可以构建出类型安全且表达力强的领域模型：

enum UserStatus: string
{
case Active = 'active';
case Inactive = 'inactive';
case Banned = 'banned';
}

enum UserRole: string
{
case Admin = 'admin';
case Editor = 'editor';
case Subscriber = 'subscriber';
}

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

$user = new User(
name: '张三',
status: UserStatus::Active,
role: UserRole::Editor,
);

4.3 领域建模的价值

• 类型安全：编译器/静态分析工具能提前发现非法状态值，避免魔法字符串散落各处。
• 自文档化：枚举成员名称本身就是业务语义的体现，代码可读性大幅提升。
• 配合命名参数：构造器属性提升与命名参数（Named Arguments）配合，调用时一目了然，尤其适合参数较多的场景。

5. 实战：重构一个用户实体类

5.1 重构前的代码

假设我们有一个遗留的用户实体类，代码冗长且状态管理混乱：

class LegacyUser
{
private string $name;
private string $email;
private string $status;
private string $role;
private ?string $avatarUrl;

public function __construct(
string $name,
string $email,
string $status,
string $role,
?string $avatarUrl = null
) {
$this->name = $name;
$this->email = $email;
$this->status = $status;
$this->role = $role;
$this->avatarUrl = $avatarUrl;
}

public function getName(): string
{
return $this->name;
}

public function getStatus(): string
{
return $this->status;
}
}

5.2 重构后的代码

利用构造器属性提升、readonly 与枚举，重构后的代码更加简洁、安全：

enum UserStatus: string
{
case Active = 'active';
case Inactive = 'inactive';
case Banned = 'banned';
}

enum UserRole: string
{
case Admin = 'admin';
case Editor = 'editor';
case Subscriber = 'subscriber';
}

class User
{
public function __construct(
public readonly string $name,
public readonly string $email,
public readonly UserStatus $status,
public readonly UserRole $role,
public readonly ?string $avatarUrl = null,
) {}

public function isActive(): bool
{
return $this->status === UserStatus::Active;
}

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

// 使用示例
$user = new User(
name: '李四',
email: 'lisi@example.com',
status: UserStatus::Active,
role: UserRole::Editor,
);

var_dump($user->isActive()); // true
var_dump($user->canEdit()); // true

5.3 重构收益对比

7. 注意事项与兼容性

7.1 兼容性要求

• 构造器属性提升需要 PHP 8.0+。
• readonly 属性需要 PHP 8.1+。
• 枚举类型需要 PHP 8.1+。
• readonly class 需要 PHP 8.2+。
• 类型化类常量、#[\\Override]、json_validate() 需要 PHP 8.3+。
• 属性钩子、不对称可见性、#[\\Deprecated] 需要 PHP 8.4+。
• #[\\NoDiscard]、#[\\Deprecated] 的 reason 参数、#[\\Override] 对接口默认方法的支持需要 PHP 8.5+。

如果你的项目仍运行在 PHP 7.x，则无法使用这些特性，需要先升级运行时环境。建议新项目直接采用 PHP 8.4 或 8.5，以享受最新语法与性能优化。

7.2 使用注意事项

• 不要过度使用：并非所有构造函数参数都适合提升。如果某个参数仅用于构造逻辑、不需要成为属性，就保持普通参数。
• 命名冲突：提升属性名不能与类中已有属性或方法重名。
• 继承场景：子类构造函数若调用父类构造函数，提升属性在父类中定义，子类中不可重复声明同名提升属性。
• 反射与序列化：提升属性与普通属性在反射、序列化行为上一致，无需特殊处理。
• IDE 支持：主流 IDE（PhpStorm、VS Code + 插件）均已良好支持该语法，可放心使用。
• 版本升级策略：引入 PHP 8.3/8.4/8.5 新特性前，务必确认生产环境的运行时版本，避免语法兼容问题。

7.3 常见误区

// 错误：缺少可见性修饰符，不会被提升为属性
class WrongExample
{
public function __construct(string $name) {}
}

// 正确：必须带可见性修饰符
class RightExample
{
public function __construct(private string $name) {}
}

义读取/写入时的钩子逻辑，替代大量 getter/setter 样板代码。

class User
{
public string $fullName {
get => trim($this->firstName . ' ' . $this->lastName);
set {
$parts = explode(' ', $value);
$this->firstName = $parts[0] ?? '';
$this->lastName = $parts[1] ?? '';
}
}

private string $firstName = '';
private string $lastName = '';
}

• 不对称可见性（Asymmetric Visibility）：属性的读取和写入可以设置不同的可见性，例如「公开读取、受保护写入」。

class Order
{
public private(set) string $status = 'pending';

public function markPaid(): void
{
$this->status = 'paid'; // 仅类内部可写
}
}

$order = new Order();
echo $order->status; // 可读
// $order->status = 'paid'; // 报错：外部不可写

• 新增 #[\\Deprecated] 属性：标记废弃方法或类，配合静态分析工具提示调用方迁移。

class LegacyApi
{
#[\\Deprecated('请使用 newApi() 替代', since: '8.4')]
public function oldApi(): void {}
}

• new 表达式无需括号：在参数中直接使用 new 时不再强制要求括号，代码更简洁。

$repo = new UserRepository(new DatabaseConnection());
// PHP 8.4 之前需写成 new DatabaseConnection()

6.3 与构造器属性提升的协同

最新版本的新特性与构造器属性提升并非孤立存在，它们常常组合出更强的表达力：

readonly class Money
{
public function __construct(
public int $amount,
public string $currency,
) {}

public function withAmount(int $newAmount): Money
{
$clone = clone $this;
$clone->amount = $newAmount; // PHP 8.3 允许在 clone 中修改 readonly
return $clone;
}
}

class Order
{
public function __construct(
public readonly Money $total,
public private(set) string $status = 'pending',
) {}

public function markPaid(): void
{
$this->status = 'paid';
}
}

这里将属性提升、readonly、类型化常量、不对称可见性、只读深拷贝等特性融为一体，构建出既简洁又安全的领域模型。

6. 注意事项与兼容性

6.1 兼容性要求

• 构造器属性提升需要 PHP 8.0+。
• readonly 属性需要 PHP 8.1+。
• 枚举类型需要 PHP 8.1+。
• readonly class 需要 PHP 8.2+。

如果你的项目仍运行在 PHP 7.x，则无法使用这些特性，需要先升级运行时环境。

6.2 使用注意事项

• 不要过度使用：并非所有构造函数参数都适合提升。如果某个参数仅用于构造逻辑、不需要成为属性，就保持普通参数。
• 命名冲突：提升属性名不能与类中已有属性或方法重名。
• 继承场景：子类构造函数若调用父类构造函数，提升属性在父类中定义，子类中不可重复声明同名提升属性。
• 反射与序列化：提升属性与普通属性在反射、序列化行为上一致，无需特殊处理。
• IDE 支持：主流 IDE（PhpStorm、VS Code + 插件）均已良好支持该语法，可放心使用。

6.3 常见误区

// 错误：缺少可见性修饰符，不会被提升为属性
class WrongExample
{
public function __construct(string $name) {}
}

// 正确：必须带可见性修饰符
class RightExample
{
public function __construct(private string $name) {}
}

8. 总结

构造器属性提升是 PHP 8 中最能「立竿见影」提升开发效率的特性之一。它与 readonly、枚举类型、命名参数等新特性组合使用，能够帮助我们写出更简洁、更安全、更具表达力的领域模型。

而 PHP 8.3、8.4、8.5 带来的类型化类常量、属性钩子、不对称可见性、只读深拷贝、#[\\NoDiscard] 等新能力，则进一步拓展了这门语言的表达边界。建议你在新项目中积极采用这些现代语法，并逐步重构遗留代码中重复的「声明-赋值」样板，让 PHP 代码真正体现出现代语言的优雅与生产力。