Phalcon框架不支持JSON字段自动序列化/反序列化，需通过get/set访问器手动实现：读取时json_decode转数组，写入前校验类型并json_encode；查询须用原生SQL调用JSON函数，且需配合验证器确保结构合法。
Phalcon 框架本身不提供数据库 JSON 字段的自动序列化/反序列化功能，不像 ThinkPHP 那样有 $json 属性支持。Phalcon 的 Model 层将 JSON 类型字段（如 MySQL 5.7+ 的 JSON 列）默认当作字符串处理——读出来是 JSON 字符串，写进去也必须是字符串。要实现“读取时自动转数组、写入时自动转 JSON 字符串”，需手动干预，核心靠访问器（accessors）和修改器（mutators）。
声明字段并定义 get/set 访问器
在 Phalcon 模型中，对 JSON 字段（例如 settings、meta）启用自动转换，需为该字段显式定义 get* 和 set* 方法：
-
getSettingsAttribute()：读取时调用json_decode($this->settings, true)，返回关联数组（或null） -
setSettingsAttribute($value)：写入前校验是否为数组/对象，再json_encode($value, JSON_UNESCAPED_UNICODE)，赋值给原始属性 - 方法名必须严格匹配字段名驼峰化规则：
user_config→getUserConfigAttribute
确保字段可写且类型安全
Phalcon 不会自动过滤非法值，需在 set* 方法中主动防护：
- 用
is_array($value) || is_object($value)判断是否可序列化 - 调用
json_encode()后检查json_last_error() === JSON_ERROR_NONE - 若校验失败，可抛异常或静默忽略（建议开发环境抛异常）
- 避免传入资源、闭包、SimpleXML 对象等无法 JSON 化的类型
查询与条件构造需注意原生字符串
因为 Phalcon 不内置 JSON 函数支持，所有 JSON 相关查询都得手写 SQL 片段：
- 使用
whereRaw()或andWhere()调用 MySQL 原生函数：JSON_CONTAINS(settings, '"admin"') - 确保数据库字段类型确实是
JSON（不是TEXT），否则JSON_*函数会返回NULL - Phalcon 3.x / 4.x 均无
whereJsonContains类方法，必须依赖底层QueryBuilder或原生 SQL
配合验证器统一处理输入输出
若项目已集成 Phalcon\Validation，可在保存前统一校验 JSON 字段结构：
- 在模型
validation()方法中，对settings字段添加自定义验证器 - 例如：要求必须含
theme和lang键，且值为字符串 - 这样可避免前端传入非法 JSON 字符串（如
"{theme: 'dark'}"缺少引号）导致入库失败
