json_decode()返回 null 主因是 json 格式错误、文件含 bom 头、编码非 utf- 8 无 bom、路径错误或未加 true 参数；应先 file_get_contents()读取，再用 json_last_error()定位问题，配置文件推荐 json_decode(…, true) ?: []兜底。
PHP 读 JSON 文件时 json_decode() 返回 null 怎么办
不是 JSON 格式错误就是编码 / 路径问题。最常见的是文件含 BOM 头、中文乱码或 JSON 语法不合法（比如末尾多逗号）。用 file_get_contents() 先读出来，再用 json_last_error() 和json_last_error_msg()定位真实原因。
- 检查文件是否 UTF- 8 无 BOM：用编辑器另存为“UTF-8（无 BOM）”，别信默认编码
- 确认路径正确：
file_exists($path)必须为true，相对路径容易错在工作目录不是你想象的那个 -
json_decode(file_get_contents($path), true)第二个参数true必须加，否则返回对象而非数组 - 如果 JSON 里有数字字符串（如
"123"），json_decode()默认会转成 int，想保留字符串得加选项JSON_BIGINT_AS_STRING
PHP 解析 JSON配置文件 的典型写法
配置文件一般小而固定，直接读取 + 解码即可，不用流式处理。但要注意权限和缓存——Web 服务器要能读文件，且别在循环里反复读。
- 推荐写法：
$config = json_decode(file_get_contents('/path/to/config.json'), true) ?: []; - 加个空数组兜底，避免后续代码因
null报Warning: Trying to access array offset on value of type null - 若配置文件可能被外部修改，上线前建议用
opcache_reset()或禁用 OPcache 对 JSON 文件的缓存（OPcache 默认会缓存file_get_contents结果） - 别用
include或require加载。json 文件——PHP 不认识 JSON 语法，会直接 Parse error
JSON 配置 vs PHP 原生数组配置的取舍
JSON 适合纯数据型配置（如 API 地址、开关项），PHP 数组适合需要逻辑判断或动态生成的配置（比如根据环境拼接 DB 主机名）。
- JSON 优点：跨语言、结构清晰、不易执行意外代码；缺点：不支持注释、不能写表达式、无法包含 PHP 常量（如
__DIR__） - PHP 配置文件（.php后缀）可 return 数组，能用
defined('ENV')做环境分支，但必须确保文件不在 Web 根目录下可直接访问，否则泄露敏感配置 - 混合方案常见：JSON 存通用字段，PHP 文件做环境适配层，
require_once后再array_merge覆盖
大 JSON 文件读取卡顿或内存溢出
超过几 MB 的 JSON 文件，file_get_contents()会一次性把全部内容载入内存，容易 OOM。这时候得换思路。
立即学习“PHP 免费学习笔记（深入）”；
- 优先考虑是否真需要全量加载：能不能只读某个 key？用
json_decode()配合substr或正则提取片段是危险操作，别试 - 真正的大文件（>10MB）改用流式解析库，比如
ext-json不支持，得上jsonstream或json-machine这类迭代器方案 - 更现实的解法：把大配置拆成多个小 JSON，按需加载；或者导出为 PHP 数组并启用 OPcache，比解析 JSON 快一个数量级
- 用
memory_get_usage()测一下加载前后内存差，确认是不是 JSON 本身导致的——有时候是 JSON 里嵌了 base64 图片才暴涨
