PHP 7, PSR-6,17,18, UVIndex Improvements
Version 3 comes with a few bug fixes and new and removed features.
- [Breaking]: The minimum required PHP version is now PHP 7.0
- [Breaking]: Support for the Weather History API has been removed. It is unfortunately not possible for me to test the integration, because it requires a paid API key.
- [Breaking]: Caching OWM responses no longer uses a custom cache implementation (
Cmfcmf\OpenWeatherMap\AbstractCache) but instead PSR-6 compatible caches. - [Breaking]: Custom
Cmfcmf\OpenWeatherMap\Fetcher\FetcherInterfaceclasses dropped in favor of PSR-18 compatible HTTP clients. You now need to pass a PSR-18 compatible HTTP client as well as a PSR-17 compatible HTTP request factory to theOpenWeatherMapconstructor. You will need to choose and install two additional dependencies separately:
Example for Guzzle (php-http/guzzle6-adapter, http-interop/http-factory-guzzle):
use Http\Factory\Guzzle\RequestFactory;
use Http\Adapter\Guzzle6\Client as GuzzleAdapter;
$httpRequestFactory = new RequestFactory();
$httpClient = GuzzleAdapter::createWithConfig([]);
$owm = new OpenWeatherMap($myApiKey, $httpClient, $httpRequestFactory);- [Breaking]: Removal of long-deprecated
getRawData()method. UsegetRawWeatherDatainstead. - [Breaking]: The units for temperatures previously were
K,°CandF. Now they areK,°Cand°F. - [Breaking]: The UV index API has been expanded to support historic uv index data and forecast UV index data:
getCurrentUVIndex,getForecastUVIndexandgetHistoricUVIndex(thanks to @roelvanhintum). ext-json,ext-libxmlandext-simplexmlhave always been implicitly required, but are now explicitly required incomposer.json(thanks to @gloomy).