php如何使用json数据

PHP如何使用JSON数据：从基础到实践的全面指南

在Web开发中,JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，因其易读、易解析和跨语言特性，已成为前后端数据交互的主流选择，PHP作为服务器端开发语言，提供了强大的JSON处理功能，能够轻松实现数据的编码（PHP数组转JSON）、解码（JSON转PHP数组）及实际应用场景操作，本文将从基础语法到实战应用，详细讲解PHP如何使用JSON数据。

JSON与PHP的数据类型对应关系

在PHP的JSON处理函数前,先明确JSON数据类型与PHP数据类型的对应关系，这是正确处理数据的前提：

核心函数：json_encode()与json_decode()

PHP处理JSON的核心是两个内置函数：json_encode()（将PHP数据转为JSON字符串）和json_decode()（将JSON字符串转为PHP数据）。

json_encode()：PHP数据转JSON字符串

json_encode()用于将PHP中的数组或对象转换为JSON格式的字符串，其基本语法为：

mixed json_encode(mixed $value, int $options = 0, int $depth = 512)

• $value：要编码的PHP数据（数组或对象）。
• $options：可选参数，常用选项包括：
  • JSON_FORCE_OBJECT：将索引数组转为对象（即使索引数组是连续的）。
  • JSON_UNESCAPED_UNICODE：不 Unicode 转义（保留中文等非ASCII字符，避免显示为\u编码）。
  • JSON_PRETTY_PRINT：格式化输出（缩进美化，便于调试）。
• $depth：指定递归深度（默认512，一般无需调整）。

示例1：基础编码

<?php
// PHP关联数组转JSON对象
$data = [
    'name' => '张三',
    'age' => 25,
    'is_student' => false,
    'courses' => ['PHP', 'MySQL', 'JavaScript']
];
$jsonStr = json_encode($data);
echo $jsonStr;
// 输出：{"name":"张三","age":25,"is_student":false,"courses":["PHP","MySQL","JavaScript"]}
?>
#### 示例2：保留中文与格式化
```php
<?php
$data = ['city' => '北京', 'country' => '中国'];
$jsonStr = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
echo $jsonStr;
/* 输出（格式化后）：
{
    "city": "北京",
    "country": "中国"
}
*/
?>

json_decode()：JSON字符串转PHP数据

json_decode()用于将JSON字符串转换为PHP的数组或对象，其基本语法为：

mixed json_decode(string $json, bool $assoc = false, int $depth = 512, int $options = 0)

• $json：要解码的JSON字符串。
• $assoc：关键参数！
  • true：返回关联数组（推荐，便于通过键名访问数据）。
  • false：返回对象（可通过->访问属性）。
• $depth：递归深度（默认512）。
• $options：可选参数，如JSON_BIGINT_AS_STRING（将大整数转为字符串，避免精度丢失）。

示例1：基础解码（返回数组）

<?php
$jsonStr = '{"name":"李四","age":30,"hobbies":["reading","coding"]}';
$data = json_decode($jsonStr, true); // 关联数组
echo $data['name']; // 输出：李四
print_r($data);
/* 输出：
Array
(
    [name] => 李四
    [age] => 30
    [hobbies] => Array([0] => reading, [1] => coding)
)
*/
?>

示例2：解码为对象

<?php
$jsonStr = '{"name":"王五","age":28}';
$data = json_decode($jsonStr); // 默认返回对象
echo $data->name; // 输出：王五
var_dump($data);
/* 输出：
object(stdClass)#1 (2) {
    ["name"] => string(6) "王五"
    ["age"] => int(28)
}
*/
?>

示例3：处理JSON数组

<?php
$jsonArray = '["apple","banana","orange"]';
$array = json_decode($jsonArray, true); // 索引数组
echo $array[1]; // 输出：banana
?>

常见错误处理

JSON编码/解码时可能出错，需通过json_last_error()和json_last_error_msg()捕获错误信息。

示例：捕获JSON编码错误

<?php
// 尝试编码包含资源的数据（资源无法编码）
$fp = fopen('test.txt', 'r');
$data = ['file' => $fp];
$jsonStr = json_encode($data);
if (json_last_error() !== JSON_ERROR_NONE) {
    echo '编码错误：' . json_last_error_msg(); // 输出：类型错误，无法编码资源类型
    fclose($fp);
}
?>

实战应用场景

前后端数据交互：API接口开发

在RESTful API中，PHP常通过JSON格式返回数据给前端（如JavaScript、移动端），用户信息接口：

PHP后端（api.php）

<?php
header('Content-Type: application/json'); // 设置响应头为JSON格式
// 模拟数据库查询
$user = [
    'id' => 1001,
    'username' => 'php_dev',
    'email' => 'php_dev@example.com',
    'created_at' => '2023-10-01 12:00:00'
];
// 返回JSON数据
echo json_encode($user, JSON_UNESCAPED_UNICODE);
?>

前端JavaScript接收

fetch('api.php')
    .then(response => response.json())
    .then(data => {
        console.log('用户名：', data.username); // 输出：用户名：php_dev
    });

配置文件读取与写入

JSON常用于存储配置数据（如数据库连接信息），PHP可轻松读取和修改。

配置文件（config.json）

{
    "database": {
        "host": "localhost",
        "username": "root",
        "password": "123456",
        "dbname": "test_db"
    },
    "app": {
        "name": "My App",
        "debug": true
    }
}

PHP读取配置

<?php
$config = json_decode(file_get_contents('config.json'), true);
echo '数据库主机：' . $config['database']['host']; // 输出：数据库主机：localhost
?>

PHP修改配置并保存

<?php
$config = json_decode(file_get_contents('config.json'), true);
$config['app']['debug'] = false; // 修改调试模式
file_put_contents('config.json', json_encode($config, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE));
echo '配置已更新';
?>

缓存数据存储

JSON可序列化复杂数据（如数组、对象）并缓存到文件，提升访问速度。

缓存示例

<?php
$cacheFile = 'cache/user_cache.json';
$cacheTime = 3600; // 缓存1小时
// 检查缓存是否存在且未过期
if (file_exists($cacheFile) && time() - filemtime($cacheFile) < $cacheTime) {
    $userList = json_decode(file_get_contents($cacheFile), true);
} else {
    // 模拟数据库查询
    $userList = [
        ['id' => 1, 'name' => 'Alice'],
        ['id'