PHPackages                             cmfcmf/openweathermap-php-api - 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. [API Development](/categories/api)
4. /
5. cmfcmf/openweathermap-php-api

ActiveLibrary[API Development](/categories/api)

cmfcmf/openweathermap-php-api
=============================

A PHP API to parse weather data from OpenWeatherMap.org. This wrapper tries to normalise and abstract the data and remove inconsistencies.

v3.4.0(7mo ago)3471.3M↓20.3%121[2 PRs](https://github.com/cmfcmf/OpenWeatherMap-PHP-Api/pulls)7MITPHPPHP &gt;=7.1.0CI passing

Since Jul 21Pushed 7mo ago23 watchersCompare

[ Source](https://github.com/cmfcmf/OpenWeatherMap-PHP-Api)[ Packagist](https://packagist.org/packages/cmfcmf/openweathermap-php-api)[ Docs](https://github.com/cmfcmf/OpenWeatherMap-PHP-API)[ Fund](https://ko-fi.com/cmfcmf)[ RSS](/packages/cmfcmf-openweathermap-php-api/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (7)Versions (36)Used By (7)

OpenWeatherMap PHP API
======================

[](#openweathermap-php-api)

A PHP 7.1+ (including PHP 8) API to retrieve and parse global weather data from [OpenWeatherMap.org](http://www.OpenWeatherMap.org). This project aims to normalise the provided data and remove inconsistencies. It is not maintained by OpenWeatherMap and not an official API wrapper.

[![Gitpod Ready-to-Code](https://camo.githubusercontent.com/ec0084907bd5b3576af415a1e46cae636fbfa04da6bf9db6296eae3057a189f0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f476974706f642d52656164792d2d746f2d2d436f64652d626c75653f6c6f676f3d676974706f64)](https://gitpod.io/#https://github.com/cmfcmf/OpenWeatherMap-PHP-API)[![Build Status](https://github.com/cmfcmf/OpenWeatherMap-PHP-API/actions/workflows/main.yml/badge.svg)](https://github.com/cmfcmf/OpenWeatherMap-PHP-API/actions/workflows/main.yml)[![license](https://camo.githubusercontent.com/22eca1255571c0302fa68d9affbccb45e6da2abe2944190437e2817de64ed53e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f636d66636d662f4f70656e576561746865724d61702d5048502d4170692e737667)](https://github.com/cmfcmf/OpenWeatherMap-PHP-Api/blob/master/LICENSE)[![release](https://camo.githubusercontent.com/0f2c40d615c003d26efa6a70e2dae45412d557ca6478c055a3e2ecf7852bea6f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f636d66636d662f4f70656e576561746865724d61702d5048502d4170692e737667)](https://github.com/cmfcmf/OpenWeatherMap-PHP-Api/releases)[![codecov](https://camo.githubusercontent.com/921913016b986b2af69ab95dd433c51ac66e490ace20b7cd2f800b928048152d/68747470733a2f2f636f6465636f762e696f2f67682f636d66636d662f4f70656e576561746865724d61702d5048502d4170692f6272616e63682f6d61696e2f67726170682f62616467652e737667)](https://codecov.io/gh/cmfcmf/OpenWeatherMap-PHP-Api)[![Scrutinizer Quality Score](https://camo.githubusercontent.com/55f3277579685c8c7e9811802e7524f450f1dd002eece7544c5a433893e84df3/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f636d66636d662f4f70656e576561746865724d61702d5048502d4170692f6261646765732f7175616c6974792d73636f72652e706e673f733d66333163613038616138383936343136636631363234303364333433363266306135646130393636)](https://scrutinizer-ci.com/g/cmfcmf/OpenWeatherMap-PHP-Api/)

Documentation
=============

[](#documentation)

You can find the latest documentation, including installation and usage instructions at .

Contributing
============

[](#contributing)

I'm happy about every **pull request** you open and **issue** you find to help make this API **more awesome**. Please note that it might sometimes take me a while to get back to you. Feel free to ping me if I don't respond.

Gitpod
------

[](#gitpod)

You can use Gitpod to launch a fully functional development environment right in your browser. Simply click on the following badge:

[![Gitpod Ready-to-Code](https://camo.githubusercontent.com/ec0084907bd5b3576af415a1e46cae636fbfa04da6bf9db6296eae3057a189f0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f476974706f642d52656164792d2d746f2d2d436f64652d626c75653f6c6f676f3d676974706f64)](https://gitpod.io/#https://github.com/cmfcmf/OpenWeatherMap-PHP-API)

Vagrant
-------

[](#vagrant)

You can use [Vagrant](https://vagrantup.com) to kick-start your development. Simply run `vagrant up` and `vagrant ssh` to start a PHP VM with all dependencies included.

Docker
------

[](#docker)

You can also use Docker to start developing this library. First install dependencies:

```
docker run --rm --interactive --tty \
    --volume $PWD:/app \
    --user $(id -u):$(id -g) \
    composer update

```

And then execute the tests:

```
docker run --rm --interactive --tty \
    --volume $PWD:/app -w /app \
    php bash

> php vendor/bin/phpunit

```

Documentation
-------------

[](#documentation-1)

The documentation is built using [Docusaurus v2](https://docusaurus.io). To run a local developnment server for the docs, execute

```
cd docs
yarn install
yarn start
```

License
=======

[](#license)

This project is licensed under the MIT license. Please see the [LICENSE file](https://github.com/Cmfcmf/OpenWeatherMap-PHP-Api/blob/master/LICENSE)distributed with this source code for further information regarding copyright and licensing.

Be aware that the OpenWeatherMap data is **not licensed under the MIT**. **Check out the following official links to read about the terms, pricing and license of OpenWeatherMap before using their service:**

- [OpenWeatherMap.org/terms](http://OpenWeatherMap.org/terms)
- [OpenWeatherMap.org/appid](http://OpenWeatherMap.org/appid)

###  Health Score

61

—

FairBetter than 99% of packages

Maintenance64

Regular maintenance activity

Popularity60

Solid adoption and visibility

Community38

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 82.3% 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

Every ~135 days

Recently: every ~469 days

Total

34

Last Release

219d ago

Major Versions

v1.1.0 → v2.0.0-rc12014-01-23

v2.4.0 → v3.0.02019-06-09

PHP version history (3 changes)v1.0.0PHP &gt;=5.3.0

v3.0.0PHP &gt;=7.0.0

v3.4.0PHP &gt;=7.1.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/aee2da246dc3af5a35bba2c5b829ec9752c47e706850dcc770d2c3ee3157ee8e?d=identicon)[cmfcmf](/maintainers/cmfcmf)

---

Top Contributors

[![cmfcmf](https://avatars.githubusercontent.com/u/2145092?v=4)](https://github.com/cmfcmf "cmfcmf (246 commits)")[![peter279k](https://avatars.githubusercontent.com/u/9021747?v=4)](https://github.com/peter279k "peter279k (13 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (12 commits)")[![1franck](https://avatars.githubusercontent.com/u/1209308?v=4)](https://github.com/1franck "1franck (7 commits)")[![goodevilgenius](https://avatars.githubusercontent.com/u/254662?v=4)](https://github.com/goodevilgenius "goodevilgenius (3 commits)")[![pablopereira27](https://avatars.githubusercontent.com/u/11337781?v=4)](https://github.com/pablopereira27 "pablopereira27 (2 commits)")[![emimarz](https://avatars.githubusercontent.com/u/10280713?v=4)](https://github.com/emimarz "emimarz (1 commits)")[![erickskrauch](https://avatars.githubusercontent.com/u/4787256?v=4)](https://github.com/erickskrauch "erickskrauch (1 commits)")[![Erulezz](https://avatars.githubusercontent.com/u/6772197?v=4)](https://github.com/Erulezz "Erulezz (1 commits)")[![GhostPirateBob](https://avatars.githubusercontent.com/u/37704390?v=4)](https://github.com/GhostPirateBob "GhostPirateBob (1 commits)")[![hevertonwinsite](https://avatars.githubusercontent.com/u/125268572?v=4)](https://github.com/hevertonwinsite "hevertonwinsite (1 commits)")[![mikepsinn](https://avatars.githubusercontent.com/u/2808553?v=4)](https://github.com/mikepsinn "mikepsinn (1 commits)")[![peterbulmer](https://avatars.githubusercontent.com/u/159683?v=4)](https://github.com/peterbulmer "peterbulmer (1 commits)")[![robjuz](https://avatars.githubusercontent.com/u/9091024?v=4)](https://github.com/robjuz "robjuz (1 commits)")[![roelvanhintum](https://avatars.githubusercontent.com/u/1023734?v=4)](https://github.com/roelvanhintum "roelvanhintum (1 commits)")[![tardypad](https://avatars.githubusercontent.com/u/6368493?v=4)](https://github.com/tardypad "tardypad (1 commits)")[![TobiAlbert](https://avatars.githubusercontent.com/u/13476980?v=4)](https://github.com/TobiAlbert "TobiAlbert (1 commits)")[![andreaskweber](https://avatars.githubusercontent.com/u/2075176?v=4)](https://github.com/andreaskweber "andreaskweber (1 commits)")[![bitdeli-chef](https://avatars.githubusercontent.com/u/3092978?v=4)](https://github.com/bitdeli-chef "bitdeli-chef (1 commits)")[![ChrisB9](https://avatars.githubusercontent.com/u/7099583?v=4)](https://github.com/ChrisB9 "ChrisB9 (1 commits)")

---

Tags

apifreeopen-apiopenweathermapparse-weather-dataphpphp-apiweatherweather-historyapifreeweatherOpenWeatherMapowm

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/cmfcmf-openweathermap-php-api/health.svg)

```
[![Health](https://phpackages.com/badges/cmfcmf-openweathermap-php-api/health.svg)](https://phpackages.com/packages/cmfcmf-openweathermap-php-api)
```

###  Alternatives

[kreait/firebase-php

Firebase Admin SDK

2.4k39.7M72](/packages/kreait-firebase-php)[kbsali/redmine-api

Redmine API client

4221.1M24](/packages/kbsali-redmine-api)[getbrevo/brevo-php

Official Brevo provided RESTFul API V3 php library

963.1M35](/packages/getbrevo-brevo-php)[php-tmdb/api

PHP wrapper for TMDB (TheMovieDatabase) API v3. Supports two types of approaches, one modelled with repositories, models and factories. And the other by simple array access to RAW data from The Movie Database.

424378.6k16](/packages/php-tmdb-api)[wordpress/php-ai-client

A provider agnostic PHP AI client SDK to communicate with any generative AI models of various capabilities using a uniform API.

26236.6k14](/packages/wordpress-php-ai-client)[wtfzdotnet/php-tmdb-api

PHP wrapper for TMDB (TheMovieDatabase) API v3. Supports two types of approaches, one modelled with repositories, models and factories. And the other by simple array access to RAW data from The Movie Database.

4252.9k](/packages/wtfzdotnet-php-tmdb-api)

PHPackages © 2026

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