php怎么设置json

PHP中如何设置与处理JSON数据：从基础到高级应用

在Web开发中,JSON（JavaScript Object Notation）已成为数据交换的主流格式，因其轻量级、易解析的特点，被广泛应用于前后端数据交互、API接口开发等场景，PHP作为服务器端脚本语言，提供了丰富的内置函数来处理JSON数据，本文将详细介绍PHP中设置JSON数据的各种方法，包括编码、解码、格式化、错误处理等核心知识点，并结合实际场景提供代码示例。

基础：使用json_encode()将PHP数据转换为JSON字符串

PHP中最常用的将数据转换为JSON格式的函数是json_encode()，它能将PHP中的数组、对象等数据结构序列化为JSON字符串。

基本语法

json_encode(mixed $value, int $depth = 512, int $options = 0): string|false

• $value：要编码的PHP变量（通常是数组或对象）。
• $depth：递归深度限制（默认512，超出时会返回JSON_ERROR_DEPTH错误）。
• $options：编码选项（如JSON格式化、中文处理等），通过常量组合使用。

编码数组：索引数组与关联数组

索引数组（普通数组）

$indexedArray = ["apple", "banana", "cherry"];
$jsonString = json_encode($indexedArray);
echo $jsonString; // 输出: ["apple","banana","cherry"]

关联数组（键值对数组）

$assocArray = ["name" => "张三", "age" => 25, "city" => "北京"];
$jsonString = json_encode($assocArray);
echo $jsonString; // 输出: {"name":"张三","age":25,"city":"北京"}

编码对象

PHP对象会被转换为JSON的结构,对象的属性自动作为JSON的键值对：

class User {
    public $name;
    public $email;
    private $password; // 私有属性不会被编码
    public function __construct($name, $email) {
        $this->name = $name;
        $this->email = $email;
    }
}
$user = new User("李四", "lisi@example.com");
$jsonString = json_encode($user);
echo $jsonString; // 输出: {"name":"李四","email":"lisi@example.com"}

处理特殊数据类型

• null：转换为JSON的null。
• 布尔值：true/false转换为JSON的true/false。
• 数字：整数和浮点数直接转换为JSON的数字类型。
• 字符串：会被双引号包裹，特殊字符（如、\）会被转义。

$specialData = [
    "nullValue" => null,
    "isActive" => true,
    "price" => 99.99,
    "message" => "他说：\"Hello, World!\""
];
$jsonString = json_encode($specialData);
echo $jsonString; 
// 输出: {"nullValue":null,"isActive":true,"price":99.99,"message":"他说：\"Hello, World!\""}

进阶：通过$options参数控制JSON格式

json_encode()的$options参数支持多种常量，用于调整JSON的输出格式和行为。

美化输出（JSON_PRETTY_PRINT）

默认情况下,json_encode()输出的JSON字符串是压缩的（无缩进和换行），开发调试时，可通过JSON_PRETTY_PRINT实现格式化输出：

$data = ["name" => "王五", "hobbies" => ["reading", "coding", "traveling"]];
$jsonString = json_encode($data, JSON_PRETTY_PRINT);
echo $jsonString;
// 输出（带缩进）:
{
    "name": "王五",
    "hobbies": [
        "reading",
        "coding",
        "traveling"
    ]
}

中文不转为Unicode（JSON_UNESCAPED_UNICODE）

默认情况下,json_encode()会将非ASCII字符（如中文）转义为Unicode（如\u4e2d\u6587），若需保留原始中文，使用JSON_UNESCAPED_UNICODE：

$data = ["city" => "上海", "country" => "中国"];
$jsonString = json_encode($data, JSON_UNESCAPED_UNICODE);
echo $jsonString; // 输出: {"city":"上海","country":"中国"}

注意：若同时使用JSON_PRETTY_PRINT和JSON_UNESCAPED_UNICODE，需用位或运算符连接：

$jsonString = json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);

不转义斜杠（JSON_UNESCAPED_SLASHES）

默认情况下,字符串中的斜杠（）会被转义为\/，若需保留原斜杠，使用JSON_UNESCAPED_SLASHES：

$data = ["path" => "C:\xampp\htdocs\project"];
$jsonString = json_encode($data, JSON_UNESCAPED_SLASHES);
echo $jsonString; // 输出: {"path":"C:\xampp\htdocs\project"}

强转换为对象（JSON_FORCE_OBJECT）

当编码的数组是空数组或索引数组时,默认会输出JSON数组（[]），若需强制输出JSON对象（），使用JSON_FORCE_OBJECT：

$emptyArray = [];
$indexedArray = [1, 2, 3];
$json1 = json_encode($emptyArray, JSON_FORCE_OBJECT); // 输出: {}
$json2 = json_encode($indexedArray, JSON_FORCE_OBJECT); // 输出: {"0":1,"1":2,"2":3}

错误处理：检查json_encode()的编码错误

当json_encode()执行失败时，会返回false，并通过json_last_error()和json_last_error_msg()获取错误信息。

常见错误场景与处理

递归深度超限

$deepArray = [];
$arrayRef = &$deepArray;
$deepArray['ref'] = &$arrayRef; // 创建循环引用
$jsonString = json_encode($deepArray);
if ($jsonString === false) {
    echo "编码错误: " . json_last_error_msg(); // 输出: 编码错误: Recursion depth exceeded
}

无效的UTF-8编码

若数据包含非UTF-8字符（如乱码），编码会失败：

$invalidUtf8 = ["text" => "\xFF\xFF"]; // 非法UTF-8字节
$jsonString = json_encode($invalidUtf8);
if ($jsonString === false) {
    echo "编码错误: " . json_last_error_msg(); // 输出: 编码错误: Malformed UTF-8 characters, possibly incorrectly encoded
}

错误处理封装函数

function safeJsonEncode($data, $options = 0) {
    $jsonString = json_encode($data, $options);
    if ($jsonString === false) {
        throw new RuntimeException("JSON编码失败: " . json_last_error_msg());
    }
    return $jsonString;
}
// 使用示例
try {
    $data = ["name" => "测试"];
    echo safeJsonEncode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
} catch (RuntimeException $e) {
    echo "错误: " . $e->getMessage();
}

反向操作：使用json_decode()将JSON字符串转为PHP数据

若需将JSON字符串还原为PHP数据（如接收前端JSON数据或解析API响应），可使用json_decode()函数。

基本语法

json_decode(string $json, bool $associative = false, int $depth = 512, int $flags = 0): mixed

• $json：要解码的JSON字符串。
• $associative：是否返回关联数组（true返回数组，false返回对象，默认false）。
• $depth：递归深度限制（默认512）。
• $flags：解码选项（如JSON_BIGINT_AS_STRING处理大整数）。

解码为数组 vs 对象

解码为对象（默认）

$jsonString = '{"name":"赵六","age":30,"hobbies":["music","sports"]}';
$obj = json_decode($jsonString);
echo $obj->name; // 输出: 赵六
echo $obj->hobbies[0]; // 输出: music

解码为关联数组

$array = json_decode($jsonString, true);
echo $array["name"]; //