akamai-open/netstorage

Akamai NetStorage

0.2.0 2019-05-06 22:04 UTC

Requires

• php: >=5.5
• ext-dom: *
• ext-simplexml: *
• akamai-open/edgegrid-client: ^1.0.0
• league/flysystem: ^1.0
• twistor/flysystem-stream-wrapper: ^1.0

Requires (Dev)

• dshafik/guzzlehttp-vcr: dev-master
• phploc/phploc: ^2.1
• phpunit/phpunit: ^4.0
• roave/security-advisories: dev-master
• squizlabs/php_codesniffer: ^2.3
• theseer/phpdox: 0.8.1.1

Apache 2.0

• Davey Shafik

README

Important

Akamai does not maintain or regulate this package. While it can be incorporated to assist you in API use, Akamai Technical Support will not offer assistance and Akamai cannot be held liable if issues arise from its use.

Overview:

This library provides the following NetStorage tools

• a FlySystem adapter for NetStorage ObjectStore (\Akamai\NetStorage\ObjectStoreAdapter) and FileStore (\Akamai\NetStorage\FileStoreAdapter)
• a request signer (\Akamai\NetStorage\Authentication)
• a Guzzle middleware for transparently signing requests to the API (\Akamai\NetStorage\Handler\Authentication)

To Do:

• A PHP streams layer, so you can use netstorage.fs://path with any built-in I/O functions (e.g. fopen, fread(), and fputs, or file_get_contents() and file_put_contents())

Installation

Installation is done via composer:

$ composer require akamai-open/netstorage

Using the Request Signer

$signer = new Akamai\NetStorage\Authentication();
$signer->setKey($key, $keyName);
$signer->setPath('/' .$cpCode. '/path/to/file');
$signer->setAction('upload');
$headers = $signer->createAuthHeaders();

/*
Return:
[
    'X-Akamai-ACS-Auth-Data' => $authData,
    'X-Akamai-ACS-Auth-Sign' => $signature
];
*/

Using the Guzzle Middleware

To use the middle, add it to the handler stack in the \GuzzleHttp\Client or \Akamai\Open\EdgeGrid\Client options:

$signer = new \Akamai\NetStorage\Authentication();
$signer->setKey($key, $keyName);

$handler = new \Akamai\NetStorage\Handler\Authentication();
$handler->setSigner($signer);

$stack = \GuzzleHttp\HandlerStack::create();
$stack->push($handler, 'netstorage-handler');

$client = new \Akamai\Open\EdgeGrid\Client([
    'base_uri' => $host,
    'handler' => $stack
]);

// Upload a file:
// Request signature is added transparently
// All parent directories must exist (e.g. /path/to)
$client->put('/' . $cpCode . '/path/to/file', [
    'headers' => [
        'X-Akamai-ACS-Action' => 'version=1&action=upload&sha1=' .sha1($fileContents)
    ],
    'body' => $fileContents
]);

Using the FlySystem Adapters

The simplest way to interact with NetStorage ObjectStore or FileStore is using the \Akamai\NetStorage\ObjectStoreAdapter or \Akamai\NetStorage\FileStoreAdapter for FlySystem.

$signer = new \Akamai\NetStorage\Authentication();
$signer->setKey($key, $keyName);

$handler = new \Akamai\NetStorage\Handler\Authentication();
$handler->setSigner($signer);

$stack = \GuzzleHttp\HandlerStack::create();
$stack->push($handler, 'netstorage-handler');

$client = new \Akamai\Open\EdgeGrid\Client([
    'base_uri' => $host,
    'handler' => $stack
]);

$adapter = new \Akamai\NetStorage\ObjectStoreAdapter($client, $cpCode);
$fs = new \League\Flysystem\Filesystem($adapter);

// Upload a file:
// cpCode, action, content signature, and request signature is added transparently
// Additionally, all required sub-directories are created transparently
$fs->write('/path/to/file', $fileContents);

Please note that $key, $keyName & $host can be obtained from "NetStorage API Information" page: https://control.akamai.com/storage/customer_portal.jsp?content_page=ns_api_info.jsp