westy92/holiday-event-api

The Official Holiday and Event API for PHP

v1.0.1 2022-12-29 22:28 UTC

Requires

• php: ^8.0
• doctrine/annotations: ^2.0
• guzzlehttp/guzzle: ^7.5
• phpdocumentor/reflection-docblock: ^5.3
• symfony/property-info: ^5.4
• symfony/serializer: ^5.4

Requires (Dev)

• phpunit/phpunit: ^9.5
• vimeo/psalm: ^5.4

MIT

• Seth Westphal

• php
• event
• api
• date
• calendar
• unofficial
• list
• free
• public
• world
• best
• international
• day
• description
• holiday
• Month
• Year
• trusted
• holidays
• celebration
• accurate
• official
• details
• popular
• federal
• national
• holidayapi
• occurrence
• checkiday

README

Industry-leading Holiday and Event API for PHP. Over 5,000 holidays and thousands of descriptions. Trusted by the World’s leading companies. Built by developers for developers since 2011.

Supported PHP Versions

The latest version of the the Holiday and Event API is compatible with all currently-supported PHP releases.

Authentication

Access to the Holiday and Event API requires an API Key. You can get for one for FREE here, no credit card required! Note that free plans are limited. To access more data and have more requests, a paid plan is required.

Installation

The recommended way to install the Holiday and Event API is through Composer.

composer require westy92/holiday-event-api

Example

try {
    // Get a FREE API key from https://apilayer.com/marketplace/checkiday-api#pricing
    $client = new Westy92\HolidayEventApi\Client('<your API key>');

    // Get Events for a given Date
    $events = $client->getEvents(
        // These parameters are the defaults but can be specified:
        // date: 'today',
        // timezone: 'America/Chicago',
        // adult: false,
    );

    $event = $events->events[0];
    echo "Today is {$event->name}! Find more information at: {$event->url}." . PHP_EOL;
    echo "Rate limit remaining: {$events->rateLimit?->remainingMonth}/{$events->rateLimit?->limitMonth} (month)." . PHP_EOL;

    // Get Event Information
    $eventInfo = $client->getEventInfo(
        id: $event->id,
        // These parameters can be specified to calculate the range of eventInfo->Event->Occurrences
        // start: 2020,
        // end: 2030,
    );

    $hashtags = implode(', ', $eventInfo->event->hashtags);
    echo "The Event's hashtags are {$hashtags}." . PHP_EOL;

    // Search for Events
    $query = "zucchini";
    $search = $client->search(
        query: $query,
        // These parameters are the defaults but can be specified:
        // adult: false,
    );

    $count = count($search->events);
    echo "Found {$count} events, including '{$search->events[0]->name}', that match the query '{$query}'." . PHP_EOL;
} catch (\Exception $e) {
    echo $e;
}

License

The Holiday and Event API is made available under the MIT License (MIT). Please see the License File for more information.