sony/cdn-purge-control-php

CDN Purge Control SDK for PHP - Lightweight PHP library to control multiple CDN edge cache.

CdnPurge, Multi CDN purge control library for PHP

, _(*1)

CdnPurge is a lightweight PHP CDN client which makes it easier to purge contents for multiple CDN providers. Currently, CdnPurge supports AWS CloudFront and Limelight., _(*2)

• Simple common interface to purge contents against multiple CDNs and get purge status.
• Easily extensible to other CDN providers.
• Easy code maintenance.
• Requires PHP >= 5.5 compiled with cURL extension and cURL 7.16.2+ compiled with a TLS backend (e.g. NSS or OpenSSL).
• Uses Guzzle to make http rest api calls.

Installing CdnPurge

The recommended way to install CdnPurge is through Composer., _(*3)

# Install Composer
curl -sS https://getcomposer.org/installer | php

Next, run the Composer command to install the latest stable version of CdnPurge:, _(*4)

composer.phar require sony/cdn-purge-control-php

After installing, you need to require Composer's autoloader:, _(*5)

require 'vendor/autoload.php';

You can then later update CdnPurge using composer:, _(*6)

bash composer.phar update, _(*7)

Quick Examples

Make purge request

<?php
// Require the Composer autoloader.
require 'vendor/autoload.php';

use CdnPurge\CdnPurgeFactory;
use CdnPurge\CdnType;

$config = array(
    'cloudfront' => array(
            'distribution_id' => 'your cloudfront distribution id'
        ),
    'limelight' => array(
            'shortname' => 'your limelight api shortname'
            'publish_url' => 'your limelight publish url'
        )
);
$credential = array(
    'cloudfront' => array(
            'key' => 'aws iam account access key id',
            'secret' => 'aws iam account secret access key'
        ),
    'limelight' => array(
            'username' => 'limelight account username',
            'shared_key' => 'limelight account shared key'
        )
);

try {
    // Make a purge request against AWS cloudfront
    $cfClient = CdnPurgeFactory::build(CdnType::CLOUDFRONT, $credential, $config);
    $cfRequestId = $client->createPurgeRequest(array(
        '/my-path-1',
        '/my-path-2'
    ));

    // Make a purge request against Limelight
    $llClient = CdnPurgeFactory::build(CdnType::LIMELIGHT, $credential, $config);
    $llRequestId = $client->createPurgeRequest(array(
        'http://my-limelight-domain/my-path-1',
        '/my-path-2'
    ));

} catch (CdnPurge\CdnClientException $e) {
    echo "An error occurred: " . $e->getMessage();
}

Get purge status

<?php
// Get the purge status
try {
    $client->getPurgeStatus($requestId);
    // 'InProgress' or 'Complete'
} catch (CdnPurge\CdnClientException $e) {
    echo "There was an error getting purge status.\n";
}

See example for a running example of how to use this library., _(*8)

Specifying credentials

Credentials are specified as an array., _(*9)

AWS CloudFront

Limelight

Specifying configurations

Configurations are specified as an array., _(*10)

AWS CloudFront

Limelight

Development

• Running tests
• Generating documentation

License

The MIT License (MIT), _(*11)

See LICENSE for details., _(*12)