marcreichel/igdb-laravel

A Laravel wrapper for version 4 of the IGDB API (Apicalypse) including webhook handling

5.3.1 2025-06-03 05:44 UTC

Requires

• php: ^8.2
• ext-json: *
• guzzlehttp/guzzle: ~6.0|~7.0
• illuminate/support: ^11.0|^12.0
• nesbot/carbon: ^2.53.1|^3.0

Requires (Dev)

• larastan/larastan: ^3.0.2
• laravel/pint: ^1.13
• nunomaduro/collision: ^8.0
• orchestra/testbench: ^9.0|^10.0
• pestphp/pest: ^3.7.4
• pestphp/pest-plugin-type-coverage: ^3.2.3
• rector/rector: ^2.0.7
• roave/security-advisories: dev-latest

MIT

• Marc Reichel

• wrapper
• laravel
• api-wrapper
• igdb
• apicalypse
• igdb-api

README

This is a Laravel wrapper for version 4 of the IGDB API (Apicalypse) including webhook handling.

Basic installation

You can install this package via composer using:

composer require marcreichel/igdb-laravel

The package will automatically register its service provider.

To publish the config file to config/igdb.php run:

php artisan igdb:publish

This is the default content of the config file:

return [
    /*
     * These are the credentials you got from https://dev.twitch.tv/console/apps
     */
    'credentials' => [
        'client_id' => env('TWITCH_CLIENT_ID', ''),
        'client_secret' => env('TWITCH_CLIENT_SECRET', ''),
    ],

    /*
     * This package caches queries automatically (for 1 hour per default).
     * Here you can set how long each query should be cached (in seconds).
     *
     * To turn cache off set this value to 0
     */
    'cache_lifetime' => env('IGDB_CACHE_LIFETIME', 3600),
    
    /**
     * The prefix used to cache the results.
     *
     * E.g.: `[CACHE_PREFIX].75170fc230cd88f32e475ff4087f81d9`
     */
    'cache_prefix' => 'igdb_cache',

    /*
     * Path where the webhooks should be handled.
     */
    'webhook_path' => 'igdb-webhook/handle',

    /*
     * The webhook secret.
     *
     * This needs to be a string of your choice in order to use the webhook
     * functionality.
     */
    'webhook_secret' => env('IGDB_WEBHOOK_SECRET', null),
];

Documentation

You will find the full documentation on the dedicated documentation site.

Testing

Run the tests with:

composer test

Contribution

Pull requests are welcome :)