PHPackages                             calendarific/php-calendarific - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. calendarific/php-calendarific

ActiveLibrary[Utility & Helpers](/categories/utility)

calendarific/php-calendarific
=============================

PHP library for Calendarific.com

2.0.0(6y ago)1245.4k—5.3%[1 issues](https://github.com/calendarific/php-calendarific/issues)MITPHPPHP >=7.0.0CI failing

Since Feb 10Pushed 6y agoCompare

[ Source](https://github.com/calendarific/php-calendarific)[ Packagist](https://packagist.org/packages/calendarific/php-calendarific)[ Docs](https://calendarific.com)[ RSS](/packages/calendarific-php-calendarific/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (2)Versions (3)Used By (0)

[![CircleCI](https://camo.githubusercontent.com/786859d9948e57839e894e2121fa094df81e5659da7368a75f1ea3ba1e2e2422/68747470733a2f2f636972636c6563692e636f6d2f67682f63616c656e646172696669632f7068702d63616c656e646172696669632e7376673f7374796c653d737667)](https://circleci.com/gh/calendarific/php-calendarific)

Calendarific
------------

[](#calendarific)

Official PHP library for the [Calendarific API](https://calendarific.com).

Installation
------------

[](#installation)

This package can be installed via [Composer](https://getcomposer.org):

```
$ composer require calendarific/php-calendarific
```

It requires **PHP >= 7.0.0**.

Usage
-----

[](#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:

ParameterTypeRequiredDescription`$key``string`YesAPI Key from [My Account](https://calendarific.com/account)`$country``string`YesCountry, as listed from `ISO 3166-1 alpha-2``$year``int`YesFour digit year representation, i.e. `2019``$month``int` or `null`NoSingle digit month representation, i.e. `1``$location``string` or `null`NoLocation within above Country, as listed from `ISO 3166-1 alpha-2``$types``array`NoArray of types to filter using. An empty array will show all typesTesting
-------

[](#testing)

Unit tests can be run within the package, however, it utilises [Docker](https://www.docker.com/community-edition) & [Docker Compose](https://docs.docker.com/compose/install):

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

License
-------

[](#license)

**calendarific/calendarific** is licensed under the MIT license. See the [LICENSE](LICENSE) file for more details.

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity35

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 61.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~108 days

Total

2

Last Release

2545d ago

Major Versions

1.0.0 → 2.0.02019-05-30

PHP version history (2 changes)1.0.0PHP >=5.3.0

2.0.0PHP >=7.0.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/19a2b5d0dea24e7dad6e2a1d5b9deff896c87a1f6d073b9feafe23efffc26859?d=identicon)[ryan-cal](/maintainers/ryan-cal)

---

Top Contributors

[![jedkirby](https://avatars.githubusercontent.com/u/1528691?v=4)](https://github.com/jedkirby "jedkirby (8 commits)")[![ryan-cal](https://avatars.githubusercontent.com/u/47374423?v=4)](https://github.com/ryan-cal "ryan-cal (5 commits)")

---

Tags

datecalendarholidayholidayscalendarindexcalendarific

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/calendarific-php-calendarific/health.svg)

```
[![Health](https://phpackages.com/badges/calendarific-php-calendarific/health.svg)](https://phpackages.com/packages/calendarific-php-calendarific)
```

###  Alternatives

[azuyalabs/yasumi

The easy PHP Library for calculating holidays

1.1k11.4M26](/packages/azuyalabs-yasumi)[league/period

Time range API for PHP

7335.4M21](/packages/league-period)[aeon-php/calendar

PHP type safe, immutable calendar library

2079.7M16](/packages/aeon-php-calendar)[yohang/calendr

Object Oriented calendar management

465614.1k3](/packages/yohang-calendr)[umulmrum/holiday

A PHP library to compute holidays. It's something :-)

92342.6k1](/packages/umulmrum-holiday)[holidayapi/holidayapi-php

Official PHP library for Holiday API

35213.3k1](/packages/holidayapi-holidayapi-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)