Download the PHP package office360/weather-crawler without Composer

office360/weather-crawler

一个PHP天气数据获取工具，用于学习和研究目的获取天气相关信息。

重要声明

⚠️ 法律风险提示

1. 本工具仅供学习和研究使用，不得用于任何商业用途。
2. 本工具获取的天气数据来源于第三方网站，数据版权归原网站所有。
3. 使用本工具时，请严格遵守相关网站的使用条款、robots协议以及中国法律法规。
4. 本工具不保证数据的准确性、完整性和时效性，使用数据时请自行验证。
5. 使用者应自行承担因使用本工具而产生的所有法律责任和风险。
6. 请勿使用本工具进行过于频繁的请求，以免对目标网站造成不必要的负担。

免责声明

本工具的开发和发布仅出于技术研究和学习目的。对于因使用本工具而导致的任何直接或间接损失，包括但不限于数据丢失、系统损坏、法律纠纷等，作者不承担任何责任。

使用者应在遵守相关法律法规的前提下使用本工具，并自行评估和承担所有风险。

功能特性

• 基于ip2region的访客IP定位：完全本地化的IP地址定位，无需依赖外部API
• 自动获取天气数据：根据访客所在城市自动获取天气数据
• 灵活的城市ID获取方式：支持三种方式获取城市ID：
  • 通过城市名称获取城市ID
  • 通过经纬度坐标获取城市ID
  • 通过IP地址获取城市ID
• 提供六种天气数据获取方式：
  • 当天基础天气数据
  • 当天详细天气数据
  • 7日天气预报
  • 逐小时天气预报（默认24小时，可自定义条数）
  • 15日天气预报
  • 综合天气数据（同时获取详细、7天、逐小时和15天数据）
• 支持PS-4自动加载：符合现代PHP开发标准
• 完善的错误处理机制：确保应用稳定运行
• 可更新的IP数据库：支持定期更新ip2region数据库以提高定位准确性

安装

方法一：使用Composer安装（推荐）

方法二：从GitHub仓库安装开发版本

如果遇到网络问题，可以在composer.json中手动添加仓库配置：

然后运行：

快速开始

创建一个简单的PHP文件来测试天气爬虫：

使用流式接口获取天气数据（推荐）

通过城市名称获取天气数据

通过经纬度获取天气数据

通过IP地址获取天气数据

运行上面的代码，您将看到对应城市的天气数据。

使用方法

基本用法（自动定位）

根据城市代码直接获取天气数据

根据城市名称获取天气数据

手动指定IP地址获取天气数据

获取综合天气数据

API参考

WeatherCrawler类

工厂方法

create()

创建WeatherCrawler实例的静态工厂方法。

返回值：

• WeatherCrawler：WeatherCrawler实例

流式接口方法

forCity(string $cityName)

通过城市名称设置城市代码。

参数：

• $cityName：城市名称（如"北京"、"上海"）

返回值：

• WeatherCrawler：返回当前实例，用于方法链式调用

forCoordinates(float $latitude, float $longitude)

通过经纬度坐标设置城市代码。

参数：

• $latitude：纬度（如北京的纬度39.9042）
• $longitude：经度（如北京的经度116.4074）

返回值：

• WeatherCrawler：返回当前实例，用于方法链式调用

forIp(?string $clientIp)

通过IP地址设置城市代码。

参数：

• $clientIp：访客IP地址（可选，不提供则自动获取）

返回值：

• WeatherCrawler：返回当前实例，用于方法链式调用

forCurrentLocation()

通过当前访问者IP地址自动设置城市代码。

返回值：

• WeatherCrawler：返回当前实例，用于方法链式调用

forCityCode(string $cityCode)

直接设置城市代码。

参数：

• $cityCode：城市代码（如"101010100"）

返回值：

• WeatherCrawler：返回当前实例，用于方法链式调用

getWeather(string $type = 'comprehensive', int $hourlyLimit = 24)

获取指定类型的天气数据。

参数：

• $type：天气数据类型（可选，默认为'comprehensive'）
  • 'basic'：当天基础天气数据
  • 'detail'：当天详细天气数据
  • '7day'：7日天气预报
  • 'hourly'：逐小时天气预报
  • '15day'：15日天气预报
  • 'comprehensive'：综合天气数据（同时获取详细、7天、逐小时和15天数据）
• $hourlyLimit：逐小时天气预报的返回条数限制（仅当$type为'hourly'或'comprehensive'时有效，默认24条）

返回值：

• array：天气数据数组，格式根据$type参数而定

获取城市ID的方法

getCityCodeByName(string $cityName)

通过城市名称获取城市代码。

参数：

• $cityName：城市名称（如"北京"、"上海"）

返回值：

• string：城市代码（如"101010100"）

getCityCodeByCoordinates(float $latitude, float $longitude)

通过经纬度坐标获取城市代码。

参数：

• $latitude：纬度（如北京的纬度39.9042）
• $longitude：经度（如北京的经度116.4074）

返回值：

• string：城市代码（如"101010100"）

getCityCodeByIp(?string $clientIp)

通过IP地址获取城市代码。

参数：

• $clientIp：访客IP地址（可选，不提供则自动获取）

返回值：

• string：城市代码（如"101010100"）

getVisitorData(?string $clientIp)

获取访客的IP、所在城市、区域等信息。

参数：

• $clientIp：访客IP地址（可选，不提供则自动获取）

返回值：

获取天气数据的方法

getCurrentWeather(string $cityCode)

获取当前天气数据（包含基础和详细数据）。

参数：

• $cityCode：城市代码（必需）

返回值：

get7DayWeather(string $cityCode)

获取7日天气预报。

参数：

• $cityCode：城市代码（必需）

返回值：

get15DayWeather(string $cityCode)

获取15日天气预报。

参数：

• $cityCode：城市代码（必需）

返回值：

getHourlyWeather(string $cityCode, int $limit = 24)

获取逐小时天气预报。

参数：

• $cityCode：城市代码（必需）
• $limit：返回条目数量限制（可选，默认24条）

返回值：

getAllWeather(string $cityCode)

获取综合天气数据，包含当前天气、15日预报和逐小时预报。

参数：

• $cityCode：城市代码（必需）

返回值：

getCityCodeMap()

获取城市代码映射表。

返回值：

• array：城市代码映射表，格式为 ['城市名称' => '城市代码']

注意事项

1. 本工具依赖于第三方数据源的结构和接口，若数据源结构发生变化，可能导致数据获取失败。
2. 使用前请务必阅读并遵守相关数据源的使用条款、robots协议以及中国法律法规。
3. 请合理控制请求频率，避免对数据源造成不必要的负担，建议在生产环境中添加缓存机制。
4. 本工具获取的数据仅供参考，请勿用于任何关键决策或商业用途。
5. 请确保您的使用行为符合相关法律法规，包括但不限于《中华人民共和国网络安全法》、《中华人民共和国著作权法》等。
6. 若您不确定使用本工具是否合法，请咨询专业法律意见。

开发

运行测试

许可证

MIT License