Yii模型查询结果处理:数据格式化技巧【详解】

云枫君_5397

云枫君_5397

2026-08-09

530人浏览

原创

Yii中需重写fields()和extraFields()控制序列化字段,日期用getter格式化防null异常,asArray()配合array_map批量处理,JSON响应用toArray指定extraFields,导出Excel时用sprintf避免科学计数法。

yii模型查询结果处理:数据格式化技巧【详解】

在Yii项目中将数据库查出的模型数据直接返回给前端,常遇到时间戳变当前时间、数字被截断、null值显示为"(Not set)"等格式混乱问题,必须对查询结果做针对性格式化处理才能交付可用数据。

模型字段自动转数组并格式化

调用toArray()前先在模型类中重写fields()和extraFields()方法,控制哪些字段参与序列化。

在fields()里显式声明需要输出的字段名,避免敏感字段(如password_hash)意外暴露。

对日期字段单独定义getter,例如getCreatedAtFormatted(),内部用date('Y-m-d H:i', $this->created_at)处理,确保null值返回空字符串而非触发Formatter默认行为。

这一步操作起来很简单,直接把文件拖进去就行。

批量查询结果统一格式化

使用asArray()获取原始数组后,再用array_map()批量处理:

方法一:用Formatter组件逐字段格式化

$rows = User::find()->asArray()->all();

$formatted = array_map(function($row) {

  return [

    'id' => (int)$row['id'],

    'name' => $row['name'] ?: '-',

    'created_at' => Yii::$app->formatter->asDatetime($row['created_at']),

  ];

}, $rows);

方法二:直接在ActiveQuery中链式调用select()和asArray(),避免中间对象创建开销。

【注意:asArray()必须在all()之前调用,否则返回的是ActiveRecord对象数组而非纯数组】

单条记录格式化为JSON响应

第一步:在控制器动作中获取模型实例

$model = Post::findOne($id);

第二步:检查是否存在,避免后续调用getter时抛出异常

Yii Framework 2.0.51
Yii Framework 2.0.51

Yii Framework 2.0.51 官方 Basic 应用模板,适合旧项目兼容、升级验证和开发测试。

下载

if (!$model) {

  throw new NotFoundHttpException('Post not found.');

}

第三步:设置响应格式并赋值data

Yii::$app->response->format = \yii\web\Response::FORMAT_JSON;

Yii::$app->response->data = $model->toArray([

  'Post' => ['id', 'title', 'content', 'created_at_formatted'],

]);

第四步:在模型中定义created_at_formatted这个extraField,其getter内做判空+格式化,不依赖全局Formatter对null的默认处理逻辑。

防止null值被格式器转成当前时间

直接调用Yii::$app->formatter->asDate(null)会输出"(Not set)",但Yii::$app->dateformatter->format()会把null当当前时间——这是两个不同组件。

永远不要在视图中裸写Yii::$app->dateformatter->format(),它不是Formatter组件,也不走内容协商流程。

必须改用Yii::$app->formatter->asDate($model->date_field),它天然支持null安全。

如果业务要求null显示为空字符串,就别用Formatter,直接在模型getter里写return $this->date_field ? date('Y-m-d', $this->date_field) : '';

导出Excel时的数值格式化避坑

导出场景下,数字字段如price若为float类型,PHP可能输出科学计数法(如1.23456789E+7),Excel打开后显示异常。

解决方案:在toArray()前强制转字符串并保留两位小数

'price' => sprintf('%.2f', $model->price),

这比依赖Formatter的asDecimal()更可控,因为后者受decimalSeparator和thousandSeparator配置影响,在非中文环境可能输出逗号分隔符。

【关键前提:导出前必须确认模型字段类型是float或int,不能是字符串"123.45",否则sprintf会截断】

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

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

下载

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

相关专题

更多
PHP Yii框架专题
PHP Yii框架专题

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

2025.09.04

3270

22

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

20

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

0

16

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

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

2026.11.12

180

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

120

15

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Yii Framework 2.0 API 官方文档
Yii Framework 2.0 API 官方文档

共0课时 | 0人学习

Yii2.0框架开发实战视频教程
Yii2.0框架开发实战视频教程

共22课时 | 9.3万人学习