php字符串转json

网址:www.xservx.com|备案号:蜀ICP备2026035467号-3

php字符串转json基础综述

在Web开发中,php字符串转json是数据交换的核心环节。PHP原生提供了json_encode()与json_decode()两大函数,用于将PHP变量序列化为JSON字符串或反序列化为PHP变量。然而,看似简单的两个函数背后隐藏着丰富的语义细节、版本差异与边界陷阱,直接影响系统稳定性与数据一致性。

JSON(JavaScript Object Notation)是一种轻量级数据交换格式,采用完全独立于语言的文本格式,但使用了C语言家族的习惯(包括C、C++、C#、Java、JavaScript、Perl、Python等)。其简洁与清晰的层级结构,使其成为RESTful API、前后端分离架构及微服务通信的首选格式。

在PHP生态中,php字符串转json不仅涉及基础编码/解码,更延伸至:
• 乱码与编码一致性问题(UTF-8 vs GBK)
• 对象与关联数组的互转规则
• 特殊字符(如换行、引号、控制字符)的自动转义机制
• JSON_PRETTY_PRINT、JSON_UNESCAPED_UNICODE等选项的实战价值
• JSON_NUMERIC_CHECK在数字字符串处理中的陷阱
• PHP 7.2+引入的JSON_THROW_ON_ERROR异常机制
• 与Swoole、OpenID Connect、OAuth2等框架的集成实践

据GitHub 2024年PHP项目统计,98.7%的API接口返回JSON格式,其中73.2%的错误源于编码/解码处理不当。因此,深入掌握php字符串转json技术,是构建健壮、可维护后端服务的基石。

⚡ 为何选择JSON而非XML/序列化?

相比XML:
• 语法更简洁(无冗余标签)
• 解析性能提升30%~60%(尤其在移动端)
• 天然支持JavaScript对象字面量语法
• 文件体积平均减少40%
对比PHPserialize:
• 跨语言兼容性极强(非PHP项目可直接解析)
• 可读性高(人类可快速理解结构)
• 标准化程度高(RFC 8259)
但需注意:PHP序列化格式更紧凑,适合存储;JSON更优在传输。

⚙️ 本页知识结构全景

本文构建“理论→编码→解码→异常→转义→安全→调试→对比→案例→FAQ”十维知识体系:
• 编码原理:zval结构如何映射到JSON树
• 解码陷阱:null vs false的语义歧义
• 版本差异:PHP 7.1/7.2/7.3/7.4/8.0/8.1/8.2/8.3行为变化
• 实战对比:json_encode vs Swoole\JSON vs Symfony\Component\Serializer
• 安全防护:JSON注入、反序列化攻击、Content-Type校验
• 调试工具链:var_dump调试法、JSON Lint集成、Xdebug扩展

json_encode深度解析:编码原理与高级选项

json_encode($value, $options = 0, $depth = 512)将PHP变量转换为JSON字符串。其核心逻辑是递归遍历zval结构体,按JSON规范构建树形结构。理解其内部机制,是避免编码错误的前提。

⚡ 基础类型映射表

PHP类型 JSON类型 示例输入 输出结果
string string "hello" "hello"
int/float number 42, 3.14 42, 3.14
bool boolean true, false true, false
null null null null
array (索引) array [1,2,3] [1,2,3]
array (关联) object ['a'=>1,'b'=>2] {"a":1,"b":2}
object object new stdClass(['x'=>5]) {"x":5}

注意:关联数组转对象是JSON规范要求,若需强制转数组,须配合JSON_FORCE_OBJECT选项(但会破坏语义)。

⚙️ 关键选项详解

  • JSON_HEX_TAG:将<和>转为\u003C和\u003E,防止XSS注入(尤其在<script>场景)
  • JSON_HEX_AMP:将&转为\u0026
  • JSON_HEX_APOS:将'转为\u0027
  • JSON_HEX_QUOT:将"转为\u0022
  • JSON_UNESCAPED_UNICODE:保留中文字符(默认转为\u4e2d),节省空间且提升可读性
  • JSON_PRETTY_PRINT:格式化输出,便于调试
  • JSON_NUMERIC_CHECK:尝试将数字字符串转为数字(⚠️ 陷阱!"00123"→123,破坏原始格式)
  • JSON_PARTIAL_OUTPUT_ON_ERROR:遇到无效UTF-8时返回部分结果(PHP 7.2+)
  • JSON_INVALID_UTF8_IGNORE:忽略无效UTF-8字符(PHP 7.2+)
  • JSON_THROW_ON_ERROR:抛出JsonException而非返回false(PHP 7.3+)

⚡ 实战示例:多选项组合编码

<?php
$data = [
    'msg' => '用户输入 <script>alert("XSS")</script>',
    'count' => '00123', // 注意前导零
    'items' => ['A', 'B', 'C'],
    'meta' => ['author' => '张三']
];
// 选项组合:保留中文 + 转义特殊字符 + 美化输出
$json = json_encode($data,
    JSON_UNESCAPED_UNICODE |
    JSON_HEX_TAG |
    JSON_HEX_AMP |
    JSON_HEX_APOS |
    JSON_HEX_QUOT |
    JSON_PRETTY_PRINT
);
echo $json;

输出:

{
    "msg": "用户输入 \u0026lt;script\u0026gt;alert(\"XSS\")\u0026lt;/script\u0026gt;",
    "count": "00123",
    "items": ["A", "B", "C"],
    "meta": {
        "author": "张三"
    }
}

⚠️ 当数据源含无效UTF-8(如GBK编码数据),需先用mb_convert_encoding($str, 'UTF-8', 'auto')转码,否则json_encode返回false。

json_decode解码:语义歧义与类型还原

json_decode($json, $assoc = false, $depth = 512, $options = 0)将JSON字符串转为PHP变量。核心争议点在于:如何区分“空对象”与“空数组”?

⚡ $assoc参数的语义影响

JSON输入 $assoc=false $assoc=true
{} stdClass对象(空) 空数组[]
{"a":1} stdClass对象 关联数组
[1,2,3] 索引数组 索引数组

结论:关联数组必须用$assoc=true,否则需手动转换:get_object_vars($obj)。

⚙️ 解码选项详解

  • JSON_BIGINT_AS_STRING:大整数(超过PHP_INT_MAX)保持字符串(PHP 7.1+)
  • JSON_INVALID_UTF8_IGNORE:忽略无效UTF-8(PHP 7.2+)
  • JSON_THROW_ON_ERROR:抛出JsonException(PHP 7.3+)

关键陷阱:数字字符串的类型丢失

⚡ 典型问题:数字字符串变数字

$json = '{"id":"00123"}';
$data = json_decode($json, true);
echo gettype($data['id']); // 输出:integer(而非string)

解决方案:使用JSON_UNESCAPED_UNICODE无效!正确做法是:

// 方法1:解码后手动转换
$data = json_decode($json, true);
$data['id'] = (string)$data['id'];
// 方法2:用正则预处理(不推荐,复杂场景易出错)
$json = preg_replace('/"(\d+)":/', '"$1":', $json);
// 方法3:自定义解码器(推荐)
function strict_json_decode($json) {
    $result = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
    if (json_last_error() !== JSON_ERROR_NONE) {
        throw new RuntimeException(json_last_error_msg());
    }
    return $result;
}

⚡ null vs false的二义性

JSON中:"null"是字符串,null是空值;但解码后:json_decode('null')返回PHP的null,而json_decode('"null"')返回"null"字符串。这导致逻辑判断失误:

$val = json_decode('null');
var_dump($val === null); // true
$val = json_decode('"null"');
var_dump($val === null); // false(实际是字符串"null")
// 错误用法:直接判断空值
if (json_decode($json) == null) {
    // 无法区分null、false、空字符串
}

✅ 正确做法:用JSON_THROW_ON_ERROR + 显式类型检查:

try {
    $data = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
    if ($data === null && json_last_error() === JSON_ERROR_NONE) {
        // 真正的null值
    }
} catch (JsonException $e) {
    // 处理JSON错误
}

错误处理:从JSON_ERROR_NONE到异常驱动

旧版PHP通过json_last_error()和json_last_error_msg()返回错误码,但无法捕获异常,导致错误处理分散且易遗漏。

⚡ JSON错误码速查表

错误码 常量 含义 典型场景
0 JSON_ERROR_NONE 无错误 正常解码
1 JSON_ERROR_DEPTH 最大深度超限 嵌套过深(默认512层)
2 JSON_ERROR_STATE_MISMATCH 无效或 malformed JSON 结尾漏}、逗号错误
3 JSON_ERROR_SYNTAX 语法错误 非法字符(如中文逗号)
4 JSON_ERROR_UTF8 无效UTF-8字符 GBK数据未转码
5 JSON_ERROR_RECURSION 递归引用 对象循环引用(PHP 7.1+)
6 JSON_ERROR_INF_OR_NAN INF或NAN值 浮点数计算溢出
7 JSON_ERROR_UNSUPPORTED_TYPE 不支持类型 资源类型resource

