PHP ews:构造函数属性提升

构造函数属性提升 是 php 8 中引入的一项功能,可简化类中的属性声明和初始化。在 php 8 之前,您必须显式声明类属性,然后在构造函数中初始化它们。通过此功能,您可以直接在构造函数的参数列表中声明和初始化属性,从而减少样板代码。

图片[1]-PHP ews:构造函数属性提升-优客之家

传统语法(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
) {}
}

好处

  1. 减少样板代码:
    • 无需在构造函数外部声明属性并手动初始化它们。
  2. 提高可读性
    • 使代码更加简洁、更容易理解,尤其是在具有许多属性的类中
  3. 支持不变性:
    • 属性可以标记为只读(在 php 8.1 中引入),以防止初始化后发生更改。

笔记

  1. 可见性修饰符
    • 升级的属性必须包含可见性修饰符(私有、受保护或公共)。
  2. 默认值
    • 您不能直接为提升的属性设置默认值,但您可以在构造函数中使用默认参数值。

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
) {}
}

集成的好处

  1. 减少样板代码
    • 提升属性消除了重复声明,并且属性可以直接应用于构造函数的属性。
  2. 更干净、更易读的代码:
    • 集成将初始化、元数据和可见性整合在一处。
  3. 反思的灵活性
    • 您可以使用 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;
}
}

代码说明

  1. 定义列属性:
    • #[attribute] 装饰器表明 column 类是一个属性。
    • 属性类接受单个参数名称,用于将属性与数据库列关联起来。
  2. 为构造函数参数添加属性:
    • 像 #[column('user_id')] 和 #[column('username')] 这样的属性被添加到构造函数参数 id 和 name 中。
  3. 使用反射:
    • reflectionclass 对象是为 user 类创建的,允许我们检查它的属性和方法。
  4. 访问构造函数:
    • getconstructor() 检索 user 类的构造函数。
  5. 迭代参数:
    • getparameters() 检索构造函数的所有参数。
  6. 获取属性:
    • getattributes(column::class) 检索应用于参数的 column 类型的所有属性。
  7. 实例化属性:
    • newinstance() 创建 column 属性的实例,提供对其 name 属性的访问。
  8. 打印元数据:
    • 将参数名称(例如,id)及其关联的列名称(例如,user_id)输出到控制台。

输出:

Parameter: id, Column: user_id
Parameter: name, Column: username

常见用例

  1. 数据库映射:
    • 使用#[column]等属性来指定数据库列。
  2. 数据验证:
    • 直接对属性应用验证,例如#[notnull] 或#[maxlength(255)]。
  3. 序列化/反序列化:
    • 将属性映射到 json 字段,例如 #[jsonfield('user_name')].

结论

构造函数属性提升属性的集成提供了一种在php中构建类的强大而简洁的方法。这在依赖元数据(例如 orm、验证或序列化)的系统中特别有用,使代码更具表现力和组织性。

© 版权声明
THE END
喜欢就支持一下吧
点赞7 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容