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

Yii框架TimestampBehavior参数完整说明

轻辰大大_6561

轻辰大大_6561

发布时间:2026-08-19 08:04:23

|

671人浏览过

|

来源于php中文网

原创

TimestampBehavior 是 Yii2 中用于自动管理创建和更新时间戳的行为,支持 Unix 时间戳或 datetime 字符串格式,通过 createdAtAttribute 和 updatedAtAttribute 控制字段,value 参数可设为 null、匿名函数、'datetime' 或 'timestamp',默认在 beforeInsert 和 beforeUpdate 时触发。

yii框架timestampbehavior参数完整说明

TimestampBehavior 是 Yii2 中最常用的自动时间戳行为之一,用于在模型保存时自动为指定属性赋值当前时间戳(Unix 时间戳)或日期时间字符串(datetime 格式)。它不依赖数据库字段类型,完全由 PHP 控制,灵活性高。

核心参数说明

createdAtAttribute:指定用于存储「创建时间」的属性名。默认为 'created_at'。设为 false 则禁用该功能。
updatedAtAttribute:指定用于存储「更新时间」的属性名。默认为 'updated_at'。设为 false 则禁用该功能。
value:定义时间值的生成方式,可为以下三种形式:
- null(默认):使用 time() 返回整型 Unix 时间戳;
- 匿名函数:如 function () { return date('Y-m-d H:i:s'); },返回格式化后的字符串;
- 字符串 'datetime':等价于调用 date('Y-m-d H:i:s');
- 字符串 'timestamp':等价于调用 time()(与默认行为一致)。

触发时机控制

该行为默认在 beforeInsert 和 beforeUpdate 事件中触发:
- 插入前:仅设置 createdAtAttribute(若启用),同时也会设置 updatedAtAttribute(若启用);
- 更新前:仅设置 updatedAtAttribute(若启用);
可通过重写 evaluateAttributes() 或监听特定事件自定义逻辑,但通常无需改动。

常见配置示例

在模型 behaviors() 方法中使用:

Yii Framework 2.0.51
Yii Framework 2.0.51

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

下载
public function behaviors()
{
    return [
        'timestamp' => [
            'class' => TimestampBehavior::className(),
            'createdAtAttribute' => 'created_at',
            'updatedAtAttribute' => 'updated_at',
            'value' => function () {
                return date('Y-m-d H:i:s');
            },
        ],
    ];
}

若数据库字段是 INT 类型存 Unix 时间戳,可简化为:

'timestamp' => [
    'class' => TimestampBehavior::className(),
    'value' => 'timestamp', // 或直接留空(默认)
],

若只需更新时间、无需创建时间:

'timestamp' => [
    'class' => TimestampBehavior::className(),
    'createdAtAttribute' => false,
    'updatedAtAttribute' => 'updated_at',
],

注意事项

该行为不会覆盖已显式赋值的属性值(即模型属性已有非-null 值时跳过);
若使用 datetime 字符串,请确保数据库字段支持该格式(如 MySQL 的 DATETIME 或 TIMESTAMP);
在批量插入(insertAll)或原生 SQL 操作中不生效,仅对 save()、insert()、update() 等 ActiveRecord 方法有效;
如需兼容 MySQL 的 NOW() 或 PostgreSQL 的 CURRENT_TIMESTAMP,建议改用数据库默认值 + 迁移定义,而非此行为。

热门AI工具

更多
DeepSeek

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

WorkBuddy

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

UpDream
UpDream Hot

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

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

花生AI
花生AI Hot

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

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

豆包大模型

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

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

相关专题

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

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

3130

2025.09.04

Uvicorn 报错与问题解决教程
Uvicorn 报错与问题解决教程

本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集,涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案,助你快速定位并解决Uvicorn运行中的各类问题。

0

2026.11.02

Uvicorn使用教程
Uvicorn使用教程

本专题汇总了Uvicorn使用教程与启动运行指南,涵盖其作为Python ASGI服务器的定位与特点,以及命令行启动(uvicorn main:app --reload)、参数配置(host/port/workers)、程序内嵌运行与Gunicorn结合部署等核心用法。同时整理了热重载调试、日志配置与生产环境部署优化等技巧,助你快速掌握Uvicorn的运行与配置。

0

2026.11.02

Uvicorn安装配置教程
Uvicorn安装配置教程

本专题汇总了Uvicorn的安装配置教程与部署指南,涵盖通过pip安装Uvicorn、启动FastAPI/Starlette应用、开发模式热重载(--reload)及多进程工作模式配置等核心操作。同时整理了结合Gunicorn的生产部署方案、HTTPS与反向代理配置及性能调优技巧,助你快速完成Uvicorn服务的安装与上线部署。

0

2026.11.02

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

120

2026.10.28

Vite 如何搭配 Vue.js
Vite 如何搭配 Vue.js

Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。

80

2026.10.28

Vite 项目目录怎么看
Vite 项目目录怎么看

Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。

260

2026.10.28

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

160

2026.10.22

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

140

2026.10.22

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共22课时 | 9.3万人学习

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

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