handmadeweb/statamic-cloudflare

2.1.0 2024-12-02 22:19 UTC

This package is auto-updated.

Last update: 2024-12-02 22:24:28 UTC


README

MIT Licensed

Cloudflare integration for Statamic with CLI, static caching integration and control panel integration.

Inspired by sebdesign/artisan-cloudflare

Requirements

  • Statamic 4.0.0 or higher

Installation

You can install the package via composer:

composer require handmadeweb/statamic-cloudflare

Copy the package config to your local config with the publish command:

php artisan vendor:publish --provider="HandmadeWeb\StatamicCloudflare\ServiceProvider"

Then add your cloudflare details to your .env file.

CLOUDFLARE_KEY=
CLOUDFLARE_EMAIL=

or

CLOUDFLARE_TOKEN=

Note that CLOUDFLARE_KEY will be used instead of CLOUDFLARE_TOKEN in the event that they are both set. KEY is the global api key with all possible permissions and TOKEN is a generated Api KEY/TOKEN which has specific permissions enabled/disabled.

And configure your zones, If you only need to specify a single zone, then you can add it to your .env

CLOUDFLARE_ZONE_DOMAIN=
CLOUDFLARE_ZONE_ID=

Otherwise you can specify multiple zones in your statamic-cloudflare.php

    /*
     * Array of zones.
     *
     * Each zone must have its domain as the key. The value should be your zoneId.
     *
     * you can find your zoneId under 'Account Home > site > Api'.
     *
     * E.g.
     *
     * 'example.com' => '023e105f4ecef8ad9ca31a8372d0c353'
     */
    'zones' => [
        // env('CLOUDFLARE_ZONE_DOMAIN', null) => env('CLOUDFLARE_ZONE_ID', null),
    ],

By default all purge actions except the Cli commands will be queued with your default queue.

This can be changed in the configuration.

    /*
     * Should purges be processed in a queue?
     * CLI commands will always run on request.
     */
    'queued' => true,

Usage

Cli

You can purge everything via the following commands.

php artisan cloudflare:cache:purge:everything
php please cloudflare:cache:purge:everything

Static Caching

If you want to use statamic-cloudflare as a static cache strategy then you will need to manually register the cacher in the register method of your App\Providers\AppServiceProvider class.

/**
 * Register any application services.
 *
 * @return void
 */
public function register()
{
    \HandmadeWeb\StatamicCloudflare\Cloudflare::registerCacher();
}

Then update your static_cache config.

'strategies' => [

    'half' => [
        'driver' => 'application',
        'expiry' => null,
    ],

    'full' => [
        'driver' => 'file',
        'path' => public_path('static'),
        'lock_hold_length' => 0,
    ],

    'cloudflare' => [
        'driver' => 'cloudflare',
        'strategy' => 'null',
    ],
],

Then update the static_cache strategy at the top of the configuration to:

'strategy' => 'cloudflare',

Currently the Cloudflare integration is only used for purging, If you would like to use another caching strategy in combination with this caching strategy, then you are free to do that.

This can be done by updating the strategy section within the cloudflare strategy, below is an example where we will be caching the application using the half measure

'cloudflare' => [
    'driver' => 'cloudflare',
    'strategy' => 'half',
],

In theory, you should be able to use any caching strategy here, such as the full measure or any other first or third party strategies, statamic-cloudfare will simply pass requests to the defined strategy and will just hook into the purge actions to also purge the page in Cloudflare.

Control Panel

Events

statamic-cloudflare will listen to the Statamic\Events\EntrySaved, Statamic\Events\EntryDeleted, Statamic\Events\TermSaved and Statamic\Events\TermDeleted events and will trigger a pruge for the url. These events will be ignored if you have configured the static cache to be a strategy that uses the cloudflare driver, as the driver will instead handle the needed purging actions.

Utility

statamic-cloudflare will add a utility to your Statamic CP.

route: /cp/utilities/cloudflare

This will be available to Super Users and Users who have the Cloudflare Manager permission.

You can purge everything quickly from here.

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Credits

License

The MIT License (MIT). Please see License File for more information.