json在php怎么调用

JSON在PHP中的调用：从基础到实践的完整指南

在现代Web开发中，JSON（JavaScript Object Notation）已成为数据交换的事实标准，其轻量级、易读且易于解析的特性，使其成为前后端通信、API交互以及配置文件存储的理想选择，PHP作为后端开发的主流语言之一，提供了强大的JSON处理能力，本文将详细介绍如何在PHP中调用JSON，包括编码、解码、处理错误以及实际应用场景。

什么是JSON？

JSON是一种基于JavaScript语法标准的数据格式，它以键值对的形式组织数据，结构清晰，易于人阅读和编写，也易于机器解析和生成,一个典型的JSON对象如下：

{
  "name": "张三",
  "age": 30,
  "isStudent": false,
  "courses": ["PHP", "MySQL", "JavaScript"],
  "address": {
    "city": "北京",
    "district": "海淀区"
  }
}

PHP中将数据编码为JSON

在PHP中，如果你需要将PHP变量（如数组、对象）转换为JSON格式的字符串，可以使用json_encode()函数。

基本用法

<?php
$data = [
    "name" => "李四",
    "age" => 25,
    "hobbies" => ["阅读", "旅行", "编程"]
];
$jsonString = json_encode($data);
echo $jsonString;
?>

输出：

{"name":"李四","age":25,"hobbies":["阅读","旅行","编程"]}

json_encode() 的常用参数

JSON_PRETTY_PRINT：格式化输出,使JSON字符串更具可读性。

$jsonString = json_encode($data, JSON_PRETTY_PRINT);
echo $jsonString;

输出：

{
    "name": "李四",
    "age": 25,
    "hobbies": [
        "阅读",
        "旅行",
        "编程"
    ]
}

JSON_UNESCAPED_UNICODE：不转义Unicode字符（如中文）,确保中文正常显示。

$dataWithChinese = ["city" => "上海", "desc" => "中国的大都市"];
$jsonString = json_encode($dataWithChinese, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
echo $jsonString;

输出：

{
    "city": "上海",
    "desc": "中国的大都市"
}

（如果不加JSON_UNESCAPED_UNICODE，中文可能会被转义为\uXXXX格式。）

JSON_NUMERIC_CHECK：将数字字符串转换为数字类型。

$dataWithNumeric = ["id" => "123", "price" => "99.99"];
$jsonString = json_encode($dataWithNumeric, JSON_NUMERIC_CHECK);
echo $jsonString; // 输出: {"id":123,"price":99.99}

json_encode() 失败的情况

如果json_encode()失败（传入的资源类型或无效的UTF-8字符），它会返回FALSE，你可以通过json_last_error_msg()函数获取具体的错误信息。

<?php
// 示例：尝试编码一个资源类型
$fp = fopen('example.txt', 'r');
$jsonString = json_encode($fp);
if ($jsonString === false) {
    echo "JSON编码失败: " . json_last_error_msg();
}
fclose($fp);
?>

PHP中解析JSON字符串

当你从前端接收到JSON数据或从文件中读取JSON配置时，需要将这些JSON字符串解析为PHP变量，这可以通过json_decode()函数实现。

基本用法

<?php
$jsonString = '{"name":"王五","age":28,"isMarried":false,"skills":["PHP","Python"]}';
$data = json_decode($jsonString);
// 访问解析后的数据
echo $data->name; // 输出: 王五
echo $data->age;  // 输出: 28
print_r($data->skills); // 输出: Array ( [0] => PHP [1] => Python )
?>

默认情况下，json_decode()会将JSON对象解析为PHP的StdClass对象，JSON数组会解析为PHP的索引数组。

解码为关联数组

如果你希望将JSON对象直接解析为PHP的关联数组（而不是StdClass对象），可以给json_decode()传递第二个参数为true。

<?php
$jsonString = '{"name":"王五","age":28}';
$dataArray = json_decode($jsonString, true); // 第二个参数为true
// 现在可以通过数组方式访问
echo $dataArray['name']; // 输出: 王五
echo $dataArray['age'];  // 输出: 28
?>

json_decode() 失败的情况

与json_encode()类似，如果JSON字符串格式无效，json_decode()会返回NULL，并可以通过json_last_error_msg()获取错误信息。

<?php
$invalidJsonString = '{"name":"赵六", "age": thirty}'; // "thirty"不是有效的JSON数字
$data = json_decode($invalidJsonString);
if ($data === null) {
    echo "JSON解码失败: " . json_last_error_msg();
    // 可能的输出: Syntax error
}
?>

实际应用场景

场景1：接收前端AJAX发送的JSON数据

前端使用JSON.stringify()将JavaScript对象发送到后端PHP，PHP通过file_get_contents("php://input")获取原始POST数据，然后json_decode()。

<?php
// 假设前端通过POST发送了JSON数据
// $jsonInput = file_get_contents("php://input");
$jsonInput = '{"username":"admin","password":"123456"}';
$data = json_decode($jsonInput, true);
if ($data && isset($data['username']) && isset($data['password'])) {
    // 验证逻辑...
    echo "欢迎, " . htmlspecialchars($data['username']);
} else {
    echo "无效的请求数据";
}
?>

场景2：从API获取JSON数据并处理

使用cURL扩展从外部API获取JSON响应,然后解析。

<?php
// 示例：获取一个公开的API（注意：实际使用时需替换为真实API地址和错误处理）
$apiUrl = "https://api.example.com/data";
$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Accept: application/json']);
$response = curl_exec($ch);
curl_close($ch);
if ($response !== false) {
    $apiData = json_decode($response, true);
    if ($apiData !== null) {
        echo "API调用成功！数据: ";
        print_r($apiData);
    } else {
        echo "API响应解析失败: " . json_last_error_msg();
    }
} else {
    echo "API请求失败";
}
?>

场景3：将PHP数据以JSON格式返回给前端

PHP处理完数据后，使用json_encode()将结果转换为JSON字符串，并设置正确的Content-Type头。

<?php
header('Content-Type: application/json; charset=utf-8');
$result = [
    'status' => 'success',
    'message' => '数据获取成功',
    'data' => [
        'users' => [
            ['id' => 1, 'name' => '张三'],
            ['id' => 2, 'name' => '李四']
        ]
    ]
];
echo json_encode($result, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
?>

输出：

{
    "status": "success",
    "message": "数据获取成功",
    "data": {
        "users": [
            {
                "id": 1,
                "name": "张三"
            },
            {
                "id": 2,
                "name": "李四"
            }
        ]
    }
}

JSON在PHP中的调用主要依赖于两个核心函数：json_encode()和json_decode()。