README

Malaysia Public Holiday is a PHP library to fetch official public holiday data for all Malaysian states by scraping Office Holidays.

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

✨ 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

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

🚀 Requirements

• PHP >= 8.1
• Composer

🛠️ Tech Stack

📦 Installation

composer require utrodus/malaysia-public-holiday

⚡ Usage

<?php

use MalaysiaHoliday\MalaysiaHoliday;

$holiday = new MalaysiaHoliday();

// Get holidays for all states in the current year
$result = $holiday->fromAllState()->get();


header('Content-Type: application/json');
echo json_encode($result, JSON_PRETTY_PRINT) . PHP_EOL;

/**
 *  Get formatted holiday data 
 *  with formatHolidayData method you can easier read and access
 *  */
echo "------------------------------------------------" . PHP_EOL;
echo "Formatted Holiday Data:" . PHP_EOL;
$formatted = $holiday->formatHolidayData($result);
echo $formatted . PHP_EOL;

I have included code examples to try this library in each file within the examples folder. Please see below:

🧪 Running Tests

vendor/bin/phpunit tests

📬 Contributing

Pull requests and suggestions are welcome! If you find bugs or have a feature request, feel free to open an issue.

📄 License

This project is open-source and available under the MIT License.