Yii2表单验证错误对象转为JSON返回-php教程-PHP中文网

yii2中将表单验证错误转为json返回，需封装为status:false、message:"验证失败"、errors:$model->errors的结构，设置响应格式为json并返回422状态码。

yii2表单验证错误对象转为json返回

Yii2 中将表单验证错误对象转为 JSON 返回，核心是把 $model->errors（关联数组）结构化处理后用 Json::encode() 输出即可，同时注意设置响应头和状态码以符合 API 规范。

获取验证错误并格式化为标准 JSON 结构

验证失败后，$model->errors 是一个以属性名为键、错误信息数组为值的多维数组。直接返回它可能不符合前端预期（比如希望扁平化或带统一字段）。推荐封装为如下结构：

status: false
message: "验证失败"
errors: 关联数组，如 {"username": ["用户名不能为空"], "email": ["邮箱格式不正确"]}

示例代码：

Feishu calendar sync, local ics to json data for AI agent

将ICS日历文件转为JSON格式，用于飞书日历导入导出及数据集成。

下载

use yii\helpers\Json;

if ($model->load(Yii::$app->request->post()) && !$model->validate()) {
    $response = [
        'status' => false,
        'message' => '验证失败',
        'errors' => $model->errors,
    ];
    Yii::$app->response->format = \yii\web\Response::FORMAT_JSON;
    return $response;
}

确保响应头和状态码正确

若手动 echo 或使用 exit，容易遗漏 HTTP 状态码。建议让 Yii 自动处理：

设置 Yii::$app->response->format = \yii\web\Response::FORMAT_JSON，框架会自动设 Content-Type: application/json
验证失败时返回 422（Unprocessable Entity）更语义化： Yii::$app->response->setStatusCode(422);

统一错误响应（可选进阶）

项目中建议封装一个通用方法，避免重复逻辑。例如在 BaseController 中添加：

protected function responseValidationError($model)
{
    Yii::$app->response->setStatusCode(422);
    Yii::$app->response->format = \yii\web\Response::FORMAT_JSON;
    return [
        'status' => false,
        'message' => '参数验证失败',
        'errors' => $model->errors,
    ];
}

控制器中直接调用：return $this->responseValidationError($model);