PHPackages                             mll-lab/holidays - 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. mll-lab/holidays

Abandoned → [mll-lab/php-utils](/?search=mll-lab%2Fphp-utils)ArchivedLibrary[Utility & Helpers](/categories/utility)

mll-lab/holidays
================

PHP package to evaluate if a day is a holiday

v3.3.0(2y ago)014.9kMITPHPPHP ^7.2 || ^8

Since Oct 6Pushed 2y ago1 watchersCompare

[ Source](https://github.com/mll-lab/holidays)[ Packagist](https://packagist.org/packages/mll-lab/holidays)[ Docs](https://github.com/mll-lab/holidays)[ GitHub Sponsors](https://github.com/mll-lab)[ RSS](/packages/mll-lab-holidays/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (7)Dependencies (13)Versions (8)Used By (0)

Holidays
========

[](#holidays)

Deprecated
----------

[](#deprecated)

This library is deprecated in favor of .

[![Continuous Integration](https://github.com/mll-lab/holidays/workflows/Continuous%20Integration/badge.svg)](https://github.com/mll-lab/holidays/actions)[![Code Coverage](https://camo.githubusercontent.com/8a4271a094425363d2c7144198cef67cea0fbbab4a13300a85b6c8061ca528f0/68747470733a2f2f636f6465636f762e696f2f67682f6d6c6c2d6c61622f686f6c69646179732f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/mll-lab/holidays)[![StyleCI](https://camo.githubusercontent.com/12c4b62fe8be02fed6faa4917f56c922af63e30dccc721393ee3249ecf9b2ee5/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3431343136363532302f736869656c643f6272616e63683d6d6173746572)](https://github.styleci.io/repos/414166520)

[![Latest Stable Version](https://camo.githubusercontent.com/23a9677ab883d9b21b66ea5d5c52d9ae58f3be551549e9658c203c8fa6f18785/68747470733a2f2f706f7365722e707567782e6f72672f6d6c6c2d6c61622f686f6c69646179732f762f737461626c65)](https://packagist.org/packages/mll-lab/holidays)[![Total Downloads](https://camo.githubusercontent.com/1a0e00ed11594402e490e4d5b9dc8906b147771f4b3f1cf6694dc13cac8cd2d7/68747470733a2f2f706f7365722e707567782e6f72672f6d6c6c2d6c61622f686f6c69646179732f646f776e6c6f616473)](https://packagist.org/packages/mll-lab/holidays)

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

[](#installation)

Install through composer

```
composer require mll-lab/holidays
```

Usage
-----

[](#usage)

```
use MLL\Holidays\BavarianHolidays;

// Call static methods on BavarianHolidays
```

### Custom Holidays

[](#custom-holidays)

You can add custom holidays by registering a method that returns a map of holidays for a given year. Set this up in a central place that always runs before your application, e.g. a bootstrap method.

```
use MLL\Holidays\BavarianHolidays;

BavarianHolidays::$loadUserDefinedHolidays = static function (int $year): array {
    switch ($year) {
        case 2019:
            return ['22.03' => 'Day of the Tentacle'];
        default:
            return [];
    }
};
```

Custom holidays have precedence over the holidays inherent to this library.

Changelog
---------

[](#changelog)

See [`CHANGELOG.md`](CHANGELOG.md).

Contributing
------------

[](#contributing)

See [`CONTRIBUTING.md`](.github/CONTRIBUTING.md).

License
-------

[](#license)

This package is licensed using the MIT License.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 56% 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 ~100 days

Recently: every ~149 days

Total

7

Last Release

1076d ago

Major Versions

v1.0.0 → v2.0.02021-10-11

v2.1.0 → v3.0.02021-10-12

PHP version history (2 changes)v1.0.0PHP ^7.4 || ^8

v2.1.0PHP ^7.2 || ^8

### Community

Maintainers

![](https://www.gravatar.com/avatar/2ff5d1af2c0f601f7ed7e75e15be0aa4c062149b57fd5aace4e44cc37b8b7a40?d=identicon)[spawnia](/maintainers/spawnia)

![](https://www.gravatar.com/avatar/8bc431e479f402ddb0f2a7d1a35a2e812ab5565b8f5eb78d5c43263984e1cf3c?d=identicon)[SimBig](/maintainers/SimBig)

---

Top Contributors

[![spawnia](https://avatars.githubusercontent.com/u/12158000?v=4)](https://github.com/spawnia "spawnia (14 commits)")[![simbig](https://avatars.githubusercontent.com/u/26680884?v=4)](https://github.com/simbig "simbig (11 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/mll-lab-holidays/health.svg)

```
[![Health](https://phpackages.com/badges/mll-lab-holidays/health.svg)](https://phpackages.com/packages/mll-lab-holidays)
```

###  Alternatives

[ashallendesign/short-url

A Laravel package for creating shortened URLs for your web apps.

1.4k1.9M4](/packages/ashallendesign-short-url)[laragraph/utils

Utilities for using GraphQL with Laravel

2113.8M7](/packages/laragraph-utils)[intervention/zodiac

Zodiac Sign Calculator

58191.7k](/packages/intervention-zodiac)[erlandmuchasaj/laravel-gzip

Gzip your responses.

40129.3k2](/packages/erlandmuchasaj-laravel-gzip)[solspace/craft-calendar

The most powerful event management and calendaring plugin!

1830.8k1](/packages/solspace-craft-calendar)

PHPackages © 2026

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