PHPackages                             office360/weather-crawler - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. office360/weather-crawler

ActiveLibrary[Utility & Helpers](/categories/utility)

office360/weather-crawler
=========================

A PHP crawler for fetching weather data from China Weather Network

1.3.0(4mo ago)04MITPHPPHP >=7.4

Since Jan 8Pushed 4mo agoCompare

[ Source](https://github.com/office360/weather-crawler)[ Packagist](https://packagist.org/packages/office360/weather-crawler)[ RSS](/packages/office360-weather-crawler/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (3)Used By (0)

office360/weather-crawler
=========================

[](#office360weather-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安装（推荐）

[](#方法一使用composer安装推荐)

```
composer require office360/weather-crawler
```

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

[](#方法二从github仓库安装开发版本)

```
composer require office360/weather-crawler:dev-main
```

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

```
{
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/office360/weather-crawler.git"
        }
    ],
    "require": {
        "office360/weather-crawler": "dev-main"
    }
}
```

然后运行：

```
composer install
```

快速开始
----

[](#快速开始)

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

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

[](#使用流式接口获取天气数据推荐)

```