mbence/varnishpurge

Varnish Purge Provider for Silex

Varnish Purge Provider for Silex

Easy to use service to purge Varnish keys., _(*1)

Description

This provider will create a PURGE request for the predefined Varnish servers, thus invalidating the given url., _(*2)

https://www.varnish-cache.org/docs/3.0/tutorial/purging.html#http-purges, _(*3)

Prerequisites

This Provider requires Sylex and Varnish-Cache ~v3.0. From the Varnish docs:, _(*4)

acl purge {
        "localhost";
        "192.168.55.0"/24;
}

sub vcl_recv {
        # allow PURGE from localhost and 192.168.55...

        if (req.request == "PURGE") {
                if (!client.ip ~ purge) {
                        error 405 "Not allowed.";
                }
                return (lookup);
        }
}

sub vcl_hit {
        if (req.request == "PURGE") {
                purge;
                error 200 "Purged.";
        }
}

sub vcl_miss {
        if (req.request == "PURGE") {
                purge;
                error 200 "Purged.";
        }
}

Installation

Step 1: Download the bundle using composer

Add the following in your composer.json:, _(*5)

{
    "require": {
        "mbence/varnishpurge": "dev-master"
    }
}

Then download / update by running the command:, _(*6)

``` bash $ php composer.phar update mbence/varnishpurge, <sub>(*7)</sub>

Composer will install the bundle to your project's `vendor/mbence/varnishpurge` directory.

### Step 2: Register the provider

``` php
$app->register(new MBence\VarnishPurge\VarnishPurgeProvider(), array(
    'varnish.options' => array(
        'servers'   => array('127.0.0.1:8080'),
        'purge'     => 'On'
    ),
));

You can turn the purge off with 'purge' => 'Off', <sub>(*8)</sub>

Usage

Call the service with a url, <sub>(*9)</sub>

php $app['varnish']->purge('/hello');, <sub>(*10)</sub>