programmatordev/openweathermap-php-api

OpenWeatherMap PHP library that provides convenient access to the OpenWeatherMap API

v2.0.0 2024-05-14 10:29 UTC

Requires

• php: >=8.1
• myclabs/deep-copy: ^1.11
• programmatordev/php-api-sdk: ^0.2.0
• programmatordev/yet-another-php-validator: ^1.1

Requires (Dev)

• monolog/monolog: ^3.6
• nyholm/psr7: ^1.8
• php-http/mock-client: ^1.6
• phpunit/phpunit: ^10.5
• symfony/cache: ^6.4
• symfony/http-client: ^6.4
• symfony/var-dumper: ^6.4

Provides

• psr/http-client-implementation: 1.0
• psr/http-factory-implementation: 1.0

MIT

• André Pimpão

• php
• api
• sdk
• psr-3
• OpenWeatherMap
• psr-6
• psr-17
• psr-18
• php8

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

Install the library via Composer:

composer require programmatordev/openweathermap-php-api

Basic Usage

Simple usage looks like:

use ProgrammatorDev\OpenWeatherMap\OpenWeatherMap;

// initialize
$api = new OpenWeatherMap('yourapikey');

// get current weather by coordinate (latitude, longitude)
$weather = $api->weather()->getCurrent(50, 50);
// show current temperature
echo $weather->getTemperature();

Documentation

• Usage
• Configuration
• Supported APIs
• Error Handling
• Entities

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.