festivo-io / festivo-php
Festivo PHP SDK (monorepo root stub)
Installs: 0
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 0
Language:Go
pkg:composer/festivo-io/festivo-php
README
Official SDKs for the Festivo Public Holidays API - Access holiday data for 100+ countries with accurate UTC dates, regional variations, and city-level holidays.
Available SDKs
| Language | Package | Version | Documentation |
|---|---|---|---|
| JavaScript/TypeScript | @festivo-io/festivo-sdk | README | |
| Python | festivo-python | README | |
| PHP | festivo-io/festivo-php | README | |
| Go | festivo-sdk-go | README |
Features
- ๐ 100+ Countries - Comprehensive holiday coverage worldwide
- ๐ UTC Dates - Accurate timezone handling for global holidays
- ๐๏ธ City & Regional - Support for local holidays (Pro/Builder plans)
- โ Type Safe - Full type definitions in all supported languages
- โก Modern - Built with current best practices for each language
- ๐งช Well Tested - Comprehensive test suites included
Quick Start
JavaScript/TypeScript
npm install @festivo-io/festivo-sdk
import { FestivoClient } from '@festivo-io/festivo-sdk'; const client = new FestivoClient({ apiKey: 'YOUR_API_KEY' }); const { holidays } = await client.getHolidays('US', 2026);
Python
pip install festivo-python
from festivo import FestivoClient client = FestivoClient(api_key='YOUR_API_KEY') result = client.get_holidays('US', 2026)
PHP
composer require festivo-io/festivo-php
use Festivo\FestivoClient; $client = new FestivoClient('YOUR_API_KEY'); $result = $client->getHolidays('US', 2026);
Go
go get github.com/festivo-io/festivo-sdk-go
import "github.com/festivo-io/festivo-sdk-go/festivo" client := festivo.NewClient("YOUR_API_KEY") result, _ := client.GetHolidays("US", 2026, nil)
Documentation
Support
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
MIT License - see LICENSE for details.