讲师中心 微信公众号

工具推荐

视频效率加速
剧云
剧云

中文短剧剧本制作平台

updream

一键生成高质量推广成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Seko
Seko

AI短剧一键生成成片

PHP枚举类型入门:PHP8.1 Enum定义状态机的最佳实践

风明小哥_4054

风明小哥_4054

发布时间:2026-05-03 10:36:47

|

172人浏览过

|

来源于php中文网

原创

PHP 8.1+ 推荐用枚举替代类常量管理状态:纯枚举提供类型安全与IDE提示;背书枚举映射数据库/API值;可添加方法封装状态逻辑;用tryFrom()安全反序列化;类型提示和match强制穷尽所有状态分支。

php枚举类型入门:php8.1 enum定义状态机的最佳实践

如果您正在使用 PHP 8.1 或更高版本开发状态驱动的业务逻辑,却发现仍依赖类常量或关联数组管理状态值,则可能面临类型不安全、IDE无提示、易传入非法值等问题。以下是针对状态机场景定义和使用 PHP 枚举类型的多种实践方式:

一、定义纯枚举表示离散状态

纯枚举适用于仅需区分互斥状态名称、无需映射外部值的场景。它提供最基础的类型约束与命名语义,杜绝任意整数或字符串被误用为状态。

1、使用 enum 关键字声明枚举名称,后接花括号。

2、在花括号内逐行列出所有合法状态标识符,每项以 case 关键字开头并以分号结尾。

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

3、确保枚举名称采用帕斯卡命名法(如 OrderStatus),每个 case 名称也保持大驼峰风格(如 Pending、Shipped)。

二、使用背书枚举(Backed Enum)映射数据库或API字段

当状态需与数据库整型字段、HTTP 状态码或第三方 API 字符串严格对齐时,背书枚举通过绑定底层标量值,实现类型安全的双向转换。

1、在 enum 声明后添加冒号及底层类型,如 : string 或 : int。

2、为每个 case 显式赋值,例如 case Active = 'active' 或 case NotFound = 404。

3、通过 ->value 属性获取底层值,用于存储或序列化;通过 ->name 获取定义时的标识符名,用于日志或调试。

三、为枚举添加状态专属方法增强行为表达力

枚举支持在内部定义实例方法,使每个状态可携带自身逻辑,避免将状态处理逻辑散落在控制器或服务类中,从而提升状态机的内聚性与可测试性。

PHP 8.5.12
PHP 8.5.12

修复 Core bailout 状态损坏安全问题,以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误,改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

1、在枚举体中声明 public function 方法名(): 返回类型。

2、在方法体内使用 match($this) 表达式,按当前枚举成员返回差异化结果。

3、例如定义 label() 方法返回中文描述,或 isFinal() 方法判断是否为终态。

四、从外部输入安全反序列化枚举实例

接收 HTTP 查询参数、JSON 请求体或数据库读取的原始值时,直接调用 ::from() 可能抛出 ValueError 异常。为保障系统健壮性,必须采用防御式解析策略。

1、使用 ::tryFrom($rawValue) 替代 ::from(),该方法在匹配失败时返回 null 而非异常。

2、对返回结果进行显式判空,仅在非 null 时继续后续流程。

3、若需统一错误处理,可封装为静态工厂方法,在返回 null 时抛出自定义异常或记录警告日志。

五、在类型提示与模式匹配中强制状态边界

PHP 枚举的真正威力体现在类型系统深度集成中:函数参数、属性声明、match 表达式均可直接引用枚举类型,编译器与 IDE 将实时校验所有使用点。

1、在函数签名中将参数类型声明为枚举全限定名,如 function handle(OrderStatus $status): void。

2、在 match 表达式中穷尽所有 case 分支,PHP 会检查是否遗漏,确保状态迁移逻辑完整覆盖。

3、在类属性中声明枚举类型并配合只读修饰符(public readonly OrderStatus $status),防止状态被意外篡改。

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

12704

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

7301

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2255

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

4608

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

5314

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

4191

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

6057

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4762

2023.11.13

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

0

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn