Yii框架的数据库字段类型映射_模型类中自动转换类型【实战】

蓮花仙者

蓮花仙者

2026-04-08

771人浏览

原创

yii 查询结果保持数据库原始类型,int字段可能返回字符串,需在afterfind()中手动转换;tinyint(1)被误判为boolean时应改用tinyint(2)或覆盖gettableschema();datetime字段需用getter转datetime对象;自定义类型映射须确保读写两端一致。

yii框架的数据库字段类型映射_模型类中自动转换类型【实战】

Yii 模型里 int 字段存了字符串,查出来还是 string?

不是数据库没转,是 Yii 默认不自动类型转换——它只在保存(save())时按 schema 做一次 cast,查询结果直接映射为 PDO 返回的原始类型(比如 MySQL 的 TINYINT 可能是 string)。尤其用 find()->asArray(false)(即 ActiveQuery 默认行为)时,ActiveRecord 实例字段值就是原样塞进去的。

常见错误现象:$model->status 显示为 "1"(字符串),但你写了 public int $status;,PHP 8.0+ 严格模式下直接报 TypeError;或者做 match=== 判断时失败。

  • 必须在模型类中显式启用类型转换:重写 attributes() 方法,把字段加进 typecastAttributes 配置
  • 或更常用:在 init() 中调用 $this->loadDefaultValues(true),但这只对 null/默认值生效,不解决已有数据
  • 真正可靠的做法:在 afterFind() 里手动 cast,例如 $this->status = (int)$this->status;

MySQL TINYINT(1) 被 Yii 当成 boolean 怎么办?

Yii 的 Schema 类会把 TINYINT(1) 自动识别为 boolean 类型,即使你数据库里存的是 0/1/2 这样的状态码。一旦字段类型被标为 booleanActiveRecord 就会在读取时强制转成 true/false,丢失中间值。

使用场景:状态字段如 status TINYINT(1) DEFAULT 0 COMMENT '0待处理,1已通过,2已拒绝' —— 这种不能当布尔用。

  • 建表时避开 TINYINT(1),改用 TINYINT(2)SMALLINT,Schema 就不会误判
  • 如果无法改库,在模型里覆盖 getTableSchema(),手动修正列类型:$schema->columns['status']->type = 'integer';
  • 注意:修改 getTableSchema() 后,save() 时的类型校验也会按新类型走,别漏掉验证规则

datetime 字段返回 string 而不是 DateTime 对象?

Yii 默认不自动把时间字段转成 DateTime 实例,哪怕你在模型里声明了 public DateTime $created_at;。查询结果仍是字符串(如 "2024-05-20 14:30:00"),PHP 严格类型检查下直接报错。

Yii Framework 2.0.51
Yii Framework 2.0.51

下载 Yii Framework 2.0.51 官方 Basic 应用模板,查看 Composer 安装方式、版本信息与开发文档。

下载

性能影响:每次访问都 new 一个 DateTime 是可接受的,但反复 parse 同一字段会浪费 CPU;用 getter 封装最轻量。

  • 推荐做法:定义 getter,例如 public function getCreatedAt(): DateTime { return new DateTime($this->created_at); }
  • 避免重写 afterFind() 把所有时间字段都转对象——内存占用翻倍,且可能和批量查询冲突
  • 如果要用 asArray(true),那就别指望对象,老老实实处理字符串格式

自定义类型映射后,save()InvalidParamException

当你手动改过 getTableSchema() 或在 attributes() 里指定了类型,但数据库字段实际长度/精度不匹配时,Yii 在 save() 前的参数绑定阶段就会抛出 InvalidParamException: Data type mismatch

容易踩的坑:只改了读取逻辑,忘了写入路径也要对齐。比如把 DECIMAL(10,2) 强制设为 float,但用户输入了 "123.456"(三位小数),PDO 绑定时发现精度超限就炸了。

  • 检查 yii\db\Schema::getColumnType() 返回值是否与 DB 实际一致(可用 var_dump($model->getTableSchema()->columns['price']) 确认)
  • 写入前做截断或四舍五入:在 beforeSave() 里处理,而不是依赖框架自动 cast
  • 测试边界值:插入 99999999.990.001,看会不会静默丢精度

类型映射不是设完就完事,读写两端都要对得上,尤其是 decimal、enum、json 这类易出错的类型。数据库 schema 和 PHP 类型声明之间那层薄薄的映射,稍有偏差,问题就藏在运行时里,很难一眼看出。

相关专题

更多
mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

1118

6

MySQL创建存储过程
MySQL创建存储过程

存储程序可以分为存储过程和函数,MySQL中创建存储过程和函数使用的语句分别为CREATE PROCEDURE和CREATE FUNCTION。使用CALL语句调用存储过程智能用输出变量返回值。函数可以从语句外调用(通过引用函数名),也能返回标量值。存储过程也可以调用其他存储过程。php中文网还提供MySQL创建存储过程的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.21

754

5

mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.18

472

5

mysql密码忘了怎么查看
mysql密码忘了怎么查看

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql密码忘了怎么办呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.19

1377

5

mysql创建数据库
mysql创建数据库

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql怎么创建数据库呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.25

1904

4

mysql默认事务隔离级别
mysql默认事务隔离级别

MySQL是一种广泛使用的关系型数据库管理系统,它支持事务处理。事务是一组数据库操作,它们作为一个逻辑单元被一起执行。为了保证事务的一致性和隔离性,MySQL提供了不同的事务隔离级别。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2023.08.08

618

3

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.11

2246

4

mysql忘记密码
mysql忘记密码

MySQL是一种关系型数据库管理系统,关系数据库将数据保存在不同的表中,而不是将所有数据放在一个大仓库内,这样就增加了速度并提高了灵活性。那么忘记mysql密码我们该怎么解决呢?php中文网给大家带来了相关的教程以及其他关于mysql的文章,欢迎大家前来学习阅读。

2023.08.14

1964

7

mysql事务隔离级别
mysql事务隔离级别

mysql规范中定义了四种事务隔离级别,不同的隔离级别对事务的处理有所不同。本专题为大家提供mysql事务隔离级别相关的文章内容,大家可以免费体验。

2023.08.16

2396

11

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共22课时 | 9.1万人学习