侯体宗的博客
  • 首页
  • Hyperf版
  • beego仿版
  • 人生(杂谈)
  • 技术
  • 关于我
  • 更多分类
    • 文件下载
    • 文字修仙
    • 中国象棋ai
    • 群聊
    • 九宫格抽奖
    • 拼图
    • 消消乐
    • 相册

在PHP 8.1版本的枚举中可以使用属性扩展示例

php  /  管理员 发布于 5个月前   141

随着PHP 8.1的发布,该语言获得了对枚举的本地支持。枚举是一种类型安全、可读和高效的方式,用于封装数据模型中一个字段可能采取的一小部分值。使用类而不是数据库枚举提供了更多的灵活性,如果你需要在未来添加到列表中。


举个例子,你有一个用户数据模型,该用户可能有一个特定的角色列表,

你可以从中选择:

namespace App\Enums;
 
enum UserRole: string
{
    case Admin = 'admin';
    case TeamAdmin = 'team_admin';
    case Support = 'support';
    case Basic = 'basic';
}

在你的数据模型中, Laravel也有对枚举的支持, 如果你在你的casts数组中定义了它, 就可以把它铸造为值.

/**
 * The attributes that should be cast.
 *
 * @var array<string,string|class-string>
 */
protected $casts = [
    'role' => UserRole::class,
];

添加枚举铸造将确保如果我们试图保存一个不在枚举中定义的角色到我们的用户模型中,将会抛出一个异常。

枚举的一个非常实际的用途是为你的HTML中的下拉菜单生成值:

<select name=”roles”>
    @foreach(UserRole::cases() as $role)
        <option value="{{ $role->value }}">{{ $role->name }}</option>
    @endforeach
</select>

从表面上看,上面的例子似乎没有什么问题,直到你看了下拉菜单中每个选项的可见名称。

Admin和TeamAdmin是很好的变量名称,但Administrator和Team Administrator最好在用户界面中呈现,这样对于管理用户角色的人来说就很清楚角色是什么。


虽然枚举对于简单的名称/值对来说是很好的,但在这种情况下,你需要添加第三个属性,你必须要有创造性。


输入PHP属性。它借用了其他语言中注释的概念,是一种将元数据与属性、方法和类联系起来的方法,这听起来正是我们需要的。

首先,我们需要建立一个描述属性:

namespace App\Enums\Attributes;
 
use Attribute;
 
#[Attribute]
class Description
{
    public function __construct(
            public string $description,
    ) {
    }
}

我们现在有了一个描述属性,我们可以在我们的枚举中利用它,

这样我们就可以定义我们想要的用户友好的角色名称:

namespace App\Enums;
 
enum UserRole: string
{
    #[Description('Administrator')]
    case Admin = 'admin';
 
    #[Description('Team Administrator')]
    case TeamAdmin = 'team_admin';
 
    case Support = 'support';
    case basic = 'basic';
}

现在我们需要检索这些属性,这只能通过反射来完成。

由于我们可能想在其他枚举中重复使用这个属性,我们将想做一个特质来使之更容易。

namespace App\Enums\Concerns;
 
use Illuminate\Support\Str;
use ReflectionClassConstant;
use App\Enums\Attributes\Description;
 
trait GetsAttributes
{
    /**
     * @param self $enum
     */
    private static function getDescription(self $enum): string
    {
        $ref = new ReflectionClassConstant(self::class, $enum->name);
        $classAttributes = $ref->getAttributes(Description::class);
 
        if (count($classAttributes) === 0) {
                return Str::headline($enum->value);
        }
 
        return $classAttributes[0]->newInstance()->description;
    }
}

如果我们把这个方法拆开,前两行是使用反射来获取枚举的属性。

由于不是每个枚举都可能有一个描述属性,我们设置了一个回退,将该枚举的值(或名称)转换为我们的描述。


最后,我们从枚举的属性中提取描述的值。

我们可以给我们的trait添加另一个方法来处理这个问题:

/**
 * @return array<string,string>
 */
public static function asSelectArray(): array
{
    /** @var array<string,string> $values */
    $values = collect(self::cases())
        ->map(function ($enum) {
            return [
                'name' => self::getDescription($enum),
                'value' => $enum->value,
            ];
        })->toArray();
 
    return $values;
}

