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

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

vasar/weather
=============

A weather SDK

0.0.1(7y ago)06MITPHP

Since Jan 27Pushed 7y agoCompare

[ Source](https://github.com/vasarr/weather)[ Packagist](https://packagist.org/packages/vasar/weather)[ RSS](/packages/vasar-weather/feed)WikiDiscussions master Synced 4d ago

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

 Weather
=========

[](#-weather-)

基于 [高德开放平台](https://lbs.amap.com/api/webservice/guide/api/weatherinfo/) 的 PHP 天气信息组件。

[![Build Status](https://camo.githubusercontent.com/29a5aea189701acbcdcd75a00b586f603d14d48a5902fa656752df9b7800113d/68747470733a2f2f7472617669732d63692e6f72672f7661736172722f776561746865722e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/vasarr/weather)[![StyleCI](https://camo.githubusercontent.com/75a0a27a273465d75a881915e64d2317eb81502fd34b4ef58d065405264bc1ae/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3136373832383934332f736869656c643f6272616e63683d6d6173746572)](https://github.styleci.io/repos/167828943)

```
$ composer require vasar/weather -vvv
```

配置
--

[](#配置)

在使用本扩展之前，你需要去 [高德开放平台](https://lbs.amap.com/dev/key/app) 注册账号，然后创建应用，获取应用的 API Key。

使用
--

[](#使用)

```
use Vasar\Weather\Weather;

$key = 'xxxxxxxxxxxxxxxxxxxxxxxx';

$w = new Weather($key);

```

获取实时天气
------

[](#获取实时天气)

```
$response = $w->getLiveWeather('深圳');

```

获取近期的天气预报
---------

[](#获取近期的天气预报)

```
$response = $w->getForecastWeather('深圳');

```

获取 XML 格式返回值
------------

[](#获取-xml-格式返回值)

```
$w->getWeather('深圳', 'base', 'XML');

```

参数说明
----

[](#参数说明)

`array | string getWeather($city, $type='base', $format = 'json')`

- $city - 城市名，比如：“深圳”；
- $type - 返回内容类型：base: 返回实况天气 / all:返回预报天气；
- $format - 输出的数据格式，默认为 json 格式，当 output 设置为 “xml” 时，输出的为 XML 格式的数据。

`array | string getLiveWeather($city, $format = 'json')`

`array | string getForecastWeather($city, $format = 'json'))`

- $city - 城市名，比如：“深圳”；
- $format - 输出的数据格式，默认为 json 格式，当 output 设置为 “xml” 时，输出的为 XML 格式的数据。

在 Laravel 中使用
-------------

[](#在-laravel-中使用)

在 Laravel 中使用也是同样的安装方式，配置写在 `config/services.php` 中：

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

```

然后在 `.env` 中配置 `WEATHER_API_KEY` ：

```
WEATHER_API_KEY=xxxxxxxxxxxxxxxxxxxxx

```

可以用两种方式来获取 Vasar\\Weather\\Weather 实例：

#### 方法参数注入

[](#方法参数注入)

```
public function show(Request $request, Weather $weather, $city)
{
    return $weather->getWeather($city);
}

```

#### 服务名访问

[](#服务名访问)

```
public function show(Request $request, $city)
{
    return app('weather')->getWeather($city);
}

```

参考
--

[](#参考)

- [高德开放平台天气接口](https://lbs.amap.com/api/webservice/guide/api/weatherinfo/)

License
-------

[](#license)

MIT

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

2665d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/80739f6fb4d2eb0a18689ef370557e283473b8348e4c746c9f2263949c03a4fe?d=identicon)[vasar](/maintainers/vasar)

---

Top Contributors

[![vasarr](https://avatars.githubusercontent.com/u/46552289?v=4)](https://github.com/vasarr "vasarr (13 commits)")

### Embed Badge

![Health badge](/badges/vasar-weather/health.svg)

```
[![Health](https://phpackages.com/badges/vasar-weather/health.svg)](https://phpackages.com/packages/vasar-weather)
```

###  Alternatives

[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)