构造函数属性提升 是 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 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、验证或序列化)的系统中特别有用,使代码更具表现力和组织性。
暂无评论内容