构造函数属性提升 是 php 8 中引入的一项功能，可简化类中的属性声明和初始化。在 php 8 之前，您必须显式声明类属性，然后在构造函数中初始化它们。通过此功能，您可以直接在构造函数的参数列表中声明和初始化属性，从而减少样板代码。
传统语法（php 8 之前）
class product {
private string $name;
private float $price;
public function __construct(string $name, float $price) {
$this->name = $name;
$this->price = $price;
}
}
构造函数属性提升语法 (php 8)
class product {
public function __construct(
private string $name,
private float $price
) {}
}
好处
-
减少样板代码:
- 无需在构造函数外部声明属性并手动初始化它们。
-
提高可读性：
立即学习“PHP免费学习笔记（深入）”；
- 使代码更加简洁、更容易理解，尤其是在具有许多属性的类中。
-
支持不变性:
- 属性可以标记为只读（在 php 8.1 中引入），以防止初始化后发生更改。
笔记
-
可见性修饰符：
- 升级的属性必须包含可见性修饰符（私有、受保护或公共）。
-
默认值：
- 您不能直接为提升的属性设置默认值，但您可以在构造函数中使用默认参数值。
class product { public function __construct( private string $name = 'unnamed', private float $price = 0.0 ) {} } -
混合促销和非促销属性：
- 您可以将传统属性和升级属性组合在同一类别中。
class product { private string $category; public function __construct( private string $name, private float $price ) { $this->category = 'general'; } }
用例
构造函数属性提升对于像dto（数据传输对象）这样的简单类特别有用，其中主要目的是存储数据。
class customerdto {
public function __construct(
public string $name,
public string $email,
public ?string $phone = null
) {}
}
结论
构造函数属性提升是 php 8 中的一项强大功能，可以提高生产力并降低代码复杂性。对于需要简洁明了初始化的具有多个属性的类来说，它是理想的选择。
属性整合
在 php 8 中，属性（也称为注解）可以与构造函数属性提升无缝结合，从而产生更干净、更具表现力的代码，尤其是在元数据需要与属性关联的场景中。
与建筑商房产促销整合
通过构造函数属性提升，属性直接在构造函数中定义。您可以使用 attributes 来装饰这些属性并添加上下文信息，而无需单独声明属性。
实际示例
假设您正在处理 dto（数据传输对象）并希望将属性映射到数据库列
没有建筑商房产促销
use attribute;
#[attribute]
class column {
public function __construct(public string $name) {}
}
class user {
#[column('user_id')]
private int $id;
#[column('username')]
private string $name;
public function __construct(int $id, string $name) {
$this->id = $id;
$this->name = $name;
}
}
与建筑商房产促销
use attribute;
#[attribute]
class column {
public function __construct(public string $name) {}
}
class user {
public function __construct(
#[column('user_id')] private int $id,
#[column('username')] private string $name
) {}
}
集成的好处
-
减少样板代码：
- 提升属性消除了重复声明，并且属性可以直接应用于构造函数的属性。
-
更干净、更易读的代码:
- 集成将初始化、元数据和可见性整合在一处。
-
反思的灵活性：
- 您可以使用 php 的 reflection api 来访问和处理应用于升级属性的属性。
通过反射访问属性
// reflection allows us to inspect and manipulate the user class at runtime.
$reflectionclass = new reflectionclass(user::class);
// get the constructor of the user class.
$constructor = $reflectionclass->getconstructor();
// iterate through the constructor's parameters.
foreach ($constructor->getparameters() as $parameter) {
// retrieve all attributes of type column applied to the current parameter.
$attributes = $parameter->getattributes(column::class);
// process each attribute found.
foreach ($attributes as $attribute) {
// instantiate the attribute to access its values.
$column = $attribute->newinstance();
// output the parameter name and the associated column name from the attribute.
echo "parameter: {$parameter->getname()}, column: {$column->name}" . php_eol;
}
}
代码说明
-
定义列属性:
- #[attribute] 装饰器表明 column 类是一个属性。
- 属性类接受单个参数名称，用于将属性与数据库列关联起来。
-
为构造函数参数添加属性:
- 像 #[column('user_id')] 和 #[column('username')] 这样的属性被添加到构造函数参数 id 和 name 中。
-
使用反射:
- reflectionclass 对象是为 user 类创建的，允许我们检查它的属性和方法。
-
访问构造函数:
- getconstructor() 检索 user 类的构造函数。
-
迭代参数:
- getparameters() 检索构造函数的所有参数。
-
获取属性:
- getattributes(column::class) 检索应用于参数的 column 类型的所有属性。
-
实例化属性:
- newinstance() 创建 column 属性的实例，提供对其 name 属性的访问。
-
打印元数据:
- 将参数名称（例如，id）及其关联的列名称（例如，user_id）输出到控制台。
输出：
Parameter: id, Column: user_id Parameter: name, Column: username
常见用例
-
数据库映射:
- 使用#[column]等属性来指定数据库列。
-
数据验证:
- 直接对属性应用验证，例如#[notnull] 或#[maxlength(255)]。
-
序列化/反序列化:
- 将属性映射到 json 字段，例如 #[jsonfield('user_name')].
结论
构造函数属性提升与属性的集成提供了一种在php中构建类的强大而简洁的方法。这在依赖元数据（例如 orm、验证或序列化）的系统中特别有用，使代码更具表现力和组织性。
