json_decode()用于将JSON字符串解码为PHP变量，支持返回对象或关联数组（设$assoc=true），需UTF-8编码且兼容RFC 7159；json_encode()则反向转换，处理资源等非法类型会返回null。
PHP中用 json_encode() 和 json_decode() 处理JSON字段
PHP原生支持JSON，核心就靠这两个函数：把PHP变量转成JSON字符串用 json_encode()，把JSON字符串还原成PHP数据用 json_decode()。它们不是“插件”，无需安装扩展（PHP 5.2+ 默认内置），但默认行为容易踩坑。
常见错误现象：json_encode() 返回 null；json_decode() 返回 null 或意外的 stdClass 对象；中文变成 \uXXXX；数据库存入后查出来是空或乱码。
-
json_encode()返回null多半因为输入数据含不可序列化的类型（如资源句柄、闭包、某些对象未实现JsonSerializable） -
json_decode()返回null时，先用json_last_error_msg()看具体错误，90% 是字符串本身格式不合法（比如末尾多逗号、单引号代替双引号） - 中文被转义：加参数
JSON_UNESCAPED_UNICODE，例如json_encode($data, JSON_UNESCAPED_UNICODE) - 想得到数组而非对象：第二个参数传
true，即json_decode($json, true) - 注意字符编码：输入字符串必须是UTF-8，否则
json_encode()直接失败
MySQL JSON字段在PHP里怎么安全读写
MySQL 5.7+ 支持 JSON 类型字段，但PHP层不能直接把数组塞进去——得先转成JSON字符串再存，查出来再解码。重点不是“能不能”，而是“怎么避免SQL注入和类型错乱”。
使用场景：存储配置项、动态表单数据、多语言文案等结构可变的内容。
立即学习“PHP免费学习笔记（深入）”；
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 写入前必须用
json_encode()，且检查返回值是否为null，否则INSERT会存入字符串"null"而非真正的JSON - 不要拼接JSON字符串进SQL语句（比如
"INSERT INTO t (j) VALUES ('".json_encode($x)."')"），必须用预处理或至少用mysqli_real_escape_string()处理结果字符串 - 从MySQL读出的JSON字段是字符串，需显式调用
json_decode()才能当数组用；若字段允许为NULL，记得判空再解码 - MySQL内部对JSON做校验，但如果PHP传入非法JSON（如
json_encode([1,2,])末尾逗号），MySQL会报错Invalid JSON text
遇到 json_encode(): type is not supported 怎么办
这个错误说明你试图编码一个PHP不支持的类型，最常见的是资源（resource）、闭包（Closure）、未实现序列化接口的对象，或者循环引用数组。
性能影响：强行用 var_export() 或 serialize() 替代，会导致数据无法被前端或其它服务消费，JSON标准不兼容。
- 先用
gettype()和is_object()检查可疑变量，定位到具体键名 - 资源类型（如
mysqli连接、文件句柄）必须提前关闭或剥离，不能进JSON - 对象要转JSON，优先让类实现
JsonSerializable接口，定义jsonSerialize()方法返回可编码的数组 - 临时方案：用
array_map()+is_resource()过滤掉资源，或用json_encode($data, JSON_PARTIAL_OUTPUT_ON_ERROR)（PHP 7.3+）跳过非法项（但会静默丢失数据，慎用）
PHP 8.2+ 的 JSON_THROW_ON_ERROR 有什么实际用处
以前写 json_decode() 必须配 if ($data === null) { echo json_last_error_msg(); }，现在可以统一抛异常，让错误更早暴露、更容易捕获。
兼容性影响：PHP 8.2+ 才支持，老项目升级前需确认环境版本；开启后所有JSON函数失败都抛 JsonException，不能用 === null 判断了。
- 推荐写法：
try { $data = json_decode($json, true, 512, JSON_THROW_ON_ERROR); } catch (JsonException $e) { // 记录日志、返回友好提示 } - 注意：
JSON_THROW_ON_ERROR只影响当前调用，不会全局生效；多个JSON操作仍需各自加try-catch - 和
json_last_error()不兼容——一旦用了这个标志，再调用json_last_error()返回0（JSON_ERROR_NONE）
SET NAMES utf8mb4）、HTTP响应头（Content-Type: application/json; charset=utf-8）三者必须都是UTF-8，否则哪怕 json_encode() 成功，前端解析也会失败。 
