PHP - JSON：初學者的全面指南

您好，有抱負的程序员們！我很興奮能帶領你們踏上一段令人著迷的PHP和JSON之旅。作為一個教學電腦科學超過十年的老師，我可以向您保證，掌握這些概念將會非常有益。那麼，我們一起來深入探究吧！

PHP - JSON

什麼是JSON？

JSON（JavaScript對象表示法）是一種輕量級數據交換格式。把它當作一種不同編程語言之間可以用來互相通信的通用語言。它就像是編程世界的世界語！

為什麼使用JSON？

由於其簡單性和可讀性，JSON變得非常受歡迎。對於人類來說，它容易閱讀和編寫，對於機器來說，它容易解析和生成。這使得它在服務器和網絡應用程序之間存儲和交換數據時變得非常完美。

PHP和JSON：天作之合

我們可靠的服務器端腚本語言PHP對JSON有出色的內置支持。這意味著我們可以在PHP應用程序中輕鬆地使用JSON數據。讓我們看看PHP提供的一些關鍵函數，以處理JSON。

PHP中的JSON函數

這裡是PHP中主要的JSON函數表格：

函數	描述
json_encode()	將PHP值轉換為JSON表示形式
json_decode()	解析JSON字符串
json_last_error()	返回發生的最後一個錯誤
json_last_error_msg()	返回最後一次json_encode()或json_decode()調用的錯誤字符串

現在，讓我們詳細探討這些函數。

json_encode()：從PHP到JSON

json_encode()函數就像一個翻譯器，將PHP數據轉換為JSON格式。讓我們看看它是如何工作的：

<?php
$student = array(
"name" => "Alice",
"age" => 22,
"courses" => array("PHP", "JavaScript", "Python")
);

$json_student = json_encode($student);
echo $json_student;
?>

這將輸出：

{"name":"Alice","age":22,"courses":["PHP","JavaScript","Python"]}

在這個例子中，我們將一個PHP關聯數組轉換為一個JSON字符串。注意PHP數組的結構是如何在JSON輸出中保留的。

json_decode()：從JSON到PHP

現在，讓我們學習相反的過程。json_decode()函數將JSON數據轉換回PHP。它就像我們的翻譯器在反方向工作：

<?php
$json_string = '{"name":"Bob","age":25,"courses":["Java","C++","Ruby"]}';

$php_object = json_decode($json_string);
$php_array = json_decode($json_string, true);

echo $php_object->name; // 輸出：Bob
echo $php_array['name']; // 也輸出：Bob
?>

在這個例子中，我們將一個JSON字符串轉換為PHP對象和PHP關聯數組。json_decode()的第二个參數決定了我們得到的是對象（false或省略）還是數組（true）。

使用json_last_error()和json_last_error_msg()處理錯誤

有時候，事情可能不會按照計劃進行。也許JSON字符串格式不當，或者存在編碼問題。這時json_last_error()和json_last_error_msg()就派上用場了：

<?php
$invalid_json = '{"name":"Charlie","age":30,}'; // 注意多餘的逗號

$result = json_decode($invalid_json);

if (json_last_error() !== JSON_ERROR_NONE) {
echo "哎呀！JSON錯誤：" . json_last_error_msg();
} else {
echo "JSON成功解析！";
}
?>

這段腚本將輸出："哎呀！JSON錯誤：語法錯誤"

這些函數就像你友好鄰居的錯誤偵探，總是準備告訴你JSON操作中出了什麼問題。

實際範例：使用JSON API

現在，我們已經介紹了基礎知識，讓我們用一個真實世界的例子來應用我們的知識。我們將創建一個簡單的腚本，從公共JSON API中獲取數據並顯示它：

<?php
// 從公共API獲取數據
$json_data = file_get_contents('https://api.publicapis.org/entries');

// 解析JSON數據
$api_data = json_decode($json_data, true);

// 檢查錯誤
if (json_last_error() !== JSON_ERROR_NONE) {
die("JSON解析失敗：" . json_last_error_msg());
}

// 顯示數據
echo "<h2>隨機公共API：</h2>";
echo "<ul>";
foreach ($api_data['entries'] as $entry) {
echo "<li>{$entry['API']} - {$entry['Description']}</li>";
}
echo "</ul>";
?>

這段腚本從一個提供其他API信息的公共API中獲取數據。然後它解析JSON回應並顯示API名稱和描述的列表。

結論

恭喜你！你剛剛踏入了PHP和JSON的世界。我們介紹了JSON的基本知識，學習了PHP的JSON函數，甚至使用公共API創建了一個真實世界的範例。

記住，熟練需要練習。試著玩轉這些函數，創建自己的JSON字符串，並嘗試不同的數據結構。在你意識到之前，你將會成為一名PHP-JSON大師！

當我們結束時，我想起了一句偉大的計算機科學家Grace Hopper的名言："語言中最破壞性的短語是'我們一直都是這樣做的。'" 所以請繼續探索，繼續學習，並在你們的編程旅程中不要害怕嘗試新事物。

祝編程愉快，未來的開發者們！

Credits: Image by storyset