PHP数组与JSON转换器

在线将PHP数组转换为JSON,或将JSON转换为PHP数组

所有转换都在您的浏览器中本地完成。您的数据永远不会发送到任何服务器。

深度指南

PHP 数组与 JSON:如何对应,以及本转换器实际能读什么

对本页面的实测说明:PHP 转 JSON 背后的文本替换步骤、哪些输入能转换而哪些会失败、JSON 转 PHP 输出中的转义隐患,以及要求精确时应使用的 PHP 端规则(json_encode、json_decode、var_export)。

最后核实: 本指南的纯文本版

关键数字一览

PHP 转 JSON 能用的输入
短语法的列表和类似 JSON 的文本
例如 ['a','b']、[1,2,3,] 和 [[1,2],[3]]。纯 JSON 文本也能通过。
PHP 转 JSON 会失败的输入
任何含 => 或 array( ... ) 的内容
页面把 => 换成冒号、array( 换成 [,却从不处理结尾括号,所以键值数组和 array() 都会被判为无效。
JSON 转 PHP 的输出
双引号字符串、4 个空格缩进、对象用 =>
字符串中只转义双引号;数据里的 $ 或反斜杠不会被转义。
var_export 选项
没有任何效果
无论是否勾选,输出都相同,而且不是 var_export 的真实格式。

可靠地把 PHP 数组转成 JSON

PHP 的解析交给 PHP 自己;页面只用来处理 JSON 这一侧。

  1. 步骤 1: 在 PHP 中编码

    在你自己的脚本或 REPL 中运行 json_encode($array, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE)。

  2. 步骤 2: 检查 JSON

    把结果粘贴到验证器,确认能解析,并查看带位置的具体错误。

  3. 步骤 3: 需要不同风格时重新排版

    用格式化工具得到 4 个空格或制表符缩进,用压缩工具得到单行。

页面实际做了什么

两个方向都没有使用 PHP 解析器。两者都在浏览器里运行、都不会上传任何内容,但 PHP 转 JSON 方向只是一小串文本替换,之后再交给 JSON.parse:

  1. 去掉首尾空白,并删除 <?php 和 ?>。
  2. 把每个 array( 替换为 [。与之配对的 ) 不会被处理。
  3. 把每个 => 替换为 :。
  4. 把每个单引号 ' 替换为双引号 "。
  5. 删除位于 ] 或 } 之前的逗号。
  6. 按 JSON 解析并输出,格式为美化(2 个空格)或紧凑。

只有经过这条流水线后恰好是有效 JSON 的内容才能转换;其他都会以“转换错误: PHP数组语法无效: …”失败,后面跟着浏览器的 JSON 信息。失败后输出框不会被清空,所以它可能仍显示上一次运行的结果。请看红色状态行,而不是输出框。

哪些能转换,哪些不能

以下结果均来自实际运行本页面。

PHP 输入 结果
['a','b','c'] 可以:["a","b","c"]
[1, 2, 3,] 可以:[1,2,3](末尾逗号被删除)
[true, false, null] 可以
[[1,2],[3]] 可以
{"a":1}(本来就是 JSON) 可以:无需改写
['name'=>'Mei','age'=>30] 失败:变成 ["name":"Mei","age":30],不是 JSON
array('a','b') 失败:变成 ["a","b")
['it\'s'] 能转换但结果错误:得到 it"s
["it's"] 失败:撇号变成不成对的引号
[TRUE, NULL] 失败:PHP 常量不区分大小写,JSON 字面量区分
$x = [1];、return [1,2];、[1,2]; // note 失败:不理解语句、分号和注释
[1=>'a', 2=>'b']、[0x1F, 010] 失败

实际上,PHP 转 JSON 方向只能处理普通列表和长得像 JSON 的文本。页面自带的说明和常见问题声称的功能比这多;不要依赖它处理关联数组。

JSON 转 PHP 的输出

这个方向会正确解析 JSON,再输出 PHP 源码。{"a":1,"b":[1,2],"c":{"d":null}} 的实测输出:

[
    "a" => 1,
    "b" => [
        1,
        2
    ],
    "c" => [
        "d" => null
    ]
]

JSON 数组变成列表,JSON 对象变成 "key" => value,{} 变成 []。取消勾选短语法会得到 array( … )。输出没有 $var = 前缀、没有末尾分号,也没有末尾逗号,需要你自己补上。由于字符串用 PHP 双引号写出且只转义 ",会有三个隐患:

  • 变量插值:JSON 字符串 "cost: $price" 在 PHP 中变成 "cost: $price",其中的 $price 会被替换为变量的值(或产生未定义变量警告)。{$x} 同理。
  • 反斜杠:JSON 值 back\nslash(真正的反斜杠后接 n,在 JSON 中写作 "back\\nslash")会输出成 "back\nslash",而 PHP 会把它读成换行。原始换行则被原样复制,没有问题。
  • 键 会加引号但不转义,所以含 " 的键会产生无效的 PHP。

数字使用 JavaScript 的格式:1.0 变成 1(整数,不是浮点数),1e21 变成 1e+21,12345678901234567890 变成 12345678901234567000。var_export 复选框不起任何作用。真正的 var_export 输出单引号字符串、带空格的 array (、列表的显式键(0 => 1,)、大写的 NULL 以及末尾逗号。

值得了解的 PHP 端规则

已用 PHP 8.3 核实:

PHP JSON
[1,2,3] [1,2,3]
['a'=>1] {"a":1}
[1=>'a',2=>'b'] {"1":"a","2":"b"}(键不是 0..n-1)
[0=>'a',1=>'b'] ["a","b"](连续的键构成列表)
[] [](空数组永远不会是 {};要得到 {} 请用 new stdClass)
1.0 1;使用 JSON_PRESERVE_ZERO_FRACTION 时为 1.0
"a/b é" 默认 "a\/b é";使用 JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE 时为 "a/b é"

json_decode($json, true) 返回关联数组;不加 true 则返回 stdClass 对象。{"1":"a","2":"b"} 解码为键 1 和 2 的整数键数组,而超过 PHP_INT_MAX 的 JSON 整数(如 12345678901234567890)会解码为浮点数。末尾逗号会让 json_decode 返回 NULL,错误信息为 “Syntax error”。

提示: 对要提交或运行的内容,请在 PHP 里用 var_export($data, true) 生成 PHP 源码,用 json_encode 生成 JSON。本页面适合快速处理列表和查看结构。

常见错误

  • 粘贴 array('key' => 'value') 或 ['key' => 'value'],然后对报错感到意外。
  • 出错后仍相信输出框;它可能是上一次转换的结果。
  • 把 JSON 转 PHP 的输出直接贴进代码,却没检查含 $ 或反斜杠的字符串。
  • 期待 1.0,或 [] 与 {} 的区别能在往返中保留。

相关工具

用 JSON 验证器、JSON 格式化或 JSON 查看器验证或重塑 JSON,并用 JSON 转文本把它展开成路径。

常见问题

如何将PHP数组转换为JSON?

选择"PHP数组转JSON"模式,粘贴您的PHP数组代码(使用[]或array()语法),选择您的JSON格式偏好(美化或紧凑),然后点击转换。工具将立即将您的PHP数组转换为有效的JSON格式。

我可以将JSON转换回PHP数组吗?

可以!选择"JSON转PHP数组"模式,粘贴您的JSON数据,选择您偏好的PHP语法(短[]或传统array()),然后点击转换。该工具支持双向转换。

PHP短数组语法和传统数组语法有什么区别?

短语法使用方括号[]并在PHP 5.4+中可用,而传统语法使用array()。例如:["a" => 1]对比array("a" => 1)。两者在功能上相同,但短语法更简洁,在现代PHP中广泛使用。

工具是否处理嵌套数组?

是的,转换器完全支持任何深度的嵌套数组和对象。它正确处理具有多层嵌套的复杂数据结构。

转换期间数据类型是否保留?

是的,该工具在转换期间保留字符串、数字、布尔值(true/false)和null值。关联数组变成JSON对象,数字索引数组变成JSON数组。

我的数据是否发送到服务器?

不,所有转换完全在您的浏览器中进行。您的数据永远不会离开您的设备,使此工具对API密钥或配置数据等敏感信息完全安全。

什么是var_export格式?

var_export是一个PHP函数,输出变量的可解析字符串表示。此选项生成PHP代码,格式与PHP的var_export()函数生成的格式完全相同,这对于代码生成和调试很有用。

我可以用于大型JSON或PHP数组吗?

可以,该工具可以处理大型数据结构。但是,非常大的文件(几兆字节)可能需要更长时间处理,具体取决于您的浏览器和设备性能。

如果我的PHP数组或JSON无效会发生什么?

工具将验证您的输入并显示特定的错误消息,指示出了什么问题,帮助您快速识别和修复语法错误。

我可以下载转换后的输出吗?

可以,使用下载按钮将转换后的输出保存为.json文件(对于JSON输出)或.php文件(对于PHP数组输出)。

为什么需要在PHP和JSON之间转换?

常见用例包括:转换API响应以在PHP应用程序中使用、从JSON固定装置生成PHP测试数据、创建配置文件、系统之间的数据迁移以及文档示例。

美化打印的JSON是否影响数据?

不,美化打印只添加空白(空格和换行符)以提高可读性。实际数据结构和值与紧凑JSON保持相同。唯一的区别是文件大小和人类可读性。

资料来源

  1. PHP manual — json_encode — Lists versus objects, escaping flags, float handling.
  2. PHP manual — json_decode — Objects as stdClass or associative arrays, big integers.
  3. PHP manual — var_export — The real output format of var_export.
  4. PHP manual — Strings — Variable interpolation and escape sequences in double-quoted strings.
  5. IETF — RFC 8259, The JSON Data Interchange Format

本指南用浅白语言解释已公布的规则,不构成财务、法律或官方意见。政策会变动,做决定前请向上方链接的政府机构核实。

把这个工具嵌入你的网站

免费使用。把这段代码贴到你的网页,并保留指向 ToolSG 的链接。