讲师中心 微信公众号
AI工具推荐 视频效率加速

Yii2.0.26REST接口返回时间戳格式配置

冬浩小哥_5198

冬浩小哥_5198

发布时间:2026-10-20 15:13:29

|

825人浏览过

|

来源于php中文网

原创

Yii 2.0.26 REST接口默认不转换时间字段为时间戳,需在模型中重写fields()方法统一处理,如将created_at、updated_at转为strtotime()结果;formatter和全局配置对REST无效;自定义Serializer适用于多模型统一管控。

yii2.0.26rest接口返回时间戳格式配置

Yii 2.0.26 的 REST 接口默认不会自动将时间字段(如 created_at、updated_at)转为时间戳格式返回,它原样输出数据库存储值(通常是 'Y-m-d H:i:s' 字符串)。若需统一返回整型时间戳(如 1734589200),不能靠前端解析或手动赋值,而应通过序列化层统一控制。

在模型中重写 fields() 方法

这是最直接、最符合 REST 规范的做法。所有时间字段的格式转换逻辑集中在此,不影响数据库操作,也不干扰 TimestampBehavior。

  • 在你的 ActiveRecord 模型(如 User)中重写 fields():

<?php
public function fields()
{
  $fields = parent::fields();
  // 将 datetime 字段转为 int 时间戳
  $fields['created_at'] = function ($model) {
    return $model->created_at ? strtotime($model->created_at) : null;
  };
  $fields['updated_at'] = function ($model) {
    return $model->updated_at ? strtotime($model->updated_at) : null;
  };
  return $fields;
}

Yii Framework 2.0.51
Yii Framework 2.0.51

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

下载
  • 注意:确保数据库字段类型是 DATETIME 或 TIMESTAMP,且 PHP 能正确解析该字符串(如 '2026-10-20 14:58:00');
  • 若字段可能为 NULL,务必判空,避免 strtotime(null) 返回 -1;
  • 此方式对关联模型、嵌套数据同样生效,因为 yii\rest\Serializer 会递归调用各模型的 fields()。

全局配置 formatter(仅适用于视图/非 REST 场景)

Yii::$app->formatter 对 REST 接口的 JSON 响应不生效——它主要用于 GridView、DetailView 等小部件,或控制器中显式调用 asTimestamp()。在 ActiveController 的标准流程中,响应由 Serializer 直接序列化数组,绕过了 formatter。

  • 不要尝试在 config/web.php 中配 'timestamp' => 'U' 并期望它影响 API 输出;
  • 若你在非 REST 控制器里用 asJson() 手动返回数据,可主动调用:
    return $this->asJson([
      'created_at' => Yii::$app->formatter->asTimestamp($model->created_at)
    ]);

使用自定义 Serializer(进阶、统一管控)

当项目中多个模型都需要时间戳化,且希望复用逻辑时,可继承 yii\rest\Serializer 并覆盖 serialize() 或 buildData() 方法。

  • 新建类 app\serializers\TimestampSerializer,在 buildData() 中检测字段名含 _at 或 _time 的值,自动转 strtotime();
  • 在控制器中指定:
    public $serializer = ['class' => 'app\serializers\TimestampSerializer'];
  • 优点:一次配置,全模型生效;缺点:增加抽象层级,调试稍复杂。

避免常见错误

以下做法看似简单,实则破坏 REST 一致性或引发隐患:

  • 在控制器里 return ['created_at' => time()]:绕过 Serializer,丢失分页、元数据、嵌套关联等 REST 特性;
  • 在 rules() 中把时间字段设为 integer 类型:导致表单验证失败,且与数据库类型冲突;
  • 用 beforeSave 把时间字段改为整型存库:违背 TimestampBehavior 设计初衷,且破坏 MySQL 自动更新能力(如 ON UPDATE CURRENT_TIMESTAMP)。

热门AI工具

更多
二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

DeepSeek

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

PixPix
PixPix Hot

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

Seko
Seko Hot

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

豆包大模型

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

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

UP简历
UP简历 Hot

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

WorkBuddy

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

相关专题

更多
PHP API接口开发与RESTful实践
PHP API接口开发与RESTful实践

本专题聚焦 PHP在API接口开发中的应用,系统讲解 RESTful 架构设计原则、路由处理、请求参数解析、JSON数据返回、身份验证(Token/JWT)、跨域处理以及接口调试与异常处理。通过实战案例(如用户管理系统、商品信息接口服务),帮助开发者掌握 PHP构建高效、可维护的RESTful API服务能力。

544

2025.11.26

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

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

3030

2025.09.04

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

60

2026.10.16

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

40

2026.10.16

OpenJDK怎么部署Java应用
OpenJDK怎么部署Java应用

Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

40

2026.10.16

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

20

2026.10.16

Revel框架MVC路由与控制器
Revel框架MVC路由与控制器

本专题聚焦Revel框架MVC核心机制,讲解路由定义、控制器Action、参数绑定、请求响应和反向路由,并结合常见场景梳理接口请求处理流程。

20

2026.10.16

Revel框架入门与安装配置
Revel框架入门与安装配置

本专题从Revel框架环境搭建讲起,系统介绍命令行工具安装、项目创建、目录结构、配置文件及热代码重载,帮助开发者快速完成首个Go Web应用。

20

2026.10.16

Linux 新手先学哪些命令
Linux 新手先学哪些命令

Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

40

2026.10.15

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Yii2中文手册
Yii2中文手册

共0课时 | 0.6万人学习

thinkphp基础介绍和yii2基础介绍
thinkphp基础介绍和yii2基础介绍

共10课时 | 2.6万人学习

Yii2框架基础视频教程
Yii2框架基础视频教程

共22课时 | 2.8万人学习

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

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