要實現php調用天氣api，關鍵在于選擇合適接口、正確發起請求并處理返回數據。1. 首先選擇如和風天氣、心知天氣或openweathermap等提供json格式返回的api，并獲取api key；2. 使用file_get_contents()或cURL發起http請求，注意確保服務器配置允許或合理設置超時等參數；3. 對返回數據進行解析，使用json_decode()轉換為數組后提取所需信息，同時加入錯誤判斷邏輯以應對api異常；4. 展示天氣信息時除溫度外還可利用濕度、風速、天氣圖標等字段提升用戶體驗，通過拼接圖標編號獲取對應圖片鏈接展示天氣狀態。整個過程需注意參數傳遞準確性和異常情況處理。
在做網站或小程序的時候，加個天氣功能挺常見的。PHP 作為后端語言，調用天氣 API 其實不難，但很多人卡在了“怎么選接口”和“怎么解析數據”這一步。其實只要找對 API、傳好參數、處理好返回結果，就能順利顯示天氣信息。
1. 選擇一個合適的天氣 API 接口
調用天氣數據的第一步是找一個靠譜的 API。現在網上有不少免費接口可以使用，比如：
這些平臺通常都提供 JSON 格式的數據返回，方便 PHP 解析。注冊賬號之后，一般會給你一個 API Key，這個 Key 是調用接口時必須帶上的參數。
立即學習“PHP免費學習筆記（深入）”；
舉個例子：
假設你注冊了 OpenWeatherMap，獲取到的 API Key 是 your_api_key，你想查北京的天氣，那請求地址大概是這樣的：
http://api.openweathermap.org/data/2.5/weather?q=Beijing&appid=your_api_key&units=metric
2. 使用 PHP 發起請求并獲取數據
PHP 中發起 HTTP 請求的方式有很多種，最常用的是 file_get_contents() 和 cURL。如果你只是簡單調用一次，用 file_get_contents() 就夠用了。
示例代碼如下：
$city = "Beijing"; $apiKey = "your_api_key"; $url = "http://api.openweathermap.org/data/2.5/weather?q={$city}&appid={$apiKey}&units=metric"; $response = file_get_contents($url); $data = json_decode($response, true); if ($data) { echo "城市：" . $data['name'] . "<br>"; echo "溫度：" . $data['main']['temp'] . " ℃<br>"; echo "天氣：" . $data['weather'][0]['description']; }
注意幾點：
- 要確保服務器開啟了 allow_url_fopen，否則 file_get_contents() 不能直接訪問 URL。
- 如果你更注重性能或需要更多控制（比如設置超時時間），建議用 cURL。
3. 處理錯誤和異常情況
實際使用中，API 并不是每次都返回正常數據。可能遇到的情況包括：
- 城市名寫錯了，返回 404
- API Key 錯誤或者過期
- 請求頻率超過限制
- 網絡問題導致請求失敗
所以建議你在調用時加上簡單的判斷邏輯：
if ($response === false) { echo "請求失敗，請檢查網絡或 API 配置"; } else { $data = json_decode($response, true); if (isset($data['cod']) && $data['cod'] != 200) { echo "天氣查詢失敗：" . $data['message']; } else { // 正常處理數據 } }
4. 顯示天氣信息的小技巧
有時候我們不只是想顯示溫度，還想展示天氣圖標、濕度、風速等信息。這些數據很多 API 都提供了，關鍵是你得知道怎么取。
以 OpenWeatherMap 為例，它的返回結構里有：
- 溫度：$data[‘main’][‘temp’]
- 濕度：$data[‘main’][‘humidity’]
- 風速：$data[‘wind’][‘speed’]
- 天氣描述：$data[‘weather’][0][‘description’]
- 圖標編號：$data[‘weather’][0][‘icon’]
你可以根據 icon 編號去官網找對應的圖片鏈接，比如：
@@##@@
這樣頁面上就不僅能看文字，還能看到天氣小圖標，用戶體驗更好一點。
基本上就這些。調用天氣接口看起來復雜，其實就是選好 API、構造好請求、處理好數據。別怕出錯，多試幾次就知道哪容易坑人了。