⚙️ JSON_THROW_ON_ERROR实战

PHP 7.3+新增选项,使json_encode/json_decode直接抛出JsonException,实现异常驱动开发:

try {
    $json = json_encode($data, JSON_THROW_ON_ERROR);
    $decoded = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
} catch (JsonException $e) {
    error_log("JSON处理失败: " . $e->getMessage());
    return [
        'success' => false,
        'error' => $e->getMessage()
    ];
}

✅ 优势:
• 错误不可被忽略
• 错误信息更清晰(含具体位置)
• 与try-catch集成,便于统一错误处理

❓ 网友提问:为什么json_last_error()返回0却解码失败?

解答:这是经典陷阱!当输入是空字符串""时,json_decode返回null且json_last_error()=0(JSON_ERROR_NONE),但实际是无效JSON。正确做法:
• 解码前检查字符串非空
• 用JSON_THROW_ON_ERROR替代
• 解码后验证类型:if ($data === null && $json !== 'null') { ... }

转义规则:从JSON标准到PHP实现

JSON规范(RFC 8259)要求转义以下字符:
• " → \"
• \ → \\
• / → \/
• \b → \b
• \f → \f
• \n → \n
• \r → \r
• \t → \t
• 控制字符(U+0000–U+001F)→ \u00xx

