首先注册天气API并获取密钥,然后使用PHP的cURL发送请求获取实时天气数据,接着解析JSON响应提取温度、湿度等信息,最后将功能封装为函数便于复用,注意保护密钥安全并处理请求频率限制。

想在网站或应用中显示实时天气?用PHP调用天气预报API是常见做法。只要几行代码,就能获取城市温度、湿度、风速等信息。下面教你从注册API到解析数据的完整流程,简单易懂,适合新手上手。
选择合适的天气API并获取密钥
市面上有多个提供免费额度的天气API,比如高德地图、和风天气、OpenWeatherMap等。以和风天气(QWeather)为例:
- 注册账号并创建项目
- 获取API Key(通常是一串字母数字)
- 查看文档,找到“实时天气”接口地址,例如:
https://devapi.qweather.com/v7/weather/now?location=101010100&key=你的KEY - 注意:location 是城市编码,可在其官网查询
使用PHP发送HTTP请求获取数据
PHP 中常用 file_get_contents 或 cURL 发起GET请求。以下是使用 cURL 的示例:
$location = '101010100'; // 北京市编码
$key = '你的API密钥';
$url = "https://devapi.qweather.com/v7/weather/now?location={$location}&key={$key}";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 测试环境可关闭SSL验证
$response = curl_exec($ch);
curl_close($ch);
if ($response) {
$data = json_decode($response, true);
// 接下来处理数据
}
解析返回的JSON数据
API 返回的是 JSON 格式数据,需用 json_decode 转为数组。以下是常见字段提取方式:
立即学习“PHP免费学习笔记(深入)”;
if ($data['code'] == '200') {
$now = $data['now'];
echo "天气:" . $now['text'] . "
";
echo "温度:" . $now['temp'] . "℃
";
echo "体感温度:" . $now['feelsLike'] . "℃
";
echo "风向:" . $now['windDir'] . "
";
echo "风力:" . $now['windScale'] . "级
";
echo "湿度:" . $now['humidity'] . "%";
} else {
echo "获取失败,请检查城市编码或密钥";
}
关键点:
- 判断 code 是否为 '200' 表示请求成功
- 注意字段名大小写(如 temp 不是 Temp)
- 多数API对请求频率有限制,避免频繁调用
封装成函数便于复用
把逻辑整理成函数,以后调用更方便:
function getWeather($location, $key) {
$url = "https://devapi.qweather.com/v7/weather/now?location={$location}&key={$key}";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
if ($data['code'] === '200') {
return $data['now'];
}
return false;}
// 使用示例
$weather = getWeather('101010100', '你的KEY');
if ($weather) {
echo "当前天气:{$weather['text']},温度:{$weather['temp']}℃";
}
基本上就这些。只要掌握请求发送和JSON解析,就能轻松集成天气功能。注意保护好你的API密钥,别暴露在前端代码里。调试时打印 response 看结构最有效。不复杂但容易忽略细节。基本上就这些。











