PHP JSON扩展自5.2.0起内置，需启用php.ini中对应扩展并重启服务器；核心函数为json_encode()和json_decode()，配合json_last_error()排查错误；PHP 7.3+支持json_validate()校验，fastjson扩展可提升编码性能6倍。
PHP环境中的JSON扩展不是可选项，而是现代API开发的默认基础设施。它从PHP 5.2.0起就已内置，无需额外安装，只需确认启用即可支撑绝大多数数据交互场景。
确认JSON扩展是否就绪
很多问题其实源于扩展未加载，而非代码写错。最直接的办法是运行phpinfo()，在页面中搜索“json”关键词，看到“json support”显示为“enabled”才算真正可用。若找不到或显示disabled，说明扩展虽存在但未启用——这时需检查php.ini配置，确保extension=json.so（Linux/macOS）或extension=php_json.dll（Windows）这一行未被注释，并重启Web服务器（如Apache、Nginx+PHP-FPM或IIS）。
核心函数：json_encode与json_decode
这两个函数构成PHP处理JSON的骨架：
- json_encode($value)：把PHP数组或对象转成JSON字符串。只接受UTF-8编码数据，非UTF-8中文会变成null；可选参数如JSON_UNESCAPED_UNICODE保留中文不转义，JSON_PRETTY_PRINT让输出带缩进便于调试
- json_decode($json, $assoc = false)：把JSON字符串还原为PHP变量。第二个参数决定返回对象（默认）还是关联数组（设为true）。例如json_decode($str, true)更适合用['key']方式取值，避免对象属性访问的语法限制
错误排查不能只靠返回值
json_encode()失败时返回false，json_decode()失败时返回null，但这些返回值容易被忽略或误判。更可靠的做法是调用json_last_error()和json_last_error_msg()获取具体错误类型和描述。常见错误包括：JSON_ERROR_UTF8（编码不合法）、JSON_ERROR_SYNTAX（JSON格式错误）、JSON_ERROR_DEPTH（嵌套过深）。PHP 7.3+还支持json_validate($string)提前校验字符串是否合法，避免解码时才发现问题。
立即学习“PHP免费学习笔记（深入）”；
性能优化有新选择
高并发API中，原生ext/json可能成为瓶颈。2026年主流方案是fastjson扩展——由PHP核心贡献者开发，API完全兼容，仅需把json_encode()换成fastjson_encode()，编码性能提升超6倍。它不强制替换全部，可按模块渐进迁移，错误码也保持一致，适配成本极低。对日均请求百万级的服务，这是值得投入的轻量升级。
