手把手教你用PHP调用天气API，轻松显示天气数据

还在为网站或小程序添加天气功能发愁？本文以“PHP调用天气API教程：手把手教你显示天气数据”为题，手把手教你使用PHP调用天气API，轻松实现天气数据显示。文章详细讲解了如何选择合适的API接口（如和风天气、心知天气、OpenWeatherMap），获取API Key，并通过`file_get_contents()`或`cURL`发起HTTP请求。同时，重点介绍了如何使用`json_decode()`解析JSON格式的返回数据，提取温度、湿度、风速、天气图标等关键信息，并展示了处理API异常的实用技巧。通过本文，你将掌握PHP调用天气API的核心步骤，为你的项目增添实用且美观的天气功能，显著提升用户体验。

要实现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。现在网上有不少免费接口可以使用，比如：

• 和风天气
• 心知天气
• OpenWeatherMap

这些平台通常都提供 JSON 格式的数据返回，方便 PHP 解析。注册账号之后，一般会给你一个 API Key，这个 Key 是调用接口时必须带上的参数。

举个例子：
假设你注册了 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 编号去官网找对应的图片链接，比如：

<img src="http://openweathermap.org/img/w/{$icon}.png" alt="天气图标">

这样页面上就不仅能看文字，还能看到天气小图标，用户体验更好一点。

基本上就这些。调用天气接口看起来复杂，其实就是选好 API、构造好请求、处理好数据。别怕出错，多试几次就知道哪容易坑人了。

终于介绍完啦！小伙伴们，这篇关于《手把手教你用PHP调用天气API，轻松显示天气数据》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！