installed plugin W3 Total Cache version 2.3.2
This commit is contained in:
Gitium
@ -0,0 +1,167 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Utilities;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Validate;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Resources;
|
||||
use MicrosoftAzure\Storage\Common\Internal\ConnectionStringSource;
|
||||
|
||||
/**
|
||||
* Configuration manager for accessing Windows Azure settings.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class CloudConfigurationManager
|
||||
{
|
||||
/**
|
||||
* @var boolean
|
||||
*/
|
||||
private static $_isInitialized = false;
|
||||
|
||||
/**
|
||||
* The list of connection string sources.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private static $_sources;
|
||||
|
||||
/**
|
||||
* Restrict users from creating instances from this class
|
||||
*/
|
||||
private function __construct()
|
||||
{
|
||||
|
||||
}
|
||||
|
||||
/**
|
||||
* Initializes the connection string source providers.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
private static function _init()
|
||||
{
|
||||
if (!self::$_isInitialized) {
|
||||
self::$_sources = array();
|
||||
|
||||
// Get list of default connection string sources.
|
||||
$default = ConnectionStringSource::getDefaultSources();
|
||||
foreach ($default as $name => $provider) {
|
||||
self::$_sources[$name] = $provider;
|
||||
}
|
||||
|
||||
self::$_isInitialized = true;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets a connection string from all available sources.
|
||||
*
|
||||
* @param string $key The connection string key name.
|
||||
*
|
||||
* @return string If the key does not exist return null.
|
||||
*/
|
||||
public static function getConnectionString($key)
|
||||
{
|
||||
Validate::isString($key, 'key');
|
||||
|
||||
self::_init();
|
||||
$value = null;
|
||||
|
||||
foreach (self::$_sources as $source) {
|
||||
$value = call_user_func_array($source, array($key));
|
||||
|
||||
if (!empty($value)) {
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
return $value;
|
||||
}
|
||||
|
||||
/**
|
||||
* Registers a new connection string source provider. If the source to get
|
||||
* registered is a default source, only the name of the source is required.
|
||||
*
|
||||
* @param string $name The source name.
|
||||
* @param callable $provider The source callback.
|
||||
* @param boolean $prepend When true, the $provider is processed first when
|
||||
* calling getConnectionString. When false (the default) the $provider is
|
||||
* processed after the existing callbacks.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public static function registerSource($name, $provider = null, $prepend = false)
|
||||
{
|
||||
Validate::isString($name, 'name');
|
||||
Validate::notNullOrEmpty($name, 'name');
|
||||
|
||||
self::_init();
|
||||
$default = ConnectionStringSource::getDefaultSources();
|
||||
|
||||
// Try to get callback if the user is trying to register a default source.
|
||||
$provider = Utilities::tryGetValue($default, $name, $provider);
|
||||
|
||||
Validate::notNullOrEmpty($provider, 'callback');
|
||||
|
||||
if ($prepend) {
|
||||
self::$_sources = array_merge(
|
||||
array($name => $provider),
|
||||
self::$_sources
|
||||
);
|
||||
|
||||
} else {
|
||||
self::$_sources[$name] = $provider;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Unregisters a connection string source.
|
||||
*
|
||||
* @param string $name The source name.
|
||||
*
|
||||
* @return callable
|
||||
*/
|
||||
public static function unregisterSource($name)
|
||||
{
|
||||
Validate::isString($name, 'name');
|
||||
Validate::notNullOrEmpty($name, 'name');
|
||||
|
||||
self::_init();
|
||||
|
||||
$sourceCallback = Utilities::tryGetValue(self::$_sources, $name);
|
||||
|
||||
if (!is_null($sourceCallback)) {
|
||||
unset(self::$_sources[$name]);
|
||||
}
|
||||
|
||||
return $sourceCallback;
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,60 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Authentication
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal\Authentication;
|
||||
|
||||
/**
|
||||
* Interface for azure authentication schemes.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Authentication
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
interface IAuthScheme
|
||||
{
|
||||
/**
|
||||
* Returns authorization header to be included in the request.
|
||||
*
|
||||
* @param array $headers request headers.
|
||||
* @param string $url reuqest url.
|
||||
* @param array $queryParams query variables.
|
||||
* @param string $httpMethod request http method.
|
||||
*
|
||||
* @see Specifying the Authorization Header section at
|
||||
* http://msdn.microsoft.com/en-us/library/windowsazure/dd179428.aspx
|
||||
*
|
||||
* @abstract
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function getAuthorizationHeader($headers, $url, $queryParams,
|
||||
$httpMethod
|
||||
);
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,139 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Authentication
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal\Authentication;
|
||||
|
||||
use MicrosoftAzure\Storage\Common\Internal\Authentication\StorageAuthScheme;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Resources;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Utilities;
|
||||
|
||||
/**
|
||||
* Provides shared key authentication scheme for blob and queue. For more info
|
||||
* check: http://msdn.microsoft.com/en-us/library/windowsazure/dd179428.aspx
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Authentication
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class SharedKeyAuthScheme extends StorageAuthScheme
|
||||
{
|
||||
protected $includedHeaders;
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
*
|
||||
* @param string $accountName storage account name.
|
||||
* @param string $accountKey storage account primary or secondary key.
|
||||
*
|
||||
* @return
|
||||
* MicrosoftAzure\Storage\Common\Internal\Authentication\SharedKeyAuthScheme
|
||||
*/
|
||||
public function __construct($accountName, $accountKey)
|
||||
{
|
||||
parent::__construct($accountName, $accountKey);
|
||||
|
||||
$this->includedHeaders = array();
|
||||
$this->includedHeaders[] = Resources::CONTENT_ENCODING;
|
||||
$this->includedHeaders[] = Resources::CONTENT_LANGUAGE;
|
||||
$this->includedHeaders[] = Resources::CONTENT_LENGTH;
|
||||
$this->includedHeaders[] = Resources::CONTENT_MD5;
|
||||
$this->includedHeaders[] = Resources::CONTENT_TYPE;
|
||||
$this->includedHeaders[] = Resources::DATE;
|
||||
$this->includedHeaders[] = Resources::IF_MODIFIED_SINCE;
|
||||
$this->includedHeaders[] = Resources::IF_MATCH;
|
||||
$this->includedHeaders[] = Resources::IF_NONE_MATCH;
|
||||
$this->includedHeaders[] = Resources::IF_UNMODIFIED_SINCE;
|
||||
$this->includedHeaders[] = Resources::RANGE;
|
||||
}
|
||||
|
||||
/**
|
||||
* Computes the authorization signature for blob and queue shared key.
|
||||
*
|
||||
* @param array $headers request headers.
|
||||
* @param string $url reuqest url.
|
||||
* @param array $queryParams query variables.
|
||||
* @param string $httpMethod request http method.
|
||||
*
|
||||
* @see Blob and Queue Services (Shared Key Authentication) at
|
||||
* http://msdn.microsoft.com/en-us/library/windowsazure/dd179428.aspx
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function computeSignature($headers, $url, $queryParams, $httpMethod)
|
||||
{
|
||||
$canonicalizedHeaders = parent::computeCanonicalizedHeaders($headers);
|
||||
|
||||
$canonicalizedResource = parent::computeCanonicalizedResource(
|
||||
$url,
|
||||
$queryParams
|
||||
);
|
||||
|
||||
$stringToSign = array();
|
||||
$stringToSign[] = strtoupper($httpMethod);
|
||||
|
||||
foreach ($this->includedHeaders as $header) {
|
||||
$stringToSign[] = Utilities::tryGetValue($headers, $header);
|
||||
}
|
||||
|
||||
if (count($canonicalizedHeaders) > 0) {
|
||||
$stringToSign[] = implode("\n", $canonicalizedHeaders);
|
||||
}
|
||||
|
||||
$stringToSign[] = $canonicalizedResource;
|
||||
$stringToSign = implode("\n", $stringToSign);
|
||||
|
||||
return $stringToSign;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns authorization header to be included in the request.
|
||||
*
|
||||
* @param array $headers request headers.
|
||||
* @param string $url reuqest url.
|
||||
* @param array $queryParams query variables.
|
||||
* @param string $httpMethod request http method.
|
||||
*
|
||||
* @see Specifying the Authorization Header section at
|
||||
* http://msdn.microsoft.com/en-us/library/windowsazure/dd179428.aspx
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function getAuthorizationHeader($headers, $url, $queryParams, $httpMethod)
|
||||
{
|
||||
$signature = $this->computeSignature(
|
||||
$headers,
|
||||
$url,
|
||||
$queryParams,
|
||||
$httpMethod
|
||||
);
|
||||
|
||||
return 'SharedKey ' . $this->accountName . ':' . base64_encode(
|
||||
hash_hmac('sha256', $signature, base64_decode($this->accountKey), true)
|
||||
);
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,213 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Authentication
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal\Authentication;
|
||||
|
||||
use MicrosoftAzure\Storage\Common\Internal\Resources;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Utilities;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Authentication\IAuthScheme;
|
||||
|
||||
/**
|
||||
* Base class for azure authentication schemes.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Authentication
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
abstract class StorageAuthScheme implements IAuthScheme
|
||||
{
|
||||
protected $accountName;
|
||||
protected $accountKey;
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
*
|
||||
* @param string $accountName storage account name.
|
||||
* @param string $accountKey storage account primary or secondary key.
|
||||
*
|
||||
* @return
|
||||
* MicrosoftAzure\Storage\Common\Internal\Authentication\StorageAuthScheme
|
||||
*/
|
||||
public function __construct($accountName, $accountKey)
|
||||
{
|
||||
$this->accountKey = $accountKey;
|
||||
$this->accountName = $accountName;
|
||||
}
|
||||
|
||||
/**
|
||||
* Computes canonicalized headers for headers array.
|
||||
*
|
||||
* @param array $headers request headers.
|
||||
*
|
||||
* @see Constructing the Canonicalized Headers String section at
|
||||
* http://msdn.microsoft.com/en-us/library/windowsazure/dd179428.aspx
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
protected function computeCanonicalizedHeaders($headers)
|
||||
{
|
||||
$canonicalizedHeaders = array();
|
||||
$normalizedHeaders = array();
|
||||
$validPrefix = Resources::X_MS_HEADER_PREFIX;
|
||||
|
||||
if (is_null($normalizedHeaders)) {
|
||||
return $canonicalizedHeaders;
|
||||
}
|
||||
|
||||
foreach ($headers as $header => $value) {
|
||||
// Convert header to lower case.
|
||||
$header = strtolower($header);
|
||||
|
||||
// Retrieve all headers for the resource that begin with x-ms-,
|
||||
// including the x-ms-date header.
|
||||
if (Utilities::startsWith($header, $validPrefix)) {
|
||||
// Unfold the string by replacing any breaking white space
|
||||
// (meaning what splits the headers, which is \r\n) with a single
|
||||
// space.
|
||||
$value = str_replace("\r\n", ' ', $value);
|
||||
|
||||
// Trim any white space around the colon in the header.
|
||||
$value = ltrim($value);
|
||||
$header = rtrim($header);
|
||||
|
||||
$normalizedHeaders[$header] = $value;
|
||||
}
|
||||
}
|
||||
|
||||
// Sort the headers lexicographically by header name, in ascending order.
|
||||
// Note that each header may appear only once in the string.
|
||||
ksort($normalizedHeaders);
|
||||
|
||||
foreach ($normalizedHeaders as $key => $value) {
|
||||
$canonicalizedHeaders[] = $key . ':' . $value;
|
||||
}
|
||||
|
||||
return $canonicalizedHeaders;
|
||||
}
|
||||
|
||||
/**
|
||||
* Computes canonicalized resources from URL using Table formar
|
||||
*
|
||||
* @param string $url request url.
|
||||
* @param array $queryParams request query variables.
|
||||
*
|
||||
* @see Constructing the Canonicalized Resource String section at
|
||||
* http://msdn.microsoft.com/en-us/library/windowsazure/dd179428.aspx
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function computeCanonicalizedResourceForTable($url, $queryParams)
|
||||
{
|
||||
$queryParams = array_change_key_case($queryParams);
|
||||
|
||||
// 1. Beginning with an empty string (""), append a forward slash (/),
|
||||
// followed by the name of the account that owns the accessed resource.
|
||||
$canonicalizedResource = '/' . $this->accountName;
|
||||
|
||||
// 2. Append the resource's encoded URI path, without any query parameters.
|
||||
$canonicalizedResource .= parse_url($url, PHP_URL_PATH);
|
||||
|
||||
// 3. The query string should include the question mark and the comp
|
||||
// parameter (for example, ?comp=metadata). No other parameters should
|
||||
// be included on the query string.
|
||||
if (array_key_exists(Resources::QP_COMP, $queryParams)) {
|
||||
$canonicalizedResource .= '?' . Resources::QP_COMP . '=';
|
||||
$canonicalizedResource .= $queryParams[Resources::QP_COMP];
|
||||
}
|
||||
|
||||
return $canonicalizedResource;
|
||||
}
|
||||
|
||||
/**
|
||||
* Computes canonicalized resources from URL.
|
||||
*
|
||||
* @param string $url request url.
|
||||
* @param array $queryParams request query variables.
|
||||
*
|
||||
* @see Constructing the Canonicalized Resource String section at
|
||||
* http://msdn.microsoft.com/en-us/library/windowsazure/dd179428.aspx
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function computeCanonicalizedResource($url, $queryParams)
|
||||
{
|
||||
$queryParams = array_change_key_case($queryParams);
|
||||
|
||||
// 1. Beginning with an empty string (""), append a forward slash (/),
|
||||
// followed by the name of the account that owns the accessed resource.
|
||||
$canonicalizedResource = '/' . $this->accountName;
|
||||
|
||||
// 2. Append the resource's encoded URI path, without any query parameters.
|
||||
$canonicalizedResource .= parse_url($url, PHP_URL_PATH);
|
||||
|
||||
// 3. Retrieve all query parameters on the resource URI, including the comp
|
||||
// parameter if it exists.
|
||||
// 4. Sort the query parameters lexicographically by parameter name, in
|
||||
// ascending order.
|
||||
if (count($queryParams) > 0) {
|
||||
ksort($queryParams);
|
||||
}
|
||||
|
||||
// 5. Convert all parameter names to lowercase.
|
||||
// 6. URL-decode each query parameter name and value.
|
||||
// 7. Append each query parameter name and value to the string in the
|
||||
// following format:
|
||||
// parameter-name:parameter-value
|
||||
// 9. Group query parameters
|
||||
// 10. Append a new line character (\n) after each name-value pair.
|
||||
foreach ($queryParams as $key => $value) {
|
||||
// $value must already be ordered lexicographically
|
||||
// See: ServiceRestProxy::groupQueryValues
|
||||
$canonicalizedResource .= "\n" . $key . ':' . $value;
|
||||
}
|
||||
|
||||
return $canonicalizedResource;
|
||||
}
|
||||
|
||||
/**
|
||||
* Computes the authorization signature.
|
||||
*
|
||||
* @param array $headers request headers.
|
||||
* @param string $url reuqest url.
|
||||
* @param array $queryParams query variables.
|
||||
* @param string $httpMethod request http method.
|
||||
*
|
||||
* @see check all authentication schemes at
|
||||
* http://msdn.microsoft.com/en-us/library/windowsazure/dd179428.aspx
|
||||
*
|
||||
* @abstract
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
abstract protected function computeSignature(
|
||||
$headers,
|
||||
$url,
|
||||
$queryParams,
|
||||
$httpMethod
|
||||
);
|
||||
}
|
||||
@ -0,0 +1,121 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Authentication
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link http://github.com/windowsazure/azure-sdk-for-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal\Authentication;
|
||||
|
||||
use MicrosoftAzure\Storage\Common\Internal\Authentication\StorageAuthScheme;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Resources;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Utilities;
|
||||
|
||||
/**
|
||||
* Provides shared key authentication scheme for blob and queue. For more info
|
||||
* check: http://msdn.microsoft.com/en-us/library/windowsazure/dd179428.aspx
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Authentication
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link http://github.com/windowsazure/azure-sdk-for-php
|
||||
*/
|
||||
class TableSharedKeyLiteAuthScheme extends StorageAuthScheme
|
||||
{
|
||||
protected $includedHeaders;
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
*
|
||||
* @param string $accountName storage account name.
|
||||
* @param string $accountKey storage account primary or secondary key.
|
||||
*
|
||||
* @return TableSharedKeyLiteAuthScheme
|
||||
*/
|
||||
public function __construct($accountName, $accountKey)
|
||||
{
|
||||
parent::__construct($accountName, $accountKey);
|
||||
|
||||
$this->includedHeaders = array();
|
||||
$this->includedHeaders[] = Resources::DATE;
|
||||
}
|
||||
|
||||
/**
|
||||
* Computes the authorization signature for blob and queue shared key.
|
||||
*
|
||||
* @param array $headers request headers.
|
||||
* @param string $url reuqest url.
|
||||
* @param array $queryParams query variables.
|
||||
* @param string $httpMethod request http method.
|
||||
*
|
||||
* @see Blob and Queue Services (Shared Key Authentication) at
|
||||
* http://msdn.microsoft.com/en-us/library/windowsazure/dd179428.aspx
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
protected function computeSignature($headers, $url, $queryParams, $httpMethod)
|
||||
{
|
||||
$canonicalizedResource = parent::computeCanonicalizedResourceForTable(
|
||||
$url,
|
||||
$queryParams
|
||||
);
|
||||
|
||||
$stringToSign = array();
|
||||
|
||||
foreach ($this->includedHeaders as $header) {
|
||||
$stringToSign[] = Utilities::tryGetValue($headers, $header);
|
||||
}
|
||||
|
||||
$stringToSign[] = $canonicalizedResource;
|
||||
$stringToSign = implode("\n", $stringToSign);
|
||||
|
||||
return $stringToSign;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns authorization header to be included in the request.
|
||||
*
|
||||
* @param array $headers request headers.
|
||||
* @param string $url reuqest url.
|
||||
* @param array $queryParams query variables.
|
||||
* @param string $httpMethod request http method.
|
||||
*
|
||||
* @see Specifying the Authorization Header section at
|
||||
* http://msdn.microsoft.com/en-us/library/windowsazure/dd179428.aspx
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function getAuthorizationHeader($headers, $url, $queryParams, $httpMethod)
|
||||
{
|
||||
$signature = $this->computeSignature(
|
||||
$headers,
|
||||
$url,
|
||||
$queryParams,
|
||||
$httpMethod
|
||||
);
|
||||
|
||||
return 'SharedKeyLite ' . $this->accountName . ':' . base64_encode(
|
||||
hash_hmac('sha256', $signature, base64_decode($this->accountKey), true)
|
||||
);
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,352 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal;
|
||||
|
||||
/**
|
||||
* Helper methods for parsing connection strings. The rules for formatting connection
|
||||
* strings are defined here:
|
||||
* www.connectionstrings.com/articles/show/important-rules-for-connection-strings
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class ConnectionStringParser
|
||||
{
|
||||
const EXPECT_KEY = 'ExpectKey';
|
||||
const EXPECT_ASSIGNMENT = 'ExpectAssignment';
|
||||
const EXPECT_VALUE = 'ExpectValue';
|
||||
const EXPECT_SEPARATOR = 'ExpectSeparator';
|
||||
|
||||
/**
|
||||
* @var string
|
||||
*/
|
||||
private $_argumentName;
|
||||
|
||||
/**
|
||||
* @var string
|
||||
*/
|
||||
private $_value;
|
||||
|
||||
/**
|
||||
* @var integer
|
||||
*/
|
||||
private $_pos;
|
||||
|
||||
/**
|
||||
* @var string
|
||||
*/
|
||||
private $_state;
|
||||
|
||||
/**
|
||||
* Parses the connection string into a collection of key/value pairs.
|
||||
*
|
||||
* @param string $argumentName Name of the argument to be used in error
|
||||
* messages.
|
||||
* @param string $connectionString Connection string.
|
||||
*
|
||||
* @return array
|
||||
*
|
||||
* @static
|
||||
*/
|
||||
public static function parseConnectionString($argumentName, $connectionString)
|
||||
{
|
||||
Validate::isString($argumentName, 'argumentName');
|
||||
Validate::notNullOrEmpty($argumentName, 'argumentName');
|
||||
Validate::isString($connectionString, 'connectionString');
|
||||
Validate::notNullOrEmpty($connectionString, 'connectionString');
|
||||
|
||||
$parser = new ConnectionStringParser($argumentName, $connectionString);
|
||||
return $parser->_parse();
|
||||
}
|
||||
|
||||
/**
|
||||
* Initializes the object.
|
||||
*
|
||||
* @param string $argumentName Name of the argument to be used in error
|
||||
* messages.
|
||||
* @param string $value Connection string.
|
||||
*/
|
||||
private function __construct($argumentName, $value)
|
||||
{
|
||||
$this->_argumentName = $argumentName;
|
||||
$this->_value = $value;
|
||||
$this->_pos = 0;
|
||||
$this->_state = ConnectionStringParser::EXPECT_KEY;
|
||||
}
|
||||
|
||||
/**
|
||||
* Parses the connection string.
|
||||
*
|
||||
* @return array
|
||||
*
|
||||
* @throws \RuntimeException
|
||||
*/
|
||||
private function _parse()
|
||||
{
|
||||
$key = null;
|
||||
$value = null;
|
||||
$connectionStringValues = array();
|
||||
|
||||
while (true) {
|
||||
$this->_skipWhiteSpaces();
|
||||
|
||||
if ($this->_pos == strlen($this->_value)
|
||||
&& $this->_state != ConnectionStringParser::EXPECT_VALUE
|
||||
) {
|
||||
// Not stopping after the end has been reached and a value is
|
||||
// expected results in creating an empty value, which we expect.
|
||||
break;
|
||||
}
|
||||
|
||||
switch ($this->_state) {
|
||||
case ConnectionStringParser::EXPECT_KEY:
|
||||
$key = $this->_extractKey();
|
||||
$this->_state = ConnectionStringParser::EXPECT_ASSIGNMENT;
|
||||
break;
|
||||
|
||||
case ConnectionStringParser::EXPECT_ASSIGNMENT:
|
||||
$this->_skipOperator('=');
|
||||
$this->_state = ConnectionStringParser::EXPECT_VALUE;
|
||||
break;
|
||||
|
||||
case ConnectionStringParser::EXPECT_VALUE:
|
||||
$value = $this->_extractValue();
|
||||
$this->_state =
|
||||
ConnectionStringParser::EXPECT_SEPARATOR;
|
||||
$connectionStringValues[$key] = $value;
|
||||
$key = null;
|
||||
$value = null;
|
||||
break;
|
||||
|
||||
default:
|
||||
$this->_skipOperator(';');
|
||||
$this->_state = ConnectionStringParser::EXPECT_KEY;
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
// Must end parsing in the valid state (expected key or separator)
|
||||
if ($this->_state == ConnectionStringParser::EXPECT_ASSIGNMENT) {
|
||||
throw $this->_createException(
|
||||
$this->_pos,
|
||||
Resources::MISSING_CONNECTION_STRING_CHAR,
|
||||
'='
|
||||
);
|
||||
}
|
||||
|
||||
return $connectionStringValues;
|
||||
}
|
||||
|
||||
/**
|
||||
*Generates an invalid connection string exception with the detailed error
|
||||
* message.
|
||||
*
|
||||
* @param integer $position The position of the error.
|
||||
* @param string $errorString The short error formatting string.
|
||||
*
|
||||
* @return \RuntimeException
|
||||
*/
|
||||
private function _createException($position, $errorString)
|
||||
{
|
||||
$arguments = func_get_args();
|
||||
|
||||
// Remove first and second arguments (position and error string)
|
||||
unset($arguments[0], $arguments[1]);
|
||||
|
||||
// Create a short error message.
|
||||
$errorString = vsprintf($errorString, $arguments);
|
||||
|
||||
// Add position.
|
||||
$errorString = sprintf(
|
||||
Resources::ERROR_PARSING_STRING,
|
||||
$errorString,
|
||||
$position
|
||||
);
|
||||
|
||||
// Create final error message.
|
||||
$errorString = sprintf(
|
||||
Resources::INVALID_CONNECTION_STRING,
|
||||
$this->_argumentName,
|
||||
$errorString
|
||||
);
|
||||
|
||||
return new \RuntimeException($errorString);
|
||||
}
|
||||
|
||||
/**
|
||||
* Skips whitespaces at the current position.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
private function _skipWhiteSpaces()
|
||||
{
|
||||
while ($this->_pos < strlen($this->_value)
|
||||
&& ctype_space($this->_value[$this->_pos])
|
||||
) {
|
||||
$this->_pos++;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Extracts the key's value.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
private function _extractValue()
|
||||
{
|
||||
$value = Resources::EMPTY_STRING;
|
||||
|
||||
if ($this->_pos < strlen($this->_value)) {
|
||||
$ch = $this->_value[$this->_pos];
|
||||
|
||||
if ($ch == '"' || $ch == '\'') {
|
||||
// Value is contained between double quotes or skipped single quotes.
|
||||
$this->_pos++;
|
||||
$value = $this->_extractString($ch);
|
||||
} else {
|
||||
$firstPos = $this->_pos;
|
||||
$isFound = false;
|
||||
|
||||
while ($this->_pos < strlen($this->_value) && !$isFound) {
|
||||
$ch = $this->_value[$this->_pos];
|
||||
|
||||
if ($ch == ';') {
|
||||
$isFound = true;
|
||||
} else {
|
||||
$this->_pos++;
|
||||
}
|
||||
}
|
||||
|
||||
$value = rtrim(
|
||||
substr($this->_value, $firstPos, $this->_pos - $firstPos)
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
return $value;
|
||||
}
|
||||
|
||||
/**
|
||||
* Extracts key at the current position.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
private function _extractKey()
|
||||
{
|
||||
$key = null;
|
||||
$firstPos = $this->_pos;
|
||||
$ch = $this->_value[$this->_pos];
|
||||
|
||||
if ($ch == '"' || $ch == '\'') {
|
||||
$this->_pos++;
|
||||
$key = $this->_extractString($ch);
|
||||
} else if ($ch == ';' || $ch == '=') {
|
||||
// Key name was expected.
|
||||
throw $this->_createException(
|
||||
$firstPos,
|
||||
Resources::ERROR_CONNECTION_STRING_MISSING_KEY
|
||||
);
|
||||
} else {
|
||||
while ($this->_pos < strlen($this->_value)) {
|
||||
$ch = $this->_value[$this->_pos];
|
||||
|
||||
// At this point we've read the key, break.
|
||||
if ($ch == '=') {
|
||||
break;
|
||||
}
|
||||
|
||||
$this->_pos++;
|
||||
}
|
||||
$key = rtrim(substr($this->_value, $firstPos, $this->_pos - $firstPos));
|
||||
}
|
||||
|
||||
if (strlen($key) == 0) {
|
||||
// Empty key name.
|
||||
throw $this->_createException(
|
||||
$firstPos,
|
||||
Resources::ERROR_CONNECTION_STRING_EMPTY_KEY
|
||||
);
|
||||
}
|
||||
|
||||
return $key;
|
||||
}
|
||||
|
||||
/**
|
||||
* Extracts the string until the given quotation mark.
|
||||
*
|
||||
* @param string $quote The quotation mark terminating the string.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
private function _extractString($quote)
|
||||
{
|
||||
$firstPos = $this->_pos;
|
||||
|
||||
while ($this->_pos < strlen($this->_value)
|
||||
&& $this->_value[$this->_pos] != $quote
|
||||
) {
|
||||
$this->_pos++;
|
||||
}
|
||||
|
||||
if ($this->_pos == strlen($this->_value)) {
|
||||
// Runaway string.
|
||||
throw $this->_createException(
|
||||
$this->_pos,
|
||||
Resources::ERROR_CONNECTION_STRING_MISSING_CHARACTER,
|
||||
$quote
|
||||
);
|
||||
}
|
||||
|
||||
return substr($this->_value, $firstPos, $this->_pos++ - $firstPos);
|
||||
}
|
||||
|
||||
/**
|
||||
* Skips specified operator.
|
||||
*
|
||||
* @param string $operatorChar The operator character.
|
||||
*
|
||||
* @return none
|
||||
*
|
||||
* @throws \RuntimeException
|
||||
*/
|
||||
private function _skipOperator($operatorChar)
|
||||
{
|
||||
if ($this->_value[$this->_pos] != $operatorChar) {
|
||||
// Character was expected.
|
||||
throw $this->_createException(
|
||||
$this->_pos,
|
||||
Resources::MISSING_CONNECTION_STRING_CHAR,
|
||||
$operatorChar
|
||||
);
|
||||
}
|
||||
|
||||
$this->_pos++;
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,98 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal;
|
||||
|
||||
/**
|
||||
* Holder for default connection string sources used in CloudConfigurationManager.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class ConnectionStringSource
|
||||
{
|
||||
/**
|
||||
* The list of all sources which comes as default.
|
||||
*
|
||||
* @var type
|
||||
*/
|
||||
private static $_defaultSources;
|
||||
|
||||
/**
|
||||
* @var boolean
|
||||
*/
|
||||
private static $_isInitialized;
|
||||
|
||||
/**
|
||||
* Environment variable source name.
|
||||
*/
|
||||
const ENVIRONMENT_SOURCE = 'environment_source';
|
||||
|
||||
/**
|
||||
* Initializes the default sources.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
private static function _init()
|
||||
{
|
||||
if (!self::$_isInitialized) {
|
||||
self::$_defaultSources = array(
|
||||
self::ENVIRONMENT_SOURCE => array(__CLASS__, 'environmentSource')
|
||||
);
|
||||
self::$_isInitialized = true;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets a connection string value from the system environment.
|
||||
*
|
||||
* @param string $key The connection string name.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public static function environmentSource($key)
|
||||
{
|
||||
Validate::isString($key, 'key');
|
||||
|
||||
return getenv($key);
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets list of default sources.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public static function getDefaultSources()
|
||||
{
|
||||
self::_init();
|
||||
return self::$_defaultSources;
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,52 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal;
|
||||
|
||||
/**
|
||||
* Interface for service with filers.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
interface FilterableService
|
||||
{
|
||||
/**
|
||||
* Adds new filter to proxy object and returns new BlobRestProxy with
|
||||
* that filter.
|
||||
*
|
||||
* @param MicrosoftAzure\Storage\Common\Internal\IServiceFilter $filter Filter to add for
|
||||
* the pipeline.
|
||||
*
|
||||
* @return mix.
|
||||
*/
|
||||
public function withFilter($filter);
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,92 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Filters
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal\Filters;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Resources;
|
||||
use MicrosoftAzure\Storage\Common\Internal\IServiceFilter;
|
||||
use MicrosoftAzure\Storage\Common\Internal\HttpFormatter;
|
||||
use GuzzleHttp\Psr7;
|
||||
|
||||
/**
|
||||
* Adds authentication header to the http request object.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Filters
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class AuthenticationFilter implements IServiceFilter
|
||||
{
|
||||
/**
|
||||
* @var MicrosoftAzure\Storage\Common\Internal\Authentication\StorageAuthScheme
|
||||
*/
|
||||
private $_authenticationScheme;
|
||||
|
||||
/**
|
||||
* Creates AuthenticationFilter with the passed scheme.
|
||||
*
|
||||
* @param StorageAuthScheme $authenticationScheme The authentication scheme.
|
||||
*/
|
||||
public function __construct($authenticationScheme)
|
||||
{
|
||||
$this->_authenticationScheme = $authenticationScheme;
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds authentication header to the request headers.
|
||||
*
|
||||
* @param \GuzzleHttp\Psr7\Request $request HTTP request object.
|
||||
*
|
||||
* @return \GuzzleHttp\Psr7\Request
|
||||
*/
|
||||
public function handleRequest($request)
|
||||
{
|
||||
$requestHeaders = HttpFormatter::formatHeaders($request->getHeaders());
|
||||
|
||||
$signedKey = $this->_authenticationScheme->getAuthorizationHeader(
|
||||
$requestHeaders, $request->getUri(),
|
||||
\GuzzleHttp\Psr7\parse_query($request->getUri()->getQuery()), $request->getMethod()
|
||||
);
|
||||
return $request->withHeader(Resources::AUTHENTICATION, $signedKey);
|
||||
}
|
||||
|
||||
/**
|
||||
* Does nothing with the response.
|
||||
*
|
||||
* @param \GuzzleHttp\Psr7\Request $request HTTP request object.
|
||||
* @param \GuzzleHttp\Psr7\Response $response HTTP response object.
|
||||
*
|
||||
* @return \GuzzleHttp\Psr7\Response
|
||||
*/
|
||||
public function handleResponse($request, $response)
|
||||
{
|
||||
// Do nothing with the response.
|
||||
return $response;
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,70 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Filters
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal\Filters;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Resources;
|
||||
use MicrosoftAzure\Storage\Common\Internal\IServiceFilter;
|
||||
|
||||
/**
|
||||
* Adds date header to the http request.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Filters
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class DateFilter implements IServiceFilter
|
||||
{
|
||||
/**
|
||||
* Adds date (in GMT format) header to the request headers.
|
||||
*
|
||||
* @param \GuzzleHttp\Psr7\Request $request HTTP request object.
|
||||
*
|
||||
* @return \GuzzleHttp\Psr7\Request
|
||||
*/
|
||||
public function handleRequest($request)
|
||||
{
|
||||
$date = gmdate(Resources::AZURE_DATE_FORMAT, time());
|
||||
return $request->withHeader(Resources::DATE, $date);
|
||||
}
|
||||
|
||||
/**
|
||||
* Does nothing with the response.
|
||||
*
|
||||
* @param \GuzzleHttp\Psr7\Request $request HTTP request object.
|
||||
* @param \GuzzleHttp\Psr7\Response $response HTTP response object.
|
||||
*
|
||||
* @return \GuzzleHttp\Psr7\Request\Response
|
||||
*/
|
||||
public function handleResponse($request, $response)
|
||||
{
|
||||
// Do nothing with the response.
|
||||
return $response;
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,134 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Filters
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal\Filters;
|
||||
|
||||
/**
|
||||
* The exponential retry policy.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Filters
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class ExponentialRetryPolicy extends RetryPolicy
|
||||
{
|
||||
/**
|
||||
* @var integer
|
||||
*/
|
||||
private $_deltaBackoffIntervalInMs;
|
||||
|
||||
/**
|
||||
* @var integer
|
||||
*/
|
||||
private $_maximumAttempts;
|
||||
|
||||
/**
|
||||
* @var integer
|
||||
*/
|
||||
private $_resolvedMaxBackoff;
|
||||
|
||||
/**
|
||||
* @var integer
|
||||
*/
|
||||
private $_resolvedMinBackoff;
|
||||
|
||||
/**
|
||||
* @var array
|
||||
*/
|
||||
private $_retryableStatusCodes;
|
||||
|
||||
/**
|
||||
* Initializes new object from ExponentialRetryPolicy.
|
||||
*
|
||||
* @param array $retryableStatusCodes The retryable status codes.
|
||||
* @param integer $deltaBackoff The backoff time delta.
|
||||
* @param integer $maximumAttempts The number of max attempts.
|
||||
*/
|
||||
public function __construct($retryableStatusCodes,
|
||||
$deltaBackoff = parent::DEFAULT_CLIENT_BACKOFF,
|
||||
$maximumAttempts = parent::DEFAULT_CLIENT_RETRY_COUNT
|
||||
) {
|
||||
$this->_deltaBackoffIntervalInMs = $deltaBackoff;
|
||||
$this->_maximumAttempts = $maximumAttempts;
|
||||
$this->_resolvedMaxBackoff = parent::DEFAULT_MAX_BACKOFF;
|
||||
$this->_resolvedMinBackoff = parent::DEFAULT_MIN_BACKOFF;
|
||||
$this->_retryableStatusCodes = $retryableStatusCodes;
|
||||
sort($retryableStatusCodes);
|
||||
}
|
||||
|
||||
/**
|
||||
* Indicates if there should be a retry or not.
|
||||
*
|
||||
* @param integer $retryCount The retry count.
|
||||
* @param \GuzzleHttp\Psr7\Response $response The HTTP response object.
|
||||
*
|
||||
* @return boolean
|
||||
*/
|
||||
public function shouldRetry($retryCount, $response)
|
||||
{
|
||||
if ( $retryCount >= $this->_maximumAttempts
|
||||
|| array_search($response->getStatusCode(), $this->_retryableStatusCodes)
|
||||
|| is_null($response)
|
||||
) {
|
||||
return false;
|
||||
} else {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Calculates the backoff for the retry policy.
|
||||
*
|
||||
* @param integer $retryCount The retry count.
|
||||
* @param \GuzzleHttp\Psr7\Response $response The HTTP response object.
|
||||
*
|
||||
* @return integer
|
||||
*/
|
||||
public function calculateBackoff($retryCount, $response)
|
||||
{
|
||||
// Calculate backoff Interval between 80% and 120% of the desired
|
||||
// backoff, multiply by 2^n -1 for
|
||||
// exponential
|
||||
$incrementDelta = (int) (pow(2, $retryCount) - 1);
|
||||
$boundedRandDelta = (int) ($this->_deltaBackoffIntervalInMs * 0.8)
|
||||
+ mt_rand(
|
||||
0,
|
||||
(int) ($this->_deltaBackoffIntervalInMs * 1.2)
|
||||
- (int) ($this->_deltaBackoffIntervalInMs * 0.8)
|
||||
);
|
||||
$incrementDelta *= $boundedRandDelta;
|
||||
|
||||
// Enforce max / min backoffs
|
||||
return min(
|
||||
$this->_resolvedMinBackoff + $incrementDelta,
|
||||
$this->_resolvedMaxBackoff
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,94 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Filters
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal\Filters;
|
||||
use MicrosoftAzure\Storage\Common\Internal\IServiceFilter;
|
||||
|
||||
/**
|
||||
* Adds all passed headers to the HTTP request headers.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Filters
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class HeadersFilter implements IServiceFilter
|
||||
{
|
||||
/**
|
||||
* @var array
|
||||
*/
|
||||
private $_headers;
|
||||
|
||||
/**
|
||||
* Constructor
|
||||
*
|
||||
* @param array $headers static headers to be added.
|
||||
*
|
||||
* @return HeadersFilter
|
||||
*/
|
||||
public function __construct($headers)
|
||||
{
|
||||
$this->_headers = $headers;
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds static header(s) to the HTTP request headers
|
||||
*
|
||||
* @param \GuzzleHttp\Psr7\Request $request HTTP request object.
|
||||
*
|
||||
* @return \GuzzleHttp\Psr7\Request
|
||||
*/
|
||||
public function handleRequest($request)
|
||||
{
|
||||
$result = $request;
|
||||
|
||||
foreach ($this->_headers as $key => $value) {
|
||||
$headers = $request->getHeaders();
|
||||
if (!array_key_exists($key, $headers)) {
|
||||
$result = $result->withHeader($key, $value);
|
||||
}
|
||||
}
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
/**
|
||||
* Does nothing with the response.
|
||||
*
|
||||
* @param \GuzzleHttp\Psr7\Request $request HTTP request object.
|
||||
* @param \GuzzleHttp\Psr7\Response $response HTTP response object.
|
||||
*
|
||||
* @return \GuzzleHttp\Psr7\Response
|
||||
*/
|
||||
public function handleResponse($request, $response)
|
||||
{
|
||||
// Do nothing with the response.
|
||||
return $response;
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,66 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Filters
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal\Filters;
|
||||
|
||||
/**
|
||||
* The retry policy abstract class.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Filters
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
abstract class RetryPolicy
|
||||
{
|
||||
const DEFAULT_CLIENT_BACKOFF = 30000;
|
||||
const DEFAULT_CLIENT_RETRY_COUNT = 3;
|
||||
const DEFAULT_MAX_BACKOFF = 90000;
|
||||
const DEFAULT_MIN_BACKOFF = 300;
|
||||
|
||||
/**
|
||||
* Indicates if there should be a retry or not.
|
||||
*
|
||||
* @param integer $retryCount The retry count.
|
||||
* @param \GuzzleHttp\Psr7\Response $response The HTTP response object.
|
||||
*
|
||||
* @return boolean
|
||||
*/
|
||||
public abstract function shouldRetry($retryCount, $response);
|
||||
|
||||
/**
|
||||
* Calculates the backoff for the retry policy.
|
||||
*
|
||||
* @param integer $retryCount The retry count.
|
||||
* @param \GuzzleHttp\Psr7\Response $response The HTTP response object.
|
||||
*
|
||||
* @return integer
|
||||
*/
|
||||
public abstract function calculateBackoff($retryCount, $response);
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,106 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Filters
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal\Filters;
|
||||
|
||||
use MicrosoftAzure\Storage\Common\Internal\IServiceFilter;
|
||||
use GuzzleHttp\Client;
|
||||
|
||||
/**
|
||||
* Short description
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Filters
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class RetryPolicyFilter implements IServiceFilter
|
||||
{
|
||||
/**
|
||||
* @var RetryPolicy
|
||||
*/
|
||||
private $_retryPolicy;
|
||||
|
||||
/**
|
||||
* @var \GuzzleHttp\Client
|
||||
*/
|
||||
private $_client;
|
||||
|
||||
/**
|
||||
* Initializes new object from RetryPolicyFilter.
|
||||
*
|
||||
* @param \GuzzleHttp\Client $client The http client to send request.
|
||||
* @param RetryPolicy $retryPolicy The retry policy object.
|
||||
*/
|
||||
public function __construct($client, $retryPolicy)
|
||||
{
|
||||
$this->_client = $client;
|
||||
$this->_retryPolicy = $retryPolicy;
|
||||
}
|
||||
|
||||
/**
|
||||
* Handles the request before sending.
|
||||
*
|
||||
* @param \GuzzleHttp\Psr7\Request $request The HTTP request.
|
||||
*
|
||||
* @return \GuzzleHttp\Psr7\Request
|
||||
*/
|
||||
public function handleRequest($request)
|
||||
{
|
||||
return $request;
|
||||
}
|
||||
|
||||
/**
|
||||
* Handles the response after sending.
|
||||
*
|
||||
* @param \GuzzleHttp\Psr7\Request $request The HTTP request.
|
||||
* @param \GuzzleHttp\Psr7\Response $response The HTTP response.
|
||||
*
|
||||
* @return \GuzzleHttp\Psr7\Response
|
||||
*/
|
||||
public function handleResponse($request, $response)
|
||||
{
|
||||
for ($retryCount = 0;; $retryCount++) {
|
||||
$shouldRetry = $this->_retryPolicy->shouldRetry(
|
||||
$retryCount,
|
||||
$response
|
||||
);
|
||||
|
||||
if (!$shouldRetry) {
|
||||
return $response;
|
||||
}
|
||||
|
||||
// Backoff for some time according to retry policy
|
||||
$backoffTime = $this->_retryPolicy->calculateBackoff(
|
||||
$retryCount,
|
||||
$response
|
||||
);
|
||||
sleep($backoffTime * 0.001);
|
||||
$response = $this->_client->send($request);
|
||||
}
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,449 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Http
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal\Http;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Utilities;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Resources;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Validate;
|
||||
|
||||
/**
|
||||
* Holds basic elements for making HTTP call.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Http
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class HttpCallContext
|
||||
{
|
||||
/**
|
||||
* The HTTP method used to make this call.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $_method;
|
||||
|
||||
/**
|
||||
* HTTP request headers.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private $_headers;
|
||||
|
||||
/**
|
||||
* The URI query parameters.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private $_queryParams;
|
||||
|
||||
/**
|
||||
* The HTTP POST parameters.
|
||||
*
|
||||
* @var array.
|
||||
*/
|
||||
private $_postParameters;
|
||||
|
||||
/**
|
||||
* @var string
|
||||
*/
|
||||
private $_uri;
|
||||
|
||||
/**
|
||||
* The URI path.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $_path;
|
||||
|
||||
/**
|
||||
* The expected status codes.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private $_statusCodes;
|
||||
|
||||
/**
|
||||
* The HTTP request body.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $_body;
|
||||
|
||||
/**
|
||||
* Default constructor.
|
||||
*/
|
||||
public function __construct()
|
||||
{
|
||||
$this->_method = null;
|
||||
$this->_body = null;
|
||||
$this->_path = null;
|
||||
$this->_uri = null;
|
||||
$this->_queryParams = array();
|
||||
$this->_postParameters = array();
|
||||
$this->_statusCodes = array();
|
||||
$this->_headers = array();
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets method.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function getMethod()
|
||||
{
|
||||
return $this->_method;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets method.
|
||||
*
|
||||
* @param string $method The method value.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public function setMethod($method)
|
||||
{
|
||||
Validate::isString($method, 'method');
|
||||
|
||||
$this->_method = $method;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets headers.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function getHeaders()
|
||||
{
|
||||
return $this->_headers;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets headers.
|
||||
*
|
||||
* Ignores the header if its value is empty.
|
||||
*
|
||||
* @param array $headers The headers value.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public function setHeaders($headers)
|
||||
{
|
||||
$this->_headers = array();
|
||||
foreach ($headers as $key => $value) {
|
||||
$this->addHeader($key, $value);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets queryParams.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function getQueryParameters()
|
||||
{
|
||||
return $this->_queryParams;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets queryParams.
|
||||
*
|
||||
* Ignores the query variable if its value is empty.
|
||||
*
|
||||
* @param array $queryParams The queryParams value.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public function setQueryParameters($queryParams)
|
||||
{
|
||||
$this->_queryParams = array();
|
||||
foreach ($queryParams as $key => $value) {
|
||||
$this->addQueryParameter($key, $value);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets uri.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function getUri()
|
||||
{
|
||||
return $this->_uri;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets uri.
|
||||
*
|
||||
* @param string $uri The uri value.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public function setUri($uri)
|
||||
{
|
||||
Validate::isString($uri, 'uri');
|
||||
|
||||
$this->_uri = $uri;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets path.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function getPath()
|
||||
{
|
||||
return $this->_path;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets path.
|
||||
*
|
||||
* @param string $path The path value.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public function setPath($path)
|
||||
{
|
||||
Validate::isString($path, 'path');
|
||||
|
||||
$this->_path = $path;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets statusCodes.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function getStatusCodes()
|
||||
{
|
||||
return $this->_statusCodes;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets statusCodes.
|
||||
*
|
||||
* @param array $statusCodes The statusCodes value.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public function setStatusCodes($statusCodes)
|
||||
{
|
||||
$this->_statusCodes = array();
|
||||
foreach ($statusCodes as $value) {
|
||||
$this->addStatusCode($value);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets body.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function getBody()
|
||||
{
|
||||
return $this->_body;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets body.
|
||||
*
|
||||
* @param string $body The body value.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public function setBody($body)
|
||||
{
|
||||
Validate::isString($body, 'body');
|
||||
|
||||
$this->_body = $body;
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds or sets header pair.
|
||||
*
|
||||
* @param string $name The HTTP header name.
|
||||
* @param string $value The HTTP header value.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public function addHeader($name, $value)
|
||||
{
|
||||
Validate::isString($name, 'name');
|
||||
Validate::isString($value, 'value');
|
||||
|
||||
$this->_headers[$name] = $value;
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds or sets header pair.
|
||||
*
|
||||
* Ignores header if it's value satisfies empty().
|
||||
*
|
||||
* @param string $name The HTTP header name.
|
||||
* @param string $value The HTTP header value.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public function addOptionalHeader($name, $value)
|
||||
{
|
||||
Validate::isString($name, 'name');
|
||||
Validate::isString($value, 'value');
|
||||
|
||||
if (!empty($value)) {
|
||||
$this->_headers[$name] = $value;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Removes header from the HTTP request headers.
|
||||
*
|
||||
* @param string $name The HTTP header name.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public function removeHeader($name)
|
||||
{
|
||||
Validate::isString($name, 'name');
|
||||
Validate::notNullOrEmpty($name, 'name');
|
||||
|
||||
unset($this->_headers[$name]);
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds or sets query parameter pair.
|
||||
*
|
||||
* @param string $name The URI query parameter name.
|
||||
* @param string $value The URI query parameter value.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public function addQueryParameter($name, $value)
|
||||
{
|
||||
Validate::isString($name, 'name');
|
||||
Validate::isString($value, 'value');
|
||||
|
||||
$this->_queryParams[$name] = $value;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets HTTP POST parameters.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function getPostParameters()
|
||||
{
|
||||
return $this->_postParameters;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets HTTP POST parameters.
|
||||
*
|
||||
* @param array $postParameters The HTTP POST parameters.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public function setPostParameters($postParameters)
|
||||
{
|
||||
Validate::isArray($postParameters, 'postParameters');
|
||||
$this->_postParameters = $postParameters;
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds or sets query parameter pair.
|
||||
*
|
||||
* Ignores query parameter if it's value satisfies empty().
|
||||
*
|
||||
* @param string $name The URI query parameter name.
|
||||
* @param string $value The URI query parameter value.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public function addOptionalQueryParameter($name, $value)
|
||||
{
|
||||
Validate::isString($name, 'name');
|
||||
Validate::isString($value, 'value');
|
||||
|
||||
if (!empty($value)) {
|
||||
$this->_queryParams[$name] = $value;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds status code to the expected status codes.
|
||||
*
|
||||
* @param integer $statusCode The expected status code.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public function addStatusCode($statusCode)
|
||||
{
|
||||
Validate::isInteger($statusCode, 'statusCode');
|
||||
|
||||
$this->_statusCodes[] = $statusCode;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets header value.
|
||||
*
|
||||
* @param string $name The header name.
|
||||
*
|
||||
* @return mix
|
||||
*/
|
||||
public function getHeader($name)
|
||||
{
|
||||
return Utilities::tryGetValue($this->_headers, $name);
|
||||
}
|
||||
|
||||
/**
|
||||
* Converts the context object to string.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function __toString()
|
||||
{
|
||||
$headers = Resources::EMPTY_STRING;
|
||||
$uri = $this->_uri;
|
||||
|
||||
if ($uri[strlen($uri)-1] != '/')
|
||||
{
|
||||
$uri = $uri.'/';
|
||||
}
|
||||
|
||||
foreach ($this->_headers as $key => $value) {
|
||||
$headers .= "$key: $value\n";
|
||||
}
|
||||
|
||||
$str = "$this->_method $uri$this->_path HTTP/1.1\n$headers\n";
|
||||
$str .= "$this->_body";
|
||||
|
||||
return $str;
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,52 @@
|
||||
<?php
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal;
|
||||
|
||||
class HttpFormatter
|
||||
{
|
||||
/**
|
||||
* Convert a http headers array into an uniformed format for further process
|
||||
*
|
||||
* @param array $headers headers for format
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public static function formatHeaders($headers)
|
||||
{
|
||||
$result = array();
|
||||
foreach ($headers as $key => $value)
|
||||
{
|
||||
if (is_array($value) && count($value) == 1)
|
||||
{
|
||||
$result[strtolower($key)] = $value[0];
|
||||
}
|
||||
else
|
||||
{
|
||||
$result[strtolower($key)] = $value;
|
||||
}
|
||||
}
|
||||
|
||||
return $result;
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,61 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal;
|
||||
|
||||
/**
|
||||
* ServceFilter is called when the sending the request and after receiving the
|
||||
* response.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
interface IServiceFilter
|
||||
{
|
||||
/**
|
||||
* Processes HTTP request before send.
|
||||
*
|
||||
* @param mix $request HTTP request object.
|
||||
*
|
||||
* @return mix processed HTTP request object.
|
||||
*/
|
||||
public function handleRequest($request);
|
||||
|
||||
/**
|
||||
* Processes HTTP response after send.
|
||||
*
|
||||
* @param mix $request HTTP request object.
|
||||
* @param mix $response HTTP response object.
|
||||
*
|
||||
* @return mix processed HTTP response object.
|
||||
*/
|
||||
public function handleResponse($request, $response);
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,57 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Resources;
|
||||
|
||||
/**
|
||||
* Exception thrown if an argument type does not match with the expected type.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class InvalidArgumentTypeException extends \InvalidArgumentException
|
||||
{
|
||||
/**
|
||||
* Constructor.
|
||||
*
|
||||
* @param string $validType The valid type that should be provided by the user.
|
||||
* @param string $name The parameter name.
|
||||
*
|
||||
* @return MicrosoftAzure\Storage\Common\Internal\InvalidArgumentTypeException
|
||||
*/
|
||||
public function __construct($validType, $name = null)
|
||||
{
|
||||
parent::__construct(
|
||||
sprintf(Resources::INVALID_PARAM_MSG, $name, $validType)
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,83 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal;
|
||||
|
||||
/**
|
||||
* Logger class for debugging purpose.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class Logger
|
||||
{
|
||||
/**
|
||||
* @var string
|
||||
*/
|
||||
private static $_filePath;
|
||||
|
||||
/**
|
||||
* Logs $var to file.
|
||||
*
|
||||
* @param mix $var The data to log.
|
||||
* @param string $tip The help message.
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public static function log($var, $tip = Resources::EMPTY_STRING)
|
||||
{
|
||||
if (!empty($tip)) {
|
||||
error_log($tip . "\n", 3, self::$_filePath);
|
||||
}
|
||||
|
||||
if (is_array($var) || is_object($var)) {
|
||||
error_log(print_r($var, true), 3, self::$_filePath);
|
||||
} else {
|
||||
error_log($var . "\n", 3, self::$_filePath);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets file path to use.
|
||||
*
|
||||
* @param string $filePath The log file path.
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public static function setLogFile($filePath)
|
||||
{
|
||||
self::$_filePath = $filePath;
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,404 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal;
|
||||
|
||||
/**
|
||||
* Project resources.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class Resources
|
||||
{
|
||||
// @codingStandardsIgnoreStart
|
||||
|
||||
// Connection strings
|
||||
const USE_DEVELOPMENT_STORAGE_NAME = 'UseDevelopmentStorage';
|
||||
const DEVELOPMENT_STORAGE_PROXY_URI_NAME = 'DevelopmentStorageProxyUri';
|
||||
const DEFAULT_ENDPOINTS_PROTOCOL_NAME = 'DefaultEndpointsProtocol';
|
||||
const ACCOUNT_NAME_NAME = 'AccountName';
|
||||
const ACCOUNT_KEY_NAME = 'AccountKey';
|
||||
const BLOB_ENDPOINT_NAME = 'BlobEndpoint';
|
||||
const QUEUE_ENDPOINT_NAME = 'QueueEndpoint';
|
||||
const TABLE_ENDPOINT_NAME = 'TableEndpoint';
|
||||
const SHARED_ACCESS_SIGNATURE_NAME = 'SharedAccessSignature';
|
||||
const DEV_STORE_NAME = 'devstoreaccount1';
|
||||
const DEV_STORE_KEY = 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==';
|
||||
const BLOB_BASE_DNS_NAME = 'blob.core.windows.net';
|
||||
const QUEUE_BASE_DNS_NAME = 'queue.core.windows.net';
|
||||
const TABLE_BASE_DNS_NAME = 'table.core.windows.net';
|
||||
const DEV_STORE_CONNECTION_STRING = 'BlobEndpoint=127.0.0.1:10000;QueueEndpoint=127.0.0.1:10001;TableEndpoint=127.0.0.1:10002;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==';
|
||||
const SUBSCRIPTION_ID_NAME = 'SubscriptionID';
|
||||
const CERTIFICATE_PATH_NAME = 'CertificatePath';
|
||||
|
||||
// Messages
|
||||
const INVALID_FUNCTION_NAME = 'The class %s does not have a function named %s.';
|
||||
const INVALID_TYPE_MSG = 'The provided variable should be of type: ';
|
||||
const INVALID_META_MSG = 'Metadata cannot contain newline characters.';
|
||||
const AZURE_ERROR_MSG = "Fail:\nCode: %s\nValue: %s\ndetails (if any): %s.";
|
||||
const NOT_IMPLEMENTED_MSG = 'This method is not implemented.';
|
||||
const NULL_OR_EMPTY_MSG = "'%s' can't be NULL or empty.";
|
||||
const NULL_MSG = "'%s' can't be NULL.";
|
||||
const INVALID_URL_MSG = 'Provided URL is invalid.';
|
||||
const INVALID_HT_MSG = 'The header type provided is invalid.';
|
||||
const INVALID_EDM_MSG = 'The provided EDM type is invalid.';
|
||||
const INVALID_PROP_MSG = 'One of the provided properties is not an instance of class Property';
|
||||
const INVALID_ENTITY_MSG = 'The provided entity object is invalid.';
|
||||
const INVALID_VERSION_MSG = 'Server does not support any known protocol versions.';
|
||||
const INVALID_BO_TYPE_MSG = 'Batch operation name is not supported or invalid.';
|
||||
const INVALID_BO_PN_MSG = 'Batch operation parameter is not supported.';
|
||||
const INVALID_OC_COUNT_MSG = 'Operations and contexts must be of same size.';
|
||||
const INVALID_EXC_OBJ_MSG = 'Exception object type should be ServiceException.';
|
||||
const NULL_TABLE_KEY_MSG = 'Partition and row keys can\'t be NULL.';
|
||||
const BATCH_ENTITY_DEL_MSG = 'The entity was deleted successfully.';
|
||||
const INVALID_PROP_VAL_MSG = "'%s' property value must satisfy %s.";
|
||||
const INVALID_PARAM_MSG = "The provided variable '%s' should be of type '%s'";
|
||||
const INVALID_STRING_LENGTH = "The provided variable '%s' should be of %s characters long";
|
||||
const INVALID_BTE_MSG = "The blob block type must exist in %s";
|
||||
const INVALID_BLOB_PAT_MSG = 'The provided access type is invalid.';
|
||||
const INVALID_SVC_PROP_MSG = 'The provided service properties is invalid.';
|
||||
const UNKNOWN_SRILZER_MSG = 'The provided serializer type is unknown';
|
||||
const INVALID_CREATE_SERVICE_OPTIONS_MSG = 'Must provide valid location or affinity group.';
|
||||
const INVALID_UPDATE_SERVICE_OPTIONS_MSG = 'Must provide either description or label.';
|
||||
const INVALID_CONFIG_MSG = 'Config object must be of type Configuration';
|
||||
const INVALID_ACH_MSG = 'The provided access condition header is invalid';
|
||||
const INVALID_RECEIVE_MODE_MSG = 'The receive message option is in neither RECEIVE_AND_DELETE nor PEEK_LOCK mode.';
|
||||
const INVALID_CONFIG_URI = "The provided URI '%s' is invalid. It has to pass the check 'filter_var(<user_uri>, FILTER_VALIDATE_URL)'.";
|
||||
const INVALID_CONFIG_VALUE = "The provided config value '%s' does not belong to the valid values subset:\n%s";
|
||||
const INVALID_ACCOUNT_KEY_FORMAT = "The provided account key '%s' is not a valid base64 string. It has to pass the check 'base64_decode(<user_account_key>, true)'.";
|
||||
const MISSING_CONNECTION_STRING_SETTINGS = "The provided connection string '%s' does not have complete configuration settings.";
|
||||
const INVALID_CONNECTION_STRING_SETTING_KEY = "The setting key '%s' is not found in the expected configuration setting keys:\n%s";
|
||||
const INVALID_CERTIFICATE_PATH = "The provided certificate path '%s' is invalid.";
|
||||
const INSTANCE_TYPE_VALIDATION_MSG = 'The type of %s is %s but is expected to be %s.';
|
||||
const MISSING_CONNECTION_STRING_CHAR = "Missing %s character";
|
||||
const ERROR_PARSING_STRING = "'%s' at position %d.";
|
||||
const INVALID_CONNECTION_STRING = "Argument '%s' is not a valid connection string: '%s'";
|
||||
const ERROR_CONNECTION_STRING_MISSING_KEY = 'Missing key name';
|
||||
const ERROR_CONNECTION_STRING_EMPTY_KEY = 'Empty key name';
|
||||
const ERROR_CONNECTION_STRING_MISSING_CHARACTER = "Missing %s character";
|
||||
const ERROR_EMPTY_SETTINGS = 'No keys were found in the connection string';
|
||||
const MISSING_LOCK_LOCATION_MSG = 'The lock location of the brokered message is missing.';
|
||||
const INVALID_SLOT = "The provided deployment slot '%s' is not valid. Only 'staging' and 'production' are accepted.";
|
||||
const INVALID_DEPLOYMENT_LOCATOR_MSG = 'A slot or deployment name must be provided.';
|
||||
const INVALID_CHANGE_MODE_MSG = "The change mode must be 'Auto' or 'Manual'. Use Mode class constants for that purpose.";
|
||||
const INVALID_DEPLOYMENT_STATUS_MSG = "The change mode must be 'Running' or 'Suspended'. Use DeploymentStatus class constants for that purpose.";
|
||||
const ERROR_OAUTH_GET_ACCESS_TOKEN = 'Unable to get oauth access token for endpoint \'%s\', account name \'%s\'';
|
||||
const ERROR_OAUTH_SERVICE_MISSING = 'OAuth service missing for account name \'%s\'';
|
||||
const ERROR_METHOD_NOT_FOUND = 'Method \'%s\' not found in object class \'%s\'';
|
||||
const ERROR_INVALID_DATE_STRING = 'Parameter \'%s\' is not a date formatted string \'%s\'';
|
||||
const ERROR_TOO_LARGE_FOR_BLOCK_BLOB = 'Error: Exceeds the uppper limit of the blob.';
|
||||
const ERROR_RANGE_NOT_ALIGN_TO_512 = 'Error: Range of the page blob must be align to 512';
|
||||
const ERROR_FILE_COULD_NOT_BE_OPENED = 'Error: file with given path could not be opened or created.';
|
||||
const ERROR_CONTAINER_NOT_EXIST = 'The specified container does not exist';
|
||||
const ERROR_BLOB_NOT_EXIST = 'The specified blob does not exist';
|
||||
const INVALID_PARAM_GENERAL = 'The provided parameter \'%s\' is invalid';
|
||||
const INVALID_NEGATIVE_PARAM = 'The provided parameter \'%s\' should be positive number.';
|
||||
|
||||
// HTTP Headers
|
||||
const X_MS_HEADER_PREFIX = 'x-ms-';
|
||||
const X_MS_META_HEADER_PREFIX = 'x-ms-meta-';
|
||||
const X_MS_APPROXIMATE_MESSAGES_COUNT = 'x-ms-approximate-messages-count';
|
||||
const X_MS_POPRECEIPT = 'x-ms-popreceipt';
|
||||
const X_MS_TIME_NEXT_VISIBLE = 'x-ms-time-next-visible';
|
||||
const X_MS_BLOB_PUBLIC_ACCESS = 'x-ms-blob-public-access';
|
||||
const X_MS_VERSION = 'x-ms-version';
|
||||
const X_MS_DATE = 'x-ms-date';
|
||||
const X_MS_BLOB_SEQUENCE_NUMBER = 'x-ms-blob-sequence-number';
|
||||
const X_MS_BLOB_SEQUENCE_NUMBER_ACTION = 'x-ms-sequence-number-action';
|
||||
const X_MS_BLOB_TYPE = 'x-ms-blob-type';
|
||||
const X_MS_BLOB_CONTENT_TYPE = 'x-ms-blob-content-type';
|
||||
const X_MS_BLOB_CONTENT_ENCODING = 'x-ms-blob-content-encoding';
|
||||
const X_MS_BLOB_CONTENT_LANGUAGE = 'x-ms-blob-content-language';
|
||||
const X_MS_BLOB_CONTENT_MD5 = 'x-ms-blob-content-md5';
|
||||
const X_MS_BLOB_CACHE_CONTROL = 'x-ms-blob-cache-control';
|
||||
const X_MS_BLOB_CONTENT_LENGTH = 'x-ms-blob-content-length';
|
||||
const X_MS_COPY_SOURCE = 'x-ms-copy-source';
|
||||
const X_MS_RANGE = 'x-ms-range';
|
||||
const X_MS_RANGE_GET_CONTENT_MD5 = 'x-ms-range-get-content-md5';
|
||||
const X_MS_LEASE_DURATION = 'x-ms-lease-duration';
|
||||
const X_MS_LEASE_ID = 'x-ms-lease-id';
|
||||
const X_MS_LEASE_TIME = 'x-ms-lease-time';
|
||||
const X_MS_LEASE_STATUS = 'x-ms-lease-status';
|
||||
const X_MS_LEASE_ACTION = 'x-ms-lease-action';
|
||||
const X_MS_DELETE_SNAPSHOTS = 'x-ms-delete-snapshots';
|
||||
const X_MS_PAGE_WRITE = 'x-ms-page-write';
|
||||
const X_MS_SNAPSHOT = 'x-ms-snapshot';
|
||||
const X_MS_SOURCE_IF_MODIFIED_SINCE = 'x-ms-source-if-modified-since';
|
||||
const X_MS_SOURCE_IF_UNMODIFIED_SINCE = 'x-ms-source-if-unmodified-since';
|
||||
const X_MS_SOURCE_IF_MATCH = 'x-ms-source-if-match';
|
||||
const X_MS_SOURCE_IF_NONE_MATCH = 'x-ms-source-if-none-match';
|
||||
const X_MS_SOURCE_LEASE_ID = 'x-ms-source-lease-id';
|
||||
const X_MS_CONTINUATION_NEXTTABLENAME = 'x-ms-continuation-nexttablename';
|
||||
const X_MS_CONTINUATION_NEXTPARTITIONKEY = 'x-ms-continuation-nextpartitionkey';
|
||||
const X_MS_CONTINUATION_NEXTROWKEY = 'x-ms-continuation-nextrowkey';
|
||||
const X_MS_REQUEST_ID = 'x-ms-request-id';
|
||||
const ETAG = 'etag';
|
||||
const LAST_MODIFIED = 'last-modified';
|
||||
const DATE = 'date';
|
||||
const AUTHENTICATION = 'authorization';
|
||||
const WRAP_AUTHORIZATION = 'WRAP access_token="%s"';
|
||||
const CONTENT_ENCODING = 'content-encoding';
|
||||
const CONTENT_LANGUAGE = 'content-language';
|
||||
const CONTENT_LENGTH = 'content-length';
|
||||
const CONTENT_LENGTH_NO_SPACE = 'contentlength';
|
||||
const CONTENT_MD5 = 'content-md5';
|
||||
const CONTENT_TYPE = 'content-type';
|
||||
const CONTENT_ID = 'content-id';
|
||||
const CONTENT_RANGE = 'content-range';
|
||||
const CACHE_CONTROL = 'cache-control';
|
||||
const IF_MODIFIED_SINCE = 'if-modified-since';
|
||||
const IF_MATCH = 'if-match';
|
||||
const IF_NONE_MATCH = 'if-none-match';
|
||||
const IF_UNMODIFIED_SINCE = 'if-unmodified-since';
|
||||
const RANGE = 'range';
|
||||
const DATA_SERVICE_VERSION = 'dataserviceversion';
|
||||
const MAX_DATA_SERVICE_VERSION = 'maxdataserviceversion';
|
||||
const ACCEPT_HEADER = 'accept';
|
||||
const ACCEPT_CHARSET = 'accept-charset';
|
||||
const USER_AGENT = 'User-Agent';
|
||||
|
||||
// Type
|
||||
const QUEUE_TYPE_NAME = 'IQueue';
|
||||
const BLOB_TYPE_NAME = 'IBlob';
|
||||
const TABLE_TYPE_NAME = 'ITable';
|
||||
|
||||
// WRAP
|
||||
const WRAP_ACCESS_TOKEN = 'wrap_access_token';
|
||||
const WRAP_ACCESS_TOKEN_EXPIRES_IN = 'wrap_access_token_expires_in';
|
||||
const WRAP_NAME = 'wrap_name';
|
||||
const WRAP_PASSWORD = 'wrap_password';
|
||||
const WRAP_SCOPE = 'wrap_scope';
|
||||
|
||||
// HTTP Methods
|
||||
const HTTP_GET = 'GET';
|
||||
const HTTP_PUT = 'PUT';
|
||||
const HTTP_POST = 'POST';
|
||||
const HTTP_HEAD = 'HEAD';
|
||||
const HTTP_DELETE = 'DELETE';
|
||||
const HTTP_MERGE = 'MERGE';
|
||||
|
||||
// Misc
|
||||
const EMPTY_STRING = '';
|
||||
const SEPARATOR = ',';
|
||||
const AZURE_DATE_FORMAT = 'D, d M Y H:i:s T';
|
||||
const TIMESTAMP_FORMAT = 'Y-m-d H:i:s';
|
||||
const EMULATED = 'EMULATED';
|
||||
const EMULATOR_BLOB_URI = '127.0.0.1:10000';
|
||||
const EMULATOR_QUEUE_URI = '127.0.0.1:10001';
|
||||
const EMULATOR_TABLE_URI = '127.0.0.1:10002';
|
||||
const ASTERISK = '*';
|
||||
const SERVICE_MANAGEMENT_URL = 'https://management.core.windows.net';
|
||||
const HTTP_SCHEME = 'http';
|
||||
const HTTPS_SCHEME = 'https';
|
||||
const SETTING_NAME = 'SettingName';
|
||||
const SETTING_CONSTRAINT = 'SettingConstraint';
|
||||
const DEV_STORE_URI = 'http://127.0.0.1';
|
||||
const SERVICE_URI_FORMAT = "%s://%s.%s";
|
||||
const WRAP_ENDPOINT_URI_FORMAT = "https://%s-sb.accesscontrol.windows.net/WRAPv0.9";
|
||||
const MB_IN_BYTES_4 = 4194304;
|
||||
const MB_IN_BYTES_32 = 33554432;
|
||||
const MB_IN_BYTES_64 = 67108864;
|
||||
const MAX_BLOB_BLOCKS = 50000;
|
||||
|
||||
// Xml Namespaces
|
||||
const WA_XML_NAMESPACE = 'http://schemas.microsoft.com/windowsazure';
|
||||
const ATOM_XML_NAMESPACE = 'http://www.w3.org/2005/Atom';
|
||||
const DS_XML_NAMESPACE = 'http://schemas.microsoft.com/ado/2007/08/dataservices';
|
||||
const DSM_XML_NAMESPACE = 'http://schemas.microsoft.com/ado/2007/08/dataservices/metadata';
|
||||
const XSI_XML_NAMESPACE = 'http://www.w3.org/2001/XMLSchema-instance';
|
||||
const NUMBER_OF_CONCURRENCY = 25;//Guzzle's default value
|
||||
const DEFAULT_NUMBER_OF_RETRIES = 3;
|
||||
const DEAFULT_RETRY_INTERVAL = 1000;//Milliseconds
|
||||
|
||||
// Header values
|
||||
const SDK_VERSION = '0.11.0';
|
||||
const STORAGE_API_LATEST_VERSION = '2015-04-05';
|
||||
const DATA_SERVICE_VERSION_VALUE = '1.0;NetFx';
|
||||
const MAX_DATA_SERVICE_VERSION_VALUE = '2.0;NetFx';
|
||||
const ACCEPT_HEADER_VALUE = 'application/atom+xml,application/xml';
|
||||
const ATOM_ENTRY_CONTENT_TYPE = 'application/atom+xml;type=entry;charset=utf-8';
|
||||
const ATOM_FEED_CONTENT_TYPE = 'application/atom+xml;type=feed;charset=utf-8';
|
||||
const ACCEPT_CHARSET_VALUE = 'utf-8';
|
||||
const INT32_MAX = 2147483647;
|
||||
|
||||
// Query parameter names
|
||||
const QP_PREFIX = 'Prefix';
|
||||
const QP_MAX_RESULTS = 'MaxResults';
|
||||
const QP_METADATA = 'Metadata';
|
||||
const QP_MARKER = 'Marker';
|
||||
const QP_NEXT_MARKER = 'NextMarker';
|
||||
const QP_COMP = 'comp';
|
||||
const QP_VISIBILITY_TIMEOUT = 'visibilitytimeout';
|
||||
const QP_POPRECEIPT = 'popreceipt';
|
||||
const QP_NUM_OF_MESSAGES = 'numofmessages';
|
||||
const QP_PEEK_ONLY = 'peekonly';
|
||||
const QP_MESSAGE_TTL = 'messagettl';
|
||||
const QP_INCLUDE = 'include';
|
||||
const QP_TIMEOUT = 'timeout';
|
||||
const QP_DELIMITER = 'Delimiter';
|
||||
const QP_REST_TYPE = 'restype';
|
||||
const QP_SNAPSHOT = 'snapshot';
|
||||
const QP_BLOCKID = 'blockid';
|
||||
const QP_BLOCK_LIST_TYPE = 'blocklisttype';
|
||||
const QP_SELECT = '$select';
|
||||
const QP_TOP = '$top';
|
||||
const QP_SKIP = '$skip';
|
||||
const QP_FILTER = '$filter';
|
||||
const QP_NEXT_TABLE_NAME = 'NextTableName';
|
||||
const QP_NEXT_PK = 'NextPartitionKey';
|
||||
const QP_NEXT_RK = 'NextRowKey';
|
||||
const QP_ACTION = 'action';
|
||||
const QP_EMBED_DETAIL = 'embed-detail';
|
||||
|
||||
// Query parameter values
|
||||
const QPV_REGENERATE = 'regenerate';
|
||||
const QPV_CONFIG = 'config';
|
||||
const QPV_STATUS = 'status';
|
||||
const QPV_UPGRADE = 'upgrade';
|
||||
const QPV_WALK_UPGRADE_DOMAIN = 'walkupgradedomain';
|
||||
const QPV_REBOOT = 'reboot';
|
||||
const QPV_REIMAGE = 'reimage';
|
||||
const QPV_ROLLBACK = 'rollback';
|
||||
|
||||
// Request body content types
|
||||
const URL_ENCODED_CONTENT_TYPE = 'application/x-www-form-urlencoded';
|
||||
const XML_CONTENT_TYPE = 'application/xml';
|
||||
const JSON_CONTENT_TYPE = 'application/json';
|
||||
const BINARY_FILE_TYPE = 'application/octet-stream';
|
||||
const XML_ATOM_CONTENT_TYPE = 'application/atom+xml';
|
||||
const HTTP_TYPE = 'application/http';
|
||||
const MULTIPART_MIXED_TYPE = 'multipart/mixed';
|
||||
|
||||
// Common used XML tags
|
||||
const XTAG_ATTRIBUTES = '@attributes';
|
||||
const XTAG_NAMESPACE = '@namespace';
|
||||
const XTAG_LABEL = 'Label';
|
||||
const XTAG_NAME = 'Name';
|
||||
const XTAG_DESCRIPTION = 'Description';
|
||||
const XTAG_LOCATION = 'Location';
|
||||
const XTAG_AFFINITY_GROUP = 'AffinityGroup';
|
||||
const XTAG_HOSTED_SERVICES = 'HostedServices';
|
||||
const XTAG_STORAGE_SERVICES = 'StorageServices';
|
||||
const XTAG_STORAGE_SERVICE = 'StorageService';
|
||||
const XTAG_DISPLAY_NAME = 'DisplayName';
|
||||
const XTAG_SERVICE_NAME = 'ServiceName';
|
||||
const XTAG_URL = 'Url';
|
||||
const XTAG_ID = 'ID';
|
||||
const XTAG_STATUS = 'Status';
|
||||
const XTAG_HTTP_STATUS_CODE = 'HttpStatusCode';
|
||||
const XTAG_CODE = 'Code';
|
||||
const XTAG_MESSAGE = 'Message';
|
||||
const XTAG_STORAGE_SERVICE_PROPERTIES = 'StorageServiceProperties';
|
||||
const XTAG_SERVICE_ENDPOINT = 'ServiceEndpoint';
|
||||
const XTAG_ENDPOINT = 'Endpoint';
|
||||
const XTAG_ENDPOINTS = 'Endpoints';
|
||||
const XTAG_PRIMARY = 'Primary';
|
||||
const XTAG_SECONDARY = 'Secondary';
|
||||
const XTAG_KEY_TYPE = 'KeyType';
|
||||
const XTAG_STORAGE_SERVICE_KEYS = 'StorageServiceKeys';
|
||||
const XTAG_ERROR = 'Error';
|
||||
const XTAG_HOSTED_SERVICE = 'HostedService';
|
||||
const XTAG_HOSTED_SERVICE_PROPERTIES = 'HostedServiceProperties';
|
||||
const XTAG_CREATE_HOSTED_SERVICE = 'CreateHostedService';
|
||||
const XTAG_CREATE_STORAGE_SERVICE_INPUT = 'CreateStorageServiceInput';
|
||||
const XTAG_UPDATE_STORAGE_SERVICE_INPUT = 'UpdateStorageServiceInput';
|
||||
const XTAG_CREATE_AFFINITY_GROUP = 'CreateAffinityGroup';
|
||||
const XTAG_UPDATE_AFFINITY_GROUP = 'UpdateAffinityGroup';
|
||||
const XTAG_UPDATE_HOSTED_SERVICE = 'UpdateHostedService';
|
||||
const XTAG_PACKAGE_URL = 'PackageUrl';
|
||||
const XTAG_CONFIGURATION = 'Configuration';
|
||||
const XTAG_START_DEPLOYMENT = 'StartDeployment';
|
||||
const XTAG_TREAT_WARNINGS_AS_ERROR = 'TreatWarningsAsError';
|
||||
const XTAG_CREATE_DEPLOYMENT = 'CreateDeployment';
|
||||
const XTAG_DEPLOYMENT_SLOT = 'DeploymentSlot';
|
||||
const XTAG_PRIVATE_ID = 'PrivateID';
|
||||
const XTAG_ROLE_INSTANCE_LIST = 'RoleInstanceList';
|
||||
const XTAG_UPGRADE_DOMAIN_COUNT = 'UpgradeDomainCount';
|
||||
const XTAG_ROLE_LIST = 'RoleList';
|
||||
const XTAG_SDK_VERSION = 'SdkVersion';
|
||||
const XTAG_INPUT_ENDPOINT_LIST = 'InputEndpointList';
|
||||
const XTAG_LOCKED = 'Locked';
|
||||
const XTAG_ROLLBACK_ALLOWED = 'RollbackAllowed';
|
||||
const XTAG_UPGRADE_STATUS = 'UpgradeStatus';
|
||||
const XTAG_UPGRADE_TYPE = 'UpgradeType';
|
||||
const XTAG_CURRENT_UPGRADE_DOMAIN_STATE = 'CurrentUpgradeDomainState';
|
||||
const XTAG_CURRENT_UPGRADE_DOMAIN = 'CurrentUpgradeDomain';
|
||||
const XTAG_ROLE_NAME = 'RoleName';
|
||||
const XTAG_INSTANCE_NAME = 'InstanceName';
|
||||
const XTAG_INSTANCE_STATUS = 'InstanceStatus';
|
||||
const XTAG_INSTANCE_UPGRADE_DOMAIN = 'InstanceUpgradeDomain';
|
||||
const XTAG_INSTANCE_FAULT_DOMAIN = 'InstanceFaultDomain';
|
||||
const XTAG_INSTANCE_SIZE = 'InstanceSize';
|
||||
const XTAG_INSTANCE_STATE_DETAILS = 'InstanceStateDetails';
|
||||
const XTAG_INSTANCE_ERROR_CODE = 'InstanceErrorCode';
|
||||
const XTAG_OS_VERSION = 'OsVersion';
|
||||
const XTAG_ROLE_INSTANCE = 'RoleInstance';
|
||||
const XTAG_ROLE = 'Role';
|
||||
const XTAG_INPUT_ENDPOINT = 'InputEndpoint';
|
||||
const XTAG_VIP = 'Vip';
|
||||
const XTAG_PORT = 'Port';
|
||||
const XTAG_DEPLOYMENT = 'Deployment';
|
||||
const XTAG_DEPLOYMENTS = 'Deployments';
|
||||
const XTAG_REGENERATE_KEYS = 'RegenerateKeys';
|
||||
const XTAG_SWAP = 'Swap';
|
||||
const XTAG_PRODUCTION = 'Production';
|
||||
const XTAG_SOURCE_DEPLOYMENT = 'SourceDeployment';
|
||||
const XTAG_CHANGE_CONFIGURATION = 'ChangeConfiguration';
|
||||
const XTAG_MODE = 'Mode';
|
||||
const XTAG_UPDATE_DEPLOYMENT_STATUS = 'UpdateDeploymentStatus';
|
||||
const XTAG_ROLE_TO_UPGRADE = 'RoleToUpgrade';
|
||||
const XTAG_FORCE = 'Force';
|
||||
const XTAG_UPGRADE_DEPLOYMENT = 'UpgradeDeployment';
|
||||
const XTAG_UPGRADE_DOMAIN = 'UpgradeDomain';
|
||||
const XTAG_WALK_UPGRADE_DOMAIN = 'WalkUpgradeDomain';
|
||||
const XTAG_ROLLBACK_UPDATE_OR_UPGRADE = 'RollbackUpdateOrUpgrade';
|
||||
const XTAG_CONTAINER_NAME = 'ContainerName';
|
||||
const XTAG_ACCOUNT_NAME = 'AccountName';
|
||||
|
||||
// PHP URL Keys
|
||||
const PHP_URL_SCHEME = 'scheme';
|
||||
const PHP_URL_HOST = 'host';
|
||||
const PHP_URL_PORT = 'port';
|
||||
const PHP_URL_USER = 'user';
|
||||
const PHP_URL_PASS = 'pass';
|
||||
const PHP_URL_PATH = 'path';
|
||||
const PHP_URL_QUERY = 'query';
|
||||
const PHP_URL_FRAGMENT = 'fragment';
|
||||
|
||||
// Status Codes
|
||||
const STATUS_OK = 200;
|
||||
const STATUS_CREATED = 201;
|
||||
const STATUS_ACCEPTED = 202;
|
||||
const STATUS_NO_CONTENT = 204;
|
||||
const STATUS_PARTIAL_CONTENT = 206;
|
||||
const STATUS_MOVED_PERMANENTLY = 301;
|
||||
|
||||
// @codingStandardsIgnoreEnd
|
||||
}
|
||||
@ -0,0 +1,162 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal;
|
||||
|
||||
use MicrosoftAzure\Storage\Common\Internal\Resources;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Validate;
|
||||
|
||||
/**
|
||||
* Base class for all REST proxies.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class RestProxy
|
||||
{
|
||||
/**
|
||||
* @var array
|
||||
*/
|
||||
private $_filters;
|
||||
|
||||
/**
|
||||
* @var MicrosoftAzure\Storage\Common\Internal\Serialization\ISerializer
|
||||
*/
|
||||
protected $dataSerializer;
|
||||
|
||||
/**
|
||||
* @var string
|
||||
*/
|
||||
private $_uri;
|
||||
|
||||
/**
|
||||
* Initializes new RestProxy object.
|
||||
*
|
||||
* @param ISerializer $dataSerializer The data serializer.
|
||||
* @param string $uri The uri of the service.
|
||||
*/
|
||||
public function __construct($dataSerializer, $uri)
|
||||
{
|
||||
$this->_filters = array();
|
||||
$this->dataSerializer = $dataSerializer;
|
||||
$this->_uri = $uri;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets HTTP filters that will process each request.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function getFilters()
|
||||
{
|
||||
return $this->_filters;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the Uri of the service.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function getUri()
|
||||
{
|
||||
return $this->_uri;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the Uri of the service.
|
||||
*
|
||||
* @param string $uri The URI of the request.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public function setUri($uri)
|
||||
{
|
||||
$this->_uri = $uri;
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds new filter to new service rest proxy object and returns that object back.
|
||||
*
|
||||
* @param MicrosoftAzure\Storage\Common\Internal\IServiceFilter $filter Filter to add for
|
||||
* the pipeline.
|
||||
*
|
||||
* @return RestProxy.
|
||||
*/
|
||||
public function withFilter($filter)
|
||||
{
|
||||
$serviceProxyWithFilter = clone $this;
|
||||
$serviceProxyWithFilter->_filters[] = $filter;
|
||||
|
||||
return $serviceProxyWithFilter;
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds optional query parameter.
|
||||
*
|
||||
* Doesn't add the value if it satisfies empty().
|
||||
*
|
||||
* @param array &$queryParameters The query parameters.
|
||||
* @param string $key The query variable name.
|
||||
* @param string $value The query variable value.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
protected function addOptionalQueryParam(&$queryParameters, $key, $value)
|
||||
{
|
||||
Validate::isArray($queryParameters, 'queryParameters');
|
||||
Validate::isString($key, 'key');
|
||||
Validate::isString($value, 'value');
|
||||
|
||||
if (!is_null($value) && Resources::EMPTY_STRING !== $value) {
|
||||
$queryParameters[$key] = $value;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds optional header.
|
||||
*
|
||||
* Doesn't add the value if it satisfies empty().
|
||||
*
|
||||
* @param array &$headers The HTTP header parameters.
|
||||
* @param string $key The HTTP header name.
|
||||
* @param string $value The HTTP header value.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
protected function addOptionalHeader(&$headers, $key, $value)
|
||||
{
|
||||
Validate::isArray($headers, 'headers');
|
||||
Validate::isString($key, 'key');
|
||||
Validate::isString($value, 'value');
|
||||
|
||||
if (!is_null($value) && Resources::EMPTY_STRING !== $value) {
|
||||
$headers[$key] = $value;
|
||||
}
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,234 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal;
|
||||
|
||||
use MicrosoftAzure\Storage\Common\Internal\Resources;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Validate;
|
||||
use GuzzleHttp\Middleware;
|
||||
|
||||
/**
|
||||
* This class provides static functions that creates retry handlers for Guzzle
|
||||
* HTTP clients to handle retry policy.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class RetryMiddlewareFactory
|
||||
{
|
||||
const LINEAR_INTERVAL_ACCUMULATION = 'Linear';
|
||||
const EXPONENTIAL_INTERVAL_ACCUMULATION = 'Exponential';
|
||||
const GENERAL_RETRY_TYPE = 'General';
|
||||
const APPEND_BLOB_RETRY_TYPE = 'Append Blob Retry';
|
||||
|
||||
/**
|
||||
* Create the retry handler for the Guzzle client, according to the given
|
||||
* attributes.
|
||||
*
|
||||
* @param string $type The type that controls the logic of
|
||||
* the decider of the retry handler.
|
||||
* @param int $numberOfRetries The maximum number of retries.
|
||||
* @param int $interval The minimum interval between each retry
|
||||
* @param string $accumulationMethod If the interval increases linearly or
|
||||
* exponentially.
|
||||
*
|
||||
* @return RetryMiddleware A RetryMiddleware object that contains
|
||||
* the logic of how the request should be
|
||||
* handled after a response.
|
||||
*/
|
||||
public static function create(
|
||||
$type = self::GENERAL_RETRY_TYPE,
|
||||
$numberOfRetries = Resources::DEFAULT_NUMBER_OF_RETRIES,
|
||||
$interval = Resources::DEAFULT_RETRY_INTERVAL,
|
||||
$accumulationMethod = self::LINEAR_INTERVAL_ACCUMULATION
|
||||
) {
|
||||
//Validate the input parameters
|
||||
//type
|
||||
Validate::isTrue(
|
||||
$type == self::GENERAL_RETRY_TYPE ||
|
||||
$type == self::APPEND_BLOB_RETRY_TYPE,
|
||||
sprintf(
|
||||
Resources::INVALID_PARAM_GENERAL,
|
||||
'type'
|
||||
)
|
||||
);
|
||||
//numberOfRetries
|
||||
Validate::isTrue(
|
||||
$numberOfRetries > 0,
|
||||
sprintf(
|
||||
Resources::INVALID_NEGATIVE_PARAM,
|
||||
'numberOfRetries'
|
||||
)
|
||||
);
|
||||
//interval
|
||||
Validate::isTrue(
|
||||
$interval > 0,
|
||||
sprintf(
|
||||
Resources::INVALID_NEGATIVE_PARAM,
|
||||
'interval'
|
||||
)
|
||||
);
|
||||
//accumulationMethod
|
||||
Validate::isTrue(
|
||||
$accumulationMethod == self::LINEAR_INTERVAL_ACCUMULATION ||
|
||||
$accumulationMethod == self::EXPONENTIAL_INTERVAL_ACCUMULATION,
|
||||
sprintf(
|
||||
Resources::INVALID_PARAM_GENERAL,
|
||||
'accumulationMethod'
|
||||
)
|
||||
);
|
||||
|
||||
//Get the interval calculator according to the type of the
|
||||
//accumulation method.
|
||||
$intervalCalculator =
|
||||
$accumulationMethod == self::LINEAR_INTERVAL_ACCUMULATION ?
|
||||
self::createLinearDelayCalculator($interval) :
|
||||
self::createExponentialDelayCalculator($interval);
|
||||
|
||||
//Get the retry decider according to the type of the retry and
|
||||
//the number of retries.
|
||||
$retryDecider = self::createRetryDecider($type, $numberOfRetries);
|
||||
|
||||
//construct the retry middle ware.
|
||||
return Middleware::retry($retryDecider, $intervalCalculator);
|
||||
}
|
||||
|
||||
/**
|
||||
* Create the retry decider for the retry handler. It will return a callable
|
||||
* that accepts the number of retries, the request, the response and the
|
||||
* exception, and return the decision for a retry.
|
||||
*
|
||||
* @param string $type The type of the retry handler.
|
||||
*
|
||||
* @return callable The callable that will return if the request should
|
||||
* be retried.
|
||||
*/
|
||||
protected static function createRetryDecider($type, $maxRetries)
|
||||
{
|
||||
return function (
|
||||
$retries,
|
||||
$request,
|
||||
$response = null,
|
||||
$exception = null
|
||||
) use (
|
||||
$type,
|
||||
$maxRetries
|
||||
) {
|
||||
//Exceeds the retry limit. No retry.
|
||||
if ($retries >= $maxRetries) {
|
||||
return false;
|
||||
}
|
||||
|
||||
//Not retriable error, won't retry.
|
||||
if (!$response) {
|
||||
return false;
|
||||
} else {
|
||||
if ($type == self::GENERAL_RETRY_TYPE) {
|
||||
return self::generalRetryDecider($response->getStatusCode());
|
||||
} else {
|
||||
return self::appendBlobRetryDecider($response->getStatusCode());
|
||||
}
|
||||
}
|
||||
|
||||
return true;
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Decide if the given status code indicate the request should be retried.
|
||||
*
|
||||
* @param int $statusCode status code of the previous request.
|
||||
*
|
||||
* @return bool true if the request should be retried.
|
||||
*/
|
||||
protected static function generalRetryDecider($statusCode)
|
||||
{
|
||||
$retry = false;
|
||||
if ($statusCode == 408) {
|
||||
$retry = true;
|
||||
} elseif ($statusCode >= 500) {
|
||||
if ($statusCode != 501 && $statusCode != 505) {
|
||||
$retry = true;
|
||||
}
|
||||
}
|
||||
return $retry;
|
||||
}
|
||||
|
||||
/**
|
||||
* Decide if the given status code indicate the request should be retried.
|
||||
* This is for append blob.
|
||||
*
|
||||
* @param int $statusCode status code of the previous request.
|
||||
*
|
||||
* @return bool true if the request should be retried.
|
||||
*/
|
||||
protected static function appendBlobRetryDecider($statusCode)
|
||||
{
|
||||
//The retry logic is different for append blob.
|
||||
//First it will need to record the former status code if it is
|
||||
//server error. Then if the following request is 412 then it
|
||||
//needs to be retried. Currently this is not implemented so will
|
||||
//only adapt to the general retry decider.
|
||||
//TODO: add logic for append blob's retry when implemented.
|
||||
$retry = self::generalRetryDecider($statusCode);
|
||||
return $retry;
|
||||
}
|
||||
|
||||
/**
|
||||
* Create the delay calculator that increases the interval linearly
|
||||
* according to the number of retries.
|
||||
*
|
||||
* @param int $interval the minimum interval of the retry.
|
||||
*
|
||||
* @return callable a calculator that will return the interval
|
||||
* according to the number of retries.
|
||||
*/
|
||||
protected static function createLinearDelayCalculator($interval)
|
||||
{
|
||||
return function ($retries) use ($interval) {
|
||||
return $retries * $interval;
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Create the delay calculator that increases the interval exponentially
|
||||
* according to the number of retries.
|
||||
*
|
||||
* @param int $interval the minimum interval of the retry.
|
||||
*
|
||||
* @return callable a calculator that will return the interval
|
||||
* according to the number of retries.
|
||||
*/
|
||||
protected static function createExponentialDelayCalculator($interval)
|
||||
{
|
||||
return function ($retries) use ($interval) {
|
||||
return $interval * ((int)\pow(2, $retries));
|
||||
};
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,73 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Serialization
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal\Serialization;
|
||||
|
||||
/**
|
||||
* The serialization interface.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Serialization
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
interface ISerializer
|
||||
{
|
||||
|
||||
/**
|
||||
* Serialize an object into a XML.
|
||||
*
|
||||
* @param Object $targetObject The target object to be serialized.
|
||||
* @param string $rootName The name of the root.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public static function objectSerialize($targetObject, $rootName);
|
||||
|
||||
/**
|
||||
* Serializes given array. The array indices must be string to use them as
|
||||
* as element name.
|
||||
*
|
||||
* @param array $array The object to serialize represented in array.
|
||||
* @param array $properties The used properties in the serialization process.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function serialize($array, $properties = null);
|
||||
|
||||
|
||||
/**
|
||||
* Unserializes given serialized string.
|
||||
*
|
||||
* @param string $serialized The serialized object in string representation.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function unserialize($serialized);
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,96 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Serialization
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal\Serialization;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Validate;
|
||||
/**
|
||||
* Perform JSON serialization / deserialization
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Serialization
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class JsonSerializer implements ISerializer
|
||||
{
|
||||
/**
|
||||
* Serialize an object with specified root element name.
|
||||
*
|
||||
* @param object $targetObject The target object.
|
||||
* @param string $rootName The name of the root element.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public static function objectSerialize($targetObject, $rootName)
|
||||
{
|
||||
Validate::notNull($targetObject, 'targetObject');
|
||||
Validate::isString($rootName, 'rootName');
|
||||
|
||||
$contianer = new \stdClass();
|
||||
|
||||
$contianer->$rootName = $targetObject;
|
||||
|
||||
return json_encode($contianer);
|
||||
}
|
||||
|
||||
/**
|
||||
* Serializes given array. The array indices must be string to use them as
|
||||
* as element name.
|
||||
*
|
||||
* @param array $array The object to serialize represented in array.
|
||||
* @param array $properties The used properties in the serialization process.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function serialize($array, $properties = null)
|
||||
{
|
||||
Validate::isArray($array, 'array');
|
||||
|
||||
return json_encode($array);
|
||||
}
|
||||
|
||||
/**
|
||||
* Unserializes given serialized string to array.
|
||||
*
|
||||
* @param string $serialized The serialized object in string representation.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function unserialize($serialized)
|
||||
{
|
||||
Validate::isString($serialized, 'serialized');
|
||||
|
||||
$json = json_decode($serialized);
|
||||
if ($json && !is_array($json)) {
|
||||
return get_object_vars($json);
|
||||
} else {
|
||||
return $json;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,245 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Serialization
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal\Serialization;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Utilities;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Resources;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Validate;
|
||||
|
||||
/**
|
||||
* Short description
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal\Serialization
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class XmlSerializer implements ISerializer
|
||||
{
|
||||
const STANDALONE = 'standalone';
|
||||
const ROOT_NAME = 'rootName';
|
||||
const DEFAULT_TAG = 'defaultTag';
|
||||
|
||||
/**
|
||||
* Converts a SimpleXML object to an Array recursively
|
||||
* ensuring all sub-elements are arrays as well.
|
||||
*
|
||||
* @param string $sxml The SimpleXML object.
|
||||
* @param array $arr The array into which to store results.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
private function _sxml2arr($sxml, $arr = null)
|
||||
{
|
||||
foreach ((array) $sxml as $key => $value) {
|
||||
if (is_object($value) || (is_array($value))) {
|
||||
$arr[$key] = $this->_sxml2arr($value);
|
||||
} else {
|
||||
$arr[$key] = $value;
|
||||
}
|
||||
}
|
||||
|
||||
return $arr;
|
||||
}
|
||||
|
||||
/**
|
||||
* Takes an array and produces XML based on it.
|
||||
*
|
||||
* @param XMLWriter $xmlw XMLWriter object that was previously instanted
|
||||
* and is used for creating the XML.
|
||||
* @param array $data Array to be converted to XML.
|
||||
* @param string $defaultTag Default XML tag to be used if none specified.
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
private function _arr2xml(\XMLWriter $xmlw, $data, $defaultTag = null)
|
||||
{
|
||||
foreach ($data as $key => $value) {
|
||||
if ($key === Resources::XTAG_ATTRIBUTES) {
|
||||
foreach ($value as $attributeName => $attributeValue) {
|
||||
$xmlw->writeAttribute($attributeName, $attributeValue);
|
||||
}
|
||||
} else if (is_array($value)) {
|
||||
if (!is_int($key)) {
|
||||
if ($key != Resources::EMPTY_STRING) {
|
||||
$xmlw->startElement($key);
|
||||
} else {
|
||||
$xmlw->startElement($defaultTag);
|
||||
}
|
||||
}
|
||||
|
||||
$this->_arr2xml($xmlw, $value);
|
||||
|
||||
if (!is_int($key)) {
|
||||
$xmlw->endElement();
|
||||
}
|
||||
} else {
|
||||
$xmlw->writeElement($key, $value);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the attributes of a specified object if get attributes
|
||||
* method is exposed.
|
||||
*
|
||||
* @param object $targetObject The target object.
|
||||
* @param array $methodArray The array of method of the target object.
|
||||
*
|
||||
* @return mixed
|
||||
*/
|
||||
private static function _getInstanceAttributes($targetObject, $methodArray)
|
||||
{
|
||||
foreach ($methodArray as $method) {
|
||||
if ($method->name == 'getAttributes') {
|
||||
$classProperty = $method->invoke($targetObject);
|
||||
return $classProperty;
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Serialize an object with specified root element name.
|
||||
*
|
||||
* @param object $targetObject The target object.
|
||||
* @param string $rootName The name of the root element.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public static function objectSerialize($targetObject, $rootName)
|
||||
{
|
||||
Validate::notNull($targetObject, 'targetObject');
|
||||
Validate::isString($rootName, 'rootName');
|
||||
$xmlWriter = new \XmlWriter();
|
||||
$xmlWriter->openMemory();
|
||||
$xmlWriter->setIndent(true);
|
||||
$reflectionClass = new \ReflectionClass($targetObject);
|
||||
$methodArray = $reflectionClass->getMethods();
|
||||
$attributes = self::_getInstanceAttributes(
|
||||
$targetObject,
|
||||
$methodArray
|
||||
);
|
||||
|
||||
$xmlWriter->startElement($rootName);
|
||||
if (!is_null($attributes)) {
|
||||
foreach (array_keys($attributes) as $attributeKey) {
|
||||
$xmlWriter->writeAttribute(
|
||||
$attributeKey,
|
||||
$attributes[$attributeKey]
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
foreach ($methodArray as $method) {
|
||||
if ((strpos($method->name, 'get') === 0)
|
||||
&& $method->isPublic()
|
||||
&& ($method->name != 'getAttributes')
|
||||
) {
|
||||
$variableName = substr($method->name, 3);
|
||||
$variableValue = $method->invoke($targetObject);
|
||||
if (!empty($variableValue)) {
|
||||
if (gettype($variableValue) === 'object') {
|
||||
$xmlWriter->writeRaw(
|
||||
XmlSerializer::objectSerialize(
|
||||
$variableValue, $variableName
|
||||
)
|
||||
);
|
||||
} else {
|
||||
$xmlWriter->writeElement($variableName, $variableValue);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
$xmlWriter->endElement();
|
||||
return $xmlWriter->outputMemory(true);
|
||||
}
|
||||
|
||||
/**
|
||||
* Serializes given array. The array indices must be string to use them as
|
||||
* as element name.
|
||||
*
|
||||
* @param array $array The object to serialize represented in array.
|
||||
* @param array $properties The used properties in the serialization process.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function serialize($array, $properties = null)
|
||||
{
|
||||
$xmlVersion = '1.0';
|
||||
$xmlEncoding = 'UTF-8';
|
||||
$standalone = Utilities::tryGetValue($properties, self::STANDALONE);
|
||||
$defaultTag = Utilities::tryGetValue($properties, self::DEFAULT_TAG);
|
||||
$rootName = Utilities::tryGetValue($properties, self::ROOT_NAME);
|
||||
$docNamespace = Utilities::tryGetValue(
|
||||
$array,
|
||||
Resources::XTAG_NAMESPACE,
|
||||
null
|
||||
);
|
||||
|
||||
if (!is_array($array)) {
|
||||
return false;
|
||||
}
|
||||
|
||||
$xmlw = new \XmlWriter();
|
||||
$xmlw->openMemory();
|
||||
$xmlw->setIndent(true);
|
||||
$xmlw->startDocument($xmlVersion, $xmlEncoding, $standalone);
|
||||
|
||||
if (is_null($docNamespace)) {
|
||||
$xmlw->startElement($rootName);
|
||||
} else {
|
||||
foreach ($docNamespace as $uri => $prefix) {
|
||||
$xmlw->startElementNS($prefix, $rootName, $uri);
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
unset($array[Resources::XTAG_NAMESPACE]);
|
||||
self::_arr2xml($xmlw, $array, $defaultTag);
|
||||
|
||||
$xmlw->endElement();
|
||||
|
||||
return $xmlw->outputMemory(true);
|
||||
}
|
||||
|
||||
/**
|
||||
* Unserializes given serialized string.
|
||||
*
|
||||
* @param string $serialized The serialized object in string representation.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function unserialize($serialized)
|
||||
{
|
||||
$sxml = new \SimpleXMLElement($serialized);
|
||||
|
||||
return $this->_sxml2arr($sxml);
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,619 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal;
|
||||
|
||||
use MicrosoftAzure\Storage\Common\ServiceException;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Resources;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Validate;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Utilities;
|
||||
use MicrosoftAzure\Storage\Common\Internal\RetryMiddlewareFactory;
|
||||
use GuzzleHttp\HandlerStack;
|
||||
use GuzzleHttp\Middleware;
|
||||
use GuzzleHttp\Client;
|
||||
use GuzzleHttp\Psr7;
|
||||
use GuzzleHttp\Psr7\Request;
|
||||
use GuzzleHttp\Psr7\Response;
|
||||
use GuzzleHttp\Psr7\Uri;
|
||||
use GuzzleHttp\Promise\EachPromise;
|
||||
|
||||
/**
|
||||
* Base class for all services rest proxies.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class ServiceRestProxy extends RestProxy
|
||||
{
|
||||
/**
|
||||
* @var string
|
||||
*/
|
||||
private $_accountName;
|
||||
|
||||
/**
|
||||
*
|
||||
* @var \Uri
|
||||
*/
|
||||
private $_psrUri;
|
||||
|
||||
/**
|
||||
* @var array
|
||||
*/
|
||||
private $_options;
|
||||
|
||||
/**
|
||||
* Initializes new ServiceRestProxy object.
|
||||
*
|
||||
* @param string $uri The storage account uri.
|
||||
* @param string $accountName The name of the account.
|
||||
* @param ISerializer $dataSerializer The data serializer.
|
||||
* @param array $options Array of options for the service
|
||||
*/
|
||||
public function __construct($uri, $accountName, $dataSerializer, $options = [])
|
||||
{
|
||||
if ($uri[strlen($uri)-1] != '/') {
|
||||
$uri = $uri . '/';
|
||||
}
|
||||
|
||||
parent::__construct($dataSerializer, $uri);
|
||||
|
||||
$this->_accountName = $accountName;
|
||||
$this->_psrUri = new \GuzzleHttp\Psr7\Uri($uri);
|
||||
$this->_options = array_merge(array('http' => array()), $options);
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the account name.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function getAccountName()
|
||||
{
|
||||
return $this->_accountName;
|
||||
}
|
||||
|
||||
/**
|
||||
* Filter the request using the filters. This is for users to create
|
||||
* request.
|
||||
* @param \GuzzleHttp\Psr7\Request $request The request to be filtered.
|
||||
*
|
||||
* @return \GuzzleHttp\Psr7\Request The filtered request.
|
||||
*/
|
||||
protected function requestWithFilter($request)
|
||||
{
|
||||
// Apply filters to the requests
|
||||
foreach ($this->getFilters() as $filter) {
|
||||
$request = $filter->handleRequest($request);
|
||||
}
|
||||
return $request;
|
||||
}
|
||||
|
||||
/**
|
||||
* Static helper function to create a usable client for the proxy.
|
||||
* The clientOptions can contain the following keys that will affect
|
||||
* the way retry handler is created and applied.
|
||||
* handler: HandlerStack, if set, this function will not
|
||||
* create a handler stack. It will still construct
|
||||
* a default retry handler if not specified by the
|
||||
* following parameters.
|
||||
* have_retry_middleware: boolean, true if the handler is already specified
|
||||
* in the handler stack.
|
||||
* retry_middleware: Middleware, if specified this method will not create
|
||||
* a default retry middle ware.
|
||||
* @param array $clientOptions Added options for client.
|
||||
*
|
||||
* @return \GuzzleHttp\Client
|
||||
*/
|
||||
protected function createClient($clientOptions)
|
||||
{
|
||||
//If retry handler is not defined by the user, create a default
|
||||
//handler.
|
||||
$stack = null;
|
||||
if (array_key_exists('handler', $this->_options['http'])) {
|
||||
$stack = $this->_options['http']['handler'];
|
||||
} elseif (array_key_exists('handler', $clientOptions)) {
|
||||
$stack = $clientOptions['handler'];
|
||||
} else {
|
||||
$stack = HandlerStack::create();
|
||||
$clientOptions['handler'] = $stack;
|
||||
}
|
||||
|
||||
//If retry middle ware is specified, push it to the client.
|
||||
//Otherwise use the default middle ware.
|
||||
if (array_key_exists('have_retry_middleware', $clientOptions) &&
|
||||
$clientOptions['have_retry_middleware'] == true) {
|
||||
//do nothing
|
||||
} elseif (array_key_exists('retry_middleware', $clientOptions)) {
|
||||
//push the retry middleware to the handler stack.
|
||||
$stack->push($clientOptions['retry_middleware']);
|
||||
} else {
|
||||
//construct the default retry middleware and push to the handler.
|
||||
$stack->push(RetryMiddlewareFactory::create(), 'retry_middleware');
|
||||
}
|
||||
return (new \GuzzleHttp\Client(
|
||||
array_merge(
|
||||
$this->_options['http'],
|
||||
array(
|
||||
"defaults" => array(
|
||||
"allow_redirects" => true,
|
||||
"exceptions" => true,
|
||||
"decode_content" => true,
|
||||
),
|
||||
'cookies' => true,
|
||||
'verify' => false,
|
||||
// For testing with Fiddler
|
||||
//'proxy' => "localhost:8888",
|
||||
),
|
||||
$clientOptions
|
||||
)
|
||||
));
|
||||
}
|
||||
|
||||
/**
|
||||
* Send the requests concurrently. Number of concurrency can be modified
|
||||
* by inserting a new key/value pair with the key 'number_of_concurrency'
|
||||
* into the $clientOptions.
|
||||
*
|
||||
* @param array $requests An array holding all the
|
||||
* initialized requests. If empty,
|
||||
* the first batch will be created
|
||||
* using the generator.
|
||||
* @param callable $generator the generator function to
|
||||
* generate request upon fullfilment
|
||||
* @param int $expectedStatusCode The expected status code for each
|
||||
* of the request.
|
||||
* @param array $clientOptions an array of additional options
|
||||
* for the client.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
protected function sendConcurrent(
|
||||
$requests,
|
||||
$generator,
|
||||
$expectedStatusCode,
|
||||
$clientOptions = []
|
||||
) {
|
||||
//set the number of concurrency to default value if not defined
|
||||
//in the array.
|
||||
$numberOfConcurrency = Resources::NUMBER_OF_CONCURRENCY;
|
||||
if (array_key_exists('number_of_concurrency', $clientOptions)) {
|
||||
$numberOfConcurrency = $clientOptions['number_of_concurrency'];
|
||||
unset($clientOptions['number_of_concurrency']);
|
||||
}
|
||||
//create the client
|
||||
$client = $this->createClient($clientOptions);
|
||||
|
||||
$promises = \call_user_func(
|
||||
function () use ($requests, $generator, $client) {
|
||||
$sendAsync = function ($request) use ($client) {
|
||||
$options = $request->getMethod() == 'HEAD'?
|
||||
array('decode_content' => false) : array();
|
||||
return $client->sendAsync($request, $options);
|
||||
};
|
||||
foreach ($requests as $request) {
|
||||
yield $sendAsync($request);
|
||||
}
|
||||
while (is_callable($generator) && ($request = $generator())) {
|
||||
yield $sendAsync($request);
|
||||
}
|
||||
}
|
||||
);
|
||||
|
||||
$eachPromise = new EachPromise($promises, [
|
||||
'concurrency' => $numberOfConcurrency,
|
||||
'fulfilled' => function ($response, $index) use ($expectedStatusCode) {
|
||||
//the promise is fulfilled, evaluate the response
|
||||
self::throwIfError(
|
||||
$response->getStatusCode(),
|
||||
$response->getReasonPhrase(),
|
||||
$response->getBody(),
|
||||
$expectedStatusCode
|
||||
);
|
||||
},
|
||||
'rejected' => function ($reason, $index) {
|
||||
//Still rejected even if the retry logic has been applied.
|
||||
//Throwing exception.
|
||||
throw $reason;
|
||||
}
|
||||
]);
|
||||
|
||||
return $eachPromise->promise()->wait();
|
||||
}
|
||||
|
||||
/**
|
||||
* Create the request to be sent.
|
||||
*
|
||||
* @param string $method The method of the HTTP request
|
||||
* @param array $headers The header field of the request
|
||||
* @param array $queryParams The query parameter of the request
|
||||
* @param array $postParameters The HTTP POST parameters
|
||||
* @param string $path URL path
|
||||
* @param string $body Request body
|
||||
*
|
||||
* @return \GuzzleHttp\Psr7\Request
|
||||
*/
|
||||
protected function createRequest(
|
||||
$method,
|
||||
$headers,
|
||||
$queryParams,
|
||||
$postParameters,
|
||||
$path,
|
||||
$body = Resources::EMPTY_STRING
|
||||
) {
|
||||
// add query parameters into headers
|
||||
$uri = $this->_psrUri;
|
||||
if ($path != null) {
|
||||
$uri = $uri->withPath($path);
|
||||
}
|
||||
|
||||
if ($queryParams != null) {
|
||||
$queryString = Psr7\build_query($queryParams);
|
||||
$uri = $uri->withQuery($queryString);
|
||||
}
|
||||
|
||||
// add post parameters into bodys
|
||||
$actualBody = null;
|
||||
if (empty($body)) {
|
||||
if (empty($headers['content-type'])) {
|
||||
$headers['content-type'] = 'application/x-www-form-urlencoded';
|
||||
$actualBody = Psr7\build_query($postParameters);
|
||||
}
|
||||
} else {
|
||||
$actualBody = $body;
|
||||
}
|
||||
|
||||
$request = new Request(
|
||||
$method,
|
||||
$uri,
|
||||
$headers,
|
||||
$actualBody
|
||||
);
|
||||
|
||||
//add content-length to header
|
||||
$bodySize = $request->getBody()->getSize();
|
||||
if ($bodySize > 0) {
|
||||
$request = $request->withHeader('content-length', $bodySize);
|
||||
}
|
||||
// Apply filters to the requests
|
||||
return $this->requestWithFilter($request);
|
||||
}
|
||||
|
||||
/**
|
||||
* Sends HTTP request with the specified parameters.
|
||||
*
|
||||
* @param string $method HTTP method used in the request
|
||||
* @param array $headers HTTP headers.
|
||||
* @param array $queryParams URL query parameters.
|
||||
* @param array $postParameters The HTTP POST parameters.
|
||||
* @param string $path URL path
|
||||
* @param int $statusCode Expected status code received in the response
|
||||
* @param string $body Request body
|
||||
* @param array $clientOptions Guzzle Client options
|
||||
*
|
||||
* @return GuzzleHttp\Psr7\Response
|
||||
*/
|
||||
protected function send(
|
||||
$method,
|
||||
$headers,
|
||||
$queryParams,
|
||||
$postParameters,
|
||||
$path,
|
||||
$statusCode,
|
||||
$body = Resources::EMPTY_STRING,
|
||||
$clientOptions = []
|
||||
) {
|
||||
$request = $this->createRequest(
|
||||
$method,
|
||||
$headers,
|
||||
$queryParams,
|
||||
$postParameters,
|
||||
$path,
|
||||
$body
|
||||
);
|
||||
$client = $this->createClient($clientOptions);
|
||||
|
||||
try {
|
||||
$options = $request->getMethod() == 'HEAD'?
|
||||
array('decode_content' => false) : array();
|
||||
$response = $client->send($request, $options);
|
||||
self::throwIfError(
|
||||
$response->getStatusCode(),
|
||||
$response->getReasonPhrase(),
|
||||
$response->getBody(),
|
||||
$statusCode
|
||||
);
|
||||
return $response;
|
||||
} catch (\GuzzleHttp\Exception\RequestException $e) {
|
||||
if ($e->hasResponse()) {
|
||||
$response = $e->getResponse();
|
||||
self::throwIfError(
|
||||
$response->getStatusCode(),
|
||||
$response->getReasonPhrase(),
|
||||
$response->getBody(),
|
||||
$statusCode
|
||||
);
|
||||
return $response;
|
||||
} else {
|
||||
throw $e;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
protected function sendContext($context)
|
||||
{
|
||||
return $this->send(
|
||||
$context->getMethod(),
|
||||
$context->getHeaders(),
|
||||
$context->getQueryParameters(),
|
||||
$context->getPostParameters(),
|
||||
$context->getPath(),
|
||||
$context->getStatusCodes(),
|
||||
$context->getBody()
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Throws ServiceException if the recieved status code is not expected.
|
||||
*
|
||||
* @param string $actual The received status code.
|
||||
* @param string $reason The reason phrase.
|
||||
* @param string $message The detailed message (if any).
|
||||
* @param string $expected The expected status codes.
|
||||
*
|
||||
* @return none
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @throws ServiceException
|
||||
*/
|
||||
public static function throwIfError($actual, $reason, $message, $expected)
|
||||
{
|
||||
$expectedStatusCodes = is_array($expected) ? $expected : array($expected);
|
||||
|
||||
if (!in_array($actual, $expectedStatusCodes)) {
|
||||
throw new ServiceException($actual, $reason, $message);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds optional header to headers if set
|
||||
*
|
||||
* @param array $headers The array of request headers.
|
||||
* @param AccessCondition $accessCondition The access condition object.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function addOptionalAccessConditionHeader($headers, $accessCondition)
|
||||
{
|
||||
if (!is_null($accessCondition)) {
|
||||
$header = $accessCondition->getHeader();
|
||||
|
||||
if ($header != Resources::EMPTY_STRING) {
|
||||
$value = $accessCondition->getValue();
|
||||
if ($value instanceof \DateTime) {
|
||||
$value = gmdate(
|
||||
Resources::AZURE_DATE_FORMAT,
|
||||
$value->getTimestamp()
|
||||
);
|
||||
}
|
||||
$headers[$header] = $value;
|
||||
}
|
||||
}
|
||||
|
||||
return $headers;
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds optional header to headers if set
|
||||
*
|
||||
* @param array $headers The array of request headers.
|
||||
* @param AccessCondition $accessCondition The access condition object.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function addOptionalSourceAccessConditionHeader(
|
||||
$headers,
|
||||
$accessCondition
|
||||
) {
|
||||
if (!is_null($accessCondition)) {
|
||||
$header = $accessCondition->getHeader();
|
||||
$headerName = null;
|
||||
if (!empty($header)) {
|
||||
switch ($header) {
|
||||
case Resources::IF_MATCH:
|
||||
$headerName = Resources::X_MS_SOURCE_IF_MATCH;
|
||||
break;
|
||||
case Resources::IF_UNMODIFIED_SINCE:
|
||||
$headerName = Resources::X_MS_SOURCE_IF_UNMODIFIED_SINCE;
|
||||
break;
|
||||
case Resources::IF_MODIFIED_SINCE:
|
||||
$headerName = Resources::X_MS_SOURCE_IF_MODIFIED_SINCE;
|
||||
break;
|
||||
case Resources::IF_NONE_MATCH:
|
||||
$headerName = Resources::X_MS_SOURCE_IF_NONE_MATCH;
|
||||
break;
|
||||
default:
|
||||
throw new \Exception(Resources::INVALID_ACH_MSG);
|
||||
break;
|
||||
}
|
||||
}
|
||||
$value = $accessCondition->getValue();
|
||||
if ($value instanceof \DateTime) {
|
||||
$value = gmdate(
|
||||
Resources::AZURE_DATE_FORMAT,
|
||||
$value->getTimestamp()
|
||||
);
|
||||
}
|
||||
|
||||
$this->addOptionalHeader($headers, $headerName, $value);
|
||||
}
|
||||
|
||||
return $headers;
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds HTTP POST parameter to the specified
|
||||
*
|
||||
* @param array $postParameters An array of HTTP POST parameters.
|
||||
* @param string $key The key of a HTTP POST parameter.
|
||||
* @param string $value the value of a HTTP POST parameter.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function addPostParameter(
|
||||
$postParameters,
|
||||
$key,
|
||||
$value
|
||||
) {
|
||||
Validate::isArray($postParameters, 'postParameters');
|
||||
$postParameters[$key] = $value;
|
||||
return $postParameters;
|
||||
}
|
||||
|
||||
/**
|
||||
* Groups set of values into one value separated with Resources::SEPARATOR
|
||||
*
|
||||
* @param array $values array of values to be grouped.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public static function groupQueryValues($values)
|
||||
{
|
||||
Validate::isArray($values, 'values');
|
||||
$joined = Resources::EMPTY_STRING;
|
||||
|
||||
sort($values);
|
||||
|
||||
foreach ($values as $value) {
|
||||
if (!is_null($value) && !empty($value)) {
|
||||
$joined .= $value . Resources::SEPARATOR;
|
||||
}
|
||||
}
|
||||
|
||||
return trim($joined, Resources::SEPARATOR);
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds metadata elements to headers array
|
||||
*
|
||||
* @param array $headers HTTP request headers
|
||||
* @param array $metadata user specified metadata
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
protected function addMetadataHeaders($headers, $metadata)
|
||||
{
|
||||
$this->validateMetadata($metadata);
|
||||
|
||||
$metadata = $this->generateMetadataHeaders($metadata);
|
||||
$headers = array_merge($headers, $metadata);
|
||||
|
||||
return $headers;
|
||||
}
|
||||
|
||||
/**
|
||||
* Generates metadata headers by prefixing each element with 'x-ms-meta'.
|
||||
*
|
||||
* @param array $metadata user defined metadata.
|
||||
*
|
||||
* @return array.
|
||||
*/
|
||||
public function generateMetadataHeaders($metadata)
|
||||
{
|
||||
$metadataHeaders = array();
|
||||
|
||||
if (is_array($metadata) && !is_null($metadata)) {
|
||||
foreach ($metadata as $key => $value) {
|
||||
$headerName = Resources::X_MS_META_HEADER_PREFIX;
|
||||
if (strpos($value, "\r") !== false
|
||||
|| strpos($value, "\n") !== false
|
||||
) {
|
||||
throw new \InvalidArgumentException(Resources::INVALID_META_MSG);
|
||||
}
|
||||
|
||||
// Metadata name is case-presrved and case insensitive
|
||||
$headerName .= $key;
|
||||
$metadataHeaders[$headerName] = $value;
|
||||
}
|
||||
}
|
||||
|
||||
return $metadataHeaders;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets metadata array by parsing them from given headers.
|
||||
*
|
||||
* @param array $headers HTTP headers containing metadata elements.
|
||||
*
|
||||
* @return array.
|
||||
*/
|
||||
public function getMetadataArray($headers)
|
||||
{
|
||||
$metadata = array();
|
||||
foreach ($headers as $key => $value) {
|
||||
$isMetadataHeader = Utilities::startsWith(
|
||||
strtolower($key),
|
||||
Resources::X_MS_META_HEADER_PREFIX
|
||||
);
|
||||
|
||||
if ($isMetadataHeader) {
|
||||
// Metadata name is case-presrved and case insensitive
|
||||
$MetadataName = str_ireplace(
|
||||
Resources::X_MS_META_HEADER_PREFIX,
|
||||
Resources::EMPTY_STRING,
|
||||
$key
|
||||
);
|
||||
$metadata[$MetadataName] = $value;
|
||||
}
|
||||
}
|
||||
|
||||
return $metadata;
|
||||
}
|
||||
|
||||
/**
|
||||
* Validates the provided metadata array.
|
||||
*
|
||||
* @param mix $metadata The metadata array.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public function validateMetadata($metadata)
|
||||
{
|
||||
if (!is_null($metadata)) {
|
||||
Validate::isArray($metadata, 'metadata');
|
||||
} else {
|
||||
$metadata = array();
|
||||
}
|
||||
|
||||
foreach ($metadata as $key => $value) {
|
||||
Validate::isString($key, 'metadata key');
|
||||
Validate::isString($value, 'metadata value');
|
||||
}
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,287 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Resources;
|
||||
|
||||
/**
|
||||
* Base class for all REST services settings.
|
||||
*
|
||||
* Derived classes must implement the following members:
|
||||
* 1- $isInitialized: A static property that indicates whether the class's static
|
||||
* members have been initialized.
|
||||
* 2- init(): A protected static method that initializes static members.
|
||||
* 3- $validSettingKeys: A static property that contains valid setting keys for this
|
||||
* service.
|
||||
* 4- createFromConnectionString($connectionString): A public static function that
|
||||
* takes a connection string and returns the created settings object.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
abstract class ServiceSettings
|
||||
{
|
||||
/**
|
||||
* Throws an exception if the connection string format does not match any of the
|
||||
* available formats.
|
||||
*
|
||||
* @param type $connectionString The invalid formatted connection string.
|
||||
*
|
||||
* @return none
|
||||
*
|
||||
* @throws \RuntimeException
|
||||
*/
|
||||
protected static function noMatch($connectionString)
|
||||
{
|
||||
throw new \RuntimeException(
|
||||
sprintf(Resources::MISSING_CONNECTION_STRING_SETTINGS, $connectionString)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Parses the connection string and then validate that the parsed keys belong to
|
||||
* the $validSettingKeys
|
||||
*
|
||||
* @param string $connectionString The user provided connection string.
|
||||
*
|
||||
* @return array The tokenized connection string keys.
|
||||
*
|
||||
* @throws \RuntimeException
|
||||
*/
|
||||
protected static function parseAndValidateKeys($connectionString)
|
||||
{
|
||||
// Initialize the static values if they are not initialized yet.
|
||||
if (!static::$isInitialized) {
|
||||
static::init();
|
||||
static::$isInitialized = true;
|
||||
}
|
||||
|
||||
$tokenizedSettings = ConnectionStringParser::parseConnectionString(
|
||||
'connectionString',
|
||||
$connectionString
|
||||
);
|
||||
|
||||
// Assure that all given keys are valid.
|
||||
foreach ($tokenizedSettings as $key => $value) {
|
||||
if (!Utilities::inArrayInsensitive($key, static::$validSettingKeys) ) {
|
||||
throw new \RuntimeException(
|
||||
sprintf(
|
||||
Resources::INVALID_CONNECTION_STRING_SETTING_KEY,
|
||||
$key,
|
||||
implode("\n", static::$validSettingKeys)
|
||||
)
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
return $tokenizedSettings;
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates an anonymous function that acts as predicate.
|
||||
*
|
||||
* @param array $requirements The array of conditions to satisfy.
|
||||
* @param boolean $isRequired Either these conditions are all required or all
|
||||
* optional.
|
||||
* @param boolean $atLeastOne Indicates that at least one requirement must
|
||||
* succeed.
|
||||
*
|
||||
* @return callable
|
||||
*/
|
||||
protected static function getValidator($requirements, $isRequired, $atLeastOne)
|
||||
{
|
||||
// @codingStandardsIgnoreStart
|
||||
|
||||
return function ($userSettings)
|
||||
use ($requirements, $isRequired, $atLeastOne) {
|
||||
$oneFound = false;
|
||||
$result = array_change_key_case($userSettings);
|
||||
foreach ($requirements as $requirement) {
|
||||
$settingName = strtolower($requirement[Resources::SETTING_NAME]);
|
||||
|
||||
// Check if the setting name exists in the provided user settings.
|
||||
if (array_key_exists($settingName, $result)) {
|
||||
// Check if the provided user setting value is valid.
|
||||
$validationFunc = $requirement[Resources::SETTING_CONSTRAINT];
|
||||
$isValid = $validationFunc($result[$settingName]);
|
||||
|
||||
if ($isValid) {
|
||||
// Remove the setting as indicator for successful validation.
|
||||
unset($result[$settingName]);
|
||||
$oneFound = true;
|
||||
}
|
||||
} else {
|
||||
// If required then fail because the setting does not exist
|
||||
if ($isRequired) {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if ($atLeastOne) {
|
||||
// At least one requirement must succeed, otherwise fail.
|
||||
return $oneFound ? $result : null;
|
||||
} else {
|
||||
return $result;
|
||||
}
|
||||
};
|
||||
|
||||
// @codingStandardsIgnoreEnd
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates at lease one succeed predicate for the provided list of requirements.
|
||||
*
|
||||
* @return callable
|
||||
*/
|
||||
protected static function atLeastOne()
|
||||
{
|
||||
$allSettings = func_get_args();
|
||||
return self::getValidator($allSettings, false, true);
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates an optional predicate for the provided list of requirements.
|
||||
*
|
||||
* @return callable
|
||||
*/
|
||||
protected static function optional()
|
||||
{
|
||||
$optionalSettings = func_get_args();
|
||||
return self::getValidator($optionalSettings, false, false);
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates an required predicate for the provided list of requirements.
|
||||
*
|
||||
* @return callable
|
||||
*/
|
||||
protected static function allRequired()
|
||||
{
|
||||
$requiredSettings = func_get_args();
|
||||
return self::getValidator($requiredSettings, true, false);
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates a setting value condition using the passed predicate.
|
||||
*
|
||||
* @param string $name The setting key name.
|
||||
* @param callable $predicate The setting value predicate.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
protected static function settingWithFunc($name, $predicate)
|
||||
{
|
||||
$requirement = array();
|
||||
$requirement[Resources::SETTING_NAME] = $name;
|
||||
$requirement[Resources::SETTING_CONSTRAINT] = $predicate;
|
||||
|
||||
return $requirement;
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates a setting value condition that validates it is one of the
|
||||
* passed valid values.
|
||||
*
|
||||
* @param string $name The setting key name.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
protected static function setting($name)
|
||||
{
|
||||
$validValues = func_get_args();
|
||||
|
||||
// Remove $name argument.
|
||||
unset($validValues[0]);
|
||||
|
||||
$validValuesCount = func_num_args();
|
||||
|
||||
$predicate = function ($settingValue) use ($validValuesCount, $validValues) {
|
||||
if (empty($validValues)) {
|
||||
// No restrictions, succeed,
|
||||
return true;
|
||||
}
|
||||
|
||||
// Check to find if the $settingValue is valid or not. The index must
|
||||
// start from 1 as unset deletes the value but does not update the array
|
||||
// indecies.
|
||||
for ($index = 1; $index < $validValuesCount; $index++) {
|
||||
if ($settingValue == $validValues[$index]) {
|
||||
// $settingValue is found in valid values set, succeed.
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
throw new \RuntimeException(
|
||||
sprintf(
|
||||
Resources::INVALID_CONFIG_VALUE,
|
||||
$settingValue,
|
||||
implode("\n", $validValues)
|
||||
)
|
||||
);
|
||||
|
||||
// $settingValue is missing in valid values set, fail.
|
||||
return false;
|
||||
};
|
||||
|
||||
return self::settingWithFunc($name, $predicate);
|
||||
}
|
||||
|
||||
/**
|
||||
* Tests to see if a given list of settings matches a set of filters exactly.
|
||||
*
|
||||
* @param array $settings The settings to check.
|
||||
*
|
||||
* @return boolean If any filter returns null, false. If there are any settings
|
||||
* left over after all filters are processed, false. Otherwise true.
|
||||
*/
|
||||
protected static function matchedSpecification($settings)
|
||||
{
|
||||
$constraints = func_get_args();
|
||||
|
||||
// Remove first element which corresponds to $settings
|
||||
unset($constraints[0]);
|
||||
|
||||
foreach ($constraints as $constraint) {
|
||||
$remainingSettings = $constraint($settings);
|
||||
|
||||
if (is_null($remainingSettings)) {
|
||||
return false;
|
||||
} else {
|
||||
$settings = $remainingSettings;
|
||||
}
|
||||
}
|
||||
|
||||
if (empty($settings)) {
|
||||
return true;
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,485 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal;
|
||||
|
||||
use MicrosoftAzure\Storage\Common\Internal\ConnectionStringParser;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Resources;
|
||||
|
||||
/**
|
||||
* Represents the settings used to sign and access a request against the storage
|
||||
* service. For more information about storage service connection strings check this
|
||||
* page: http://msdn.microsoft.com/en-us/library/ee758697
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class StorageServiceSettings extends ServiceSettings
|
||||
{
|
||||
/**
|
||||
* The storage service name.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $_name;
|
||||
|
||||
/**
|
||||
* A base64 representation.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $_key;
|
||||
|
||||
/**
|
||||
* The endpoint for the blob service.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $_blobEndpointUri;
|
||||
|
||||
/**
|
||||
* The endpoint for the queue service.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $_queueEndpointUri;
|
||||
|
||||
/**
|
||||
* The endpoint for the table service.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $_tableEndpointUri;
|
||||
|
||||
/**
|
||||
* @var StorageServiceSettings
|
||||
*/
|
||||
private static $_devStoreAccount;
|
||||
|
||||
/**
|
||||
* Validator for the UseDevelopmentStorage setting. Must be "true".
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private static $_useDevelopmentStorageSetting;
|
||||
|
||||
/**
|
||||
* Validator for the DevelopmentStorageProxyUri setting. Must be a valid Uri.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private static $_developmentStorageProxyUriSetting;
|
||||
|
||||
/**
|
||||
* Validator for the DefaultEndpointsProtocol setting. Must be either "http"
|
||||
* or "https".
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private static $_defaultEndpointsProtocolSetting;
|
||||
|
||||
/**
|
||||
* Validator for the AccountName setting. No restrictions.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private static $_accountNameSetting;
|
||||
|
||||
/**
|
||||
* Validator for the AccountKey setting. Must be a valid base64 string.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private static $_accountKeySetting;
|
||||
|
||||
/**
|
||||
* Validator for the BlobEndpoint setting. Must be a valid Uri.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private static $_blobEndpointSetting;
|
||||
|
||||
/**
|
||||
* Validator for the QueueEndpoint setting. Must be a valid Uri.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private static $_queueEndpointSetting;
|
||||
|
||||
/**
|
||||
* Validator for the TableEndpoint setting. Must be a valid Uri.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private static $_tableEndpointSetting;
|
||||
|
||||
/**
|
||||
* @var boolean
|
||||
*/
|
||||
protected static $isInitialized = false;
|
||||
|
||||
/**
|
||||
* Holds the expected setting keys.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected static $validSettingKeys = array();
|
||||
|
||||
/**
|
||||
* Initializes static members of the class.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
protected static function init()
|
||||
{
|
||||
self::$_useDevelopmentStorageSetting = self::setting(
|
||||
Resources::USE_DEVELOPMENT_STORAGE_NAME,
|
||||
'true'
|
||||
);
|
||||
|
||||
self::$_developmentStorageProxyUriSetting = self::settingWithFunc(
|
||||
Resources::DEVELOPMENT_STORAGE_PROXY_URI_NAME,
|
||||
Validate::getIsValidUri()
|
||||
);
|
||||
|
||||
self::$_defaultEndpointsProtocolSetting = self::setting(
|
||||
Resources::DEFAULT_ENDPOINTS_PROTOCOL_NAME,
|
||||
'http',
|
||||
'https'
|
||||
);
|
||||
|
||||
self::$_accountNameSetting = self::setting(Resources::ACCOUNT_NAME_NAME);
|
||||
|
||||
self::$_accountKeySetting = self::settingWithFunc(
|
||||
Resources::ACCOUNT_KEY_NAME,
|
||||
// base64_decode will return false if the $key is not in base64 format.
|
||||
function ($key) {
|
||||
$isValidBase64String = base64_decode($key, true);
|
||||
if ($isValidBase64String) {
|
||||
return true;
|
||||
} else {
|
||||
throw new \RuntimeException(
|
||||
sprintf(Resources::INVALID_ACCOUNT_KEY_FORMAT, $key)
|
||||
);
|
||||
}
|
||||
}
|
||||
);
|
||||
|
||||
self::$_blobEndpointSetting = self::settingWithFunc(
|
||||
Resources::BLOB_ENDPOINT_NAME,
|
||||
Validate::getIsValidUri()
|
||||
);
|
||||
|
||||
self::$_queueEndpointSetting = self::settingWithFunc(
|
||||
Resources::QUEUE_ENDPOINT_NAME,
|
||||
Validate::getIsValidUri()
|
||||
);
|
||||
|
||||
self::$_tableEndpointSetting = self::settingWithFunc(
|
||||
Resources::TABLE_ENDPOINT_NAME,
|
||||
Validate::getIsValidUri()
|
||||
);
|
||||
|
||||
self::$validSettingKeys[] = Resources::USE_DEVELOPMENT_STORAGE_NAME;
|
||||
self::$validSettingKeys[] = Resources::DEVELOPMENT_STORAGE_PROXY_URI_NAME;
|
||||
self::$validSettingKeys[] = Resources::DEFAULT_ENDPOINTS_PROTOCOL_NAME;
|
||||
self::$validSettingKeys[] = Resources::ACCOUNT_NAME_NAME;
|
||||
self::$validSettingKeys[] = Resources::ACCOUNT_KEY_NAME;
|
||||
self::$validSettingKeys[] = Resources::BLOB_ENDPOINT_NAME;
|
||||
self::$validSettingKeys[] = Resources::QUEUE_ENDPOINT_NAME;
|
||||
self::$validSettingKeys[] = Resources::TABLE_ENDPOINT_NAME;
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates new storage service settings instance.
|
||||
*
|
||||
* @param string $name The storage service name.
|
||||
* @param string $key The storage service key.
|
||||
* @param string $blobEndpointUri The sotrage service blob endpoint.
|
||||
* @param string $queueEndpointUri The sotrage service queue endpoint.
|
||||
* @param string $tableEndpointUri The sotrage service table endpoint.
|
||||
*/
|
||||
public function __construct(
|
||||
$name,
|
||||
$key,
|
||||
$blobEndpointUri,
|
||||
$queueEndpointUri,
|
||||
$tableEndpointUri
|
||||
) {
|
||||
$this->_name = $name;
|
||||
$this->_key = $key;
|
||||
$this->_blobEndpointUri = $blobEndpointUri;
|
||||
$this->_queueEndpointUri = $queueEndpointUri;
|
||||
$this->_tableEndpointUri = $tableEndpointUri;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns a StorageServiceSettings with development storage credentials using
|
||||
* the specified proxy Uri.
|
||||
*
|
||||
* @param string $proxyUri The proxy endpoint to use.
|
||||
*
|
||||
* @return StorageServiceSettings
|
||||
*/
|
||||
private static function _getDevelopmentStorageAccount($proxyUri)
|
||||
{
|
||||
if (is_null($proxyUri)) {
|
||||
return self::developmentStorageAccount();
|
||||
}
|
||||
|
||||
$scheme = parse_url($proxyUri, PHP_URL_SCHEME);
|
||||
$host = parse_url($proxyUri, PHP_URL_HOST);
|
||||
$prefix = $scheme . "://" . $host;
|
||||
|
||||
return new StorageServiceSettings(
|
||||
Resources::DEV_STORE_NAME,
|
||||
Resources::DEV_STORE_KEY,
|
||||
$prefix . ':10000/devstoreaccount1/',
|
||||
$prefix . ':10001/devstoreaccount1/',
|
||||
$prefix . ':10002/devstoreaccount1/'
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets a StorageServiceSettings object that references the development storage
|
||||
* account.
|
||||
*
|
||||
* @return StorageServiceSettings
|
||||
*/
|
||||
public static function developmentStorageAccount()
|
||||
{
|
||||
if (is_null(self::$_devStoreAccount)) {
|
||||
self::$_devStoreAccount = self::_getDevelopmentStorageAccount(
|
||||
Resources::DEV_STORE_URI
|
||||
);
|
||||
}
|
||||
|
||||
return self::$_devStoreAccount;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the default service endpoint using the specified protocol and account
|
||||
* name.
|
||||
*
|
||||
* @param array $settings The service settings.
|
||||
* @param string $dns The service DNS.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
private static function _getDefaultServiceEndpoint($settings, $dns)
|
||||
{
|
||||
$scheme = Utilities::tryGetValueInsensitive(
|
||||
Resources::DEFAULT_ENDPOINTS_PROTOCOL_NAME,
|
||||
$settings
|
||||
);
|
||||
$accountName = Utilities::tryGetValueInsensitive(
|
||||
Resources::ACCOUNT_NAME_NAME,
|
||||
$settings
|
||||
);
|
||||
|
||||
return sprintf(Resources::SERVICE_URI_FORMAT, $scheme, $accountName, $dns);
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates StorageServiceSettings object given endpoints uri.
|
||||
*
|
||||
* @param array $settings The service settings.
|
||||
* @param string $blobEndpointUri The blob endpoint uri.
|
||||
* @param string $queueEndpointUri The queue endpoint uri.
|
||||
* @param string $tableEndpointUri The table endpoint uri.
|
||||
*
|
||||
* @return \MicrosoftAzure\Storage\Common\Internal\StorageServiceSettings
|
||||
*/
|
||||
private static function _createStorageServiceSettings(
|
||||
$settings,
|
||||
$blobEndpointUri = null,
|
||||
$queueEndpointUri = null,
|
||||
$tableEndpointUri = null
|
||||
) {
|
||||
$blobEndpointUri = Utilities::tryGetValueInsensitive(
|
||||
Resources::BLOB_ENDPOINT_NAME,
|
||||
$settings,
|
||||
$blobEndpointUri
|
||||
);
|
||||
$queueEndpointUri = Utilities::tryGetValueInsensitive(
|
||||
Resources::QUEUE_ENDPOINT_NAME,
|
||||
$settings,
|
||||
$queueEndpointUri
|
||||
);
|
||||
$tableEndpointUri = Utilities::tryGetValueInsensitive(
|
||||
Resources::TABLE_ENDPOINT_NAME,
|
||||
$settings,
|
||||
$tableEndpointUri
|
||||
);
|
||||
$accountName = Utilities::tryGetValueInsensitive(
|
||||
Resources::ACCOUNT_NAME_NAME,
|
||||
$settings
|
||||
);
|
||||
$accountKey = Utilities::tryGetValueInsensitive(
|
||||
Resources::ACCOUNT_KEY_NAME,
|
||||
$settings
|
||||
);
|
||||
|
||||
return new StorageServiceSettings(
|
||||
$accountName,
|
||||
$accountKey,
|
||||
$blobEndpointUri,
|
||||
$queueEndpointUri,
|
||||
$tableEndpointUri
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates a StorageServiceSettings object from the given connection string.
|
||||
*
|
||||
* @param string $connectionString The storage settings connection string.
|
||||
*
|
||||
* @return StorageServiceSettings
|
||||
*/
|
||||
public static function createFromConnectionString($connectionString)
|
||||
{
|
||||
$tokenizedSettings = self::parseAndValidateKeys($connectionString);
|
||||
|
||||
// Devstore case
|
||||
$matchedSpecs = self::matchedSpecification(
|
||||
$tokenizedSettings,
|
||||
self::allRequired(self::$_useDevelopmentStorageSetting),
|
||||
self::optional(self::$_developmentStorageProxyUriSetting)
|
||||
);
|
||||
if ($matchedSpecs) {
|
||||
$proxyUri = Utilities::tryGetValueInsensitive(
|
||||
Resources::DEVELOPMENT_STORAGE_PROXY_URI_NAME,
|
||||
$tokenizedSettings
|
||||
);
|
||||
|
||||
return self::_getDevelopmentStorageAccount($proxyUri);
|
||||
}
|
||||
|
||||
// Automatic case
|
||||
$matchedSpecs = self::matchedSpecification(
|
||||
$tokenizedSettings,
|
||||
self::allRequired(
|
||||
self::$_defaultEndpointsProtocolSetting,
|
||||
self::$_accountNameSetting,
|
||||
self::$_accountKeySetting
|
||||
),
|
||||
self::optional(
|
||||
self::$_blobEndpointSetting,
|
||||
self::$_queueEndpointSetting,
|
||||
self::$_tableEndpointSetting
|
||||
)
|
||||
);
|
||||
if ($matchedSpecs) {
|
||||
return self::_createStorageServiceSettings(
|
||||
$tokenizedSettings,
|
||||
self::_getDefaultServiceEndpoint(
|
||||
$tokenizedSettings,
|
||||
Resources::BLOB_BASE_DNS_NAME
|
||||
),
|
||||
self::_getDefaultServiceEndpoint(
|
||||
$tokenizedSettings,
|
||||
Resources::QUEUE_BASE_DNS_NAME
|
||||
),
|
||||
self::_getDefaultServiceEndpoint(
|
||||
$tokenizedSettings,
|
||||
Resources::TABLE_BASE_DNS_NAME
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
// Explicit case
|
||||
$matchedSpecs = self::matchedSpecification(
|
||||
$tokenizedSettings,
|
||||
self::atLeastOne(
|
||||
self::$_blobEndpointSetting,
|
||||
self::$_queueEndpointSetting,
|
||||
self::$_tableEndpointSetting
|
||||
),
|
||||
self::allRequired(
|
||||
self::$_accountNameSetting,
|
||||
self::$_accountKeySetting
|
||||
)
|
||||
);
|
||||
if ($matchedSpecs) {
|
||||
return self::_createStorageServiceSettings($tokenizedSettings);
|
||||
}
|
||||
|
||||
self::noMatch($connectionString);
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets storage service name.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function getName()
|
||||
{
|
||||
return $this->_name;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets storage service key.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function getKey()
|
||||
{
|
||||
return $this->_key;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets storage service blob endpoint uri.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function getBlobEndpointUri()
|
||||
{
|
||||
return $this->_blobEndpointUri;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets storage service queue endpoint uri.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function getQueueEndpointUri()
|
||||
{
|
||||
return $this->_queueEndpointUri;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets storage service table endpoint uri.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function getTableEndpointUri()
|
||||
{
|
||||
return $this->_tableEndpointUri;
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,781 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal;
|
||||
|
||||
use GuzzleHttp\Psr7\Stream;
|
||||
|
||||
/**
|
||||
* Utilities for the project
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class Utilities
|
||||
{
|
||||
/**
|
||||
* Returns the specified value of the $key passed from $array and in case that
|
||||
* this $key doesn't exist, the default value is returned.
|
||||
*
|
||||
* @param array $array The array to be used.
|
||||
* @param mix $key The array key.
|
||||
* @param mix $default The value to return if $key is not found in $array.
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return mix
|
||||
*/
|
||||
public static function tryGetValue($array, $key, $default = null)
|
||||
{
|
||||
return is_array($array) && array_key_exists($key, $array)
|
||||
? $array[$key]
|
||||
: $default;
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds a url scheme if there is no scheme.
|
||||
*
|
||||
* @param string $url The URL.
|
||||
* @param string $scheme The scheme. By default HTTP
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public static function tryAddUrlScheme($url, $scheme = 'http')
|
||||
{
|
||||
$urlScheme = parse_url($url, PHP_URL_SCHEME);
|
||||
|
||||
if (empty($urlScheme)) {
|
||||
$url = "$scheme://" . $url;
|
||||
}
|
||||
|
||||
return $url;
|
||||
}
|
||||
|
||||
/**
|
||||
* Parse storage account name from an endpoint url.
|
||||
*
|
||||
* @param string $url The endpoint $url
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public static function tryParseAccountNameFromUrl($url)
|
||||
{
|
||||
$host = parse_url($url, PHP_URL_HOST);
|
||||
|
||||
// first token of the url host is account name
|
||||
return explode('.', $host)[0];
|
||||
}
|
||||
|
||||
/**
|
||||
* tries to get nested array with index name $key from $array.
|
||||
*
|
||||
* Returns empty array object if the value is NULL.
|
||||
*
|
||||
* @param string $key The index name.
|
||||
* @param array $array The array object.
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public static function tryGetArray($key, $array)
|
||||
{
|
||||
return Utilities::getArray(Utilities::tryGetValue($array, $key));
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds the given key/value pair into array if the value doesn't satisfy empty().
|
||||
*
|
||||
* This function just validates that the given $array is actually array. If it's
|
||||
* NULL the function treats it as array.
|
||||
*
|
||||
* @param string $key The key.
|
||||
* @param string $value The value.
|
||||
* @param array &$array The array. If NULL will be used as array.
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public static function addIfNotEmpty($key, $value, &$array)
|
||||
{
|
||||
if (!is_null($array)) {
|
||||
Validate::isArray($array, 'array');
|
||||
}
|
||||
|
||||
if (!empty($value)) {
|
||||
$array[$key] = $value;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the specified value of the key chain passed from $array and in case
|
||||
* that key chain doesn't exist, null is returned.
|
||||
*
|
||||
* @param array $array Array to be used.
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return mix
|
||||
*/
|
||||
public static function tryGetKeysChainValue($array)
|
||||
{
|
||||
$arguments = func_get_args();
|
||||
$numArguments = func_num_args();
|
||||
|
||||
$currentArray = $array;
|
||||
for ($i = 1; $i < $numArguments; $i++) {
|
||||
if (is_array($currentArray)) {
|
||||
if (array_key_exists($arguments[$i], $currentArray)) {
|
||||
$currentArray = $currentArray[$arguments[$i]];
|
||||
} else {
|
||||
return null;
|
||||
}
|
||||
} else {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
return $currentArray;
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if the passed $string starts with $prefix
|
||||
*
|
||||
* @param string $string word to seaech in
|
||||
* @param string $prefix prefix to be matched
|
||||
* @param boolean $ignoreCase true to ignore case during the comparison;
|
||||
* otherwise, false
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return boolean
|
||||
*/
|
||||
public static function startsWith($string, $prefix, $ignoreCase = false)
|
||||
{
|
||||
if ($ignoreCase) {
|
||||
$string = strtolower($string);
|
||||
$prefix = strtolower($prefix);
|
||||
}
|
||||
return ($prefix == substr($string, 0, strlen($prefix)));
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns grouped items from passed $var
|
||||
*
|
||||
* @param array $var item to group
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public static function getArray($var)
|
||||
{
|
||||
if (is_null($var) || empty($var)) {
|
||||
return array();
|
||||
}
|
||||
|
||||
foreach ($var as $value) {
|
||||
if ((gettype($value) == 'object')
|
||||
&& (get_class($value) == 'SimpleXMLElement')
|
||||
) {
|
||||
return (array) $var;
|
||||
} else if (!is_array($value)) {
|
||||
return array($var);
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
return $var;
|
||||
}
|
||||
|
||||
/**
|
||||
* Unserializes the passed $xml into array.
|
||||
*
|
||||
* @param string $xml XML to be parsed.
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public static function unserialize($xml)
|
||||
{
|
||||
$sxml = new \SimpleXMLElement($xml);
|
||||
|
||||
return self::_sxml2arr($sxml);
|
||||
}
|
||||
|
||||
/**
|
||||
* Converts a SimpleXML object to an Array recursively
|
||||
* ensuring all sub-elements are arrays as well.
|
||||
*
|
||||
* @param string $sxml SimpleXML object
|
||||
* @param array $arr Array into which to store results
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
private static function _sxml2arr($sxml, $arr = null)
|
||||
{
|
||||
foreach ((array) $sxml as $key => $value) {
|
||||
if (is_object($value) || (is_array($value))) {
|
||||
$arr[$key] = self::_sxml2arr($value);
|
||||
} else {
|
||||
$arr[$key] = $value;
|
||||
}
|
||||
}
|
||||
|
||||
return $arr;
|
||||
}
|
||||
|
||||
/**
|
||||
* Serializes given array into xml. The array indices must be string to use
|
||||
* them as XML tags.
|
||||
*
|
||||
* @param array $array object to serialize represented in array.
|
||||
* @param string $rootName name of the XML root element.
|
||||
* @param string $defaultTag default tag for non-tagged elements.
|
||||
* @param string $standalone adds 'standalone' header tag, values 'yes'/'no'
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public static function serialize($array, $rootName, $defaultTag = null,
|
||||
$standalone = null
|
||||
) {
|
||||
$xmlVersion = '1.0';
|
||||
$xmlEncoding = 'UTF-8';
|
||||
|
||||
if (!is_array($array)) {
|
||||
return false;
|
||||
}
|
||||
|
||||
$xmlw = new \XmlWriter();
|
||||
$xmlw->openMemory();
|
||||
$xmlw->startDocument($xmlVersion, $xmlEncoding, $standalone);
|
||||
|
||||
$xmlw->startElement($rootName);
|
||||
|
||||
self::_arr2xml($xmlw, $array, $defaultTag);
|
||||
|
||||
$xmlw->endElement();
|
||||
|
||||
return $xmlw->outputMemory(true);
|
||||
}
|
||||
|
||||
/**
|
||||
* Takes an array and produces XML based on it.
|
||||
*
|
||||
* @param XMLWriter $xmlw XMLWriter object that was previously instanted
|
||||
* and is used for creating the XML.
|
||||
* @param array $data Array to be converted to XML
|
||||
* @param string $defaultTag Default XML tag to be used if none specified.
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
private static function _arr2xml(\XMLWriter $xmlw, $data, $defaultTag = null)
|
||||
{
|
||||
foreach ($data as $key => $value) {
|
||||
if (strcmp($key, '@attributes') == 0) {
|
||||
foreach ($value as $attributeName => $attributeValue) {
|
||||
$xmlw->writeAttribute($attributeName, $attributeValue);
|
||||
}
|
||||
} else if (is_array($value)) {
|
||||
if (!is_int($key)) {
|
||||
if ($key != Resources::EMPTY_STRING) {
|
||||
$xmlw->startElement($key);
|
||||
} else {
|
||||
$xmlw->startElement($defaultTag);
|
||||
}
|
||||
}
|
||||
|
||||
self::_arr2xml($xmlw, $value);
|
||||
|
||||
if (!is_int($key)) {
|
||||
$xmlw->endElement();
|
||||
}
|
||||
continue;
|
||||
} else {
|
||||
$xmlw->writeElement($key, $value);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Converts string into boolean value.
|
||||
*
|
||||
* @param string $obj boolean value in string format.
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public static function toBoolean($obj)
|
||||
{
|
||||
return filter_var($obj, FILTER_VALIDATE_BOOLEAN);
|
||||
}
|
||||
|
||||
/**
|
||||
* Converts string into boolean value.
|
||||
*
|
||||
* @param bool $obj boolean value to convert.
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public static function booleanToString($obj)
|
||||
{
|
||||
return $obj ? 'true' : 'false';
|
||||
}
|
||||
|
||||
/**
|
||||
* Converts a given date string into \DateTime object
|
||||
*
|
||||
* @param string $date windows azure date ins string represntation.
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return \DateTime
|
||||
*/
|
||||
public static function rfc1123ToDateTime($date)
|
||||
{
|
||||
$timeZone = new \DateTimeZone('GMT');
|
||||
$format = Resources::AZURE_DATE_FORMAT;
|
||||
|
||||
return \DateTime::createFromFormat($format, $date, $timeZone);
|
||||
}
|
||||
|
||||
/**
|
||||
* Generate ISO 8601 compliant date string in UTC time zone
|
||||
*
|
||||
* @param int $timestamp The unix timestamp to convert
|
||||
* (for DateTime check date_timestamp_get).
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public static function isoDate($timestamp = null)
|
||||
{
|
||||
$tz = date_default_timezone_get();
|
||||
date_default_timezone_set('UTC');
|
||||
|
||||
if (is_null($timestamp)) {
|
||||
$timestamp = time();
|
||||
}
|
||||
|
||||
$returnValue = str_replace(
|
||||
'+00:00', '.0000000Z', date('c', $timestamp)
|
||||
);
|
||||
date_default_timezone_set($tz);
|
||||
return $returnValue;
|
||||
}
|
||||
|
||||
/**
|
||||
* Converts a DateTime object into an Edm.DaeTime value in UTC timezone,
|
||||
* represented as a string.
|
||||
*
|
||||
* @param \DateTime $value The datetime value.
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public static function convertToEdmDateTime($value)
|
||||
{
|
||||
if (empty($value)) {
|
||||
return $value;
|
||||
}
|
||||
|
||||
if (is_string($value)) {
|
||||
$value = self::convertToDateTime($value);
|
||||
}
|
||||
|
||||
Validate::isDate($value);
|
||||
|
||||
$cloned = clone $value;
|
||||
$cloned->setTimezone(new \DateTimeZone('UTC'));
|
||||
return str_replace('+0000', 'Z', $cloned->format("Y-m-d\TH:i:s.u0O"));
|
||||
}
|
||||
|
||||
/**
|
||||
* Converts a string to a \DateTime object. Returns false on failure.
|
||||
*
|
||||
* @param string $value The string value to parse.
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return \DateTime
|
||||
*/
|
||||
public static function convertToDateTime($value)
|
||||
{
|
||||
if ($value instanceof \DateTime) {
|
||||
return $value;
|
||||
}
|
||||
|
||||
if (substr($value, -1) == 'Z') {
|
||||
$value = substr($value, 0, strlen($value) - 1);
|
||||
}
|
||||
|
||||
return new \DateTime($value, new \DateTimeZone('UTC'));
|
||||
}
|
||||
|
||||
/**
|
||||
* Converts string to stream handle.
|
||||
*
|
||||
* @param type $string The string contents.
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return resource
|
||||
*/
|
||||
public static function stringToStream($string)
|
||||
{
|
||||
return fopen('data://text/plain,' . urlencode($string), 'rb');
|
||||
}
|
||||
|
||||
/**
|
||||
* Sorts an array based on given keys order.
|
||||
*
|
||||
* @param array $array The array to sort.
|
||||
* @param array $order The keys order array.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public static function orderArray($array, $order)
|
||||
{
|
||||
$ordered = array();
|
||||
|
||||
foreach ($order as $key) {
|
||||
if (array_key_exists($key, $array)) {
|
||||
$ordered[$key] = $array[$key];
|
||||
}
|
||||
}
|
||||
|
||||
return $ordered;
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if a value exists in an array. The comparison is done in a case
|
||||
* insensitive manner.
|
||||
*
|
||||
* @param string $needle The searched value.
|
||||
* @param array $haystack The array.
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return boolean
|
||||
*/
|
||||
public static function inArrayInsensitive($needle, $haystack)
|
||||
{
|
||||
return in_array(strtolower($needle), array_map('strtolower', $haystack));
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if the given key exists in the array. The comparison is done in a case
|
||||
* insensitive manner.
|
||||
*
|
||||
* @param string $key The value to check.
|
||||
* @param array $search The array with keys to check.
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return boolean
|
||||
*/
|
||||
public static function arrayKeyExistsInsensitive($key, $search)
|
||||
{
|
||||
return array_key_exists(strtolower($key), array_change_key_case($search));
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the specified value of the $key passed from $array and in case that
|
||||
* this $key doesn't exist, the default value is returned. The key matching is
|
||||
* done in a case insensitive manner.
|
||||
*
|
||||
* @param string $key The array key.
|
||||
* @param array $haystack The array to be used.
|
||||
* @param mix $default The value to return if $key is not found in $array.
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return mix
|
||||
*/
|
||||
public static function tryGetValueInsensitive($key, $haystack, $default = null)
|
||||
{
|
||||
$array = array_change_key_case($haystack);
|
||||
return Utilities::tryGetValue($array, strtolower($key), $default);
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns a string representation of a version 4 GUID, which uses random
|
||||
* numbers.There are 6 reserved bits, and the GUIDs have this format:
|
||||
* xxxxxxxx-xxxx-4xxx-[8|9|a|b]xxx-xxxxxxxxxxxx
|
||||
* where 'x' is a hexadecimal digit, 0-9a-f.
|
||||
*
|
||||
* See http://tools.ietf.org/html/rfc4122 for more information.
|
||||
*
|
||||
* Note: This function is available on all platforms, while the
|
||||
* com_create_guid() is only available for Windows.
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return string A new GUID.
|
||||
*/
|
||||
public static function getGuid()
|
||||
{
|
||||
// @codingStandardsIgnoreStart
|
||||
|
||||
return sprintf(
|
||||
'%04x%04x-%04x-%04x-%02x%02x-%04x%04x%04x',
|
||||
mt_rand(0, 65535),
|
||||
mt_rand(0, 65535), // 32 bits for "time_low"
|
||||
mt_rand(0, 65535), // 16 bits for "time_mid"
|
||||
mt_rand(0, 4096) + 16384, // 16 bits for "time_hi_and_version", with
|
||||
// the most significant 4 bits being 0100
|
||||
// to indicate randomly generated version
|
||||
mt_rand(0, 64) + 128, // 8 bits for "clock_seq_hi", with
|
||||
// the most significant 2 bits being 10,
|
||||
// required by version 4 GUIDs.
|
||||
mt_rand(0, 256), // 8 bits for "clock_seq_low"
|
||||
mt_rand(0, 65535), // 16 bits for "node 0" and "node 1"
|
||||
mt_rand(0, 65535), // 16 bits for "node 2" and "node 3"
|
||||
mt_rand(0, 65535) // 16 bits for "node 4" and "node 5"
|
||||
);
|
||||
|
||||
// @codingStandardsIgnoreEnd
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates a list of objects of type $class from the provided array using static
|
||||
* create method.
|
||||
*
|
||||
* @param array $parsed The object in array representation
|
||||
* @param string $class The class name. Must have static method create.
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public static function createInstanceList($parsed, $class)
|
||||
{
|
||||
$list = array();
|
||||
|
||||
foreach ($parsed as $value) {
|
||||
$list[] = $class::create($value);
|
||||
}
|
||||
|
||||
return $list;
|
||||
}
|
||||
|
||||
/**
|
||||
* Takes a string and return if it ends with the specified character/string.
|
||||
*
|
||||
* @param string $haystack The string to search in.
|
||||
* @param string $needle postfix to match.
|
||||
* @param boolean $ignoreCase Set true to ignore case during the comparison;
|
||||
* otherwise, false
|
||||
*
|
||||
* @static
|
||||
*
|
||||
* @return boolean
|
||||
*/
|
||||
public static function endsWith($haystack, $needle, $ignoreCase = false)
|
||||
{
|
||||
if ($ignoreCase) {
|
||||
$haystack = strtolower($haystack);
|
||||
$needle = strtolower($needle);
|
||||
}
|
||||
$length = strlen($needle);
|
||||
if ($length == 0) {
|
||||
return true;
|
||||
}
|
||||
|
||||
return (substr($haystack, -$length) === $needle);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get id from entity object or string.
|
||||
* If entity is object than validate type and return $entity->$method()
|
||||
* If entity is string than return this string
|
||||
*
|
||||
* @param object|string $entity Entity with id property
|
||||
* @param string $type Entity type to validate
|
||||
* @param string $method Methods that gets id (getId by default)
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public static function getEntityId($entity, $type, $method = 'getId')
|
||||
{
|
||||
if (is_string($entity)) {
|
||||
return $entity;
|
||||
} else {
|
||||
Validate::isA($entity, $type, 'entity');
|
||||
Validate::methodExists($entity, $method, $type);
|
||||
|
||||
return $entity->$method();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Generate a pseudo-random string of bytes using a cryptographically strong
|
||||
* algorithm.
|
||||
*
|
||||
* @param int $length Length of the string in bytes
|
||||
*
|
||||
* @return string|boolean Generated string of bytes on success, or FALSE on
|
||||
* failure.
|
||||
*/
|
||||
public static function generateCryptoKey($length)
|
||||
{
|
||||
return openssl_random_pseudo_bytes($length);
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Encrypts $data with CTR encryption
|
||||
*
|
||||
* @param string $data Data to be encrypted
|
||||
* @param string $key AES Encryption key
|
||||
* @param string $initializationVector Initialization vector
|
||||
*
|
||||
* @return string Encrypted data
|
||||
*/
|
||||
public static function ctrCrypt($data, $key, $initializationVector)
|
||||
{
|
||||
Validate::isString($data, 'data');
|
||||
Validate::isString($key, 'key');
|
||||
Validate::isString($initializationVector, 'initializationVector');
|
||||
|
||||
Validate::isTrue(
|
||||
(strlen($key) == 16 || strlen($key) == 24 || strlen($key) == 32),
|
||||
sprintf(Resources::INVALID_STRING_LENGTH, 'key', '16, 24, 32')
|
||||
);
|
||||
|
||||
Validate::isTrue(
|
||||
(strlen($initializationVector) == 16),
|
||||
sprintf(Resources::INVALID_STRING_LENGTH, 'initializationVector', '16')
|
||||
);
|
||||
|
||||
$blockCount = ceil(strlen($data) / 16);
|
||||
|
||||
$ctrData = '';
|
||||
for ($i = 0; $i < $blockCount; ++$i) {
|
||||
$ctrData .= $initializationVector;
|
||||
|
||||
// increment Initialization Vector
|
||||
$j = 15;
|
||||
do {
|
||||
$digit = ord($initializationVector[$j]) + 1;
|
||||
$initializationVector[$j] = chr($digit & 0xFF);
|
||||
|
||||
$j--;
|
||||
} while (($digit == 0x100) && ($j >= 0));
|
||||
}
|
||||
|
||||
$encryptCtrData = mcrypt_encrypt(
|
||||
MCRYPT_RIJNDAEL_128,
|
||||
$key,
|
||||
$ctrData,
|
||||
MCRYPT_MODE_ECB
|
||||
);
|
||||
|
||||
return $data ^ $encryptCtrData;
|
||||
}
|
||||
|
||||
/**
|
||||
* Convert base 256 number to decimal number.
|
||||
*
|
||||
* @param string $number Base 256 number
|
||||
*
|
||||
* @return string Decimal number
|
||||
*/
|
||||
public static function base256ToDec($number)
|
||||
{
|
||||
Validate::isString($number, 'number');
|
||||
|
||||
$result = 0;
|
||||
$base = 1;
|
||||
for ($i = strlen($number) - 1; $i >= 0; $i--) {
|
||||
$result = bcadd($result, bcmul(ord($number[$i]), $base));
|
||||
$base = bcmul($base, 256);
|
||||
}
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
/**
|
||||
* To evaluate if the stream is larger than a certain size. To restore
|
||||
* the stream, it has to be seekable, so will return true if the stream
|
||||
* is not seekable.
|
||||
* @param StreamInterface $stream The stream to be evaluated.
|
||||
* @param int $size The size if the string is larger than.
|
||||
*
|
||||
* @return boolean true if the stream is larger than the given size.
|
||||
*/
|
||||
public static function isStreamLargerThanSizeOrNotSeekable($stream, $size)
|
||||
{
|
||||
Validate::isInteger($size, 'size');
|
||||
Validate::isTrue(
|
||||
$stream instanceof Stream,
|
||||
sprintf(Resources::INVALID_PARAM_MSG, 'stream', 'Guzzle\Stream')
|
||||
);
|
||||
$result = true;
|
||||
if ($stream->isSeekable()) {
|
||||
$position = $stream->tell();
|
||||
try {
|
||||
$stream->seek($size);
|
||||
} catch (\RuntimeException $e) {
|
||||
$pos = strpos(
|
||||
$e->getMessage(),
|
||||
'to seek to stream position '
|
||||
);
|
||||
if ($pos == null) {
|
||||
throw $e;
|
||||
}
|
||||
$result = false;
|
||||
}
|
||||
if ($stream->eof()) {
|
||||
$result = false;
|
||||
} elseif ($stream->read(1) == '') {
|
||||
$result = false;
|
||||
}
|
||||
$stream->seek($position);
|
||||
}
|
||||
return $result;
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,394 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Internal;
|
||||
|
||||
use MicrosoftAzure\Storage\Common\Internal\InvalidArgumentTypeException;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Resources;
|
||||
|
||||
/**
|
||||
* Validates aganist a condition and throws an exception in case of failure.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Internal
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class Validate
|
||||
{
|
||||
/**
|
||||
* Throws exception if the provided variable type is not array.
|
||||
*
|
||||
* @param mix $var The variable to check.
|
||||
* @param string $name The parameter name.
|
||||
*
|
||||
* @throws InvalidArgumentTypeException.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public static function isArray($var, $name)
|
||||
{
|
||||
if (!is_array($var)) {
|
||||
throw new InvalidArgumentTypeException(gettype(array()), $name);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Throws exception if the provided variable type is not string.
|
||||
*
|
||||
* @param mix $var The variable to check.
|
||||
* @param string $name The parameter name.
|
||||
*
|
||||
* @throws InvalidArgumentTypeException
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public static function isString($var, $name)
|
||||
{
|
||||
try {
|
||||
(string)$var;
|
||||
} catch (\Exception $e) {
|
||||
throw new InvalidArgumentTypeException(gettype(''), $name);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Throws exception if the provided variable type is not boolean.
|
||||
*
|
||||
* @param mix $var variable to check against.
|
||||
*
|
||||
* @throws InvalidArgumentTypeException
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public static function isBoolean($var)
|
||||
{
|
||||
(bool)$var;
|
||||
}
|
||||
|
||||
/**
|
||||
* Throws exception if the provided variable is set to null.
|
||||
*
|
||||
* @param mix $var The variable to check.
|
||||
* @param string $name The parameter name.
|
||||
*
|
||||
* @throws \InvalidArgumentException
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public static function notNullOrEmpty($var, $name)
|
||||
{
|
||||
if (is_null($var) || empty($var)) {
|
||||
throw new \InvalidArgumentException(
|
||||
sprintf(Resources::NULL_OR_EMPTY_MSG, $name)
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Throws exception if the provided variable is not double.
|
||||
*
|
||||
* @param mix $var The variable to check.
|
||||
* @param string $name The parameter name.
|
||||
*
|
||||
* @throws \InvalidArgumentException
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public static function isDouble($var, $name)
|
||||
{
|
||||
if (!is_numeric($var)) {
|
||||
throw new InvalidArgumentTypeException('double', $name);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Throws exception if the provided variable type is not integer.
|
||||
*
|
||||
* @param mix $var The variable to check.
|
||||
* @param string $name The parameter name.
|
||||
*
|
||||
* @throws InvalidArgumentTypeException
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public static function isInteger($var, $name)
|
||||
{
|
||||
try {
|
||||
(int)$var;
|
||||
} catch (\Exception $e) {
|
||||
throw new InvalidArgumentTypeException(gettype(123), $name);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns whether the variable is an empty or null string.
|
||||
*
|
||||
* @param string $var value.
|
||||
*
|
||||
* @return boolean
|
||||
*/
|
||||
public static function isNullOrEmptyString($var)
|
||||
{
|
||||
try {
|
||||
(string)$var;
|
||||
} catch (\Exception $e) {
|
||||
return false;
|
||||
}
|
||||
|
||||
return (!isset($var) || trim($var)==='');
|
||||
}
|
||||
|
||||
/**
|
||||
* Throws exception if the provided condition is not satisfied.
|
||||
*
|
||||
* @param bool $isSatisfied condition result.
|
||||
* @param string $failureMessage the exception message
|
||||
*
|
||||
* @throws \Exception
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public static function isTrue($isSatisfied, $failureMessage)
|
||||
{
|
||||
if (!$isSatisfied) {
|
||||
throw new \InvalidArgumentException($failureMessage);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Throws exception if the provided $date is not of type \DateTime
|
||||
*
|
||||
* @param mix $date variable to check against.
|
||||
*
|
||||
* @throws MicrosoftAzure\Storage\Common\Internal\InvalidArgumentTypeException
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public static function isDate($date)
|
||||
{
|
||||
if (gettype($date) != 'object' || get_class($date) != 'DateTime') {
|
||||
throw new InvalidArgumentTypeException('DateTime');
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Throws exception if the provided variable is set to null.
|
||||
*
|
||||
* @param mix $var The variable to check.
|
||||
* @param string $name The parameter name.
|
||||
*
|
||||
* @throws \InvalidArgumentException
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public static function notNull($var, $name)
|
||||
{
|
||||
if (is_null($var)) {
|
||||
throw new \InvalidArgumentException(sprintf(Resources::NULL_MSG, $name));
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Throws exception if the object is not of the specified class type.
|
||||
*
|
||||
* @param mixed $objectInstance An object that requires class type validation.
|
||||
* @param mixed $classInstance The instance of the class the the
|
||||
* object instance should be.
|
||||
* @param string $name The name of the object.
|
||||
*
|
||||
* @throws \InvalidArgumentException
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public static function isInstanceOf($objectInstance, $classInstance, $name)
|
||||
{
|
||||
Validate::notNull($classInstance, 'classInstance');
|
||||
if (is_null($objectInstance)) {
|
||||
return true;
|
||||
}
|
||||
|
||||
$objectType = gettype($objectInstance);
|
||||
$classType = gettype($classInstance);
|
||||
|
||||
if ($objectType === $classType) {
|
||||
return true;
|
||||
} else {
|
||||
throw new \InvalidArgumentException(
|
||||
sprintf(
|
||||
Resources::INSTANCE_TYPE_VALIDATION_MSG,
|
||||
$name,
|
||||
$objectType,
|
||||
$classType
|
||||
)
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates a anonymous function that check if the given uri is valid or not.
|
||||
*
|
||||
* @return callable
|
||||
*/
|
||||
public static function getIsValidUri()
|
||||
{
|
||||
return function ($uri) {
|
||||
return Validate::isValidUri($uri);
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Throws exception if the string is not of a valid uri.
|
||||
*
|
||||
* @param string $uri String to check.
|
||||
*
|
||||
* @throws \InvalidArgumentException
|
||||
*
|
||||
* @return boolean
|
||||
*/
|
||||
public static function isValidUri($uri)
|
||||
{
|
||||
$isValid = filter_var($uri, FILTER_VALIDATE_URL);
|
||||
|
||||
if ($isValid) {
|
||||
return true;
|
||||
} else {
|
||||
throw new \RuntimeException(
|
||||
sprintf(Resources::INVALID_CONFIG_URI, $uri)
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Throws exception if the provided variable type is not object.
|
||||
*
|
||||
* @param mix $var The variable to check.
|
||||
* @param string $name The parameter name.
|
||||
*
|
||||
* @throws InvalidArgumentTypeException.
|
||||
*
|
||||
* @return boolean
|
||||
*/
|
||||
public static function isObject($var, $name)
|
||||
{
|
||||
if (!is_object($var)) {
|
||||
throw new InvalidArgumentTypeException('object', $name);
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Throws exception if the object is not of the specified class type.
|
||||
*
|
||||
* @param mixed $objectInstance An object that requires class type validation.
|
||||
* @param string $class The class the object instance should be.
|
||||
* @param string $name The parameter name.
|
||||
*
|
||||
* @throws \InvalidArgumentException
|
||||
*
|
||||
* @return boolean
|
||||
*/
|
||||
public static function isA($objectInstance, $class, $name)
|
||||
{
|
||||
Validate::isString($class, 'class');
|
||||
Validate::notNull($objectInstance, 'objectInstance');
|
||||
Validate::isObject($objectInstance, 'objectInstance');
|
||||
|
||||
$objectType = get_class($objectInstance);
|
||||
|
||||
if (is_a($objectInstance, $class)) {
|
||||
return true;
|
||||
} else {
|
||||
throw new \InvalidArgumentException(
|
||||
sprintf(
|
||||
Resources::INSTANCE_TYPE_VALIDATION_MSG,
|
||||
$name,
|
||||
$objectType,
|
||||
$class
|
||||
)
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Validate if method exists in object
|
||||
*
|
||||
* @param object $objectInstance An object that requires method existing
|
||||
* validation
|
||||
* @param string $method Method name
|
||||
* @param string $name The parameter name
|
||||
*
|
||||
* @return boolean
|
||||
*/
|
||||
public static function methodExists($objectInstance, $method, $name)
|
||||
{
|
||||
Validate::isString($method, 'method');
|
||||
Validate::notNull($objectInstance, 'objectInstance');
|
||||
Validate::isObject($objectInstance, 'objectInstance');
|
||||
|
||||
if (method_exists($objectInstance, $method)) {
|
||||
return true;
|
||||
} else {
|
||||
throw new \InvalidArgumentException(
|
||||
sprintf(
|
||||
Resources::ERROR_METHOD_NOT_FOUND,
|
||||
$method,
|
||||
$name
|
||||
)
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Validate if string is date formatted
|
||||
*
|
||||
* @param string $value Value to validate
|
||||
* @param string $name Name of parameter to insert in erro message
|
||||
*
|
||||
* @throws \InvalidArgumentException
|
||||
*
|
||||
* @return boolean
|
||||
*/
|
||||
public static function isDateString($value, $name)
|
||||
{
|
||||
Validate::isString($value, 'value');
|
||||
|
||||
try {
|
||||
new \DateTime($value);
|
||||
return true;
|
||||
} catch (\Exception $e) {
|
||||
throw new \InvalidArgumentException(
|
||||
sprintf(
|
||||
Resources::ERROR_INVALID_DATE_STRING,
|
||||
$name,
|
||||
$value
|
||||
)
|
||||
);
|
||||
}
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,81 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Models
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Models;
|
||||
use MicrosoftAzure\Storage\Common\Models\ServiceProperties;
|
||||
|
||||
/**
|
||||
* Result from calling GetQueueProperties REST wrapper.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Models
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class GetServicePropertiesResult
|
||||
{
|
||||
private $_serviceProperties;
|
||||
|
||||
/**
|
||||
* Creates object from $parsedResponse.
|
||||
*
|
||||
* @param array $parsedResponse XML response parsed into array.
|
||||
*
|
||||
* @return MicrosoftAzure\Storage\Common\Models\GetServicePropertiesResult
|
||||
*/
|
||||
public static function create($parsedResponse)
|
||||
{
|
||||
$result = new GetServicePropertiesResult();
|
||||
$result->_serviceProperties = ServiceProperties::create($parsedResponse);
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets service properties object.
|
||||
*
|
||||
* @return MicrosoftAzure\Storage\Common\Models\ServiceProperties
|
||||
*/
|
||||
public function getValue()
|
||||
{
|
||||
return $this->_serviceProperties;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets service properties object.
|
||||
*
|
||||
* @param ServiceProperties $serviceProperties object to use.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public function setValue($serviceProperties)
|
||||
{
|
||||
$this->_serviceProperties = clone $serviceProperties;
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,229 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Models
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Models;
|
||||
use MicrosoftAzure\Storage\Common\Models\RetentionPolicy;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Utilities;
|
||||
|
||||
/**
|
||||
* Holds elements of queue properties logging field.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Models
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class Logging
|
||||
{
|
||||
/**
|
||||
* The version of Storage Analytics to configure
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $_version;
|
||||
|
||||
/**
|
||||
* Applies only to logging configuration. Indicates whether all delete requests
|
||||
* should be logged.
|
||||
*
|
||||
* @var bool
|
||||
*/
|
||||
private $_delete;
|
||||
|
||||
/**
|
||||
* Applies only to logging configuration. Indicates whether all read requests
|
||||
* should be logged.
|
||||
*
|
||||
* @var bool.
|
||||
*/
|
||||
private $_read;
|
||||
|
||||
/**
|
||||
* Applies only to logging configuration. Indicates whether all write requests
|
||||
* should be logged.
|
||||
*
|
||||
* @var bool
|
||||
*/
|
||||
private $_write;
|
||||
|
||||
/**
|
||||
* @var MicrosoftAzure\Storage\Common\Models\RetentionPolicy
|
||||
*/
|
||||
private $_retentionPolicy;
|
||||
|
||||
/**
|
||||
* Creates object from $parsedResponse.
|
||||
*
|
||||
* @param array $parsedResponse XML response parsed into array.
|
||||
*
|
||||
* @return MicrosoftAzure\Storage\Common\Models\Logging
|
||||
*/
|
||||
public static function create($parsedResponse)
|
||||
{
|
||||
$result = new Logging();
|
||||
$result->setVersion($parsedResponse['Version']);
|
||||
$result->setDelete(Utilities::toBoolean($parsedResponse['Delete']));
|
||||
$result->setRead(Utilities::toBoolean($parsedResponse['Read']));
|
||||
$result->setWrite(Utilities::toBoolean($parsedResponse['Write']));
|
||||
$result->setRetentionPolicy(
|
||||
RetentionPolicy::create($parsedResponse['RetentionPolicy'])
|
||||
);
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets retention policy
|
||||
*
|
||||
* @return MicrosoftAzure\Storage\Common\Models\RetentionPolicy
|
||||
*
|
||||
*/
|
||||
public function getRetentionPolicy()
|
||||
{
|
||||
return $this->_retentionPolicy;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets retention policy
|
||||
*
|
||||
* @param RetentionPolicy $policy object to use
|
||||
*
|
||||
* @return none.
|
||||
*/
|
||||
public function setRetentionPolicy($policy)
|
||||
{
|
||||
$this->_retentionPolicy = $policy;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets write
|
||||
*
|
||||
* @return bool.
|
||||
*/
|
||||
public function getWrite()
|
||||
{
|
||||
return $this->_write;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets write
|
||||
*
|
||||
* @param bool $write new value.
|
||||
*
|
||||
* @return none.
|
||||
*/
|
||||
public function setWrite($write)
|
||||
{
|
||||
$this->_write = $write;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets read
|
||||
*
|
||||
* @return bool.
|
||||
*/
|
||||
public function getRead()
|
||||
{
|
||||
return $this->_read;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets read
|
||||
*
|
||||
* @param bool $read new value.
|
||||
*
|
||||
* @return none.
|
||||
*/
|
||||
public function setRead($read)
|
||||
{
|
||||
$this->_read = $read;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets delete
|
||||
*
|
||||
* @return bool.
|
||||
*/
|
||||
public function getDelete()
|
||||
{
|
||||
return $this->_delete;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets delete
|
||||
*
|
||||
* @param bool $delete new value.
|
||||
*
|
||||
* @return none.
|
||||
*/
|
||||
public function setDelete($delete)
|
||||
{
|
||||
$this->_delete = $delete;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets version
|
||||
*
|
||||
* @return string.
|
||||
*/
|
||||
public function getVersion()
|
||||
{
|
||||
return $this->_version;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets version
|
||||
*
|
||||
* @param string $version new value.
|
||||
*
|
||||
* @return none.
|
||||
*/
|
||||
public function setVersion($version)
|
||||
{
|
||||
$this->_version = $version;
|
||||
}
|
||||
|
||||
/**
|
||||
* Converts this object to array with XML tags
|
||||
*
|
||||
* @return array.
|
||||
*/
|
||||
public function toArray()
|
||||
{
|
||||
return array(
|
||||
'Version' => $this->_version,
|
||||
'Delete' => Utilities::booleanToString($this->_delete),
|
||||
'Read' => Utilities::booleanToString($this->_read),
|
||||
'Write' => Utilities::booleanToString($this->_write),
|
||||
'RetentionPolicy' => !empty($this->_retentionPolicy)
|
||||
? $this->_retentionPolicy->toArray()
|
||||
: null
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,202 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Models
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Models;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Utilities;
|
||||
|
||||
/**
|
||||
* Holds elements of queue properties metrics field.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Models
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class Metrics
|
||||
{
|
||||
/**
|
||||
* The version of Storage Analytics to configure
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $_version;
|
||||
|
||||
/**
|
||||
* Indicates whether metrics is enabled for the storage service
|
||||
*
|
||||
* @var bool
|
||||
*/
|
||||
private $_enabled;
|
||||
|
||||
/**
|
||||
* Indicates whether a retention policy is enabled for the storage service
|
||||
*
|
||||
* @var bool
|
||||
*/
|
||||
private $_includeAPIs;
|
||||
|
||||
/**
|
||||
* @var MicrosoftAzure\Storage\Common\Models\RetentionPolicy
|
||||
*/
|
||||
private $_retentionPolicy;
|
||||
|
||||
/**
|
||||
* Creates object from $parsedResponse.
|
||||
*
|
||||
* @param array $parsedResponse XML response parsed into array.
|
||||
*
|
||||
* @return MicrosoftAzure\Storage\Common\Models\Metrics
|
||||
*/
|
||||
public static function create($parsedResponse)
|
||||
{
|
||||
$result = new Metrics();
|
||||
$result->setVersion($parsedResponse['Version']);
|
||||
$result->setEnabled(Utilities::toBoolean($parsedResponse['Enabled']));
|
||||
if ($result->getEnabled()) {
|
||||
$result->setIncludeAPIs(
|
||||
Utilities::toBoolean($parsedResponse['IncludeAPIs'])
|
||||
);
|
||||
}
|
||||
$result->setRetentionPolicy(
|
||||
RetentionPolicy::create($parsedResponse['RetentionPolicy'])
|
||||
);
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets retention policy
|
||||
*
|
||||
* @return MicrosoftAzure\Storage\Common\Models\RetentionPolicy
|
||||
*
|
||||
*/
|
||||
public function getRetentionPolicy()
|
||||
{
|
||||
return $this->_retentionPolicy;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets retention policy
|
||||
*
|
||||
* @param RetentionPolicy $policy object to use
|
||||
*
|
||||
* @return none.
|
||||
*/
|
||||
public function setRetentionPolicy($policy)
|
||||
{
|
||||
$this->_retentionPolicy = $policy;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets include APIs.
|
||||
*
|
||||
* @return bool.
|
||||
*/
|
||||
public function getIncludeAPIs()
|
||||
{
|
||||
return $this->_includeAPIs;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets include APIs.
|
||||
*
|
||||
* @param $bool $includeAPIs value to use.
|
||||
*
|
||||
* @return none.
|
||||
*/
|
||||
public function setIncludeAPIs($includeAPIs)
|
||||
{
|
||||
$this->_includeAPIs = $includeAPIs;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets enabled.
|
||||
*
|
||||
* @return bool.
|
||||
*/
|
||||
public function getEnabled()
|
||||
{
|
||||
return $this->_enabled;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets enabled.
|
||||
*
|
||||
* @param bool $enabled value to use.
|
||||
*
|
||||
* @return none.
|
||||
*/
|
||||
public function setEnabled($enabled)
|
||||
{
|
||||
$this->_enabled = $enabled;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets version
|
||||
*
|
||||
* @return string.
|
||||
*/
|
||||
public function getVersion()
|
||||
{
|
||||
return $this->_version;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets version
|
||||
*
|
||||
* @param string $version new value.
|
||||
*
|
||||
* @return none.
|
||||
*/
|
||||
public function setVersion($version)
|
||||
{
|
||||
$this->_version = $version;
|
||||
}
|
||||
|
||||
/**
|
||||
* Converts this object to array with XML tags
|
||||
*
|
||||
* @return array.
|
||||
*/
|
||||
public function toArray()
|
||||
{
|
||||
$array = array(
|
||||
'Version' => $this->_version,
|
||||
'Enabled' => Utilities::booleanToString($this->_enabled)
|
||||
);
|
||||
if ($this->_enabled) {
|
||||
$array['IncludeAPIs'] = Utilities::booleanToString($this->_includeAPIs);
|
||||
}
|
||||
$array['RetentionPolicy'] = !empty($this->_retentionPolicy)
|
||||
? $this->_retentionPolicy->toArray()
|
||||
: null;
|
||||
|
||||
return $array;
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,136 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Models
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Models;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Utilities;
|
||||
|
||||
/**
|
||||
* Holds elements of queue properties retention policy field.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Models
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class RetentionPolicy
|
||||
{
|
||||
/**
|
||||
* Indicates whether a retention policy is enabled for the storage service
|
||||
*
|
||||
* @var bool.
|
||||
*/
|
||||
private $_enabled;
|
||||
|
||||
/**
|
||||
* If $_enabled is true then this field indicates the number of days that metrics
|
||||
* or logging data should be retained. All data older than this value will be
|
||||
* deleted. The minimum value you can specify is 1;
|
||||
* the largest value is 365 (one year)
|
||||
*
|
||||
* @var int
|
||||
*/
|
||||
private $_days;
|
||||
|
||||
/**
|
||||
* Creates object from $parsedResponse.
|
||||
*
|
||||
* @param array $parsedResponse XML response parsed into array.
|
||||
*
|
||||
* @return MicrosoftAzure\Storage\Common\Models\RetentionPolicy
|
||||
*/
|
||||
public static function create($parsedResponse)
|
||||
{
|
||||
$result = new RetentionPolicy();
|
||||
$result->setEnabled(Utilities::toBoolean($parsedResponse['Enabled']));
|
||||
if ($result->getEnabled()) {
|
||||
$result->setDays(intval($parsedResponse['Days']));
|
||||
}
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets enabled.
|
||||
*
|
||||
* @return bool.
|
||||
*/
|
||||
public function getEnabled()
|
||||
{
|
||||
return $this->_enabled;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets enabled.
|
||||
*
|
||||
* @param bool $enabled value to use.
|
||||
*
|
||||
* @return none.
|
||||
*/
|
||||
public function setEnabled($enabled)
|
||||
{
|
||||
$this->_enabled = $enabled;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets days field.
|
||||
*
|
||||
* @return int
|
||||
*/
|
||||
public function getDays()
|
||||
{
|
||||
return $this->_days;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets days field.
|
||||
*
|
||||
* @param int $days value to use.
|
||||
*
|
||||
* @return none
|
||||
*/
|
||||
public function setDays($days)
|
||||
{
|
||||
$this->_days = $days;
|
||||
}
|
||||
|
||||
/**
|
||||
* Converts this object to array with XML tags
|
||||
*
|
||||
* @return array.
|
||||
*/
|
||||
public function toArray()
|
||||
{
|
||||
$array = array('Enabled' => Utilities::booleanToString($this->_enabled));
|
||||
if (isset($this->_days)) {
|
||||
$array['Days'] = strval($this->_days);
|
||||
}
|
||||
|
||||
return $array;
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,136 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Models
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common\Models;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Utilities;
|
||||
use MicrosoftAzure\Storage\Common\Models\Logging;
|
||||
use MicrosoftAzure\Storage\Common\Models\Metrics;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Serialization\XmlSerializer;
|
||||
|
||||
/**
|
||||
* Encapsulates service properties
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common\Models
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class ServiceProperties
|
||||
{
|
||||
private $_logging;
|
||||
private $_metrics;
|
||||
public static $xmlRootName = 'StorageServiceProperties';
|
||||
|
||||
/**
|
||||
* Creates ServiceProperties object from parsed XML response.
|
||||
*
|
||||
* @param array $parsedResponse XML response parsed into array.
|
||||
*
|
||||
* @return MicrosoftAzure\Storage\Common\Models\ServiceProperties.
|
||||
*/
|
||||
public static function create($parsedResponse)
|
||||
{
|
||||
$result = new ServiceProperties();
|
||||
$result->setLogging(Logging::create($parsedResponse['Logging']));
|
||||
$result->setMetrics(Metrics::create($parsedResponse['HourMetrics']));
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets logging element.
|
||||
*
|
||||
* @return MicrosoftAzure\Storage\Common\Models\Logging.
|
||||
*/
|
||||
public function getLogging()
|
||||
{
|
||||
return $this->_logging;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets logging element.
|
||||
*
|
||||
* @param MicrosoftAzure\Storage\Common\Models\Logging $logging new element.
|
||||
*
|
||||
* @return none.
|
||||
*/
|
||||
public function setLogging($logging)
|
||||
{
|
||||
$this->_logging = clone $logging;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets metrics element.
|
||||
*
|
||||
* @return MicrosoftAzure\Storage\Common\Models\Metrics.
|
||||
*/
|
||||
public function getMetrics()
|
||||
{
|
||||
return $this->_metrics;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets metrics element.
|
||||
*
|
||||
* @param MicrosoftAzure\Storage\Common\Models\Metrics $metrics new element.
|
||||
*
|
||||
* @return none.
|
||||
*/
|
||||
public function setMetrics($metrics)
|
||||
{
|
||||
$this->_metrics = clone $metrics;
|
||||
}
|
||||
|
||||
/**
|
||||
* Converts this object to array with XML tags
|
||||
*
|
||||
* @return array.
|
||||
*/
|
||||
public function toArray()
|
||||
{
|
||||
return array(
|
||||
'Logging' => !empty($this->_logging) ? $this->_logging->toArray() : null,
|
||||
'HourMetrics' => !empty($this->_metrics) ? $this->_metrics->toArray() : null
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Converts this current object to XML representation.
|
||||
*
|
||||
* @param XmlSerializer $xmlSerializer The XML serializer.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function toXml($xmlSerializer)
|
||||
{
|
||||
$properties = array(XmlSerializer::ROOT_NAME => self::$xmlRootName);
|
||||
|
||||
return $xmlSerializer->serialize($this->toArray(), $properties);
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,84 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Resources;
|
||||
|
||||
/**
|
||||
* Fires when the response code is incorrect.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class ServiceException extends \LogicException
|
||||
{
|
||||
private $_error;
|
||||
private $_reason;
|
||||
|
||||
/**
|
||||
* Constructor
|
||||
*
|
||||
* @param string $errorCode status error code.
|
||||
* @param string $error string value of the error code.
|
||||
* @param string $reason detailed message for the error.
|
||||
*
|
||||
* @return MicrosoftAzure\Storage\Common\ServiceException
|
||||
*/
|
||||
public function __construct($errorCode, $error = null, $reason = null)
|
||||
{
|
||||
parent::__construct(
|
||||
sprintf(Resources::AZURE_ERROR_MSG, $errorCode, $error, $reason)
|
||||
);
|
||||
$this->code = $errorCode;
|
||||
$this->_error = $error;
|
||||
$this->_reason = $reason;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets error text.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function getErrorText()
|
||||
{
|
||||
return $this->_error;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets detailed error reason.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function getErrorReason()
|
||||
{
|
||||
return $this->_reason;
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,325 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* LICENSE: The MIT License (the "License")
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
* https://github.com/azure/azure-storage-php/LICENSE
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* PHP version 5
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
|
||||
namespace MicrosoftAzure\Storage\Common;
|
||||
|
||||
use MicrosoftAzure\Storage\Blob\BlobRestProxy;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Resources;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Validate;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Utilities;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Filters\DateFilter;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Filters\HeadersFilter;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Filters\AuthenticationFilter;
|
||||
use MicrosoftAzure\Storage\Common\Internal\InvalidArgumentTypeException;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Serialization\XmlSerializer;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Authentication\SharedKeyAuthScheme;
|
||||
use MicrosoftAzure\Storage\Common\Internal\Authentication\TableSharedKeyLiteAuthScheme;
|
||||
use MicrosoftAzure\Storage\Common\Internal\StorageServiceSettings;
|
||||
use MicrosoftAzure\Storage\Queue\QueueRestProxy;
|
||||
use MicrosoftAzure\Storage\Table\TableRestProxy;
|
||||
use MicrosoftAzure\Storage\Table\Internal\AtomReaderWriter;
|
||||
use MicrosoftAzure\Storage\Table\Internal\MimeReaderWriter;
|
||||
|
||||
/**
|
||||
* Builds azure service objects.
|
||||
*
|
||||
* @category Microsoft
|
||||
* @package MicrosoftAzure\Storage\Common
|
||||
* @author Azure Storage PHP SDK <dmsh@microsoft.com>
|
||||
* @copyright 2016 Microsoft Corporation
|
||||
* @license https://github.com/azure/azure-storage-php/LICENSE
|
||||
* @version Release: 0.11.0
|
||||
* @link https://github.com/azure/azure-storage-php
|
||||
*/
|
||||
class ServicesBuilder
|
||||
{
|
||||
/**
|
||||
* @var ServicesBuilder
|
||||
*/
|
||||
private static $_instance = null;
|
||||
|
||||
/**
|
||||
* Gets the serializer used in the REST services construction.
|
||||
*
|
||||
* @return MicrosoftAzure\Storage\Common\Internal\Serialization\ISerializer
|
||||
*/
|
||||
protected function serializer()
|
||||
{
|
||||
return new XmlSerializer();
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the MIME serializer used in the REST services construction.
|
||||
*
|
||||
* @return \MicrosoftAzure\Storage\Table\Internal\IMimeReaderWriter
|
||||
*/
|
||||
protected function mimeSerializer()
|
||||
{
|
||||
return new MimeReaderWriter();
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the Atom serializer used in the REST services construction.
|
||||
*
|
||||
* @return \MicrosoftAzure\Storage\Table\Internal\IAtomReaderWriter
|
||||
*/
|
||||
protected function atomSerializer()
|
||||
{
|
||||
return new AtomReaderWriter();
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the Queue authentication scheme.
|
||||
*
|
||||
* @param string $accountName The account name.
|
||||
* @param string $accountKey The account key.
|
||||
*
|
||||
* @return \MicrosoftAzure\Storage\Common\Internal\Authentication\StorageAuthScheme
|
||||
*/
|
||||
protected function queueAuthenticationScheme($accountName, $accountKey)
|
||||
{
|
||||
return new SharedKeyAuthScheme($accountName, $accountKey);
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the Blob authentication scheme.
|
||||
*
|
||||
* @param string $accountName The account name.
|
||||
* @param string $accountKey The account key.
|
||||
*
|
||||
* @return \MicrosoftAzure\Storage\Common\Internal\Authentication\StorageAuthScheme
|
||||
*/
|
||||
protected function blobAuthenticationScheme($accountName, $accountKey)
|
||||
{
|
||||
return new SharedKeyAuthScheme($accountName, $accountKey);
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the Table authentication scheme.
|
||||
*
|
||||
* @param string $accountName The account name.
|
||||
* @param string $accountKey The account key.
|
||||
*
|
||||
* @return TableSharedKeyLiteAuthScheme
|
||||
*/
|
||||
protected function tableAuthenticationScheme($accountName, $accountKey)
|
||||
{
|
||||
return new TableSharedKeyLiteAuthScheme($accountName, $accountKey);
|
||||
}
|
||||
|
||||
/**
|
||||
* Builds a queue object.
|
||||
*
|
||||
* @param string $connectionString The configuration connection string.
|
||||
* @param array $options Array of options to pass to the service
|
||||
*
|
||||
* @return \MicrosoftAzure\Storage\Queue\Internal\IQueue
|
||||
*/
|
||||
public function createQueueService($connectionString, $options = [])
|
||||
{
|
||||
$settings = StorageServiceSettings::createFromConnectionString(
|
||||
$connectionString
|
||||
);
|
||||
|
||||
$serializer = $this->serializer();
|
||||
$uri = Utilities::tryAddUrlScheme(
|
||||
$settings->getQueueEndpointUri()
|
||||
);
|
||||
|
||||
$queueWrapper = new QueueRestProxy(
|
||||
$uri,
|
||||
$settings->getName(),
|
||||
$serializer,
|
||||
$options
|
||||
);
|
||||
|
||||
// Adding headers filter
|
||||
$headers = array(
|
||||
Resources::USER_AGENT => self::getUserAgent(),
|
||||
);
|
||||
|
||||
$headers[Resources::X_MS_VERSION] = Resources::STORAGE_API_LATEST_VERSION;
|
||||
|
||||
$headersFilter = new HeadersFilter($headers);
|
||||
$queueWrapper = $queueWrapper->withFilter($headersFilter);
|
||||
|
||||
// Adding date filter
|
||||
$dateFilter = new DateFilter();
|
||||
$queueWrapper = $queueWrapper->withFilter($dateFilter);
|
||||
|
||||
// Adding authentication filter
|
||||
$authFilter = new AuthenticationFilter(
|
||||
$this->queueAuthenticationScheme(
|
||||
$settings->getName(),
|
||||
$settings->getKey()
|
||||
)
|
||||
);
|
||||
|
||||
$queueWrapper = $queueWrapper->withFilter($authFilter);
|
||||
|
||||
return $queueWrapper;
|
||||
}
|
||||
|
||||
/**
|
||||
* Builds a blob object.
|
||||
*
|
||||
* @param string $connectionString The configuration connection string.
|
||||
* @param array $options Array of options to pass to the service
|
||||
* @return \MicrosoftAzure\Storage\Blob\Internal\IBlob
|
||||
*/
|
||||
public function createBlobService($connectionString, $options = [])
|
||||
{
|
||||
$settings = StorageServiceSettings::createFromConnectionString(
|
||||
$connectionString
|
||||
);
|
||||
|
||||
$serializer = $this->serializer();
|
||||
$uri = Utilities::tryAddUrlScheme(
|
||||
$settings->getBlobEndpointUri()
|
||||
);
|
||||
|
||||
$blobWrapper = new BlobRestProxy(
|
||||
$uri,
|
||||
$settings->getName(),
|
||||
$serializer,
|
||||
$options
|
||||
);
|
||||
|
||||
// Adding headers filter
|
||||
$headers = array(
|
||||
Resources::USER_AGENT => self::getUserAgent(),
|
||||
);
|
||||
|
||||
$headers[Resources::X_MS_VERSION] = Resources::STORAGE_API_LATEST_VERSION;
|
||||
|
||||
$headersFilter = new HeadersFilter($headers);
|
||||
$blobWrapper = $blobWrapper->withFilter($headersFilter);
|
||||
|
||||
// Adding date filter
|
||||
$dateFilter = new DateFilter();
|
||||
$blobWrapper = $blobWrapper->withFilter($dateFilter);
|
||||
|
||||
$authFilter = new AuthenticationFilter(
|
||||
$this->blobAuthenticationScheme(
|
||||
$settings->getName(),
|
||||
$settings->getKey()
|
||||
)
|
||||
);
|
||||
|
||||
$blobWrapper = $blobWrapper->withFilter($authFilter);
|
||||
|
||||
return $blobWrapper;
|
||||
}
|
||||
|
||||
/**
|
||||
* Builds a table object.
|
||||
*
|
||||
* @param string $connectionString The configuration connection string.
|
||||
* @param array $options Array of options to pass to the service
|
||||
*
|
||||
* @return \MicrosoftAzure\Storage\Table\Internal\ITable
|
||||
*/
|
||||
public function createTableService($connectionString, $options = [])
|
||||
{
|
||||
$settings = StorageServiceSettings::createFromConnectionString(
|
||||
$connectionString
|
||||
);
|
||||
|
||||
$atomSerializer = $this->atomSerializer();
|
||||
$mimeSerializer = $this->mimeSerializer();
|
||||
$serializer = $this->serializer();
|
||||
$uri = Utilities::tryAddUrlScheme(
|
||||
$settings->getTableEndpointUri()
|
||||
);
|
||||
|
||||
$tableWrapper = new TableRestProxy(
|
||||
$uri,
|
||||
$atomSerializer,
|
||||
$mimeSerializer,
|
||||
$serializer,
|
||||
$options
|
||||
);
|
||||
|
||||
// Adding headers filter
|
||||
$headers = array();
|
||||
$latestServicesVersion = Resources::STORAGE_API_LATEST_VERSION;
|
||||
$currentVersion = Resources::DATA_SERVICE_VERSION_VALUE;
|
||||
$maxVersion = Resources::MAX_DATA_SERVICE_VERSION_VALUE;
|
||||
$accept = Resources::ACCEPT_HEADER_VALUE;
|
||||
$acceptCharset = Resources::ACCEPT_CHARSET_VALUE;
|
||||
$userAgent = self::getUserAgent();
|
||||
|
||||
$headers[Resources::X_MS_VERSION] = $latestServicesVersion;
|
||||
$headers[Resources::DATA_SERVICE_VERSION] = $currentVersion;
|
||||
$headers[Resources::MAX_DATA_SERVICE_VERSION] = $maxVersion;
|
||||
$headers[Resources::MAX_DATA_SERVICE_VERSION] = $maxVersion;
|
||||
$headers[Resources::ACCEPT_HEADER] = $accept;
|
||||
$headers[Resources::ACCEPT_CHARSET] = $acceptCharset;
|
||||
$headers[Resources::USER_AGENT] = $userAgent;
|
||||
|
||||
$headersFilter = new HeadersFilter($headers);
|
||||
$tableWrapper = $tableWrapper->withFilter($headersFilter);
|
||||
|
||||
// Adding date filter
|
||||
$dateFilter = new DateFilter();
|
||||
$tableWrapper = $tableWrapper->withFilter($dateFilter);
|
||||
|
||||
// Adding authentication filter
|
||||
$authFilter = new AuthenticationFilter(
|
||||
$this->tableAuthenticationScheme(
|
||||
$settings->getName(),
|
||||
$settings->getKey()
|
||||
)
|
||||
);
|
||||
|
||||
$tableWrapper = $tableWrapper->withFilter($authFilter);
|
||||
|
||||
return $tableWrapper;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the user agent string used in request header.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
private static function getUserAgent()
|
||||
{
|
||||
// e.g. User-Agent: Azure-Storage/0.10.0 (PHP 5.5.32)
|
||||
return 'Azure-Storage/' . Resources::SDK_VERSION . ' (PHP ' . PHP_VERSION . ')';
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the static instance of this class.
|
||||
*
|
||||
* @return ServicesBuilder
|
||||
*/
|
||||
public static function getInstance()
|
||||
{
|
||||
if (!isset(self::$_instance)) {
|
||||
self::$_instance = new ServicesBuilder();
|
||||
}
|
||||
|
||||
return self::$_instance;
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user