现在,在我们的HTML中,我们可以简单地改变我们对枚举类的调用方法:

<select name=”roles”>
       @foreach(UserRoles::asSelectArray() as $role)
            <option value=”{{ $role->value }}”>{{ $role->name }}</option>
       @endforeach
</select>

虽然它们是PHP的新成员,但枚举和属性是语言的重要补充,

并为许多常见的用例提供了本地支持。


  • 上一条:
    Laravel 10.5版本发布
    下一条:
    2023年php面试题之一部分收集分享
  • 昵称:

    邮箱:

    0条评论 (评论内容有缓存机制,请悉知!)
    最新最热
    • 分类目录
    • 人生(杂谈)
    • 技术
    • linux
    • Java
    • php
    • 框架(架构)
    • 前端
    • ThinkPHP
    • 数据库
    • 微信(小程序)
    • Laravel
    • Redis
    • Docker
    • Go
    • swoole
    • Windows
    • Python
    • 苹果(mac/ios)
    • 相关文章
    • 在php中使用spatie/mjml-php扩展包实现将MJML转换为HTML(0个评论)
    • 在PHP语言中使用Guzzle库实现一个api压力测试功能的代码示例(0个评论)
    • PHP max()函数浅析(0个评论)
    • 在php 8语言中match表达式的用法及使用场景示例(0个评论)
    • 全球国家代码及手机、电话号码前缀编号数据分享(0个评论)
    • 近期文章
    • Laravel 10.24版本发布(0个评论)
    • go语言多项目批量更新依赖及自动调用jenkins构建流程步骤(0个评论)
    • 在go语言中实现数学pow(x^y 的幂次)代码示例(0个评论)
    • Laravel应用程序性能监控 (APM) 工具:Scout (0个评论)
    • 推荐一款针对git、diff和grep输出的语法高亮显示的扩展包:Git Delta(0个评论)
    • laravel框架中以公共函数方式实现job异步化执行封装代码示例(0个评论)
    • 在go语言中实现从http响应中解码JSON数据(0个评论)
    • go语言中如何使用JSON网络令牌(JWT)在控制器之间传递数据(0个评论)
    • 计算机网络知识详解(0个评论)
    • Laravel HTTP 测试与Symfony的DomCrawler(0个评论)
    • 近期评论
    • 路人 在

      php中使用hyperf框架调用讯飞星火大模型实现国内版chatgpt功能示例中评论 教程很详细,如果加个前端chatgpt对话页面就完美了..
    • 博主 在

      科学上网翻墙之v2rayN-Core客户端免费公益节点使用教程中评论 @ mashrdn 多切换几个节点测试,免费ssr是没那么稳..
    • mashrdn 在

      科学上网翻墙之v2rayN-Core客户端免费公益节点使用教程中评论 V2rayn免费节点添加上去了,youtobe无法打开网页,是怎么回事..
    • 张伟 在

      科学上网翻墙之v2rayN-Core客户端免费公益节点使用教程中评论 3q!有用,不过免费节点隔天就要去git上复制新的导进去..
    • 博主 在

      科学上网翻墙访问Google , 上外网神器佛跳墙VPN(永久免费)使用流程步骤中评论 该篇教程已不能用了,告知大家,免的老有老铁问我!..
    • 2016-10
    • 2016-11
    • 2017-06
    • 2017-07
    • 2017-08
    • 2017-09
    • 2017-11
    • 2017-12
    • 2018-01
    • 2018-02
    • 2018-03
    • 2020-03
    • 2020-04
    • 2020-05
    • 2020-06
    • 2020-07
    • 2020-09
    • 2021-02
    • 2021-03
    • 2021-04
    • 2021-05
    • 2021-06
    • 2021-07
    • 2021-08
    • 2021-09
    • 2021-10
    • 2021-11
    • 2021-12
    • 2022-01
    • 2022-02
    • 2022-05
    • 2022-06
    • 2022-07
    • 2022-08
    • 2022-09
    • 2022-10
    • 2022-11
    • 2022-12
    • 2023-01
    • 2023-02
    • 2023-03
    • 2023-04
    • 2023-05
    • 2023-06
    • 2023-07
    • 2023-08
    • 2023-09
    Top

    Copyright·© 2019 侯体宗版权所有· 粤ICP备20027696号 PHP交流群

    侯体宗的博客