讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

Seko
Seko

AI短剧一键生成成片

Laper
Laper

剧本策划到成片协作

剧云
剧云

中文短剧剧本制作平台

Yii2表单验证错误信息数组转JSON返回

胖涛同学_2924

胖涛同学_2924

发布时间:2026-08-20 14:29:50

|

145人浏览过

|

来源于php中文网

原创

Yii2表单验证失败时,推荐返回标准JSON结构:{"code":422,"message":"验证失败","errors":{"username":["用户名不能为空"],"email":["邮箱格式不正确"]}},其中errors直接使用$model->getErrors()结果,无需额外转换。

yii2表单验证错误信息数组转json返回

Yii2 表单验证失败后,默认返回的是一个嵌套的 Array,比如:['username' => ['用户名不能为空', '用户名长度不能超过10个字符']]。若需以 JSON 格式返回给前端(如 AJAX 提交),需将其规范转换为标准 JSON 结构,常见做法是转成键值对形式或扁平化错误列表。

使用 getErrors() 获取并格式化

在控制器中调用模型的 getErrors() 方法,它返回的是字段名 → 错误消息数组的结构。可进一步处理为更易前端解析的格式:

  • 保留字段维度:每个字段对应一个字符串(取第一条错误)或字符串数组
  • 扁平化为一维错误列表:适合统一提示,不强调字段归属
  • 添加状态码和 message 包裹,符合 REST 接口习惯

推荐的 JSON 返回结构示例

建议采用以下结构,兼顾语义清晰与前端友好:

{
  "code": 422,
  "message": "验证失败",
  "errors": {
    "username": ["用户名不能为空"],
    "email": ["邮箱格式不正确"]
  }
}

其中 code 使用 HTTP 422 Unprocessable Entity 更准确(Yii2 默认也支持此状态码)。

Expanso yaml-to-json
Expanso yaml-to-json

使用 Expanso Edge 管道将 YAML 输入转换为 JSON 格式。

下载

控制器中返回 JSON 的写法

在 action 中验证失败时,直接输出 JSON 响应:

if ($model->load(Yii::$app->request->post()) && !$model->validate()) {
    Yii::$app->response->format = \yii\web\Response::FORMAT_JSON;
    Yii::$app->response->setStatusCode(422);
    return [
        'code' => 422,
        'message' => '验证失败',
        'errors' => $model->getErrors(), // 已是字段 => [msg] 数组
    ];
}

注意:$model->getErrors() 返回的就是你要的「字段名 → 错误消息数组」结构,无需额外遍历转换,直接作为 errors 值即可。

前端接收与使用提示

AJAX 成功回调中,可直接读取 response.errors:

  • 遍历 Object.keys(errors) 定位字段
  • 每个字段的 errors[field][0] 是首条提示(常用)
  • 也可拼接全部:errors[field].join(';')

热门AI工具

更多
码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

DeepSeek

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

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

WorkBuddy

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

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

豆包大模型

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

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2295

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3742

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1236

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

4339

2025.09.10

ThinkPHP表单验证与数据安全处理实战
ThinkPHP表单验证与数据安全处理实战

本专题聚焦 ThinkPHP 在表单处理中的验证与安全机制,系统讲解验证器使用、自定义规则、场景验证以及错误提示处理。内容涵盖 XSS 防护、SQL 注入防御、数据过滤与输入校验等关键安全措施。通过实际案例,帮助开发者构建安全可靠的数据处理流程。

281

2026.03.30

PHP Yii框架专题
PHP Yii框架专题

本专题专注于PHP主流框架Yii的应用,系统讲解MVC架构、路由机制、数据库操作、表单处理、安全验证与RESTful API 开发等核心内容。通过电商网站、后台管理系统与内容管理平台等实战项目,帮助学员快速掌握Yii框架的开发技巧与实战经验。

3190

2025.09.04

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

40

2026.11.06

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

20

2026.11.06

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

20

2026.11.06

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 21.3万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.9万人学习

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

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