Yii框架中可自定义时间戳字段名为create_time、update_time等,需在TimestampBehavior中配置createdAtAttribute和updatedAtAttribute,确保数据库字段存在并调整规则。

Yii框架中时间戳字段名默认是 created_at 和 updated_at,但实际项目常需自定义(如 create_time、update_time 或中文字段)。修改方式取决于你用的是 ActiveRecord 行为(如 TimestampBehavior)还是手动赋值逻辑,核心在于行为配置和模型规则的同步调整。
1. 修改 TimestampBehavior 中的字段名
在模型类的 behaviors() 方法中,显式指定 createdAtAttribute 和 updatedAtAttribute:
public function behaviors()
{
return [
'timestamp' => [
'class' => TimestampBehavior::class,
'createdAtAttribute' => 'create_time', // 对应数据库字段名
'updatedAtAttribute' => 'update_time', // 对应数据库字段名
'value' => new Expression('NOW()'), // MySQL;其他数据库可选 time(), datetime('now') 等
],
];
}
注意:value 选项决定是用 PHP 时间(time())还是数据库函数(推荐 NOW()),后者更准确且避免时区偏差。
2. 确保数据库字段存在且类型兼容
数据库表中必须已存在对应字段,例如:
- MySQL:建议使用
INT(11)存储 Unix 时间戳,或DATETIME/TIMESTAMP类型(此时value应设为new Expression('NOW()')) - PostgreSQL:可用
TIMESTAMP WITHOUT TIME ZONE,配合new Expression('CURRENT_TIMESTAMP')
如果字段不存在,需通过迁移添加:
$this->addColumn('{{%user}}', 'create_time', $this->integer());
$this->addColumn('{{%user}}', 'update_time', $this->integer());
3. 调整安全属性与验证规则(可选但推荐)
若字段需被批量赋值(如 load() 或 create()),需将其加入 safe 规则;若禁止手动修改创建时间,可设为 readonly:
public function rules()
{
return [
[['create_time', 'update_time'], 'safe'], // 允许赋值(仅当需要手动设置时)
// 或者完全屏蔽手动写入创建时间:
// ['create_time', 'default', 'value' => null, 'on' => self::SCENARIO_INSERT],
// ['update_time', 'default', 'value' => null, 'on' => self::SCENARIO_UPDATE],
];
}
更稳妥的做法是:不将时间戳字段放入 rules() 的 safe 列表,而是完全交由 TimestampBehavior 自动管理。
4. 验证字段是否生效
保存模型后检查数据库记录:
- 新记录插入后,
create_time是否自动填充 - 调用
$model->save()更新后,update_time是否变更 - 执行
$model->updateAll(['status' => 1], ['id' => 123])时,update_time不会更新(因为绕过了 ActiveRecord 生命周期),如需支持需额外处理
若未生效,优先检查行为是否正确注册、字段名拼写是否一致、数据库字段是否存在且可写。











