PHP library for

2.0.0 2019-05-30 18:10 UTC

This package is auto-updated.

Last update: 2021-03-27 17:09:18 UTC




Official PHP library for the Calendarific API.


This package can be installed via Composer:

$ composer require calendarific/php-calendarific

It requires PHP >= 7.0.0.


The following guide assumes that you've imported the class Calendarific\Calendarific into your namespace. There's a helper command available which makes querying the API very easy, and is explained below:

$key = 'api-key-123';
$country = 'GB';
$year = 2019;
$month = null;
$day = null,
$location = null,
$types = ['national'];

$dates = Calendarific::make(

The below define's the parameter's for the Calendarific::make() helper command:

Parameter Type Required Description
$key string Yes API Key from My Account
$country string Yes Country, as listed from ISO 3166-1 alpha-2
$year int Yes Four digit year representation, i.e. 2019
$month int or null No Single digit month representation, i.e. 1
$location string or null No Location within above Country, as listed from ISO 3166-1 alpha-2
$types array No Array of types to filter using. An empty array will show all types


Unit tests can be run within the package, however, it utilises Docker & Docker Compose:

$ docker-compose -f ./docker-compose.yml run --rm cli php ./vendor/bin/phpunit


calendarific/calendarific is licensed under the MIT license. See the LICENSE file for more details.