13  * to license@zend.com so we can send you a copy immediately.

    13  * to license@zend.com so we can send you a copy immediately.

    14  *

    14  *

    15  * @category   Zend

    15  * @category   Zend

    16  * @package    Zend_Service_WindowsAzure

    16  * @package    Zend_Service_WindowsAzure

    17  * @subpackage Storage

    17  * @subpackage Storage

    19  * @license    http://todo     name_todo

    19  * @license    http://todo     name_todo

    21  */

    21  */

    22 

    22 

    23 /**

    23 /**

    25  */

    25  */

    27 

    52 

    28 /**

    53 /**

    29  * @see Zend_Service_WindowsAzure_Credentials_SharedAccessSignature

    54  * @see Zend_Service_WindowsAzure_Credentials_SharedAccessSignature

    30  */

    55  */

    31 require_once 'Zend/Service/WindowsAzure/Credentials/SharedAccessSignature.php';

    56 require_once 'Zend/Service/WindowsAzure/Credentials/SharedAccessSignature.php';

    84 /**

    57 /**

    85  * @category   Zend

    58  * @category   Zend

    86  * @package    Zend_Service_WindowsAzure

    59  * @package    Zend_Service_WindowsAzure

    87  * @subpackage Storage

    60  * @subpackage Storage

    89  * @license    http://framework.zend.com/license/new-bsd     New BSD License

    62  * @license    http://framework.zend.com/license/new-bsd     New BSD License

    90  */

    63  */

    91 class Zend_Service_WindowsAzure_Storage_Blob extends Zend_Service_WindowsAzure_Storage

    64 class Zend_Service_WindowsAzure_Storage_Blob extends Zend_Service_WindowsAzure_Storage

    92 {

    65 {

    93 	/**

    66 	/**

   152 	/**

   125 	/**

   153 	 * SharedAccessSignature credentials

   126 	 * SharedAccessSignature credentials

   154 	 *

   127 	 *

   155 	 * @var Zend_Service_WindowsAzure_Credentials_SharedAccessSignature

   128 	 * @var Zend_Service_WindowsAzure_Credentials_SharedAccessSignature

   156 	 */

   129 	 */

   158 

   131 

   159 	/**

   132 	/**

   160 	 * Creates a new Zend_Service_WindowsAzure_Storage_Blob instance

   133 	 * Creates a new Zend_Service_WindowsAzure_Storage_Blob instance

   161 	 *

   134 	 *

   162 	 * @param string $host Storage host name

   135 	 * @param string $host Storage host name

   185 	 * @return boolean

   158 	 * @return boolean

   186 	 */

   159 	 */

   187 	public function blobExists($containerName = '', $blobName = '', $snapshotId = null)

   160 	public function blobExists($containerName = '', $blobName = '', $snapshotId = null)

   188 	{

   161 	{

   189 		if ($containerName === '') {

   162 		if ($containerName === '') {

   193 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   168 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   194 		}

   169 		}

   195 		if ($blobName === '') {

   170 		if ($blobName === '') {

   196 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

   172 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

   197 		}

   173 		}

   198 

   174 

   199 		// Get blob instance

   175 		// Get blob instance

   200 		try {

   176 		try {

   213 	 * @return boolean

   189 	 * @return boolean

   214 	 */

   190 	 */

   215 	public function containerExists($containerName = '')

   191 	public function containerExists($containerName = '')

   216 	{

   192 	{

   217 		if ($containerName === '') {

   193 		if ($containerName === '') {

   221 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   199 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   222 		}

   200 		}

   223 			

   201 			

   224 		// List containers

   202 		// List containers

   225 		$containers = $this->listContainers($containerName, 1);

   203 		$containers = $this->listContainers($containerName, 1);

   241 	 * @throws Zend_Service_WindowsAzure_Exception

   219 	 * @throws Zend_Service_WindowsAzure_Exception

   242 	 */

   220 	 */

   243 	public function createContainer($containerName = '', $metadata = array())

   221 	public function createContainer($containerName = '', $metadata = array())

   244 	{

   222 	{

   245 		if ($containerName === '') {

   223 		if ($containerName === '') {

   249 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   229 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   250 		}

   230 		}

   251 		if (!is_array($metadata)) {

   231 		if (!is_array($metadata)) {

   252 			throw new Zend_Service_WindowsAzure_Exception('Meta data should be an array of key and value pairs.');

   233 			throw new Zend_Service_WindowsAzure_Exception('Meta data should be an array of key and value pairs.');

   253 		}

   234 		}

   254 			

   235 			

   255 		// Create metadata headers

   236 		// Create metadata headers

   256 		$headers = array();

   237 		$headers = array();

   257 		$headers = array_merge($headers, $this->_generateMetadataHeaders($metadata));

   238 		$headers = array_merge($headers, $this->_generateMetadataHeaders($metadata));

   258 

   239 

   259 		// Perform request

   240 		// Perform request

   260 		$response = $this->_performRequest($containerName, '?restype=container', Zend_Http_Client::PUT, $headers, false, null, Zend_Service_WindowsAzure_Storage::RESOURCE_CONTAINER, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_WRITE);

   241 		$response = $this->_performRequest($containerName, '?restype=container', Zend_Http_Client::PUT, $headers, false, null, Zend_Service_WindowsAzure_Storage::RESOURCE_CONTAINER, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_WRITE);

   261 		if ($response->isSuccessful()) {

   242 		if ($response->isSuccessful()) {

   262 			return new Zend_Service_WindowsAzure_Storage_BlobContainer(

   244 			return new Zend_Service_WindowsAzure_Storage_BlobContainer(

   263 			$containerName,

   245 			$containerName,

   264 			$response->getHeader('Etag'),

   246 			$response->getHeader('Etag'),

   265 			$response->getHeader('Last-modified'),

   247 			$response->getHeader('Last-modified'),

   266 			$metadata

   248 			$metadata

   267 			);

   249 			);

   268 		} else {

   250 		} else {

   269 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

   252 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

   270 		}

   267 		}

   271 	}

   268 	}

   272 

   269 

   273 	/**

   270 	/**

   274 	 * Get container ACL

   271 	 * Get container ACL

   279 	 * @throws Zend_Service_WindowsAzure_Exception

   276 	 * @throws Zend_Service_WindowsAzure_Exception

   280 	 */

   277 	 */

   281 	public function getContainerAcl($containerName = '', $signedIdentifiers = false)

   278 	public function getContainerAcl($containerName = '', $signedIdentifiers = false)

   282 	{

   279 	{

   283 		if ($containerName === '') {

   280 		if ($containerName === '') {

   287 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   286 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   288 		}

   287 		}

   289 

   288 

   290 		// Perform request

   289 		// Perform request

   291 		$response = $this->_performRequest($containerName, '?restype=container&comp=acl', Zend_Http_Client::GET, array(), false, null, Zend_Service_WindowsAzure_Storage::RESOURCE_CONTAINER, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_READ);

   290 		$response = $this->_performRequest($containerName, '?restype=container&comp=acl', Zend_Http_Client::GET, array(), false, null, Zend_Service_WindowsAzure_Storage::RESOURCE_CONTAINER, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_READ);

   311 					} else {

   310 					} else {

   312 						$entries = array($result->SignedIdentifier);

   311 						$entries = array($result->SignedIdentifier);

   313 					}

   312 					}

   314 				}

   313 				}

   315 

   314 

   316 				// Return value

   316 				// Return value

   317 				$returnValue = array();

   317 				$returnValue = array();

   318 				foreach ($entries as $entry) {

   318 				foreach ($entries as $entry) {

   319 					$returnValue[] = new Zend_Service_WindowsAzure_Storage_SignedIdentifier(

   319 					$returnValue[] = new Zend_Service_WindowsAzure_Storage_SignedIdentifier(

   320 					$entry->Id,

   320 					$entry->Id,

   326 

   326 

   327 				// Return

   327 				// Return

   328 				return $returnValue;

   328 				return $returnValue;

   329 			}

   329 			}

   330 		} else {

   330 		} else {

   331 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

   332 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

   332 		}

   333 		}

   333 	}

   334 	}

   334 

   335 

   335 	/**

   336 	/**

   341 	 * @throws Zend_Service_WindowsAzure_Exception

   342 	 * @throws Zend_Service_WindowsAzure_Exception

   342 	 */

   343 	 */

   343 	public function setContainerAcl($containerName = '', $acl = self::ACL_PRIVATE, $signedIdentifiers = array())

   344 	public function setContainerAcl($containerName = '', $acl = self::ACL_PRIVATE, $signedIdentifiers = array())

   344 	{

   345 	{

   345 		if ($containerName === '') {

   346 		if ($containerName === '') {

   349 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   352 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   350 		}

   353 		}

   351 

   354 

   352 		// Headers

   355 		// Headers

   353 		$headers = array();

   356 		$headers = array();

   354 

   357 

   355 		// Acl specified?

   358 		// Acl specified?

   357 			$headers[Zend_Service_WindowsAzure_Storage::PREFIX_STORAGE_HEADER . 'blob-public-access'] = $acl;

   360 			$headers[Zend_Service_WindowsAzure_Storage::PREFIX_STORAGE_HEADER . 'blob-public-access'] = $acl;

   358 		}

   361 		}

   359 

   362 

   360 		// Policies

   363 		// Policies

   361 		$policies = null;

   364 		$policies = null;

   380 		}

   383 		}

   381 

   384 

   382 		// Perform request

   385 		// Perform request

   383 		$response = $this->_performRequest($containerName, '?restype=container&comp=acl', Zend_Http_Client::PUT, $headers, false, $policies, Zend_Service_WindowsAzure_Storage::RESOURCE_CONTAINER, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_WRITE);

   386 		$response = $this->_performRequest($containerName, '?restype=container&comp=acl', Zend_Http_Client::PUT, $headers, false, $policies, Zend_Service_WindowsAzure_Storage::RESOURCE_CONTAINER, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_WRITE);

   384 		if (!$response->isSuccessful()) {

   387 		if (!$response->isSuccessful()) {

   385 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

   389 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

   386 		}

   390 		}

   387 	}

   391 	}

   388 

   392 

   389 	/**

   393 	/**

   394 	 * @throws Zend_Service_WindowsAzure_Exception

   398 	 * @throws Zend_Service_WindowsAzure_Exception

   395 	 */

   399 	 */

   396 	public function getContainer($containerName = '')

   400 	public function getContainer($containerName = '')

   397 	{

   401 	{

   398 		if ($containerName === '') {

   402 		if ($containerName === '') {

   402 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   408 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   403 		}

   409 		}

   404 

   410 

   405 		// Perform request

   411 		// Perform request

   406 		$response = $this->_performRequest($containerName, '?restype=container', Zend_Http_Client::GET, array(), false, null, Zend_Service_WindowsAzure_Storage::RESOURCE_CONTAINER, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_READ);

   412 		$response = $this->_performRequest($containerName, '?restype=container', Zend_Http_Client::GET, array(), false, null, Zend_Service_WindowsAzure_Storage::RESOURCE_CONTAINER, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_READ);

   414 			$response->getHeader('Etag'),

   420 			$response->getHeader('Etag'),

   415 			$response->getHeader('Last-modified'),

   421 			$response->getHeader('Last-modified'),

   416 			$metadata

   422 			$metadata

   417 			);

   423 			);

   418 		} else {

   424 		} else {

   419 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

   426 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

   420 		}

   427 		}

   421 	}

   428 	}

   422 

   429 

   423 	/**

   430 	/**

   428 	 * @throws Zend_Service_WindowsAzure_Exception

   435 	 * @throws Zend_Service_WindowsAzure_Exception

   429 	 */

   436 	 */

   430 	public function getContainerMetadata($containerName = '')

   437 	public function getContainerMetadata($containerName = '')

   431 	{

   438 	{

   432 		if ($containerName === '') {

   439 		if ($containerName === '') {

   436 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   445 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   437 		}

   446 		}

   438 

   447 

   439 		return $this->getContainer($containerName)->Metadata;

   448 		return $this->getContainer($containerName)->Metadata;

   440 	}

   449 	}

   450 	 * @throws Zend_Service_WindowsAzure_Exception

   459 	 * @throws Zend_Service_WindowsAzure_Exception

   451 	 */

   460 	 */

   452 	public function setContainerMetadata($containerName = '', $metadata = array(), $additionalHeaders = array())

   461 	public function setContainerMetadata($containerName = '', $metadata = array(), $additionalHeaders = array())

   453 	{

   462 	{

   454 		if ($containerName === '') {

   463 		if ($containerName === '') {

   458 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   469 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   459 		}

   470 		}

   460 		if (!is_array($metadata)) {

   471 		if (!is_array($metadata)) {

   461 			throw new Zend_Service_WindowsAzure_Exception('Meta data should be an array of key and value pairs.');

   473 			throw new Zend_Service_WindowsAzure_Exception('Meta data should be an array of key and value pairs.');

   462 		}

   474 		}

   463 		if (count($metadata) == 0) {

   475 		if (count($metadata) == 0) {

   464 			return;

   476 			return;

   465 		}

   477 		}

   474 		}

   486 		}

   475 

   487 

   476 		// Perform request

   488 		// Perform request

   477 		$response = $this->_performRequest($containerName, '?restype=container&comp=metadata', Zend_Http_Client::PUT, $headers, false, null, Zend_Service_WindowsAzure_Storage::RESOURCE_CONTAINER, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_WRITE);

   489 		$response = $this->_performRequest($containerName, '?restype=container&comp=metadata', Zend_Http_Client::PUT, $headers, false, null, Zend_Service_WindowsAzure_Storage::RESOURCE_CONTAINER, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_WRITE);

   478 		if (!$response->isSuccessful()) {

   490 		if (!$response->isSuccessful()) {

   479 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

   492 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

   480 		}

   493 		}

   481 	}

   494 	}

   482 

   495 

   483 	/**

   496 	/**

   488 	 * @throws Zend_Service_WindowsAzure_Exception

   501 	 * @throws Zend_Service_WindowsAzure_Exception

   489 	 */

   502 	 */

   490 	public function deleteContainer($containerName = '', $additionalHeaders = array())

   503 	public function deleteContainer($containerName = '', $additionalHeaders = array())

   491 	{

   504 	{

   492 		if ($containerName === '') {

   505 		if ($containerName === '') {

   496 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   511 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   497 		}

   512 		}

   498 			

   513 			

   499 		// Additional headers?

   514 		// Additional headers?

   500 		$headers = array();

   515 		$headers = array();

   503 		}

   518 		}

   504 

   519 

   505 		// Perform request

   520 		// Perform request

   506 		$response = $this->_performRequest($containerName, '?restype=container', Zend_Http_Client::DELETE, $headers, false, null, Zend_Service_WindowsAzure_Storage::RESOURCE_CONTAINER, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_WRITE);

   521 		$response = $this->_performRequest($containerName, '?restype=container', Zend_Http_Client::DELETE, $headers, false, null, Zend_Service_WindowsAzure_Storage::RESOURCE_CONTAINER, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_WRITE);

   507 		if (!$response->isSuccessful()) {

   522 		if (!$response->isSuccessful()) {

   508 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

   524 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

   509 		}

   525 		}

   510 	}

   526 	}

   511 

   527 

   512 	/**

   528 	/**

   522 	 */

   538 	 */

   523 	public function listContainers($prefix = null, $maxResults = null, $marker = null, $include = null, $currentResultCount = 0)

   539 	public function listContainers($prefix = null, $maxResults = null, $marker = null, $include = null, $currentResultCount = 0)

   524 	{

   540 	{

   525 		// Build query string

   541 		// Build query string

   526 		$queryString = array('comp=list');

   542 		$queryString = array('comp=list');

   528 			$queryString[] = 'prefix=' . $prefix;

   544 			$queryString[] = 'prefix=' . $prefix;

   529 		}

   545 		}

   531 			$queryString[] = 'maxresults=' . $maxResults;

   547 			$queryString[] = 'maxresults=' . $maxResults;

   532 		}

   548 		}

   534 			$queryString[] = 'marker=' . $marker;

   550 			$queryString[] = 'marker=' . $marker;

   535 		}

   551 		}

   537 			$queryString[] = 'include=' . $include;

   553 			$queryString[] = 'include=' . $include;

   538 		}

   554 		}

   539 		$queryString = self::createQueryStringFromArray($queryString);

   555 		$queryString = self::createQueryStringFromArray($queryString);

   540 		 

   556 		 

   541 		// Perform request

   557 		// Perform request

   543 		if ($response->isSuccessful()) {

   559 		if ($response->isSuccessful()) {

   544 			$xmlContainers = $this->_parseResponse($response)->Containers->Container;

   560 			$xmlContainers = $this->_parseResponse($response)->Containers->Container;

   545 			$xmlMarker = (string)$this->_parseResponse($response)->NextMarker;

   561 			$xmlMarker = (string)$this->_parseResponse($response)->NextMarker;

   546 

   562 

   547 			$containers = array();

   563 			$containers = array();

   549 				for ($i = 0; $i < count($xmlContainers); $i++) {

   565 				for ($i = 0; $i < count($xmlContainers); $i++) {

   550 					$containers[] = new Zend_Service_WindowsAzure_Storage_BlobContainer(

   567 					$containers[] = new Zend_Service_WindowsAzure_Storage_BlobContainer(

   551 					(string)$xmlContainers[$i]->Name,

   568 					(string)$xmlContainers[$i]->Name,

   552 					(string)$xmlContainers[$i]->Etag,

   569 					(string)$xmlContainers[$i]->Etag,

   553 					(string)$xmlContainers[$i]->LastModified,

   570 					(string)$xmlContainers[$i]->LastModified,

   554 					$this->_parseMetadataElement($xmlContainers[$i])

   571 					$this->_parseMetadataElement($xmlContainers[$i])

   555 					);

   572 					);

   556 				}

   573 				}

   557 			}

   574 			}

   558 			$currentResultCount = $currentResultCount + count($containers);

   575 			$currentResultCount = $currentResultCount + count($containers);

   561 					$containers = array_merge($containers, $this->listContainers($prefix, $maxResults, $xmlMarker, $include, $currentResultCount));

   578 					$containers = array_merge($containers, $this->listContainers($prefix, $maxResults, $xmlMarker, $include, $currentResultCount));

   562 				}

   579 				}

   563 			}

   580 			}

   565 				$containers = array_slice($containers, 0, $maxResults);

   582 				$containers = array_slice($containers, 0, $maxResults);

   566 			}

   583 			}

   567 			 

   584 			 

   568 			return $containers;

   585 			return $containers;

   569 		} else {

   586 		} else {

   570 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

   588 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

   571 		}

   589 		}

   572 	}

   590 	}

   573 

   591 

   574 	/**

   592 	/**

   584 	 * @throws Zend_Service_WindowsAzure_Exception

   602 	 * @throws Zend_Service_WindowsAzure_Exception

   585 	 */

   603 	 */

   586 	public function putBlob($containerName = '', $blobName = '', $localFileName = '', $metadata = array(), $leaseId = null, $additionalHeaders = array())

   604 	public function putBlob($containerName = '', $blobName = '', $localFileName = '', $metadata = array(), $leaseId = null, $additionalHeaders = array())

   587 	{

   605 	{

   588 		if ($containerName === '') {

   606 		if ($containerName === '') {

   592 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   612 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   593 		}

   613 		}

   594 		if ($blobName === '') {

   614 		if ($blobName === '') {

   595 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

   616 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

   596 		}

   617 		}

   597 		if ($localFileName === '') {

   618 		if ($localFileName === '') {

   598 			throw new Zend_Service_WindowsAzure_Exception('Local file name is not specified.');

   620 			throw new Zend_Service_WindowsAzure_Exception('Local file name is not specified.');

   599 		}

   621 		}

   600 		if (!file_exists($localFileName)) {

   622 		if (!file_exists($localFileName)) {

   601 			throw new Zend_Service_WindowsAzure_Exception('Local file not found.');

   624 			throw new Zend_Service_WindowsAzure_Exception('Local file not found.');

   602 		}

   625 		}

   603 		if ($containerName === '$root' && strpos($blobName, '/') !== false) {

   626 		if ($containerName === '$root' && strpos($blobName, '/') !== false) {

   604 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

   628 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

   605 		}

   629 		}

   606 			

   630 			

   607 		// Check file size

   631 		// Check file size

   608 		if (filesize($localFileName) >= self::MAX_BLOB_SIZE) {

   632 		if (filesize($localFileName) >= self::MAX_BLOB_SIZE) {

   610 		}

   634 		}

   611 

   635 

   612 		// Put the data to Windows Azure Storage

   636 		// Put the data to Windows Azure Storage

   613 		return $this->putBlobData($containerName, $blobName, file_get_contents($localFileName), $metadata, $leaseId, $additionalHeaders);

   637 		return $this->putBlobData($containerName, $blobName, file_get_contents($localFileName), $metadata, $leaseId, $additionalHeaders);

   614 	}

   638 	}

   626 	 * @throws Zend_Service_WindowsAzure_Exception

   650 	 * @throws Zend_Service_WindowsAzure_Exception

   627 	 */

   651 	 */

   628 	public function putBlobData($containerName = '', $blobName = '', $data = '', $metadata = array(), $leaseId = null, $additionalHeaders = array())

   652 	public function putBlobData($containerName = '', $blobName = '', $data = '', $metadata = array(), $leaseId = null, $additionalHeaders = array())

   629 	{

   653 	{

   630 		if ($containerName === '') {

   654 		if ($containerName === '') {

   634 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   660 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   635 		}

   661 		}

   636 		if ($blobName === '') {

   662 		if ($blobName === '') {

   637 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

   664 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

   638 		}

   665 		}

   639 		if ($containerName === '$root' && strpos($blobName, '/') !== false) {

   666 		if ($containerName === '$root' && strpos($blobName, '/') !== false) {

   640 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

   668 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

   641 		}

   669 		}

   642 

   670 

   643 		// Create metadata headers

   671 		// Create metadata headers

   644 		$headers = array();

   672 		$headers = array();

   646 			$headers['x-ms-lease-id'] = $leaseId;

   674 			$headers['x-ms-lease-id'] = $leaseId;

   647 		}

   675 		}

   648 		$headers = array_merge($headers, $this->_generateMetadataHeaders($metadata));

   676 		$headers = array_merge($headers, $this->_generateMetadataHeaders($metadata));

   649 

   677 

   650 		// Additional headers?

   678 		// Additional headers?

   659 		$resourceName = self::createResourceName($containerName , $blobName);

   687 		$resourceName = self::createResourceName($containerName , $blobName);

   660 

   688 

   661 		// Perform request

   689 		// Perform request

   662 		$response = $this->_performRequest($resourceName, '', Zend_Http_Client::PUT, $headers, false, $data, Zend_Service_WindowsAzure_Storage::RESOURCE_BLOB, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_WRITE);

   690 		$response = $this->_performRequest($resourceName, '', Zend_Http_Client::PUT, $headers, false, $data, Zend_Service_WindowsAzure_Storage::RESOURCE_BLOB, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_WRITE);

   663 		if ($response->isSuccessful()) {

   691 		if ($response->isSuccessful()) {

   664 			return new Zend_Service_WindowsAzure_Storage_BlobInstance(

   693 			return new Zend_Service_WindowsAzure_Storage_BlobInstance(

   665 			$containerName,

   694 			$containerName,

   666 			$blobName,

   695 			$blobName,

   667 			null,

   696 			null,

   668 			$response->getHeader('Etag'),

   697 			$response->getHeader('Etag'),

   674 				'',

   703 				'',

   675 			false,

   704 			false,

   676 			$metadata

   705 			$metadata

   677 			);

   706 			);

   678 		} else {

   707 		} else {

   679 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

   709 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

   680 		}

   710 		}

   681 	}

   711 	}

   682 

   712 

   683 	/**

   713 	/**

   686 	 * @param string $containerName Container name

   716 	 * @param string $containerName Container name

   687 	 * @param string $blobName Blob name

   717 	 * @param string $blobName Blob name

   688 	 * @param string $localFileName Local file name to be uploaded

   718 	 * @param string $localFileName Local file name to be uploaded

   689 	 * @param array  $metadata      Key/value pairs of meta data

   719 	 * @param array  $metadata      Key/value pairs of meta data

   690 	 * @param string $leaseId       Lease identifier

   720 	 * @param string $leaseId       Lease identifier

   691 	 * @return object Partial blob properties

   722 	 * @return object Partial blob properties

   692 	 * @throws Zend_Service_WindowsAzure_Exception

   723 	 * @throws Zend_Service_WindowsAzure_Exception

   693 	 */

   724 	 */

   700 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   733 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   701 		}

   734 		}

   702 		if ($blobName === '') {

   735 		if ($blobName === '') {

   703 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

   737 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

   704 		}

   738 		}

   705 		if ($localFileName === '') {

   739 		if ($localFileName === '') {

   706 			throw new Zend_Service_WindowsAzure_Exception('Local file name is not specified.');

   741 			throw new Zend_Service_WindowsAzure_Exception('Local file name is not specified.');

   707 		}

   742 		}

   708 		if (!file_exists($localFileName)) {

   743 		if (!file_exists($localFileName)) {

   709 			throw new Zend_Service_WindowsAzure_Exception('Local file not found.');

   745 			throw new Zend_Service_WindowsAzure_Exception('Local file not found.');

   710 		}

   746 		}

   711 		if ($containerName === '$root' && strpos($blobName, '/') !== false) {

   747 		if ($containerName === '$root' && strpos($blobName, '/') !== false) {

   712 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

   749 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

   713 		}

   750 		}

   714 			

   751 			

   715 		// Check file size

   752 		// Check file size

   716 		if (filesize($localFileName) < self::MAX_BLOB_SIZE) {

   753 		if (filesize($localFileName) < self::MAX_BLOB_SIZE) {

   718 		}

   755 		}

   719 			

   756 			

   720 		// Determine number of parts

   757 		// Determine number of parts

   721 		$numberOfParts = ceil( filesize($localFileName) / self::MAX_BLOB_TRANSFER_SIZE );

   758 		$numberOfParts = ceil( filesize($localFileName) / self::MAX_BLOB_TRANSFER_SIZE );

   722 

   759 

   727 		}

   764 		}

   728 

   765 

   729 		// Open file

   766 		// Open file

   730 		$fp = fopen($localFileName, 'r');

   767 		$fp = fopen($localFileName, 'r');

   731 		if ($fp === false) {

   768 		if ($fp === false) {

   732 			throw new Zend_Service_WindowsAzure_Exception('Could not open local file.');

   770 			throw new Zend_Service_WindowsAzure_Exception('Could not open local file.');

   733 		}

   771 		}

   734 			

   772 			

   735 		// Upload parts

   773 		// Upload parts

   736 		for ($i = 0; $i < $numberOfParts; $i++) {

   774 		for ($i = 0; $i < $numberOfParts; $i++) {

   750 

   788 

   751 		// Close file

   789 		// Close file

   752 		fclose($fp);

   790 		fclose($fp);

   753 

   791 

   754 		// Put block list

   792 		// Put block list

   756 

   794 

   757 		// Return information of the blob

   795 		// Return information of the blob

   758 		return $this->getBlobInstance($containerName, $blobName, null, $leaseId);

   796 		return $this->getBlobInstance($containerName, $blobName, null, $leaseId);

   759 	}

   797 	}

   760 		

   798 		

   769 	 * @throws Zend_Service_WindowsAzure_Exception

   807 	 * @throws Zend_Service_WindowsAzure_Exception

   770 	 */

   808 	 */

   771 	public function putBlock($containerName = '', $blobName = '', $identifier = '', $contents = '', $leaseId = null)

   809 	public function putBlock($containerName = '', $blobName = '', $identifier = '', $contents = '', $leaseId = null)

   772 	{

   810 	{

   773 		if ($containerName === '') {

   811 		if ($containerName === '') {

   777 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   817 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   778 		}

   818 		}

   779 		if ($identifier === '') {

   819 		if ($identifier === '') {

   780 			throw new Zend_Service_WindowsAzure_Exception('Block identifier is not specified.');

   821 			throw new Zend_Service_WindowsAzure_Exception('Block identifier is not specified.');

   781 		}

   822 		}

   782 		if (strlen($contents) > self::MAX_BLOB_TRANSFER_SIZE) {

   823 		if (strlen($contents) > self::MAX_BLOB_TRANSFER_SIZE) {

   783 			throw new Zend_Service_WindowsAzure_Exception('Block size is too big.');

   825 			throw new Zend_Service_WindowsAzure_Exception('Block size is too big.');

   784 		}

   826 		}

   785 		if ($containerName === '$root' && strpos($blobName, '/') !== false) {

   827 		if ($containerName === '$root' && strpos($blobName, '/') !== false) {

   786 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

   829 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

   787 		}

   830 		}

   788 

   831 

   789 		// Headers

   832 		// Headers

   790 		$headers = array();

   833 		$headers = array();

   792 			$headers['x-ms-lease-id'] = $leaseId;

   835 			$headers['x-ms-lease-id'] = $leaseId;

   793 		}

   836 		}

   794 			

   837 			

   795 		// Resource name

   838 		// Resource name

   796 		$resourceName = self::createResourceName($containerName , $blobName);

   839 		$resourceName = self::createResourceName($containerName , $blobName);

   797 

   840 

   798 		// Upload

   841 		// Upload

   799 		$response = $this->_performRequest($resourceName, '?comp=block&blockid=' . base64_encode($identifier), Zend_Http_Client::PUT, $headers, false, $contents, Zend_Service_WindowsAzure_Storage::RESOURCE_BLOB, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_WRITE);

   842 		$response = $this->_performRequest($resourceName, '?comp=block&blockid=' . base64_encode($identifier), Zend_Http_Client::PUT, $headers, false, $contents, Zend_Service_WindowsAzure_Storage::RESOURCE_BLOB, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_WRITE);

   800 		if (!$response->isSuccessful()) {

   843 		if (!$response->isSuccessful()) {

   801 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

   845 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

   802 		}

   846 		}

   803 	}

   847 	}

   804 

   848 

   805 	/**

   849 	/**

   814 	 * @throws Zend_Service_WindowsAzure_Exception

   858 	 * @throws Zend_Service_WindowsAzure_Exception

   815 	 */

   859 	 */

   816 	public function putBlockList($containerName = '', $blobName = '', $blockList = array(), $metadata = array(), $leaseId = null, $additionalHeaders = array())

   860 	public function putBlockList($containerName = '', $blobName = '', $blockList = array(), $metadata = array(), $leaseId = null, $additionalHeaders = array())

   817 	{

   861 	{

   818 		if ($containerName === '') {

   862 		if ($containerName === '') {

   822 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   868 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   823 		}

   869 		}

   824 		if ($blobName === '') {

   870 		if ($blobName === '') {

   825 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

   872 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

   826 		}

   873 		}

   827 		if (count($blockList) == 0) {

   874 		if (count($blockList) == 0) {

   828 			throw new Zend_Service_WindowsAzure_Exception('Block list does not contain any elements.');

   876 			throw new Zend_Service_WindowsAzure_Exception('Block list does not contain any elements.');

   829 		}

   877 		}

   830 		if ($containerName === '$root' && strpos($blobName, '/') !== false) {

   878 		if ($containerName === '$root' && strpos($blobName, '/') !== false) {

   831 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

   880 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

   832 		}

   881 		}

   833 

   882 

   834 		// Generate block list

   883 		// Generate block list

   835 		$blocks = '';

   884 		$blocks = '';

   837 			$blocks .= '  <Latest>' . base64_encode($block) . '</Latest>' . "\n";

   886 			$blocks .= '  <Latest>' . base64_encode($block) . '</Latest>' . "\n";

   838 		}

   887 		}

   839 

   888 

   840 		// Generate block list request

   889 		// Generate block list request

   841 		$fileContents = utf8_encode(implode("\n", array(

   890 		$fileContents = utf8_encode(implode("\n", array(

   846 			)));

   895 			)));

   847 

   896 

   848 			// Create metadata headers

   897 			// Create metadata headers

   849 			$headers = array();

   898 			$headers = array();

   851 				$headers['x-ms-lease-id'] = $leaseId;

   900 				$headers['x-ms-lease-id'] = $leaseId;

   852 			}

   901 			}

   853 			$headers = array_merge($headers, $this->_generateMetadataHeaders($metadata));

   902 			$headers = array_merge($headers, $this->_generateMetadataHeaders($metadata));

   854 

   903 

   855 			// Additional headers?

   904 			// Additional headers?

   861 			$resourceName = self::createResourceName($containerName , $blobName);

   910 			$resourceName = self::createResourceName($containerName , $blobName);

   862 

   911 

   863 			// Perform request

   912 			// Perform request

   864 			$response = $this->_performRequest($resourceName, '?comp=blocklist', Zend_Http_Client::PUT, $headers, false, $fileContents, Zend_Service_WindowsAzure_Storage::RESOURCE_BLOB, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_WRITE);

   913 			$response = $this->_performRequest($resourceName, '?comp=blocklist', Zend_Http_Client::PUT, $headers, false, $fileContents, Zend_Service_WindowsAzure_Storage::RESOURCE_BLOB, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_WRITE);

   865 			if (!$response->isSuccessful()) {

   914 			if (!$response->isSuccessful()) {

   866 				throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

   916 				throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

   867 			}

   917 			}

   868 	}

   918 	}

   869 

   919 

   870 	/**

   920 	/**

   879 	 * @throws Zend_Service_WindowsAzure_Exception

   929 	 * @throws Zend_Service_WindowsAzure_Exception

   880 	 */

   930 	 */

   881 	public function getBlockList($containerName = '', $blobName = '', $snapshotId = null, $leaseId = null, $type = 0)

   931 	public function getBlockList($containerName = '', $blobName = '', $snapshotId = null, $leaseId = null, $type = 0)

   882 	{

   932 	{

   883 		if ($containerName === '') {

   933 		if ($containerName === '') {

   887 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   939 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   888 		}

   940 		}

   889 		if ($blobName === '') {

   941 		if ($blobName === '') {

   890 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

   943 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

   891 		}

   944 		}

   892 		if ($type < 0 || $type > 2) {

   945 		if ($type < 0 || $type > 2) {

   893 			throw new Zend_Service_WindowsAzure_Exception('Invalid type of block list to retrieve.');

   947 			throw new Zend_Service_WindowsAzure_Exception('Invalid type of block list to retrieve.');

   894 		}

   948 		}

   895 

   949 

   896 		// Set $blockListType

   950 		// Set $blockListType

   897 		$blockListType = 'all';

   951 		$blockListType = 'all';

   902 			$blockListType = 'uncommitted';

   956 			$blockListType = 'uncommitted';

   903 		}

   957 		}

   904 

   958 

   905 		// Headers

   959 		// Headers

   906 		$headers = array();

   960 		$headers = array();

   908 			$headers['x-ms-lease-id'] = $leaseId;

   962 			$headers['x-ms-lease-id'] = $leaseId;

   909 		}

   963 		}

   910 

   964 

   911 		// Build query string

   965 		// Build query string

   912 		$queryString = array('comp=blocklist', 'blocklisttype=' . $blockListType);

   966 		$queryString = array('comp=blocklist', 'blocklisttype=' . $blockListType);

   914 			$queryString[] = 'snapshot=' . $snapshotId;

   968 			$queryString[] = 'snapshot=' . $snapshotId;

   915 		}

   969 		}

   916 		$queryString = self::createQueryStringFromArray($queryString);

   970 		$queryString = self::createQueryStringFromArray($queryString);

   917 

   971 

   918 		// Resource name

   972 		// Resource name

   943 				}

   997 				}

   944 			}

   998 			}

   945 

   999 

   946 			return $returnValue;

  1000 			return $returnValue;

   947 		} else {

  1001 		} else {

   948 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

  1003 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

   949 		}

  1004 		}

   950 	}

  1005 	}

   951 

  1006 

   952 	/**

  1007 	/**

   962 	 * @throws Zend_Service_WindowsAzure_Exception

  1017 	 * @throws Zend_Service_WindowsAzure_Exception

   963 	 */

  1018 	 */

   964 	public function createPageBlob($containerName = '', $blobName = '', $size = 0, $metadata = array(), $leaseId = null, $additionalHeaders = array())

  1019 	public function createPageBlob($containerName = '', $blobName = '', $size = 0, $metadata = array(), $leaseId = null, $additionalHeaders = array())

   965 	{

  1020 	{

   966 		if ($containerName === '') {

  1021 		if ($containerName === '') {

   970 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

  1027 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

   971 		}

  1028 		}

   972 		if ($blobName === '') {

  1029 		if ($blobName === '') {

   973 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

  1031 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

   974 		}

  1032 		}

   975 		if ($containerName === '$root' && strpos($blobName, '/') !== false) {

  1033 		if ($containerName === '$root' && strpos($blobName, '/') !== false) {

   976 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

  1035 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

   977 		}

  1036 		}

   978 		if ($size <= 0) {

  1037 		if ($size <= 0) {

   979 			throw new Zend_Service_WindowsAzure_Exception('Page blob size must be specified.');

  1039 			throw new Zend_Service_WindowsAzure_Exception('Page blob size must be specified.');

   980 		}

  1040 		}

   981 

  1041 

   982 		// Create metadata headers

  1042 		// Create metadata headers

   983 		$headers = array();

  1043 		$headers = array();

   985 			$headers['x-ms-lease-id'] = $leaseId;

  1045 			$headers['x-ms-lease-id'] = $leaseId;

   986 		}

  1046 		}

   987 		$headers = array_merge($headers, $this->_generateMetadataHeaders($metadata));

  1047 		$headers = array_merge($headers, $this->_generateMetadataHeaders($metadata));

   988 

  1048 

   989 		// Additional headers?

  1049 		// Additional headers?

  1000 		$resourceName = self::createResourceName($containerName , $blobName);

  1060 		$resourceName = self::createResourceName($containerName , $blobName);

  1001 

  1061 

  1002 		// Perform request

  1062 		// Perform request

  1003 		$response = $this->_performRequest($resourceName, '', Zend_Http_Client::PUT, $headers, false, '', Zend_Service_WindowsAzure_Storage::RESOURCE_BLOB, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_WRITE);

  1063 		$response = $this->_performRequest($resourceName, '', Zend_Http_Client::PUT, $headers, false, '', Zend_Service_WindowsAzure_Storage::RESOURCE_BLOB, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_WRITE);

  1004 		if ($response->isSuccessful()) {

  1064 		if ($response->isSuccessful()) {

  1005 			return new Zend_Service_WindowsAzure_Storage_BlobInstance(

  1066 			return new Zend_Service_WindowsAzure_Storage_BlobInstance(

  1006 			$containerName,

  1067 			$containerName,

  1007 			$blobName,

  1068 			$blobName,

  1008 			null,

  1069 			null,

  1009 			$response->getHeader('Etag'),

  1070 			$response->getHeader('Etag'),

  1015 				'',

  1076 				'',

  1016 			false,

  1077 			false,

  1017 			$metadata

  1078 			$metadata

  1018 			);

  1079 			);

  1019 		} else {

  1080 		} else {

  1020 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

  1082 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

  1021 		}

  1083 		}

  1022 	}

  1084 	}

  1023 

  1085 

  1024 	/**

  1086 	/**

  1035 	 * @throws Zend_Service_WindowsAzure_Exception

  1097 	 * @throws Zend_Service_WindowsAzure_Exception

  1036 	 */

  1098 	 */

  1037 	public function putPage($containerName = '', $blobName = '', $startByteOffset = 0, $endByteOffset = 0, $contents = '', $writeMethod = self::PAGE_WRITE_UPDATE, $leaseId = null, $additionalHeaders = array())

  1099 	public function putPage($containerName = '', $blobName = '', $startByteOffset = 0, $endByteOffset = 0, $contents = '', $writeMethod = self::PAGE_WRITE_UPDATE, $leaseId = null, $additionalHeaders = array())

  1038 	{

  1100 	{

  1039 		if ($containerName === '') {

  1101 		if ($containerName === '') {

  1043 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

  1107 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

  1044 		}

  1108 		}

  1045 		if ($blobName === '') {

  1109 		if ($blobName === '') {

  1046 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

  1111 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

  1047 		}

  1112 		}

  1048 		if ($containerName === '$root' && strpos($blobName, '/') !== false) {

  1113 		if ($containerName === '$root' && strpos($blobName, '/') !== false) {

  1049 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

  1115 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

  1050 		}

  1116 		}

  1051 		if ($startByteOffset % 512 != 0) {

  1117 		if ($startByteOffset % 512 != 0) {

  1052 			throw new Zend_Service_WindowsAzure_Exception('Start byte offset must be a modulus of 512.');

  1119 			throw new Zend_Service_WindowsAzure_Exception('Start byte offset must be a modulus of 512.');

  1053 		}

  1120 		}

  1054 		if (($endByteOffset + 1) % 512 != 0) {

  1121 		if (($endByteOffset + 1) % 512 != 0) {

  1055 			throw new Zend_Service_WindowsAzure_Exception('End byte offset must be a modulus of 512 minus 1.');

  1123 			throw new Zend_Service_WindowsAzure_Exception('End byte offset must be a modulus of 512 minus 1.');

  1056 		}

  1124 		}

  1057 

  1125 

  1058 		// Determine size

  1126 		// Determine size

  1059 		$size = strlen($contents);

  1127 		$size = strlen($contents);

  1060 		if ($size >= self::MAX_BLOB_TRANSFER_SIZE) {

  1128 		if ($size >= self::MAX_BLOB_TRANSFER_SIZE) {

  1061 			throw new Zend_Service_WindowsAzure_Exception('Page blob size must not be larger than ' + self::MAX_BLOB_TRANSFER_SIZE . ' bytes.');

  1130 			throw new Zend_Service_WindowsAzure_Exception('Page blob size must not be larger than ' + self::MAX_BLOB_TRANSFER_SIZE . ' bytes.');

  1062 		}

  1131 		}

  1063 

  1132 

  1064 		// Create metadata headers

  1133 		// Create metadata headers

  1065 		$headers = array();

  1134 		$headers = array();

  1067 			$headers['x-ms-lease-id'] = $leaseId;

  1136 			$headers['x-ms-lease-id'] = $leaseId;

  1068 		}

  1137 		}

  1069 

  1138 

  1070 		// Additional headers?

  1139 		// Additional headers?

  1071 		foreach ($additionalHeaders as $key => $value) {

  1140 		foreach ($additionalHeaders as $key => $value) {

  1082 		$resourceName = self::createResourceName($containerName , $blobName);

  1151 		$resourceName = self::createResourceName($containerName , $blobName);

  1083 

  1152 

  1084 		// Perform request

  1153 		// Perform request

  1085 		$response = $this->_performRequest($resourceName, '?comp=page', Zend_Http_Client::PUT, $headers, false, $contents, Zend_Service_WindowsAzure_Storage::RESOURCE_BLOB, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_WRITE);

  1154 		$response = $this->_performRequest($resourceName, '?comp=page', Zend_Http_Client::PUT, $headers, false, $contents, Zend_Service_WindowsAzure_Storage::RESOURCE_BLOB, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_WRITE);

  1086 		if (!$response->isSuccessful()) {

  1155 		if (!$response->isSuccessful()) {

  1087 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

  1157 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

  1088 		}

  1158 		}

  1089 	}

  1159 	}

  1090 

  1160 

  1091 	/**

  1161 	/**

  1100 	 * @throws Zend_Service_WindowsAzure_Exception

  1170 	 * @throws Zend_Service_WindowsAzure_Exception

  1101 	 */

  1171 	 */

  1102 	public function getPageRegions($containerName = '', $blobName = '', $startByteOffset = 0, $endByteOffset = 0, $leaseId = null)

  1172 	public function getPageRegions($containerName = '', $blobName = '', $startByteOffset = 0, $endByteOffset = 0, $leaseId = null)

  1103 	{

  1173 	{

  1104 		if ($containerName === '') {

  1174 		if ($containerName === '') {

  1108 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

  1180 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

  1109 		}

  1181 		}

  1110 		if ($blobName === '') {

  1182 		if ($blobName === '') {

  1111 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

  1184 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

  1112 		}

  1185 		}

  1113 		if ($containerName === '$root' && strpos($blobName, '/') !== false) {

  1186 		if ($containerName === '$root' && strpos($blobName, '/') !== false) {

  1114 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

  1188 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

  1115 		}

  1189 		}

  1116 		if ($startByteOffset % 512 != 0) {

  1190 		if ($startByteOffset % 512 != 0) {

  1117 			throw new Zend_Service_WindowsAzure_Exception('Start byte offset must be a modulus of 512.');

  1192 			throw new Zend_Service_WindowsAzure_Exception('Start byte offset must be a modulus of 512.');

  1118 		}

  1193 		}

  1119 		if ($endByteOffset > 0 && ($endByteOffset + 1) % 512 != 0) {

  1194 		if ($endByteOffset > 0 && ($endByteOffset + 1) % 512 != 0) {

  1120 			throw new Zend_Service_WindowsAzure_Exception('End byte offset must be a modulus of 512 minus 1.');

  1196 			throw new Zend_Service_WindowsAzure_Exception('End byte offset must be a modulus of 512 minus 1.');

  1121 		}

  1197 		}

  1122 

  1198 

  1123 		// Create metadata headers

  1199 		// Create metadata headers

  1124 		$headers = array();

  1200 		$headers = array();

  1126 			$headers['x-ms-lease-id'] = $leaseId;

  1202 			$headers['x-ms-lease-id'] = $leaseId;

  1127 		}

  1203 		}

  1128 

  1204 

  1129 		// Specify range?

  1205 		// Specify range?

  1130 		if ($endByteOffset > 0) {

  1206 		if ($endByteOffset > 0) {

  1142 			if (count($result->PageRange) > 1) {

  1218 			if (count($result->PageRange) > 1) {

  1143 				$xmlRanges = $result->PageRange;

  1219 				$xmlRanges = $result->PageRange;

  1144 			} else {

  1220 			} else {

  1145 				$xmlRanges = array($result->PageRange);

  1221 				$xmlRanges = array($result->PageRange);

  1146 			}

  1222 			}

  1148 			$ranges = array();

  1225 			$ranges = array();

  1149 			for ($i = 0; $i < count($xmlRanges); $i++) {

  1227 			for ($i = 0; $i < count($xmlRanges); $i++) {

  1150 				$ranges[] = new Zend_Service_WindowsAzure_Storage_PageRegionInstance(

  1228 				$ranges[] = new Zend_Service_WindowsAzure_Storage_PageRegionInstance(

  1151 				(int)$xmlRanges[$i]->Start,

  1229 				(int)$xmlRanges[$i]->Start,

  1152 				(int)$xmlRanges[$i]->End

  1230 				(int)$xmlRanges[$i]->End

  1153 				);

  1231 				);

  1154 			}

  1232 			}

  1155 			 

  1233 			 

  1156 			return $ranges;

  1234 			return $ranges;

  1157 		} else {

  1235 		} else {

  1158 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

  1237 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

  1159 		}

  1238 		}

  1160 	}

  1239 	}

  1161 		

  1240 		

  1162 	/**

  1241 	/**

  1174 	 * @throws Zend_Service_WindowsAzure_Exception

  1253 	 * @throws Zend_Service_WindowsAzure_Exception

  1175 	 */

  1254 	 */

  1176 	public function copyBlob($sourceContainerName = '', $sourceBlobName = '', $destinationContainerName = '', $destinationBlobName = '', $metadata = array(), $sourceSnapshotId = null, $destinationLeaseId = null, $additionalHeaders = array())

  1255 	public function copyBlob($sourceContainerName = '', $sourceBlobName = '', $destinationContainerName = '', $destinationBlobName = '', $metadata = array(), $sourceSnapshotId = null, $destinationLeaseId = null, $additionalHeaders = array())

  1177 	{

  1256 	{

  1178 		if ($sourceContainerName === '') {

  1257 		if ($sourceContainerName === '') {

  1179 			throw new Zend_Service_WindowsAzure_Exception('Source container name is not specified.');

  1259 			throw new Zend_Service_WindowsAzure_Exception('Source container name is not specified.');

  1180 		}

  1260 		}

  1181 		if (!self::isValidContainerName($sourceContainerName)) {

  1261 		if (!self::isValidContainerName($sourceContainerName)) {

  1182 			throw new Zend_Service_WindowsAzure_Exception('Source container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

  1263 			throw new Zend_Service_WindowsAzure_Exception('Source container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

  1183 		}

  1264 		}

  1184 		if ($sourceBlobName === '') {

  1265 		if ($sourceBlobName === '') {

  1185 			throw new Zend_Service_WindowsAzure_Exception('Source blob name is not specified.');

  1267 			throw new Zend_Service_WindowsAzure_Exception('Source blob name is not specified.');

  1186 		}

  1268 		}

  1187 		if ($destinationContainerName === '') {

  1269 		if ($destinationContainerName === '') {

  1188 			throw new Zend_Service_WindowsAzure_Exception('Destination container name is not specified.');

  1271 			throw new Zend_Service_WindowsAzure_Exception('Destination container name is not specified.');

  1189 		}

  1272 		}

  1190 		if (!self::isValidContainerName($destinationContainerName)) {

  1273 		if (!self::isValidContainerName($destinationContainerName)) {

  1191 			throw new Zend_Service_WindowsAzure_Exception('Destination container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

  1275 			throw new Zend_Service_WindowsAzure_Exception('Destination container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

  1192 		}

  1276 		}

  1193 		if ($destinationBlobName === '') {

  1277 		if ($destinationBlobName === '') {

  1194 			throw new Zend_Service_WindowsAzure_Exception('Destination blob name is not specified.');

  1279 			throw new Zend_Service_WindowsAzure_Exception('Destination blob name is not specified.');

  1195 		}

  1280 		}

  1196 		if ($sourceContainerName === '$root' && strpos($sourceBlobName, '/') !== false) {

  1281 		if ($sourceContainerName === '$root' && strpos($sourceBlobName, '/') !== false) {

  1197 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

  1283 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

  1198 		}

  1284 		}

  1199 		if ($destinationContainerName === '$root' && strpos($destinationBlobName, '/') !== false) {

  1285 		if ($destinationContainerName === '$root' && strpos($destinationBlobName, '/') !== false) {

  1200 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

  1287 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

  1201 		}

  1288 		}

  1202 

  1289 

  1203 		// Create metadata headers

  1290 		// Create metadata headers

  1204 		$headers = array();

  1291 		$headers = array();

  1206 			$headers['x-ms-lease-id'] = $destinationLeaseId;

  1293 			$headers['x-ms-lease-id'] = $destinationLeaseId;

  1207 		}

  1294 		}

  1208 		$headers = array_merge($headers, $this->_generateMetadataHeaders($metadata));

  1295 		$headers = array_merge($headers, $this->_generateMetadataHeaders($metadata));

  1209 

  1296 

  1210 		// Additional headers?

  1297 		// Additional headers?

  1212 			$headers[$key] = $value;

  1299 			$headers[$key] = $value;

  1213 		}

  1300 		}

  1214 

  1301 

  1215 		// Resource names

  1302 		// Resource names

  1216 		$sourceResourceName = self::createResourceName($sourceContainerName, $sourceBlobName);

  1303 		$sourceResourceName = self::createResourceName($sourceContainerName, $sourceBlobName);

  1218 			$sourceResourceName .= '?snapshot=' . $sourceSnapshotId;

  1305 			$sourceResourceName .= '?snapshot=' . $sourceSnapshotId;

  1219 		}

  1306 		}

  1220 		$destinationResourceName = self::createResourceName($destinationContainerName, $destinationBlobName);

  1307 		$destinationResourceName = self::createResourceName($destinationContainerName, $destinationBlobName);

  1221 

  1308 

  1222 		// Set source blob

  1309 		// Set source blob

  1223 		$headers["x-ms-copy-source"] = '/' . $this->_accountName . '/' . $sourceResourceName;

  1310 		$headers["x-ms-copy-source"] = '/' . $this->_accountName . '/' . $sourceResourceName;

  1224 

  1311 

  1225 		// Perform request

  1312 		// Perform request

  1226 		$response = $this->_performRequest($destinationResourceName, '', Zend_Http_Client::PUT, $headers, false, null, Zend_Service_WindowsAzure_Storage::RESOURCE_BLOB, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_WRITE);

  1313 		$response = $this->_performRequest($destinationResourceName, '', Zend_Http_Client::PUT, $headers, false, null, Zend_Service_WindowsAzure_Storage::RESOURCE_BLOB, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_WRITE);

  1227 		if ($response->isSuccessful()) {

  1314 		if ($response->isSuccessful()) {

  1228 			return new Zend_Service_WindowsAzure_Storage_BlobInstance(

  1316 			return new Zend_Service_WindowsAzure_Storage_BlobInstance(

  1229 			$destinationContainerName,

  1317 			$destinationContainerName,

  1230 			$destinationBlobName,

  1318 			$destinationBlobName,

  1231 			null,

  1319 			null,

  1232 			$response->getHeader('Etag'),

  1320 			$response->getHeader('Etag'),

  1238 				'',

  1326 				'',

  1239 			false,

  1327 			false,

  1240 			$metadata

  1328 			$metadata

  1241 			);

  1329 			);

  1242 		} else {

  1330 		} else {

  1243 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

  1332 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

  1244 		}

  1333 		}

  1245 	}

  1334 	}

  1246 

  1335 

  1247 	/**

  1336 	/**

  1256 	 * @throws Zend_Service_WindowsAzure_Exception

  1345 	 * @throws Zend_Service_WindowsAzure_Exception

  1257 	 */

  1346 	 */

  1258 	public function getBlob($containerName = '', $blobName = '', $localFileName = '', $snapshotId = null, $leaseId = null, $additionalHeaders = array())

  1347 	public function getBlob($containerName = '', $blobName = '', $localFileName = '', $snapshotId = null, $leaseId = null, $additionalHeaders = array())

  1259 	{

  1348 	{

  1260 		if ($containerName === '') {

  1349 		if ($containerName === '') {

  1264 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

  1355 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

  1265 		}

  1356 		}

  1266 		if ($blobName === '') {

  1357 		if ($blobName === '') {

  1267 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

  1359 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

  1268 		}

  1360 		}

  1269 		if ($localFileName === '') {

  1361 		if ($localFileName === '') {

  1270 			throw new Zend_Service_WindowsAzure_Exception('Local file name is not specified.');

  1363 			throw new Zend_Service_WindowsAzure_Exception('Local file name is not specified.');

  1271 		}

  1364 		}

  1272 

  1365 

  1273 		// Fetch data

  1366 		// Fetch data

  1274 		file_put_contents($localFileName, $this->getBlobData($containerName, $blobName, $snapshotId, $leaseId, $additionalHeaders));

  1367 		file_put_contents($localFileName, $this->getBlobData($containerName, $blobName, $snapshotId, $leaseId, $additionalHeaders));

  1286 	 * @throws Zend_Service_WindowsAzure_Exception

  1379 	 * @throws Zend_Service_WindowsAzure_Exception

  1287 	 */

  1380 	 */

  1288 	public function getBlobData($containerName = '', $blobName = '', $snapshotId = null, $leaseId = null, $additionalHeaders = array())

  1381 	public function getBlobData($containerName = '', $blobName = '', $snapshotId = null, $leaseId = null, $additionalHeaders = array())

  1289 	{

  1382 	{

  1290 		if ($containerName === '') {

  1383 		if ($containerName === '') {

  1294 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

  1389 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

  1295 		}

  1390 		}

  1296 		if ($blobName === '') {

  1391 		if ($blobName === '') {

  1297 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

  1393 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

  1298 		}

  1394 		}

  1299 

  1395 

  1300 		// Build query string

  1396 		// Build query string

  1301 		$queryString = array();

  1397 		$queryString = array();

  1303 			$queryString[] = 'snapshot=' . $snapshotId;

  1399 			$queryString[] = 'snapshot=' . $snapshotId;

  1304 		}

  1400 		}

  1305 		$queryString = self::createQueryStringFromArray($queryString);

  1401 		$queryString = self::createQueryStringFromArray($queryString);

  1306 

  1402 

  1307 		// Additional headers?

  1403 		// Additional headers?

  1308 		$headers = array();

  1404 		$headers = array();

  1310 			$headers['x-ms-lease-id'] = $leaseId;

  1406 			$headers['x-ms-lease-id'] = $leaseId;

  1311 		}

  1407 		}

  1312 		foreach ($additionalHeaders as $key => $value) {

  1408 		foreach ($additionalHeaders as $key => $value) {

  1313 			$headers[$key] = $value;

  1409 			$headers[$key] = $value;

  1314 		}

  1410 		}

  1319 		// Perform request

  1415 		// Perform request

  1320 		$response = $this->_performRequest($resourceName, $queryString, Zend_Http_Client::GET, $headers, false, null, Zend_Service_WindowsAzure_Storage::RESOURCE_BLOB, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_READ);

  1416 		$response = $this->_performRequest($resourceName, $queryString, Zend_Http_Client::GET, $headers, false, null, Zend_Service_WindowsAzure_Storage::RESOURCE_BLOB, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_READ);

  1321 		if ($response->isSuccessful()) {

  1417 		if ($response->isSuccessful()) {

  1322 			return $response->getBody();

  1418 			return $response->getBody();

  1323 		} else {

  1419 		} else {

  1324 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

  1421 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

  1325 		}

  1422 		}

  1326 	}

  1423 	}

  1327 

  1424 

  1328 	/**

  1425 	/**

  1337 	 * @throws Zend_Service_WindowsAzure_Exception

  1434 	 * @throws Zend_Service_WindowsAzure_Exception

  1338 	 */

  1435 	 */

  1339 	public function getBlobInstance($containerName = '', $blobName = '', $snapshotId = null, $leaseId = null, $additionalHeaders = array())

  1436 	public function getBlobInstance($containerName = '', $blobName = '', $snapshotId = null, $leaseId = null, $additionalHeaders = array())

  1340 	{

  1437 	{

  1341 		if ($containerName === '') {

  1438 		if ($containerName === '') {

  1345 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

  1444 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

  1346 		}

  1445 		}

  1347 		if ($blobName === '') {

  1446 		if ($blobName === '') {

  1348 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

  1448 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

  1349 		}

  1449 		}

  1350 		if ($containerName === '$root' && strpos($blobName, '/') !== false) {

  1450 		if ($containerName === '$root' && strpos($blobName, '/') !== false) {

  1351 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

  1452 			throw new Zend_Service_WindowsAzure_Exception('Blobs stored in the root container can not have a name containing a forward slash (/).');

  1352 		}

  1453 		}

  1353 

  1454 

  1354 		// Build query string

  1455 		// Build query string

  1355 		$queryString = array();

  1456 		$queryString = array();

  1357 			$queryString[] = 'snapshot=' . $snapshotId;

  1458 			$queryString[] = 'snapshot=' . $snapshotId;

  1358 		}

  1459 		}

  1359 		$queryString = self::createQueryStringFromArray($queryString);

  1460 		$queryString = self::createQueryStringFromArray($queryString);

  1360 		 

  1461 		 

  1361 		// Additional headers?

  1462 		// Additional headers?

  1362 		$headers = array();

  1463 		$headers = array();

  1364 			$headers['x-ms-lease-id'] = $leaseId;

  1465 			$headers['x-ms-lease-id'] = $leaseId;

  1365 		}

  1466 		}

  1366 		foreach ($additionalHeaders as $key => $value) {

  1467 		foreach ($additionalHeaders as $key => $value) {

  1367 			$headers[$key] = $value;

  1468 			$headers[$key] = $value;

  1368 		}

  1469 		}

  1373 		// Perform request

  1474 		// Perform request

  1374 		$response = $this->_performRequest($resourceName, $queryString, Zend_Http_Client::HEAD, $headers, false, null, Zend_Service_WindowsAzure_Storage::RESOURCE_BLOB, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_READ);

  1475 		$response = $this->_performRequest($resourceName, $queryString, Zend_Http_Client::HEAD, $headers, false, null, Zend_Service_WindowsAzure_Storage::RESOURCE_BLOB, Zend_Service_WindowsAzure_Credentials_CredentialsAbstract::PERMISSION_READ);

  1375 		if ($response->isSuccessful()) {

  1476 		if ($response->isSuccessful()) {

  1376 			// Parse metadata

  1477 			// Parse metadata

  1377 			$metadata = $this->_parseMetadataHeaders($response->getHeaders());

  1478 			$metadata = $this->_parseMetadataHeaders($response->getHeaders());

  1379 			// Return blob

  1480 			// Return blob

  1380 			return new Zend_Service_WindowsAzure_Storage_BlobInstance(

  1481 			return new Zend_Service_WindowsAzure_Storage_BlobInstance(

  1396 			);

  1497 			);

  1397 		} else {

  1498 		} else {

  1398 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

  1500 			throw new Zend_Service_WindowsAzure_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

  1399 		}

  1501 		}

  1400 	}

  1502 	}

  1401 

  1503 

  1402 	/**

  1504 	/**

  1410 	 * @throws Zend_Service_WindowsAzure_Exception

  1512 	 * @throws Zend_Service_WindowsAzure_Exception

  1411 	 */

  1513 	 */

  1412 	public function getBlobMetadata($containerName = '', $blobName = '', $snapshotId = null, $leaseId = null)

  1514 	public function getBlobMetadata($containerName = '', $blobName = '', $snapshotId = null, $leaseId = null)

  1413 	{

  1515 	{

  1414 		if ($containerName === '') {

  1516 		if ($containerName === '') {

  1418 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

  1522 			throw new Zend_Service_WindowsAzure_Exception('Container name does not adhere to container naming conventions. See http://msdn.microsoft.com/en-us/library/dd135715.aspx for more information.');

  1419 		}

  1523 		}

  1420 		if ($blobName === '') {

  1524 		if ($blobName === '') {

  1421 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');

  1526 			throw new Zend_Service_WindowsAzure_Exception('Blob name is not specified.');