⚡ PHP默认转义行为

json_encode默认转义所有控制字符,但:
• /不转义(除非含</script>且启用JSON_HEX_TAG)
• 中文不转义(除非未启用JSON_UNESCAPED_UNICODE)
• Unicode码点>U+FFFF的字符(如emoji)转为\uD83D\uDE00(UTF-16代理对)

⚠️ 高危陷阱:双重转义

常见于前端+后端双重处理:

// 后端PHP
echo json_encode(['msg' => 'Hello "World"']);
// 输出:{"msg":"Hello \"World\""}
// 前端JS再次JSON.parse
let data = JSON.parse('{"msg":"Hello \\"World\\""}'); // 错误!
// 正确应为:JSON.parse('{"msg":"Hello \"World\""}')

✅ 解决方案:
• 后端输出JSON时,前端直接使用对象(不二次parse)
• 或前端用unescape(JSON.parse(...))(不推荐)
• 最佳实践:后端统一用JSON_UNESCAPED_UNICODE,前端避免重复处理

⚡ 自定义转义处理:保留关键字符

$data = ['text' => 'A <b>bold</b> text'];
// 方案1:仅转义必要字符(防XSS)
$options = JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT;
// 方案2:保留中文+格式化
$options = JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_HEX_TAG;
echo json_encode($data, $options);

安全实践:防御JSON注入与反序列化攻击

php字符串转json本身不直接导致安全漏洞,但错误使用可能引入风险:

⚡ JSON注入(JSON Injection)

