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

Fund package maintenance!
Ko Fi

Installs: 1 119 469

Dependents: 13

Suggesters: 0

Security: 0

Stars: 327

Watchers: 24

Forks: 120

v3.3.2 2022-02-19 15:37 UTC


A PHP 7.1+ (including PHP 8) API to retrieve and parse global weather data from 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 Build Status license release codecov Scrutinizer Quality Score


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


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.


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


You can use Vagrant to kick-start your development. Simply run vagrant up and vagrant ssh to start a PHP VM with all dependencies included.


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


The documentation is built using Docusaurus v2. To run a local developnment server for the docs, execute

cd docs
yarn install
yarn start


This project is licensed under the MIT license. Please see the LICENSE file 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: