dkvhin/ph-holidays

Fetch Holidays from Philippine government website

v1.0.7 2024-12-03 00:26 UTC

Requires

• php: ^8.1
• guzzlehttp/guzzle: ^7.0
• nesbot/carbon: ^2.7|^3.0

Requires (Dev)

• pestphp/pest: ^2.35
• phpstan/phpstan: ^1.11

MIT

• Ervin Musngi

• philippines
• holidays

README

This package can fetch regular and special holidays from the official website https://www.officialgazette.gov.ph/nationwide-holidays/

NOTE: This is not yet working 100% as the website is using a bot checker ( cloudflare ), this can cause errors if used in production.

use Dkvhin\PhHolidays\PhilippineHolidays;


// for the current year
$holidays = PhilippineHolidays::fetch();

// returns an array of regular holidays
$regular = $holidays->regular();

// returns an array of special holidays
$special = $holidays->special();

Installation

You can install the package via composer:

composer require dkvhin/ph-holidays

Usage

use Dkvhin\PhHolidays\PhilippineHolidays;

// for the current year
$holidays = PhilippineHolidays::fetch();


// you can also pass specific year
// NOTE that the website only provides the last 6 years worth of holidays
// Advance year are not always available from the website 
// eg. ( current year is 2024, holidays for 2025 might not be available yet until the end of the year)
$holidays = PhilippineHolidays::fetch(2022);

Testing

composer test

Credits

• Ervin Musngi

License

The MIT License (MIT). Please see License File for more information.