Small library to access Microsoft Windows Azure Blob Storage with a Service or a StreamWrapper.

Small library to access Microsoft Windows Azure Blob Storage with a Service or a StreamWrapper.

README

Small platform-independent library that allows you to work with Windows Azure Blob Storage from PHP.

You can work with Windows Azure Blob from any platform (Windows or Linux) and only need an Azure storage account to get started.

Features:

  • Programmatic API to work with files/blobs
  • Streamwrapper
  • Containers Management (Private or Public)
  • ACLs

The code is forked and adapted from the PHP Azure SDK.
It is cleaned up and stripped from all the PHP Azure SDK dependencies to be very leightweight.

Installation

Suggested via composer:

{
    "require": {
        "beberlei/azure-blob-storage": "*"
    }
}

Then using the composer binary:

prompt> php composer.phar install

Configuration

<?php
use BeberleiAzureBlobStorageBlobClient;

$accountUrl  = "http://myaccount.blob.storage.windows.net";
$accountName = "myaccount";
$accountKey  = "abcdefg";

$client = new BlobClient($accountUrl, $accountName, $accountKey);

// With Dev-Storage (localhost:10000)
$client = new BlobClient();

Usage

Container API

Containers are equivalent to harddrives with a name in Azure Blob Storage. You have to create
a container before being able to store files:

<?php
$container = "testing";

if ( ! $client->containerExists($container)) {
    $client->createContainer($container);
}

$client->createContainerIfNotExists($container);
$client->deleteContainer($container);

You can also set/get arbitrary metadata for a container:

<?php
$container = "testing_metadata";
$metadata = array('x-ms-application-user' => 'beberlei');

$client->createContainer($container, $metadata);
$metadata = $client->getContainerMetadata($container);
$metadata['x-ms-another-header'] = 'value';

$client->setContainerMetadata($container, $metadata);

Blob API

A container holds blobs (files) with names. Azure Blob Storage has no concept of directories within
a container, but you can just use “/” (Yes, not “”) as seperator to simulate them.

<?php
$container = 'testing_blob';
$client->createContainerIfNotExists($container);

$blobFileName = '/path/to/testing.gif';

$client->putBlob($container, 'testing.gif', $blobFileName);
$client->putBlobData($container, 'testing.gif', file_get_contents($blobFileName));

$client->copyBlob($container, 'testing.gif', $container, 'testing2.gif');

$blob = $client->getBlobInstance($container, 'testing2.gif');
// $blob instanceof BeberleiAzureBlobStorageBlobInstance

$localFileName = sys_get_temp_dir() . '/testing2.gif';
$client->getBlob($container, 'testing2.gif', $localFileName);

$data = $client->getBlobData($container, 'testing2.gif');

$blobs = $client->listBlobs($container, 'testing');
// array of BeberleiAzureBlobStroageBlobInstance

$client->deleteBlob($containerName, 'testing.gif');
$client->deleteBlob($containerName, 'testing2.gif');

By default Azure Blob Storage creates Block Blobs and not Page Blobs.
You can use the $client->putPageBlob() API to create page blobs.

Streamwrapper

To register the stream wrapper for Windows Azure Blob-Storage you have to define a prefix:

<?php
use BeberleiAzureBlobStorageBlobClient;
$client = new BlobClient();

$client->registerStreamWrapper('azure');

file_put_contents('azure://test.txt', 'Hello World!');

Source

Add a Comment

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *