PHP不直接添加JSON字段，而是依赖MySQL 5.7+等数据库的JSON类型支持；建表须用JSON类型而非TEXT，写入前用json_encode()并校验，查询优先使用MySQL JSON函数如->或JSON_EXTRACT()。
PHP 本身不直接“添加 JSON 字段”，真正起作用的是数据库（如 MySQL 5.7+ 或 PostgreSQL）对 JSON 类型的支持；PHP 只负责把合法 JSON 字符串写入或读取该字段。关键在建表时用对类型、写入时避开字符串拼接、读取时注意类型转换。
MySQL 建表必须用 JSON 类型，别用 TEXT
用 TEXT 存 JSON 看似能用，但会丢失校验、索引和函数能力（比如 JSON_EXTRACT、-> 操作符）。MySQL 5.7 起原生支持 JSON 列类型，建表语句要明确指定：
CREATE TABLE users ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(100), profile JSON );
注意点：
-
JSON列不能设默认值（除非是 MySQL 8.0.13+ 支持DEFAULT (JSON_OBJECT())） - 插入空值用
NULL，别用'{}'字符串 - 如果旧表要加字段，用
ALTER TABLE users ADD COLUMN settings JSON;
PHP 写入前必须用 json_encode()，且检查返回值
PHP 数组不能直接 insert 到 JSON 字段——必须先转成字符串，且确保编码无误。常见错误是传入含非法字符、资源、循环引用的数组：
立即学习“PHP免费学习笔记（深入）”；
$data = ['theme' => 'dark', 'notifications' => true, 'lang' => 'zh-CN'];
$json_str = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
if ($json_str === false) {
throw new RuntimeException('JSON 编码失败：' . json_last_error_msg());
}
// 安全写入（PDO 预处理）
$stmt = $pdo->prepare("INSERT INTO users (name, profile) VALUES (?, ?)");
$stmt->execute(['Alice', $json_str]);
重点：
- 务必检查
json_encode()返回是否为false，否则字段存的是NULL或空字符串 - 避免手动拼接 JSON 字符串（如
"{'a':1}"），极易引发 SQL 注入或语法错误 - 不用
JSON_HEX_TAG等标记选项，除非你真需要转义</>
查询时用 MySQL JSON 函数提取字段，别在 PHP 里 json_decode() 后遍历
如果只查某几个 JSON 内部字段（比如用户设置里的 theme），直接在 SQL 里用 -> 或 JSON_EXTRACT()，比查出整段 JSON 再 PHP 解析快得多，也省带宽：
SELECT id, name, profile->'$.theme' AS theme FROM users WHERE profile->'$.notifications' = true;
对应 PHP 中获取结果：
$stmt = $pdo->query("SELECT id, name, profile->'$.theme' AS theme FROM users");
while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
// $row['theme'] 是字符串 '"dark"'（带引号），需再 json_decode() 一次
$theme = json_decode($row['theme'], true);
}
注意：
- MySQL 的
->操作符返回的是带双引号的 JSON 字符串（如"dark"），不是 PHP 原生类型 - 如果要查 JSON 数组长度、是否存在某个 key，用
JSON_LENGTH()、JSON_CONTAINS_PATH()更可靠 - 对 JSON 字段建虚拟列 + 索引（如
ALTER TABLE users ADD theme VARCHAR(20) AS (profile->'$.theme');）才能高效 where 查询
最易被忽略的是：MySQL 的 JSON 类型会对内容做标准化（比如重排对象 key 顺序、删除空白），所以不要依赖 JSON 字符串字面量相等判断；另外，PHP 读取后若要修改再写回，一定要完整覆盖整个 JSON 字段，而不是“局部更新”——MySQL 没有原子级 JSON 字段内单 key 更新语法（JSON_SET 可以，但得手写 SQL）。
