phpEnv下MySQL使用JSON字段教程 phpEnv非关系型数据存储-php教程-PHP中文网

phpenv中mysql需启用strict_trans_tables模式并设utf8mb4字符集，否则json写入会静默失败或中文乱码；建表须显式指定utf8mb4，php连接后立即set_charset('utf8mb4')，并用json函数在sql层处理而非php解析。

phpenv下mysql使用json字段教程 phpenv非关系型数据存储

phpEnv 是 Windows 下轻量级 PHP 开发环境，自带 MySQL（通常是 5.7 或 8.0），完全支持原生 JSON 字段类型——但默认配置不启用严格模式，且字符集常为 utf8 而非 utf8mb4，这两点会导致 JSON 写入失败或中文乱码，必须手动调整。

确认 MySQL 版本与 JSON 支持状态

phpEnv 中的 MySQL 默认启动时未开启严格 SQL 模式，而 JSON 字段插入非法 JSON 会静默转为空字符串（而非报错），极易掩盖问题。先连进 MySQL 控制台执行：

SELECT VERSION();

若返回 5.7.x 或 8.0.x，说明支持原生 JSON；再查当前 SQL 模式：

SELECT @@sql_mode;

确保结果中包含 STRICT_TRANS_TABLES。不包含？需修改 phpEnv 自带的 my.ini（通常在 phpEnv\MySQL\conf\ 目录下），在 [mysqld] 段追加：

sql_mode = "STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION"

然后重启 phpEnv 的 MySQL 服务。否则 INSERT INTO t (j) VALUES ('{invalid}') 不报错，但字段值变成 NULL，调试时很难发现。

建表时声明 JSON 字段并设对字符集

phpEnv 自带的 MySQL 默认字符集常为 utf8（即 utf8mb3），它不支持 emoji 和部分四字节 Unicode，而 JSON 字段内部存储二进制格式，但输入/输出仍依赖连接层字符集。建表必须显式指定 utf8mb4：

Json Repair Kit

使用 Node.js 评估修复格式错误的 JSON，自动纠正尾随逗号、单引号、未加引号的键等常见问题，实现文件规范化。

下载

CREATE TABLE users (
  id INT PRIMARY KEY AUTO_INCREMENT,
  profile JSON,
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

profile JSON 声明原生 JSON 类型，MySQL 会自动校验语法、压缩存储
省略 DEFAULT CHARSET 会导致表用 latin1 或 utf8，后续插入含中文的 JSON（如 {"name": "张三"}）会报错 Incorrect string value
不要用 TEXT 代替 JSON——虽然能存，但失去 JSON_EXTRACT()、索引、校验等全部能力

PHP 中安全写入和读取 JSON 字段

phpEnv 的 PHP 默认开启 mysqli 扩展，但连接时若不设字符集，仍可能触发 JSON 解析异常。关键三步不能漏：

连接后立即执行 $mysqli->set_charset('utf8mb4')，否则 json_encode() 出来的中文在入库时被截断
写入前用 json_last_error() === JSON_ERROR_NONE 校验 PHP 数组是否可合法编码，避免把 null 或资源句柄塞进 JSON 字段
读取后必须用 json_decode($row['profile'], true)，第二个参数 true 强制返回关联数组，否则得到对象，后续 $data->name 在 PHP 8+ 可能因属性不存在而静默失败

示例片段：

$data = ['name' => '李四', 'skills' => ['PHP', 'MySQL'], 'active' => true];
$json_str = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
if (json_last_error() !== JSON_ERROR_NONE) {
    throw new Exception('JSON 编码失败：' . json_last_error_msg());
}
$stmt = $mysqli->prepare("INSERT INTO users (profile) VALUES (?)");
$stmt->bind_param("s", $json_str);
$stmt->execute();

用 MySQL 函数直接查询 JSON 内容，别全量取到 PHP 处解析

频繁从 PHP 层 json_decode() 整个 JSON 字段再过滤，是性能杀手。phpEnv 的 MySQL 完全支持原生 JSON 函数，应优先在 SQL 层过滤：

查某个键值：SELECT id, JSON_EXTRACT(profile, '$.name') AS name FROM users WHERE JSON_EXTRACT(profile, '$.active') = true
模糊匹配嵌套字段：SELECT * FROM users WHERE JSON_CONTAINS(profile, '"PHP"', '$.skills')
更新单个键：UPDATE users SET profile = JSON_SET(profile, '$.last_login', NOW()) WHERE id = 123

注意：JSON_EXTRACT() 返回带引号的字符串（如 "张三"），如需去引号，用 JSON_UNQUOTE(JSON_EXTRACT(...))；而 JSON_CONTAINS() 第二个参数必须是 JSON 字符串（即带双引号），传 'PHP' 会永远返回 false。

真正容易被忽略的不是语法，而是 phpEnv 环境下 MySQL 的默认 sql_mode 和字符集——它们让 JSON 表现得“好像能用”，实则埋着静默失败和乱码的坑。改完 my.ini 并重启服务，比写十行 PHP 校验代码更管用。