php中文网

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. 提高可读性

    立即学习“PHP免费学习笔记(深入)”;

    • 使代码更加简洁、更容易理解,尤其是在具有许多属性的类中。
  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:构造函数属性提升的详细内容,更多请关注php中文网其它相关文章!