php数组怎么转换成json

PHP数组转JSON：从入门到精通的完整指南

在Web开发中,PHP数组与JSON格式的相互转换是非常常见的操作，JSON（JavaScript Object Notation）因其轻量级、易读易写的特性，成为前后端数据交换的主流格式，本文将详细介绍PHP数组如何转换成JSON，包括基础方法、高级选项、常见问题及解决方案。

基础转换：使用json_encode()

PHP提供了内置函数json_encode()，用于将PHP数组或对象转换为JSON格式的字符串，这是最核心、最常用的方法。

索引数组转换

索引数组（以数字为键的数组）会被转换为JSON数组格式（使用方括号[]）。

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

关联数组转换

关联数组（以字符串为键的数组）会被转换为JSON对象格式（使用花括号）。

<?php
$assocArray = array(
    "name" => "John",
    "age" => 30,
    "city" => "New York"
);
$jsonString = json_encode($assocArray);
echo $jsonString;
// 输出: {"name":"John","age":30,"city":"New York"}
?>

混合数组转换

混合数组（同时包含数字键和字符串键）的行为取决于PHP版本，但在大多数情况下，数字键会被视为索引，字符串键被视为对象属性，最终结果可能是一个包含数组和对象的复杂JSON结构，或者在某些情况下可能不符合预期，建议在进行JSON编码时尽量使用纯索引数组或纯关联数组。

<?php
$mixedArray = array(
    0 => "apple",
    "fruit1" => "banana",
    2 => "cherry",
    "fruit2" => "date"
);
$jsonString = json_encode($mixedArray);
echo $jsonString;
// 可能输出: {"0":"apple","fruit1":"banana","2":"cherry","fruit2":"date"}
// (数字键被保留为字符串键，因为JSON对象键必须是字符串)
?>

json_encode()的常用参数

json_encode()函数提供了一些可选参数，用于控制JSON输出的格式和行为。

JSON_PRETTY_PRINT (美化输出)

使用该参数可以使输出的JSON字符串更具可读性,通过缩进和换行来格式化。

<?php
$assocArray = array(
    "name" => "John",
    "age" => 30,
    "city" => "New York"
);
$jsonString = json_encode($assocArray, JSON_PRETTY_PRINT);
echo $jsonString;
/*
输出:
{
    "name": "John",
    "age": 30,
    "city": "New York"
}
*/
?>

JSON_UNESCAPED_UNICODE (不转义Unicode字符)

默认情况下,json_encode()会将非ASCII字符（如中文）转义为\uXXXX格式，使用此参数可以保留原始的Unicode字符。

<?php
$assocArray = array(
    "name" => "张三",
    "city" => "北京"
);
// 默认转义
$jsonString1 = json_encode($assocArray);
echo $jsonString1 . "\n";
// 输出: {"name":"\u5f20\u4e09","city":"\u5317\u4eac"}
// 不转义Unicode
$jsonString2 = json_encode($assocArray, JSON_UNESCAPED_UNICODE);
echo $jsonString2 . "\n";
// 输出: {"name":"张三","city":"北京"}
?>

JSON_NUMERIC_CHECK (数字字符串转为数字)

如果数组中的值是数字字符串（如"123"），使用此参数会将它们转换为JSON数字类型。

<?php
$assocArray = array(
    "id" => "123",
    "price" => "99.99",
    "name" => "Product"
);
$jsonString = json_encode($assocArray, JSON_NUMERIC_CHECK);
echo $jsonString;
// 输出: {"id":123,"price":99.99,"name":"Product"}
?>

JSON_FORCE_OBJECT (强制输出对象)

即使索引数组,使用此参数也会强制输出为JSON对象（键为数字字符串）。

<?php
$indexedArray = array("apple", "banana", "cherry");
$jsonString = json_encode($indexedArray, JSON_FORCE_OBJECT);
echo $jsonString;
// 输出: {"0":"apple","1":"banana","2":"cherry"}
?>

JSON_HEX_TAG, JSON_HEX_AMP, JSON_HEX_APOS, JSON_HEX_QUOT (转义特定字符)

这些参数用于对特定的HTML字符进行十六进制转义,适用于在HTML中嵌入JSON字符串的场景。

处理转换过程中的错误

在使用json_encode()时，可能会因为各种原因失败（如无效的UTF-8编码、数组中包含资源类型等），函数会返回false，并产生一个JSON格式的错误信息。

检查json_encode()的返回值

<?php
$invalidArray = array(
    "name" => "John",
    "data" => fopen("php://memory", "r") // 资源类型不能编码
);
$jsonString = json_encode($invalidArray);
if ($jsonString === false) {
    echo "JSON编码失败: " . json_last_error_msg();
} else {
    echo $jsonString;
}
// 输出: JSON编码失败: Type is not supported
?>

常见错误及解决方法

JSON_ERROR_UTF8: 源字符串包含无效的UTF-8字符，可以使用mb_convert_encoding()或utf8_encode()（对于ISO-8859-1数据）进行预处理。

$invalidUtf8 = "你好\x80世界";
$validUtf8 = mb_convert_encoding($invalidUtf8, 'UTF-8', 'UTF-8');
$jsonString = json_encode($validUtf8);
echo $jsonString; // 输出: "你好世界"

数组中包含资源或对象（除非实现了JsonSerializable接口）: 确保数组中的值是基本数据类型（string, int, float, bool, null）或可序列化的数组/对象。

高级应用与最佳实践

深度嵌套数组转换

json_encode()可以处理任意深度的嵌套数组，自动将其转换为对应的嵌套JSON结构。

<?php
$nestedArray = array(
    "user" => array(
        "name" => "Alice",
        "hobbies" => array("reading", "hiking", "coding")
    ),
    "status" => "active"
);
$jsonString = json_encode($nestedArray, JSON_PRETTY_PRINT);
echo $jsonString;
/*
输出:
{
    "user": {
        "name": "Alice",
        "hobbies": [
            "reading",
            "hiking",
            "coding"
        ]
    },
    "status": "active"
}
*/
?>

自定义对象序列化（JsonSerializable接口）

如果需要将对象转换为JSON,并且希望自定义转换逻辑，可以让类实现JsonSerializable接口，并实现jsonSerialize()方法。

<?php
class User implements JsonSerializable {
    private $name;
    private $age;
    private $password; // 不希望序列化的字段
    public function __construct($name, $age, $password) {
        $this->name = $name;
        $this->age = $age;
        $this->password = $password;
    }
    public function jsonSerialize() {
        return [
            'name' => $this->name,
            'age' => $this->age
            // password 自动被排除
        ];
    }
}
$user = new User("Bob", 25, "secret");
$jsonString = json_encode($user, JSON_PRETTY_PRINT);
echo $jsonString;
/*
输出:
{
    "name": "Bob",
    "age": 25
}
*/
?>

处理特殊数据类型