Getting Started

Using Yasumi in your projects is super easy! Yasumi is available on Packagist and can be installed using Composer.

System Requirements

You need PHP >= 8.0 to use Yasumi, but the latest stable version of PHP is recommended. Yasumi is verified and tested on PHP 8.0 or higher. Other versions of PHP are no longer supported.

Please see the Security and Support Policy for more details.


Install azuyalabs/yasumi using Composer by issuing the following command:

composer require azuyalabs/yasumi

Be sure to include the Composer autoload file in your project:


require 'vendor/autoload.php';

// Use the factory to create a new holiday provider instance
$holidays = Yasumi\Yasumi::create('USA', (int) date('Y'));

That's all it takes, you're ready to go!

Interested in learning more about Yasumi? Have a look at the Cookbook section; this section includes various recipes, examples and how-to's to get started with Yasumi.

Last updated 01/07/2024