PHPackages                             utrodus/malaysia-public-holiday - 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. utrodus/malaysia-public-holiday

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

utrodus/malaysia-public-holiday
===============================

A PHP library to crawl Malaysia public holidays with filtering and caching.

1.0.2(1y ago)099MITPHPPHP >=8.1CI failing

Since Apr 19Pushed 5mo ago1 watchersCompare

[ Source](https://github.com/utrodus/malaysia-public-holiday)[ Packagist](https://packagist.org/packages/utrodus/malaysia-public-holiday)[ RSS](/packages/utrodus-malaysia-public-holiday/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (4)Versions (4)Used By (0)

🇲🇾 Malaysia Public Holiday
==========================

[](#-malaysia-public-holiday)

[![PHP Version](https://camo.githubusercontent.com/1a5e13126d38c1d05f712dae30e7f60ae0444a9c882e9e526349ccba27facb8d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253345253344382e312d626c7565)](https://camo.githubusercontent.com/1a5e13126d38c1d05f712dae30e7f60ae0444a9c882e9e526349ccba27facb8d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253345253344382e312d626c7565)[![Build Status](https://github.com/utrodus/malaysia-public-holiday/actions/workflows/tests.yaml/badge.svg?label=Build+Status)](https://github.com/utrodus/malaysia-public-holiday/actions/workflows/tests.yaml)[![Packagist Stable Version](https://camo.githubusercontent.com/25b8231f53898453e9c1ad164f67950d20eba1ea75c6e8efd1eefbff9b288a7f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7574726f6475732f6d616c61797369612d7075626c69632d686f6c696461792e737667)](https://packagist.org/packages/utrodus/malaysia-public-holiday)

**Malaysia Public Holiday** is a PHP library to fetch **official public holiday data** for all Malaysian states by scraping [Office Holidays](https://www.officeholidays.com/countries/malaysia).

It’s best for HR applications, attendance systems, logistics planning, calendars, and any system that needs accurate holiday information.

---

✨ Features
----------

[](#-features)

- 📆 Get national and regional holidays in Malaysia
- 🌍 Support for all Malaysian states and federal territories
- 📅 Filter holidays by **year**, **month**, or **state**
- 🔁 Supports alias names for states (e.g., `KL`, `Johore`, `Malacca`)
- ⚙️ Easily integrable with any PHP project

---

💼 Use Cases
-----------

[](#-use-cases)

- Employee attendance and HR systems
- Delivery scheduling & logistics
- Custom calendar generation
- Event planning & automation
- Working-day calculations

---

---

🚀 Requirements
--------------

[](#-requirements)

- PHP >= **8.1**
- Composer

---

🛠️ Tech Stack
-------------

[](#️-tech-stack)

ToolPurpose**PHP >= 8.1**Core programming language[Guzzle](https://github.com/guzzle/guzzle)HTTP requests[Symfony BrowserKit](https://symfony.com/doc/current/components/browser_kit.html)Web scraping (HTML crawling)[PHPUnit](https://phpunit.de/)Unit testing[GitHub Actions](https://github.com/features/actions)Continuous integration---

📦 Installation
--------------

[](#-installation)

```
composer require utrodus/malaysia-public-holiday
```

---

⚡ Usage
-------

[](#-usage)

```