ThinkPHP字段类型怎么定_ThinkPHP数据库设计最佳实践【说明】-ThinkPHP-PHP中文网

thinkphp模型字段类型必须手动配置$type或$schema，否则默认按字符串处理；如datetime不配则无法转carbon对象，json不配$json数组则不自动编解码。

thinkphp字段类型怎么定_thinkphp数据库设计最佳实践【说明】

字段类型必须手动定义，ThinkPHP 不会自动推断数据库字段类型。 你看到的 datetime、json、float 等行为，全靠你在模型里显式配置 $type 或 $schema，否则数据库里存的是什么，PHP 拿到的就是什么字符串或整数。

ThinkPHP 的模型默认把所有字段当字符串处理。比如 MySQL 的 DATETIME 字段，不配 $type 就永远是字符串；JSON 字段不配就只是原始 JSON 字符串，不会自动 json_decode 成数组。

$type 是最轻量的写法，只影响单个字段的读写转换，不影响字段元信息
必须写完整字段名，别名（如 create_time AS ctime）要单独配，否则无效
常见映射：'create_time' => 'datetime' → 转成 Carbon 对象；'config' => 'json' → 自动编解码，但需同时确保 $json = ['config'] 存在
如果字段实际是 TIMESTAMP 类型，配 'update_time' => 'timestamp' 才会转成整型时间戳，配 datetime 可能报错或返回空

$schema 是硬编码字段定义，fields_cache 是运行时生成的缓存——二者目标一致：避免首次模型实例化时查一次 SHOW COLUMNS。但使用逻辑完全不同。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

启用 fields_cache 需在 config/database.php 中设 'fields_cache' => true（注意拼写是 fields_cache，不是 fileds_cache）
执行 php think optimize:schema 后，缓存文件生成在 runtime/schema/ 下，Db 类和模型都生效
$schema 必须写全表所有字段，漏一个就可能触发自动探测，导致缓存失效或类型错误
调试模式下 fields_cache 默认不生效，所以开发时容易误以为“没起作用”，其实是被环境覆盖了

ThinkPHP 对 JSON 的支持是“有条件启用”的，不是声明了字段类型为 json 就自动生效。

仅配置 'data' => 'json' 在 $type 里不够，还必须把字段名加入 $json 数组：protected $json = ['data'];
如果数据库字段类型不是原生 JSON（比如用 TEXT 存 JSON 字符串），也能工作，但要注意内容必须是合法 JSON，否则 json_last_error() 会静默失败
写入时传数组自动编码，但传字符串不会二次编码——也就是说，如果你手动 json_encode 后再赋值，结果会变成双重编码
关联查询中（如 with('profile')），嵌套模型的 $json 不会自动继承，得各自定义

历史表字段冗余或命名风格混乱时，$disuse 和 $strict 是刚需，但它们的行为很容易被忽略。

protected $disuse = ['status', 'type'] 后，这些字段在 save()、create()、allowField() 中彻底消失，连 data() 方法也不会透出
$strict = false 允许模型接收非定义字段，但仅对 data() 和构造函数参数有效；__set()（即 $user->xxx = 123）仍会抛 InvalidArgumentException
MySQL 表字段是小写下划线（create_time），但模型里用驼峰（createTime）访问时，必须确认开启了 think\db\Connection 的 auto_convert，否则直接报错
字段名大小写在 Linux 环境下严格区分，Windows 下可能侥幸通过，上线后容易突然崩