当前位置：首页 > 文章列表 > 文章 > php教程 > PHP 属性：如何使用 PHP 属性并创建自定义属性类 – 快速提示

PHP 属性：如何使用 PHP 属性并创建自定义属性类 – 快速提示

来源：dev.to 2024-08-23 22:46:01 0浏览收藏

来到golang学习网的大家，相信都是编程学习爱好者，希望在这里学习文章相关编程知识。下面本篇文章就来带大家聊聊《PHP 属性：如何使用 PHP 属性并创建自定义属性类 – 快速提示》，介绍一下，希望对大家的知识积累有所帮助，助力实战开发！

php 属性是在 php 8.0 中引入的。该版本标志着该语言的一个重要里程碑，带来了一些新功能和改进，包括引入用于向代码声明添加元数据的属性。

我第一次必须处理属性是由于 inspector 的 php 库中的一个问题。检查 github。在深入研究解决方案之前，让我们先概述一下属性是什么以及如何在 php 代码中使用它们。

属性是一项强大的功能，允许您将元数据添加到类、方法或属性等声明中。这些元数据可以通过编程方式检索，为更干净、更有组织、更高效的代码开辟了新的可能性。

记住，属性在运行时没有效果。它们将在反射 api 中可用，使您的应用程序能够根据附加到类、方法或属性的属性了解您想要运行的内容。

内置属性

php 附带了几个用于不同目的的内置属性。以下是一些值得注意的：

@已弃用

将函数或方法标记为已弃用，表明应避免使用它，因为它可能会在未来版本中被删除。

#[deprecated("use newfunction() instead")]
function oldfunction() 
{
    // function implementation
}

@覆盖

确保子类中的方法旨在覆盖父类中的方法。

class child extends parent {
    #[override]
    public function defaultmethod() 
    {
        // method implementation
    }
}

如果 defaultmethod() 最终将在父类中更改其名称，则这不再是重写。在这种情况下，php 将发出警告，因为我们明确声明我们希望进行覆盖并提醒我们有关未对齐的情况。

不管怎样，一个好的ide应该能让我们不犯这样的错误。

@suppresswarnings

抑制特定代码段的特定警告。

#[suppresswarnings("somewarning")]
function somefunction() 
{
    // function implementation
}

创建自定义属性类

现在，让我们创建一个自定义属性类。当您想要将特定行为封装在属性中时，这非常有用。

#[attribute]
class customattribute 
{
    public string $message;

    public function __construct(string $message) 
    {
        $this->message = $message;
    }
}

然后您可以在各种元素上使用此自定义属性：

class myclass 
{
    #[customattribute("this is a custom attribute")]
    public $myproperty;

    #[customattribute("another custom attribute")]
    public function mymethod() 
    {
        // method implementation
    }
}

使用示例

让我们探讨一个实际的例子。假设您正在构建一个 web 应用程序，并且您想要创建一个自定义属性来定义字符串的长度：

#[attribute(attribute::target_property)]
class maxlength 
{
    public int $maxlength;

    public function __construct(int $maxlength) 
    {
        $this->maxlength = $maxlength;
    }
}

在上面的示例中，我们限制了仅将属性应用于类属性的能力。现在我们可以在 user 类中使用它：

class user 
{
    #[maxlength(20, message: "username must be 20 characters or less")]
    public string $username;

    // other properties and methods
}

前面提到，向属性添加属性在执行过程中没有任何影响。但我们现在可以使用反射检索这些信息，最终采取一些行动。

php 框架的采用

最常用的 php 框架（如 symfony 和 laravel）已经采用属性来基本上取代“注释”。在 symfony 5.2 或更高版本中，您可以声明一个控制器并使用属性将其连接到路由：

public class arrayable implements \arrayaccess
{
    …

    public function offsetexists($offset)
    {
        return isset($this->data[$offset]);
    }

    …
}

自 php 8 起，arrayaccess 接口的定义更改为：

PHP 属性：如何使用 PHP 属性并创建自定义属性类 – 快速提示

通过使用属性，他们强制声明偏移函数中参数的数据类型。使用 languageleveltypeaware 属性，如果实现不提供参数的数据类型，则会触发“弃用警告”。

但是在函数参数中声明数据类型会破坏与不支持参数数据类型声明的旧版本 php 的兼容性。

由于这只是对未来更改的警告，我们使用另一个内置 php 属性来解决该问题以抑制警告：

public class Arrayable implements \ArrayAccess
{
    …

    #[\ReturnTypeWillChange]
    public function offsetExists($offset)
    {
        return isset($this->data[$offset]);
    }

    …
}

returntypewillchange 属性只是告诉 php，我们了解该语言的未来变化，并且我们已经计划了必要的更新。

特别是对于这一更改，它们肯定会在 php 9 中实现。

请记住明智地使用属性，保持代码库干净且有详细记录。这在 saas 产品开发中尤其重要，因为可扩展性、可维护性和效率至关重要。