PHP Academy · 课时

JSON 编码与解码

Q: 「JSON 编码与解码」这节课中我会学到什么？

将 PHP 数组转换为 JSON，并使用 json_encode/json_decode 解析 JSON 响应。 你通过在浏览器中直接运行的动手代码来练习 PHP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

将 PHP 数组转换为 JSON，并使用 json_encode/json_decode 解析 JSON 响应。

JSON 编码与解码 是 CoddyKit 上的免费 PHP Academy 课时。这是第 1 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 PHP Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 PHP Academy 课程共包含 4 节课。

什么是 JSON

JSON（JavaScript 对象表示法）是一种用于 API 通信和配置文件的轻量级数据格式。PHP 提供了用于编码和解码 JSON 的内置函数。

json_encode()

将 PHP 值（数组、对象或标量）转换为 JSON 字符串。

<?php
$data   = ["name" => "Alice", "age" => 30, "active" => true];
$json   = json_encode($data);
echo $json; // {"name":"Alice","age":30,"active":true}

json_decode()

解析 JSON 字符串并返回 PHP 值。默认返回 stdClass 对象；将 true 作为第二个参数传入，则返回关联数组。

<?php
$json = '{"name":"Alice","age":30}';
$obj  = json_decode($json);          // stdClass
$arr  = json_decode($json, true);    // associative array
echo $arr["name"]; // "Alice"

JSON 美化输出

请使用 JSON_PRETTY_PRINT 标志格式化输出，使其更易于人类阅读。

<?php
$json = json_encode(["a" => 1, "b" => 2], JSON_PRETTY_PRINT);
echo $json;
// {
//     "a": 1,
//     "b": 2
// }

实用的 json_encode 标志

常用标志包括：JSON_UNESCAPED_UNICODE（保持 UTF-8 原样）、JSON_UNESCAPED_SLASHES（不在 / 前添加反斜杠）、JSON_THROW_ON_ERROR（失败时抛出异常）。

<?php
$json = json_encode(["url" => "https://example.com/path"],
    JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);

错误处理

编码或解码后请检查 json_last_error()，或者使用 JSON_THROW_ON_ERROR 自动获取异常。

<?php
try {
    $data = json_decode($input, true, 512, JSON_THROW_ON_ERROR);
} catch (\JsonException $e) {
    echo "Invalid JSON: ".$e->getMessage();
}

对象编码

对象会被编码为 JSON 对象。默认情况下只包含公共属性。请实现 JsonSerializable 以控制序列化过程。

<?php
class Point implements \JsonSerializable {
    public function __construct(
        private float $x, private float $y
    ) {}
    public function jsonSerialize(): mixed {
        return ["x" => $this->x, "y" => $this->y];
    }
}
echo json_encode(new Point(1.0, 2.5)); // {"x":1,"y":2.5}

嵌套结构

JSON 支持嵌套。深度嵌套的 PHP 数组可以无缝编码为嵌套的 JSON 对象或数组。

<?php
$order = [
    "id"    => 1,
    "items" => [
        ["sku" => "A1", "qty" => 2],
        ["sku" => "B3", "qty" => 1],
    ],
];
echo json_encode($order, JSON_PRETTY_PRINT);

解码深度

json_decode 的第 3 个参数用于设置最大递归深度（默认值为 512）。对于非常深的 JSON，可能需要提高此限制。

JSON_NUMERIC_CHECK

JSON_NUMERIC_CHECK 标志会在编码过程中将数字字符串转换为数字。请谨慎使用，因为它可能会破坏电话号码。

流式处理大型 JSON

对于非常大的 JSON 文件，请使用流式解析器库（例如 halaxa/json-machine），而不要使用 json_decode 加载整个文件。

总结

json_encode 会将 PHP 值转换为 JSON 字符串。json_decode 会解析 JSON。请使用 JSON_THROW_ON_ERROR 安全地处理错误。

快速检查

如何从 json_decode 获取关联数组？

常见问题解答

「JSON 编码与解码」课时是免费的吗？

是的 — 「JSON 编码与解码」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 PHP Academy 课程的其余内容，请升级到 CoddyKit PRO。 PHP Academy 课程共包含 4 节课。

「JSON 编码与解码」这节课中我会学到什么？

将 PHP 数组转换为 JSON，并使用 json_encode/json_decode 解析 JSON 响应。你通过在浏览器中直接运行的动手代码来练习 PHP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 PHP Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 PHP Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 4 节。

「JSON 编码与解码」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 PHP Academy 课中编写并运行代码吗？

能。每节 PHP Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 PHP Academy