本教程详细讲解如何在 php 文件间高效且规范地传输数组数据，特别是以 json 格式进行传输。内容涵盖将 php 数组序列化为 json 字符串 (`json_encode`)、通过 http 响应 (`echo` 配合 `content-type` 头) 或直接文件写入 (`file_put_contents`) 进行数据发送，以及在接收端解析 json 数据 (`json_decode`) 的方法，并提供相关示例代码和注意事项。
在现代 Web 开发中，不同 PHP 文件或模块之间的数据交换是常见需求。为了确保数据结构清晰、易于解析和跨平台兼容，JSON (Javascript Object Notation) 成为了一种非常流行的选择。本教程将深入探讨如何将 PHP 数组转换为 JSON 格式，并通过两种主要方法在 PHP 文件间进行传输。
1. PHP 数组到 JSON 字符串的转换
在 PHP 中，将关联数组或索引数组转换为 JSON 字符串的核心函数是 json_encode()。这个函数能够将复杂的 PHP 数据结构（如数组、对象）序列化成符合 JSON 规范的字符串。
示例：PHP 数组到 JSON 字符串
假设我们有一个包含用户信息的 PHP 数组，希望将其转换为 JSON 格式：
立即学习“PHP免费学习笔记（深入）”；
<?php// 原始的 PHP 数组$userData = array( array("First_Name" => "jacob", "Last_Name" => "caliph"), array("First_Name" => "joseph", "Last_Name" => "jones"), array("First_Name" => "Emily", "Last_Name" => "Joe"));// 使用 json_encode() 将 PHP 数组转换为 JSON 字符串$jsonString = json_encode($userData);// 输出 JSON 字符串echo $jsonString;// 预期输出: [{"First_Name":"jacob","Last_Name":"caliph"},{"First_Name":"joseph","Last_Name":"jones"},{"First_Name":"Emily":"Joe"}]?>登录后复制json_encode() 函数的第二个参数可以接受一些选项，例如 JSON_PRETTY_PRINT 用于格式化输出，使其更具可读性（不建议用于生产环境的数据传输，但对于调试很有用）。
2. 通过 HTTP 协议传输 JSON 数据
这是最常见的 PHP 文件间（通常是服务器-客户端或 API 调用）传输数据的方式。一个 PHP 文件作为数据提供者（API 端点），另一个 PHP 文件作为数据消费者。
2.1 数据提供者 (json_server.php)
数据提供者文件负责生成 JSON 响应。这通常涉及设置正确的 HTTP 头，将 PHP 数组编码为 JSON，并将其输出到响应体中。
<?php// json_server.php// 设置 Content-Type 头，告知客户端响应内容是 JSON 格式header("Content-Type: application/json");// 准备要发送的 PHP 数组数据$data = array( array("First_Name" => "jacob", "Last_Name" => "caliph"), array("First_Name" => "joseph", "Last_Name" => "jones"), array("First_Name" => "Emily", "Last_Name" => "Joe"));// 将 PHP 数组编码为 JSON 字符串$jsonOutput = json_encode($data);// 清空输出缓冲区，防止 BOM 或其他意外字符干扰 JSON 输出// ob_clean() 是一个重要的步骤，尤其是在文件开头可能存在 BOM 或其他非预期输出时ob_clean();// 输出 JSON 字符串echo $jsonOutput;// 释放内存（可选，对于小型脚本通常不是必需的，但良好实践）unset($data);// 或者 $data = NULL;exit(); // 确保脚本在此处终止，不再输出其他内容?>登录后复制注意事项：
header("Content-Type: application/json");：这是至关重要的一步，它告诉客户端（如浏览器、另一个 PHP 脚本或移动应用）响应体中的内容是 JSON 格式，以便客户端正确解析。ob_clean();：在 echo JSON 数据之前调用 ob_clean() 是一个好习惯，它可以清除之前可能存在的任何意外输出（例如，文件开头的空格、BOM 字符或错误信息），确保输出的 JSON 字符串是纯净且有效的。exit();：在输出 JSON 后立即终止脚本，可以防止在脚本后面意外输出其他内容，从而破坏 JSON 格式。2.2 数据消费者 (json_client.php)
数据消费者文件通过 HTTP 请求获取 JSON 数据，并将其解析回 PHP 数组。
Find JSON Path online Easily find JSON paths within JSON objects using our intuitive Json Path Finder
30 查看详情 
<?php// json_client.php// 目标 JSON 服务端点的 URL$jsonServerUrl = "http://localhost/your_project_path/json_server.php"; // 请替换为实际路径// 使用 file_get_contents() 发送 GET 请求并获取响应内容// 也可以使用 cURL 库进行更复杂的 HTTP 请求$jsonResponse = file_get_contents($jsonServerUrl);if ($jsonResponse === false) { echo "Error: Could not retrieve data from " . $jsonServerUrl;} else { // 将 JSON 字符串解码回 PHP 数组 // 第二个参数 true 表示将 JSON 对象解码为关联数组，而不是标准对象 $decodedData = json_decode($jsonResponse, true); // 检查 JSON 解码是否成功 if (json_last_error() === JSON_ERROR_NONE) { echo "Successfully received and decoded data:\n"; print_r($decodedData); // 示例：访问数据 echo "\nFirst user's first name: " . $decodedData[0]['First_Name'] . "\n"; } else { echo "Error decoding JSON: " . json_last_error_msg() . "\n"; echo "Raw JSON response: " . $jsonResponse . "\n"; }}?>登录后复制注意事项：
file_get_contents()：对于简单的 GET 请求，这是一个方便的函数。对于需要发送 POST 数据、设置自定义头或处理更复杂情况的请求，推荐使用 PHP 的 cURL 扩展。json_decode($jsonResponse, true);：json_decode() 函数将 JSON 字符串转换回 PHP 数据。第二个参数 true 确保 JSON 对象被解码为 PHP 关联数组，而不是 PHP 对象。json_last_error() 和 json_last_error_msg()：在解码 JSON 后检查这些函数，可以帮助你调试解析错误。3. 直接写入文件系统传输 JSON 数据
如果两个 PHP 文件运行在同一个服务器上，并且你希望直接在文件系统层面进行数据存储和读取，而不是通过 HTTP 请求，可以使用 file_put_contents() 和 file_get_contents()。
3.1 数据写入方 (json_writer.php)
数据写入方将 PHP 数组编码为 JSON 字符串，并将其写入到指定的文件中。
<?php// json_writer.php// 准备要存储的 PHP 数组数据$dataToStore = array( array("First_Name" => "jacob", "Last_Name" => "caliph"), array("First_Name" => "joseph", "Last_Name" => "jones"), array("First_Name" => "Emily", "Last_Name" => "Joe"));// 目标文件路径$targetFilePath = "data/user_data.json"; // 确保 'data' 目录存在且可写// 将 PHP 数组编码为 JSON 字符串$jsonString = json_encode($dataToStore, JSON_PRETTY_PRINT); // 使用 JSON_PRETTY_PRINT 便于查看文件内容if ($jsonString === false) { echo "Error encoding data to JSON: " . json_last_error_msg() . "\n";} else { // 将 JSON 字符串写入文件 // FILE_APPEND 可以用于追加数据，但对于这种结构化数据通常是覆盖 $bytesWritten = file_put_contents($targetFilePath, $jsonString); if ($bytesWritten !== false) { echo "Data successfully written to " . $targetFilePath . " (" . $bytesWritten . " bytes).\n"; } else { echo "Error writing data to file " . $targetFilePath . ".\n"; }}?>登录后复制注意事项：
文件路径：确保目标文件路径是正确的，并且 PHP 脚本对该路径具有写入权限。JSON_PRETTY_PRINT：在写入文件时，使用此选项可以使 JSON 文件内容更易读，尤其是在调试或手动检查文件时。3.2 数据读取方 (json_reader.php)
数据读取方从文件中读取 JSON 字符串，并将其解析回 PHP 数组。
<?php// json_reader.php// 目标文件路径$sourceFilePath = "data/user_data.json"; // 确保路径与写入时一致// 检查文件是否存在if (!file_exists($sourceFilePath)) { echo "Error: File " . $sourceFilePath . " does not exist.\n";} else { // 从文件中读取 JSON 字符串 $jsonFromFile = file_get_contents($sourceFilePath); if ($jsonFromFile === false) { echo "Error: Could not read data from " . $sourceFilePath . ".\n"; } else { // 将 JSON 字符串解码回 PHP 数组 $decodedDataFromFile = json_decode($jsonFromFile, true); // 检查 JSON 解码是否成功 if (json_last_error() === JSON_ERROR_NONE) { echo "Successfully read and decoded data from file:\n"; print_r($decodedDataFromFile); } else { echo "Error decoding JSON from file: " . json_last_error_msg() . "\n"; echo "Raw JSON from file: " . $jsonFromFile . "\n"; } }}?>登录后复制注意事项：
文件权限：确保 PHP 脚本对源文件具有读取权限。错误处理：在读取文件和解码 JSON 后，始终检查返回结果和 json_last_error()，以确保操作成功。4. 总结
在 PHP 文件间传输 JSON 格式的数组数据，主要有两种策略：
通过 HTTP 协议传输： 适用于构建 API、前后端分离或跨服务器通信。发送端设置 Content-Type: application/json 头并 echo JSON 字符串；接收端通过 HTTP 请求获取数据并 json_decode。这种方式灵活且通用性强。直接写入文件系统： 适用于同一服务器上不同脚本间的数据持久化或共享，避免了 HTTP 请求的开销。发送端使用 json_encode 和 file_put_contents 写入文件；接收端使用 file_get_contents 读取文件并 json_decode。无论选择哪种方法，json_encode() 和 json_decode() 都是核心函数，它们确保了 PHP 数组与 JSON 字符串之间的无缝转换。在实际应用中，务必注意错误处理、文件权限和数据验证，以构建健壮可靠的数据交换机制。
以上就是PHP 文件间传输 JSON 数组数据教程的详细内容，更多请关注php中文网其它相关文章！