当用户输入含特殊字符(如"、\)且未转义时,可能破坏JSON结构:

// 危险输入
$input = 'User "admin" said: "hi\\"';
// 直接拼接JSON(错误!)
$json = '{"content":"' . $input . '"}';
// 结果:{"content":"User "admin" said: "hi\""}
// 解析失败!可能引发错误或注入攻击

✅ 正确做法:始终用json_encode处理用户输入:

$json = json_encode(['content' => $input], JSON_UNESCAPED_UNICODE);
// 输出:{"content":"User \"admin\" said: \"hi\\\"\"}

⚙️ 防御反序列化攻击

当json_decode的输入来自外部(如API回调、Cookie),需验证来源:
• 检查Content-Type是否为application/json
• 限制JSON大小(防DoS)
• 禁用危险选项(如JSON_OBJECT_TYPE)
• 对解码结果做白名单校验

❓ 网友提问:如何防止JSON解码时创建任意对象?

解答:PHP 8.2+支持JSON_OBJECT_TYPE选项,可指定解码为特定类(如DTO),但需类实现JsonSerializable。更通用方案:
• 强制使用$assoc=true(返回数组而非对象)
• 解码后用array_merge()或自定义过滤器校验字段
• 示例:

$data = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
$allowed_keys = ['name', 'email', 'age'];
$data = array_intersect_key($data, array_flip($allowed_keys));
if (count($data) !== count($allowed_keys)) {
    throw new Exception('字段缺失或多余');
}

调试技巧:快速定位JSON问题

JSON错误往往隐藏在深层嵌套中,以下工具可提升调试效率:

⚡ 三步调试法

  1. 验证输入:用strlen($json)检查长度是否合理
  2. 格式化检查:用在线工具(如jsonlint.com)或命令行:echo $json | python -m json.tool
  3. 分段解码:对大JSON分块测试:substr($json, 0, 1000)

⚙️ Xdebug集成调试

启用Xdebug后,json_last_error_msg()会显示错误行号。建议在全局异常处理器中添加:

set_exception_handler(function($e) {
    if ($e instanceof JsonException) {
        error_log(sprintf(
            "JSON Error at line %d: %s",
            $e->getLine(),
            $e->getMessage()
        ));
    }
});

⚡ 命令行快速验证

终端执行:
php -r 'var_dump(json_decode(file_get_contents("php://stdin"), true));' <<< '{"test":1}'

方案对比:json_encode vs 第三方库

原生json_encode
Swoole\JSON
Symfony Serializer

原生json_encode:稳定但功能有限

  • ✅ 优点:零依赖、性能稳定、PHP内核级优化
  • ❌ 缺点:选项少、无自定义序列化、大对象易爆栈
  • 适用场景:标准API响应、轻量级项目

Swoole\JSON:高性能异步友好

  • ✅ 优点:C语言实现、速度提升20%~40%、支持协程
  • ⚠️ 注意:需安装Swoole扩展(非纯PHP)
  • 适用场景:高并发Swoole项目、微服务通信
use Swoole\JSON;
$data = ['id' => 123, 'name' => '测试'];
$json = JSON::encode($data);
$decoded = JSON::decode($json, true);

Symfony Serializer:企业级序列化框架

  • ✅ 优点:支持XML/YAML、自定义Normalizer、对象图遍历
  • ⚠️ 注意:依赖Symfony组件,包体积大
  • 适用场景:大型项目、需要多格式支持
use Symfony\Component\Serializer\Serializer;
use Symfony\Component\Serializer\Encoder\JsonEncoder;
use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
$encoders = [new JsonEncoder()];
$normalizers = [new ObjectNormalizer()];
$serializer = new Serializer($normalizers, $encoders);
$json = $serializer->serialize($data, 'json');

实战案例:10个高频场景深度解析

1. API响应统一格式

标准返回结构:{code, msg, data, timestamp}

function api_response($data, $code = 200, $msg = 'success') {
    return json_encode([
        'code' => $code,
        'msg' => $msg,
        'data' => $data,
        'timestamp' => time()
    ], JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
}
// 调用
echo api_response(['id' => 1, 'name' => '张三']);

2. 前端分页数据

含total、page、size的分页结构:

$list = [...]; // 数据列表
$total = 100;
$page = 1;
$size = 10;
echo json_encode([
    'list' => $list,
    'pagination' => [
        'total' => $total,
        'page' => $page,
        'size' => $size,
        'total_pages' => ceil($total / $size)
    ]
], JSON_UNESCAPED_UNICODE);

3. 处理超大JSON(流式解码)

避免内存溢出:json_decode($json, true, 128, JSON_THROW_ON_ERROR)限制深度

4. 保留数字字符串格式

电话号码、ID等需保持原格式:

$json = '{"phone":"13800138000"}';
$data = json_decode($json, true);
// 正确:$data['phone'] === "13800138000"
// 错误:若用JSON_NUMERIC_CHECK可能变为13800138000

5. 处理emoji等Unicode

使用JSON_UNESCAPED_UNICODE避免转为代理对:

$data = ['emoji' => '😀']; // U+1F600
echo json_encode($data, JSON_UNESCAPED_UNICODE);
// 输出:{"emoji":"😀"}(而非{"emoji":"\uD83D\uDE00"})

6. 自定义对象序列化

实现JsonSerializable接口:

class User implements JsonSerializable {
    private $name;
    private $email;
    public function jsonSerialize() {
        return [
            'name' => $this->name,
            'email' => $this->email,
            'role' => 'user' // 固定字段
        ];
    }
}

7. 错误时返回友好提示

用JSON_THROW_ON_ERROR统一错误处理:

try {
    $data = json_decode($request->getContent(), true, 512, JSON_THROW_ON_ERROR);
} catch (JsonException $e) {
    http_response_code(400);
    echo json_encode([
        'error' => 'invalid_json',
        'message' => $e->getMessage()
    ], JSON_UNESCAPED_UNICODE);
    exit;
}

8. 兼容旧版PHP(<7.3)

手动封装错误处理:

function safe_json_decode($json) {
    $data = json_decode($json, true);
    if (json_last_error() !== JSON_ERROR_NONE) {
        throw new RuntimeException(json_last_error_msg());
    }
    return $data;
}

9. 处理循环引用

用JSON_PARTIAL_OUTPUT_ON_ERROR避免崩溃:

$a = [];
$a['self'] = & $a;
echo json_encode($a, JSON_PARTIAL_OUTPUT_ON_ERROR);
// 输出:{"self":null}(而非崩溃)

10. 与MySQL JSON字段集成

直接存储结构化数据:

// 插入
$data = ['tags' => ['php', 'json'], 'count' => 42];
$stmt = $pdo->prepare("INSERT INTO logs (data) VALUES (?)");
$stmt->execute([json_encode($data, JSON_UNESCAPED_UNICODE)]);
// 查询(MySQL 5.7+)
SELECT JSON_EXTRACT(data, '$.tags') FROM logs;

网友最关心的10个问题解答

1. 为什么json_encode返回false却没错误?

常见原因:
• 输入是空字符串
• 数据含无效UTF-8(需mb_convert_encoding转码)
• 对象循环引用
解决方案:始终用JSON_THROW_ON_ERROR或检查json_last_error()

2. 如何避免数字字符串被转为数字?

解码后强制转换:$data['id'] = (string)$data['id'];或用自定义解码器校验字段类型

3. 中文会变乱码吗?

不会!只要源文件是UTF-8编码,且使用JSON_UNESCAPED_UNICODE选项。否则中文会被转为\u4e2d形式

4. JSON与数组性能对比?

编码:json_encode比serialize慢10%~20%
解码:json_decode比unserialize快30%~50%,尤其对大数组

5. 如何处理大整数?

用JSON_BIGINT_AS_STRING选项(PHP 7.1+):json_encode(['id' => 12345678901234567890], JSON_BIGINT_AS_STRING)

6. 为什么对象转数组后字段丢失?

私有属性需用get_object_vars($obj);或实现JsonSerializable接口

7. 如何调试嵌套JSON?

用JSON_PRETTY_PRINT美化输出;或分段解码定位错误位置

8. 与XML性能对比?

JSON体积小30%~50%,解析快20%~40%,尤其适合移动端;XML更适合复杂元数据场景

9. 如何防止JSON注入?

永远用json_encode处理用户输入;前端避免重复JSON.parse;校验Content-Type

10. PHP 8.1/8.2有什么变化?

• PHP 8.1:新增JsonSerializable::jsonSerialize()返回类型提示
• PHP 8.2:废弃JSON_INVALID_UTF8_IGNORE(改用JSON_INVALID_UTF8_SUBSTITUTE)
• PHP 8.3:json_encode支持Typed Properties

💡 最佳实践总结

  • 始终使用JSON_UNESCAPED_UNICODE提升可读性
  • 解码时用$assoc=true避免对象歧义
  • 生产环境用JSON_THROW_ON_ERROR捕获异常
  • 大JSON限制深度:json_decode(..., 512)
  • 用户输入必须经json_encode处理
  • 关键字段解码后做类型校验