calendarific/php-calendarific

PHP library for Calendarific.com

2.0.0 2019-05-30 18:10 UTC

Requires

• php: >=7.0.0
• jedkirby/json: 0.1.0

Requires (Dev)

• phpunit/phpunit: ^6.5

MIT

• Calendarific Team

• date
• calendar
• holiday
• holidays
• calendarindex
• calendarific

README

Calendarific

Official PHP library for the Calendarific API.

Installation

This package can be installed via Composer:

$ composer require calendarific/php-calendarific

It requires PHP >= 7.0.0.

Usage

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(
    $key,
    $country,
    $year,
    $month,
    $day,
    $location,
    $types
);

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

Testing

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

License

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