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

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

- Tool: [PHP数组JSON转换器](https://toolsg.com/zh/php-array-json-converter)
- Language: zh (available: en, zh, ms, ta)
- Last verified against official sources: 2026-10-19
- Source site: ToolSG — a planning guide, not official or financial advice. Cite the agencies listed under Sources.

## 关键数字一览

| 项目 | 数值 | 来源 |
| --- | --- | --- |
| 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. **在 PHP 中编码** — 在你自己的脚本或 REPL 中运行 json_encode($array, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE)。
2. **检查 JSON** — 把结果粘贴到验证器，确认能解析，并查看带位置的具体错误。 相关工具: [JSON 校验器](https://toolsg.com/zh/json-validator)
3. **需要不同风格时重新排版** — 用格式化工具得到 4 个空格或制表符缩进，用压缩工具得到单行。 相关工具: [JSON 格式化与压缩工具](https://toolsg.com/zh/json-formatter), [JSON 压缩工具](https://toolsg.com/zh/json-minify)

## 页面实际做了什么

两个方向都没有使用 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}}` 的实测输出：

```php
[
    "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 验证器](https://toolsg.com/zh/json-validator)、[JSON 格式化](https://toolsg.com/zh/json-formatter)或 [JSON 查看器](https://toolsg.com/zh/json-viewer)验证或重塑 JSON，并用 [JSON 转文本](https://toolsg.com/zh/json-to-text)把它展开成路径。

## 常见问题

**如何将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保持相同。唯一的区别是文件大小和人类可读性。


## 资料来源

- [PHP manual — json_encode](https://www.php.net/manual/en/function.json-encode.php) — Lists versus objects, escaping flags, float handling.
- [PHP manual — json_decode](https://www.php.net/manual/en/function.json-decode.php) — Objects as stdClass or associative arrays, big integers.
- [PHP manual — var_export](https://www.php.net/manual/en/function.var-export.php) — The real output format of var_export.
- [PHP manual — Strings](https://www.php.net/manual/en/language.types.string.php) — Variable interpolation and escape sequences in double-quoted strings.
- [IETF — RFC 8259, The JSON Data Interchange Format](https://www.rfc-editor.org/rfc/rfc8259.html)
