PHPackages                             zhaiyuxin/weather - 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. zhaiyuxin/weather

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

zhaiyuxin/weather
=================

v1.0.0(8mo ago)00MITPHPCI passing

Since Aug 16Pushed 6mo agoCompare

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

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

Weather - 高德天气 API 组件
=====================

[](#weather---高德天气-api-组件)

[![Latest Version on Packagist](https://camo.githubusercontent.com/d58658549b81de85f1b1c9d9e37690ebed38e546da716f517c04ffa057b78206/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7a686169797578696e2f776561746865723f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/zhaiyuxin/weather)[![Total Downloads on Packagist](https://camo.githubusercontent.com/81d8b7712fcfbc265f9d75413c45f124942bf66748334ecd02cdc0de6a4d2323/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7a686169797578696e2f776561746865723f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/zhaiyuxin/weather)[![Software License](https://camo.githubusercontent.com/9897f4467850972a38c7db9a4d38280b8fcdac0ada00e9c8c0a72ecfa8551653/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666f722d7468652d6261646765)](LICENSE)[![Build Status](https://camo.githubusercontent.com/438cd73fae4744eb8f64fd5a122de25d52672ee243e6899b988cf88e3ea5cb47/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f7a686169797578696e3130332f776561746865722f74657374732e796d6c3f7374796c653d666f722d7468652d6261646765)](https://github.com/zhaiyuxin103/weather/actions)[![Code Coverage](https://camo.githubusercontent.com/75743c16f3b11663b56f1a79817c21f5bf169c05a56a4c8b37f3df9ec610c47f/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f6769746875622f7a686169797578696e3130332f776561746865723f7374796c653d666f722d7468652d6261646765)](https://codecov.io/gh/zhaiyuxin103/weather)

一个基于高德开放平台 API 的 PHP 天气信息组件，支持 Laravel 框架，提供简单易用的天气查询功能。

---

✨ 特性
----

[](#-特性)

- 🌤️ 支持实时天气查询
- 🏙️ 支持全国城市天气信息
- 📱 完美集成 Laravel 框架
- 🔧 支持 JSON 和 XML 响应格式
- 🚀 基于 Guzzle HTTP 客户端
- 🧪 完整的测试覆盖
- 📚 详细的文档和示例

📋 系统要求
------

[](#-系统要求)

- PHP >= 8.0
- Laravel >= 10.0
- Composer

🚀 安装
----

[](#-安装)

### 通过 Composer 安装

[](#通过-composer-安装)

```
composer require zhaiyuxin/weather
```

⚙️ 配置
-----

[](#️-配置)

### 1. 获取高德开放平台 API Key

[](#1-获取高德开放平台-api-key)

首先，你需要在 [高德开放平台](https://lbs.amap.com/) 注册账号并创建应用，获取 API Key。

### 2. 环境变量配置

[](#2-环境变量配置)

在 `.env` 文件中添加：

```
WEATHER_API_KEY=your_amap_api_key_here
```

### 3. 配置文件

[](#3-配置文件)

配置文件位于 `config/services.php`：

```
'weather' => [
    'key' => env('WEATHER_API_KEY'),
],
```

📖 使用方法
------

[](#-使用方法)

### 基本用法

[](#基本用法)

#### 1. 直接实例化

[](#1-直接实例化)

```