programmatordev / openweathermap-php-api
OpenWeatherMap PHP library that provides convenient access to the OpenWeatherMap API
Requires
- php: >=8.1
- php-http/cache-plugin: ^1.8
- php-http/client-common: ^2.7
- php-http/discovery: ^1.18
- php-http/logger-plugin: ^1.3
- programmatordev/yet-another-php-validator: ^0.5
- psr/cache: ^2.0 || ^3.0
- psr/http-client: ^1.0
- psr/http-factory: ^1.0
- psr/log: ^2.0 || ^3.0
- symfony/options-resolver: ^6.3
Requires (Dev)
- monolog/monolog: ^3.4
- nyholm/psr7: ^1.8
- php-http/mock-client: ^1.6
- phpunit/phpunit: ^10.0
- symfony/cache: ^6.3
- symfony/http-client: ^6.3
- symfony/var-dumper: ^6.3
Provides
README
OpenWeatherMap PHP library that provides convenient access to the OpenWeatherMap API.
Supports PSR-18 HTTP clients, PSR-17 HTTP factories, PSR-6 caches and PSR-3 logs.
Requirements
- PHP 8.1 or higher.
API Key
A key is required to be able to make requests to the API. You must sign up for an OpenWeatherMap account to get one.
Installation
You can install the library via Composer:
composer require programmatordev/openweathermap-php-api
To use the library, use Composer's autoload:
require_once 'vendor/autoload.php';
Basic Usage
Simple usage looks like:
use ProgrammatorDev\OpenWeatherMap\Config; use ProgrammatorDev\OpenWeatherMap\OpenWeatherMap; // Initialize $openWeatherMap = new OpenWeatherMap( new Config([ 'applicationKey' => 'yourappkey' ]) ); // Get current weather by coordinate (latitude, longitude) $currentWeather = $openWeatherMap->weather()->getCurrent(50, 50); // Show current temperature echo $currentWeather->getTemperature();
Documentation
Contributing
Any form of contribution to improve this library (including requests) will be welcome and appreciated. Make sure to open a pull request or issue.
License
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.