PHPackages festivo-io/festivo-php - 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. festivo-io/festivo-php ActiveLibrary festivo-io/festivo-php ====================== Festivo PHP SDK (monorepo root stub) v0.2.1(2mo ago)01GoCI passing Since Feb 16Pushed 2mo agoCompare [ Source](https://github.com/festivo-io/festivo-sdk)[ Packagist](https://packagist.org/packages/festivo-io/festivo-php)[ Docs](https://github.com/festivo-io/festivo-sdk)[ RSS](/packages/festivo-io-festivo-php/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (2)DependenciesVersions (5)Used By (0) Festivo SDKs ============ [](#festivo-sdks) [![License](https://camo.githubusercontent.com/ffe7a7c1be47ba1323b52ca86c30eb55fb0d54165c6570a4a10926bd145996d6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6665737469766f2d696f2f6665737469766f2d73646b)](LICENSE)[![GitHub release](https://camo.githubusercontent.com/1ea5668b6d0ec354afc39dee1b4b9bb8b9a73f0cb1d68ea1a01073091301fb1e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6665737469766f2d696f2f6665737469766f2d73646b)](https://github.com/festivo-io/festivo-sdk/releases) Official SDKs for the [Festivo Public Holidays API](https://getfestivo.com) - Access holiday data for 250+ countries with accurate UTC dates, regional variations, and city-level holidays. Available SDKs -------------- [](#available-sdks) LanguagePackageVersionDocumentation**JavaScript/TypeScript**[@festivo-io/festivo-sdk](https://www.npmjs.com/package/@festivo-io/festivo-sdk)[![npm](https://camo.githubusercontent.com/fc1802ba2172962e6cbbd8de9691a8c84a6afffc10775e2c566f1e2e1c855272/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f762f406665737469766f2d696f2f6665737469766f2d73646b2e737667)](https://www.npmjs.com/package/@festivo-io/festivo-sdk)[README](js/README.md)**Python**[festivo-python](https://pypi.org/project/festivo-python/)[![PyPI](https://camo.githubusercontent.com/6bdda05eee8de6acb382d04bf59401bf958053a51b0ccd635c85e44a0080d0c1/68747470733a2f2f696d672e736869656c64732e696f2f707970692f762f6665737469766f2d707974686f6e2e737667)](https://pypi.org/project/festivo-python/)[README](python/README.md)**PHP**[festivo-io/festivo-php](https://packagist.org/packages/festivo-io/festivo-php)[![Packagist](https://camo.githubusercontent.com/a10011381bab16fd7d5f1c7eab7776b48875f7198b75b13640559c15e1faf8c8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6665737469766f2d696f2f6665737469766f2d7068702e737667)](https://packagist.org/packages/festivo-io/festivo-php)[README](php/README.md)**Go**[festivo-sdk-go](https://pkg.go.dev/github.com/festivo-io/festivo-sdk-go)[![Go](https://camo.githubusercontent.com/b80b593c7bf03146ae14a0f384ef424a411d2af82b2727b1674be1469375232e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f7461672f6665737469766f2d696f2f6665737469766f2d73646b)](https://github.com/festivo-io/festivo-sdk/tags)[README](go/README.md)**Ruby**[festivo](https://rubygems.org/gems/festivo)[![Gem](https://camo.githubusercontent.com/ec647b96303a25a8cdc309ca8a20fd0d820f7b05637806018f614c0acd925ba0/68747470733a2f2f696d672e736869656c64732e696f2f67656d2f762f6665737469766f2e737667)](https://rubygems.org/gems/festivo)[README](ruby/README.md)**Java**io.festivo:festivo-sdk[![Maven Central](https://camo.githubusercontent.com/f1b3a7ce59d57613b4663e973dde5212c6bd3bb0e5d92f47ac61e7320929cf2d/68747470733a2f2f696d672e736869656c64732e696f2f6d6176656e2d63656e7472616c2f762f696f2e6665737469766f2f6665737469766f2d73646b2e737667)](https://search.maven.org/artifact/io.festivo/festivo-sdk)[README](java/README.md)Features -------- [](#features) - ๐ŸŒ **250+ 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 ----------- [](#quick-start) ### JavaScript/TypeScript [](#javascripttypescript) ``` 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 [](#python) ``` pip install festivo-python ``` ``` from festivo import FestivoClient client = FestivoClient(api_key='YOUR_API_KEY') result = client.get_holidays('US', 2026) ``` ### PHP [](#php) ``` composer require festivo-io/festivo-php ``` ``` use Festivo\FestivoClient; $client = new FestivoClient('YOUR_API_KEY'); $result = $client->getHolidays('US', 2026); ``` ### Go [](#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) ``` ### Ruby [](#ruby) ``` gem install festivo ``` ``` require 'festivo' client = Festivo::Client.new('YOUR_API_KEY') result = client.get_holidays(country: 'US', year: 2026) ``` ### Java [](#java) **Maven:** ``` io.festivo festivo-sdk 0.2.0 ``` **Gradle:** ``` implementation 'io.festivo:festivo-sdk:0.2.0' ``` ``` import com.festivo.FestivoClient; FestivoClient client = new FestivoClient("YOUR_API_KEY"); FestivoClient.HolidaysResponse holidays = client.getHolidays("US", 2026, null); ``` Documentation ------------- [](#documentation) - [Official Website](https://getfestivo.com) - [API Documentation](https://getfestivo.com/docs) - [Get Your API Key](https://app.getfestivo.com/dashboard) Support ------- [](#support) - Email: - [Report Issues](https://github.com/festivo-io/festivo-sdk/issues) Contributing ------------ [](#contributing) Contributions are welcome! Please feel free to submit a Pull Request. License ------- [](#license) MIT License - see [LICENSE](LICENSE) for details. ### Health Score 30 โ€” LowBetter than 64% of packages Maintenance84 Actively maintained with recent releases Popularity1 Limited adoption so far Community6 Small or concentrated contributor base Maturity27 Early-stage or recently created project Bus Factor1 Top contributor holds 100% 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 ~2 days Total 4 Last Release 83d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/50739235?v=4)[Festivo](/maintainers/festivo-io)[@festivo-io](https://github.com/festivo-io) --- Top Contributors [![SzymonDukla](https://avatars.githubusercontent.com/u/7996340?v=4)](https://github.com/SzymonDukla "SzymonDukla (1 commits)") ### Embed Badge ![Health badge](/badges/festivo-io-festivo-php/health.svg) ``` [![Health](https://phpackages.com/badges/festivo-io-festivo-php/health.svg)](https://phpackages.com/packages/festivo-io-festivo-php) ``` PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)