php中json如何写数组

PHP中JSON数组的写法与使用指南

在PHP开发中,JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，因其易读易写的特性而被广泛使用，将PHP数组转换为JSON格式是前后端数据交互的常见操作，本文将详细介绍PHP中如何正确地编写和处理JSON数组。

PHP数组转JSON的基本方法

PHP提供了json_encode()函数，用于将PHP数组或对象转换为JSON格式的字符串。

索引数组转JSON

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

关联数组转JSON

<?php
$assocArray = [
    "name" => "John",
    "age" => 30,
    "isStudent" => false
];
$jsonString = json_encode($assocArray);
echo $jsonString; // 输出: {"name":"John","age":30,"isStudent":false}
?>

多维数组转JSON

<?php
$multiArray = [
    "fruits" => ["apple", "banana"],
    "vegetables" => ["carrot", "broccoli"],
    "details" => [
        "color" => "red",
        "origin" => "China"
    ]
];
$jsonString = json_encode($multiArray);
echo $jsonString;
// 输出: {"fruits":["apple","banana"],"vegetables":["carrot","broccoli"],"details":{"color":"red","origin":"China"}}
?>

json_encode()的常用参数

json_encode()函数提供了几个有用的参数，可以控制JSON输出的格式：

JSON_PRETTY_PRINT - 美化输出

<?php
$data = ["name" => "Alice", "hobbies" => ["reading", "hiking"]];
$prettyJson = json_encode($data, JSON_PRETTY_PRINT);
echo $prettyJson;
/*
输出:
{
    "name": "Alice",
    "hobbies": [
        "reading",
        "hiking"
    ]
}
*/
?>

JSON_UNESCAPED_UNICODE - 不转义Unicode字符

<?php
$data = ["chinese" => "中文", "english" => "English"];
$json = json_encode($data, JSON_UNESCAPED_UNICODE);
echo $json; // 输出: {"chinese":"中文","english":"English"}
?>

JSON_NUMERIC_CHECK - 将数字字符串转为数字

<?php
$data = ["id" => "123", "price" => "99.99"];
$json = json_encode($data, JSON_NUMERIC_CHECK);
echo $json; // 输出: {"id":123,"price":99.99}
?>

处理JSON编码错误

当使用json_encode()时，可能会遇到各种错误，可以使用json_last_error()和json_last_error_msg()来检查和诊断问题：

<?php
$data = ["invalid" => pack("H*", "c328")]; // 包含无效UTF-8字符的字符串
$json = json_encode($data);
if ($json === false) {
    echo "JSON编码失败: " . json_last_error_msg();
    // 可能的输出: "JSON编码失败: Malformed UTF-8 characters, possibly incorrectly encoded"
}
?>

从JSON字符串解析回PHP数组

使用json_decode()函数可以将JSON字符串转换回PHP数组：

<?php
$jsonString = '{"name":"Bob","age":25,"skills":["PHP","JavaScript","MySQL"]}';
$phpArray = json_decode($jsonString, true); // 第二个参数true表示返回关联数组而非对象
print_r($phpArray);
/*
输出:
Array
(
    [name] => Bob
    [age] => 25
    [skills] => Array
        (
            [0] => PHP
            [1] => JavaScript
            [2] => MySQL
        )
)
*/
?>

实用技巧与注意事项

确保数据是UTF-8编码：PHP的JSON函数只能正确处理UTF-8编码的数据。
处理特殊字符：对于包含特殊字符的数据，考虑使用JSON_HEX_QUOT、JSON_HEX_TAG等选项。
深度控制：对于非常深的数组结构，可以使用JSON_MAX_DEPTH选项（PHP 5.5+）来限制递归深度。
空数组与空对象：注意PHP的空数组[]会被编码为JSON的[]，而空对象new stdClass()会被编码为。
性能考虑：对于大型数组，json_encode()可能会消耗较多内存，可以考虑分批处理数据。

实际应用示例

假设我们需要从数据库获取用户数据并以JSON格式返回给前端：

<?php
// 模拟数据库查询结果
$users = [
    [
        "id" => 1,
        "name" => "张三",
        "email" => "zhangsan@example.com",
        "roles" => ["admin", "editor"]
    ],
    [
        "id" => 2,
        "name" => "李四",
        "email" => "lisi@example.com",
        "roles" => ["user"]
    ]
];
// 设置响应头为JSON格式
header('Content-Type: application/json; charset=utf-8');
// 编码为JSON并输出
echo json_encode($users, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
?>

PHP中处理JSON数组主要依赖于json_encode()和json_decode()两个函数，通过合理使用这些函数及其参数，可以灵活地在PHP数组和JSON格式之间进行转换，在实际开发中，注意处理编码问题、错误检查和性能优化，能够帮助你更高效地实现前后端数据交互，这些技巧对于现代PHP开发者来说是一项基本而重要的技能。