PHP ews：构造函数属性提升（构造.函数.属性.提升.PHP...）

构造函数属性提升 是 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
    ) {}
}

好处

1. 减少样板代码:

   • 无需在构造函数外部声明属性并手动初始化它们。

2. 提高可读性：

   • 使代码更加简洁、更容易理解，尤其是在具有许多属性的类中。

3. 支持不变性:

   • 属性可以标记为只读（在 php 8.1 中引入），以防止初始化后发生更改。

笔记

1. 可见性修饰符：

   • 升级的属性必须包含可见性修饰符（私有、受保护或公共）。

2. 默认值：

   • 您不能直接为提升的属性设置默认值，但您可以在构造函数中使用默认参数值。

   class product {
      public function __construct(
          private string $name = 'unnamed',
          private float $price = 0.0
      ) {}
   }
   

3. 混合促销和非促销属性：

   • 您可以将传统属性和升级属性组合在同一类别中。

   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、验证或序列化）的系统中特别有用，使代码更具表现力和组织性。

以上就是PHP ews：构造函数属性提升的详细内容，更多请关注知识资源分享宝库其它相关文章！