--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/web/lib/Zend/Cloud/StorageService/Adapter/WindowsAzure.php Fri Mar 11 15:05:35 2011 +0100
@@ -0,0 +1,443 @@
+<?php
+/**
+ * LICENSE
+ *
+ * This source file is subject to the new BSD license that is bundled
+ * with this package in the file LICENSE.txt.
+ * It is also available through the world-wide-web at this URL:
+ * http://framework.zend.com/license/new-bsd
+ * If you did not receive a copy of the license and are unable to
+ * obtain it through the world-wide-web, please send an email
+ * to license@zend.com so we can send you a copy immediately.
+ *
+ * @category Zend
+ * @package Zend_Cloud
+ * @subpackage StorageService
+ * @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license http://framework.zend.com/license/new-bsd New BSD License
+ */
+
+require_once 'Zend/Cloud/StorageService/Adapter.php';
+require_once 'Zend/Service/WindowsAzure/Storage/Blob.php';
+require_once 'Zend/Cloud/StorageService/Exception.php';
+
+/**
+ *
+ * Windows Azure Blob Service abstraction
+ *
+ * @category Zend
+ * @package Zend_Cloud
+ * @subpackage StorageService
+ * @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license http://framework.zend.com/license/new-bsd New BSD License
+ */
+class Zend_Cloud_StorageService_Adapter_WindowsAzure
+ implements Zend_Cloud_StorageService_Adapter
+{
+ const ACCOUNT_NAME = 'storage_accountname';
+ const ACCOUNT_KEY = 'storage_accountkey';
+ const HOST = "storage_host";
+ const PROXY_HOST = "storage_proxy_host";
+ const PROXY_PORT = "storage_proxy_port";
+ const PROXY_CREDENTIALS = "storage_proxy_credentials";
+ const CONTAINER = "storage_container";
+ const RETURN_TYPE = 'return_type';
+ const RETURN_PATHNAME = 'return_path';
+ const RETURN_OPENMODE = 'return_openmode';
+
+ /** return types for fetch */
+ const RETURN_PATH = 1; // return filename
+ const RETURN_STRING = 2; // return data as string
+ const RETURN_STREAM = 3; // return PHP stream
+
+ /** return types for list */
+ const RETURN_LIST = 1; // return native list
+ const RETURN_NAMES = 2; // return only names
+
+ const DEFAULT_HOST = Zend_Service_WindowsAzure_Storage::URL_CLOUD_BLOB;
+
+ /**
+ * Storage container to operate on
+ *
+ * @var string
+ */
+ protected $_container;
+
+ /**
+ * Storage client
+ *
+ * @var Zend_Service_WindowsAzure_Storage_Blob
+ */
+ protected $_storageClient = null;
+
+ /**
+ * Creates a new Zend_Cloud_Storage_WindowsAzure instance
+ *
+ * @param array|Zend_Config $options Options for the Zend_Cloud_Storage_WindowsAzure instance
+ */
+ public function __construct($options = array())
+ {
+ if ($options instanceof Zend_Config) {
+ $options = $options->toArray();
+ }
+
+ if (!is_array($options)) {
+ throw new Zend_Cloud_StorageService_Exception('Invalid options provided');
+ }
+
+ // Build Zend_Service_WindowsAzure_Storage_Blob instance
+ if (!isset($options[self::HOST])) {
+ $host = self::DEFAULT_HOST;
+ } else {
+ $host = $options[self::HOST];
+ }
+
+ if (!isset($options[self::ACCOUNT_NAME])) {
+ throw new Zend_Cloud_StorageService_Exception('No Windows Azure account name provided.');
+ }
+ if (!isset($options[self::ACCOUNT_KEY])) {
+ throw new Zend_Cloud_StorageService_Exception('No Windows Azure account key provided.');
+ }
+
+ $this->_storageClient = new Zend_Service_WindowsAzure_Storage_Blob($host,
+ $options[self::ACCOUNT_NAME], $options[self::ACCOUNT_KEY]);
+
+ // Parse other options
+ if (!empty($options[self::PROXY_HOST])) {
+ $proxyHost = $options[self::PROXY_HOST];
+ $proxyPort = isset($options[self::PROXY_PORT]) ? $options[self::PROXY_PORT] : 8080;
+ $proxyCredentials = isset($options[self::PROXY_CREDENTIALS]) ? $options[self::PROXY_CREDENTIALS] : '';
+
+ $this->_storageClient->setProxy(true, $proxyHost, $proxyPort, $proxyCredentials);
+ }
+
+ if (isset($options[self::HTTP_ADAPTER])) {
+ $this->_storageClient->setHttpClientChannel($options[self::HTTP_ADAPTER]);
+ }
+
+ // Set container
+ $this->_container = $options[self::CONTAINER];
+
+ // Make sure the container exists
+ if (!$this->_storageClient->containerExists($this->_container)) {
+ $this->_storageClient->createContainer($this->_container);
+ }
+ }
+
+ /**
+ * Get an item from the storage service.
+ *
+ * @param string $path
+ * @param array $options
+ * @return mixed
+ */
+ public function fetchItem($path, $options = null)
+ {
+ // Options
+ $returnType = self::RETURN_STRING;
+ $returnPath = tempnam('', 'azr');
+ $openMode = 'r';
+
+ // Parse options
+ if (is_array($options)) {
+ if (isset($options[self::RETURN_TYPE])) {
+ $returnType = $options[self::RETURN_TYPE];
+ }
+
+ if (isset($options[self::RETURN_PATHNAME])) {
+ $returnPath = $options[self::RETURN_PATHNAME];
+ }
+
+ if (isset($options[self::RETURN_OPENMODE])) {
+ $openMode = $options[self::RETURN_OPENMODE];
+ }
+ }
+
+ // Fetch the blob
+ try {
+ $this->_storageClient->getBlob(
+ $this->_container,
+ $path,
+ $returnPath
+ );
+ } catch (Zend_Service_WindowsAzure_Exception $e) {
+ if (strpos($e->getMessage(), "does not exist") !== false) {
+ return false;
+ }
+ throw new Zend_Cloud_StorageService_Exception('Error on fetch: '.$e->getMessage(), $e->getCode(), $e);
+ }
+
+ // Return value
+ if ($returnType == self::RETURN_PATH) {
+ return $returnPath;
+ }
+ if ($returnType == self::RETURN_STRING) {
+ return file_get_contents($returnPath);
+ }
+ if ($returnType == self::RETURN_STREAM) {
+ return fopen($returnPath, $openMode);
+ }
+ }
+
+ /**
+ * Store an item in the storage service.
+ * WARNING: This operation overwrites any item that is located at
+ * $destinationPath.
+ * @param string $destinationPath
+ * @param mixed $data
+ * @param array $options
+ * @return boolean
+ */
+ public function storeItem($destinationPath, $data, $options = null)
+ {
+ // Create a temporary file that will be uploaded
+ $temporaryFilePath = '';
+ $removeTemporaryFilePath = false;
+
+ if (is_resource($data)) {
+ $temporaryFilePath = tempnam('', 'azr');
+ $fpDestination = fopen($temporaryFilePath, 'w');
+
+ $fpSource = $data;
+ rewind($fpSource);
+ while (!feof($fpSource)) {
+ fwrite($fpDestination, fread($fpSource, 8192));
+ }
+
+ fclose($fpDestination);
+
+ $removeTemporaryFilePath = true;
+ } elseif (file_exists($data)) {
+ $temporaryFilePath = $data;
+ $removeTemporaryFilePath = false;
+ } else {
+ $temporaryFilePath = tempnam('', 'azr');
+ file_put_contents($temporaryFilePath, $data);
+ $removeTemporaryFilePath = true;
+ }
+
+ try {
+ // Upload data
+ $this->_storageClient->putBlob(
+ $this->_container,
+ $destinationPath,
+ $temporaryFilePath
+ );
+ } catch(Zend_Service_WindowsAzure_Exception $e) {
+ @unlink($temporaryFilePath);
+ throw new Zend_Cloud_StorageService_Exception('Error on store: '.$e->getMessage(), $e->getCode(), $e);
+ }
+ if ($removeTemporaryFilePath) {
+ @unlink($temporaryFilePath);
+ }
+ }
+
+ /**
+ * Delete an item in the storage service.
+ *
+ * @param string $path
+ * @param array $options
+ * @return void
+ */
+ public function deleteItem($path, $options = null)
+ {
+ try {
+ $this->_storageClient->deleteBlob(
+ $this->_container,
+ $path
+ );
+ } catch (Zend_Service_WindowsAzure_Exception $e) {
+ throw new Zend_Cloud_StorageService_Exception('Error on delete: '.$e->getMessage(), $e->getCode(), $e);
+ }
+ }
+
+ /**
+ * Copy an item in the storage service to a given path.
+ *
+ * @param string $sourcePath
+ * @param string $destinationPath
+ * @param array $options
+ * @return void
+ */
+ public function copyItem($sourcePath, $destinationPath, $options = null)
+ {
+ try {
+ $this->_storageClient->copyBlob(
+ $this->_container,
+ $sourcePath,
+ $this->_container,
+ $destinationPath
+ );
+ } catch (Zend_Service_WindowsAzure_Exception $e) {
+ throw new Zend_Cloud_StorageService_Exception('Error on copy: '.$e->getMessage(), $e->getCode(), $e);
+ }
+ }
+
+ /**
+ * Move an item in the storage service to a given path.
+ *
+ * @param string $sourcePath
+ * @param string $destinationPath
+ * @param array $options
+ * @return void
+ */
+ public function moveItem($sourcePath, $destinationPath, $options = null)
+ {
+ try {
+ $this->_storageClient->copyBlob(
+ $this->_container,
+ $sourcePath,
+ $this->_container,
+ $destinationPath
+ );
+
+ $this->_storageClient->deleteBlob(
+ $this->_container,
+ $sourcePath
+ );
+ } catch (Zend_Service_WindowsAzure_Exception $e) {
+ throw new Zend_Cloud_StorageService_Exception('Error on move: '.$e->getMessage(), $e->getCode(), $e);
+ }
+
+ }
+
+ /**
+ * Rename an item in the storage service to a given name.
+ *
+ *
+ * @param string $path
+ * @param string $name
+ * @param array $options
+ * @return void
+ */
+ public function renameItem($path, $name, $options = null)
+ {
+ return $this->moveItem($path, $name, $options);
+ }
+
+ /**
+ * List items in the given directory in the storage service
+ *
+ * The $path must be a directory
+ *
+ *
+ * @param string $path Must be a directory
+ * @param array $options
+ * @return array A list of item names
+ */
+ public function listItems($path, $options = null)
+ {
+ // Options
+ $returnType = self::RETURN_NAMES; // 1: return list of paths, 2: return raw output from underlying provider
+
+ // Parse options
+ if (is_array($options)&& isset($options[self::RETURN_TYPE])) {
+ $returnType = $options[self::RETURN_TYPE];
+ }
+
+ try {
+ // Fetch list
+ $blobList = $this->_storageClient->listBlobs(
+ $this->_container,
+ $path
+ );
+ } catch (Zend_Service_WindowsAzure_Exception $e) {
+ throw new Zend_Cloud_StorageService_Exception('Error on list: '.$e->getMessage(), $e->getCode(), $e);
+ }
+
+ // Return
+ if ($returnType == self::RETURN_LIST) {
+ return $blobList;
+ }
+
+ $returnValue = array();
+ foreach ($blobList as $blob) {
+ $returnValue[] = $blob->Name;
+ }
+
+ return $returnValue;
+ }
+
+ /**
+ * Get a key/value array of metadata for the given path.
+ *
+ * @param string $path
+ * @param array $options
+ * @return array
+ */
+ public function fetchMetadata($path, $options = null)
+ {
+ try {
+ return $this->_storageClient->getBlobMetaData(
+ $this->_container,
+ $path
+ );
+ } catch (Zend_Service_WindowsAzure_Exception $e) {
+ if (strpos($e->getMessage(), "could not be accessed") !== false) {
+ return false;
+ }
+ throw new Zend_Cloud_StorageService_Exception('Error on fetch: '.$e->getMessage(), $e->getCode(), $e);
+ }
+ }
+
+ /**
+ * Store a key/value array of metadata at the given path.
+ * WARNING: This operation overwrites any metadata that is located at
+ * $destinationPath.
+ *
+ * @param string $destinationPath
+ * @param array $options
+ * @return void
+ */
+ public function storeMetadata($destinationPath, $metadata, $options = null)
+ {
+ try {
+ $this->_storageClient->setBlobMetadata($this->_container, $destinationPath, $metadata);
+ } catch (Zend_Service_WindowsAzure_Exception $e) {
+ if (strpos($e->getMessage(), "could not be accessed") === false) {
+ throw new Zend_Cloud_StorageService_Exception('Error on store metadata: '.$e->getMessage(), $e->getCode(), $e);
+ }
+ }
+ }
+
+ /**
+ * Delete a key/value array of metadata at the given path.
+ *
+ * @param string $path
+ * @param array $options
+ * @return void
+ */
+ public function deleteMetadata($path, $options = null)
+ {
+ try {
+ $this->_storageClient->setBlobMetadata($this->_container, $destinationPath, array());
+ } catch (Zend_Service_WindowsAzure_Exception $e) {
+ if (strpos($e->getMessage(), "could not be accessed") === false) {
+ throw new Zend_Cloud_StorageService_Exception('Error on delete metadata: '.$e->getMessage(), $e->getCode(), $e);
+ }
+ }
+ }
+
+ /**
+ * Delete container
+ *
+ * @return void
+ */
+ public function deleteContainer()
+ {
+ try {
+ $this->_storageClient->deleteContainer($this->_container);
+ } catch (Zend_Service_WindowsAzure_Exception $e) {
+ throw new Zend_Cloud_StorageService_Exception('Error on delete: '.$e->getMessage(), $e->getCode(), $e);
+ }
+ }
+
+ /**
+ * Get the concrete adapter.
+ * @return Zend_Service_Azure_Storage_Blob
+ */
+ public function getClient()
+ {
+ return $this->_storageClient;
+ }
+}