API Documentation

Service/Amazon/SimpleDb.php

Zend Framework

LICENSE

This source file is subject to the new BSD license that is bundled with this package in the file LICENSE.txt. It is also available through the world-wide-web at this URL: http://framework.zend.com/license/new-bsd If you did not receive a copy of the license and are unable to obtain it through the world-wide-web, please send an email to license@zend.com so we can send you a copy immediately.

category
Zend  
copyright
Copyright (c) 2005-2011 Zend Technologies USA Inc. (http://www.zend.com)  
license
New BSD License  
package
Zend_Service_Amazon  
subpackage
SimpleDb  

\Zend_Service_Amazon_SimpleDb

Abstract Amazon class that handles the credentials for any of the Web Services that Amazon offers

Extends from
\Zend_Service_Amazon_Abstract
category
Zend  
copyright
Copyright (c) 2005-2011 Zend Technologies USA Inc. (http://www.zend.com)  
license
New BSD License  
package
Zend_Service_Amazon  
subpackage
SimpleDb  

Properties

Propertyprotected  $_httpTimeout= '10'

Period after which HTTP request will timeout in seconds

Default value10Details
Type
Propertyprotected  $_sdbApiVersion= '2009-04-15'

The API version to use

Default value2009-04-15Details
Type
Propertyprotected  $_sdbEndpoint= 'sdb.amazonaws.com/'

The HTTP query server

Default valuesdb.amazonaws.com/Details
Type
Propertyprotected  $_signatureMethod= 'HmacSHA256'

Signature Encoding Method

Default valueHmacSHA256Details
Type
Propertyprotected  $_signatureVersion= '2'

Signature Version

Default value2Details
Type

Methods

methodpublic__construct(  $accessKey,  $secretKey ) : void

Create Amazon SimpleDB client.

Parameters
Name Type Description
$accessKey
$secretKey
methodprotected_addRequiredParameters( array $parameters ) : array

Adds required authentication and version parameters to an array of parameters

The required parameters are: - AWSAccessKey - SignatureVersion - Timestamp - Version and - Signature

If a required parameter is already set in the $parameters array, it is overwritten.

Parameters
Name Type Description
$parameters array the array to which to add the required parameters.
Returns
Type Description
array
methodprivate_checkForErrors( \Zend_Service_Amazon_SimpleDb_Response $response ) : void

Checks for errors responses from Amazon

Parameters
Name Type Description
$response \Zend_Service_Amazon_SimpleDb_Response the response object to check.
Throws
Exception Description
\Zend_Service_Amazon_SimpleDb_Exception if one or more errors are returned from Amazon.
methodprotected_getAccessKey( ) : string

Method to fetch the Access Key

Inherited from: \Zend_Service_Amazon_Abstract::_getAccessKey()
Returns
Type Description
string
methodprotected_getSecretKey( ) : string

Method to fetch the Secret AWS Key

Inherited from: \Zend_Service_Amazon_Abstract::_getSecretKey()
Returns
Type Description
string
methodprotected_sendRequest( array $params = array ) : \Zend_Service_Amazon_SimpleDb_Response

Sends a HTTP request to the SimpleDB service using Zend_Http_Client

Parameters
Name Type Description
$params array List of parameters to send with the request
Returns
Type Description
\Zend_Service_Amazon_SimpleDb_Response
Throws
Exception Description
\Zend_Service_Amazon_SimpleDb_Exception
methodprotected_signParameters(  $paramaters ) : string

Computes the RFC 2104-compliant HMAC signature for request parameters

This implements the Amazon Web Services signature, as per the following specification:

  1. Sort all request parameters (including SignatureVersion and excluding Signature, the value of which is being created), ignoring case.

  2. Iterate over the sorted list and append the parameter name (in its original case) and then its value. Do not URL-encode the parameter values before constructing this string. Do not use any separator characters when appending strings.

Parameters
Name Type Description
$paramaters
Returns
Type Description
string the signed data.
methodpublicbatchPutAttributes( array $items, string $domainName, array $replace = array ) : void

Add many attributes at once

Parameters
Name Type Description
$items array
$domainName string
$replace array
methodpubliccreateDomain( string $domainName ) : boolean

Create a new domain

Parameters
Name Type Description
$domainName string Valid domain name of the domain to create
Returns
Type Description
boolean True if successful, false if not
methodpublicdeleteAttributes( string $domainName, string $itemName, array $attributes = array ) : void

Delete attributes

Parameters
Name Type Description
$domainName string
$itemName string
$attributes array
methodpublicdeleteDomain( string $domainName ) : boolean

Delete a domain

Parameters
Name Type Description
$domainName string Valid domain name of the domain to delete
Returns
Type Description
boolean True if successful, false if not
methodpublicdomainMetadata( string $domainName ) : array

Retrieve domain metadata

Parameters
Name Type Description
$domainName string Name of the domain for which metadata will be requested
Returns
Type Description
array Key/value array of metadatum names and values.
methodpublicgetAttributes( string $domainName,  $itemName,  $attributeName = null ) : void

Get attributes API method

Parameters
Name Type Description
$domainName string Domain name within database
$itemName string
$attributeName
methodpublicgetEndpoint( ) : \Zend_Uri_Http

Get SimpleDB endpoint

Returns
Type Description
\Zend_Uri_Http
methodpublicgetHttpClient( ) : \Zend_Http_Client
static

Gets the HTTP client object.

Inherited from: \Zend_Service_Abstract::getHttpClient()
Returns
Type Description
\Zend_Http_Client
methodpubliclistDomains( int $maxNumberOfDomains = 100, int $nextToken = null ) : array

List domains

Parameters
Name Type Description
$maxNumberOfDomains int
$nextToken int
Returns
Type Description
array 0 or more domain names
methodpublicputAttributes( string $domainName, string $itemName, array|\Traverable $attributes, array $replace = array ) : void

Push attributes

Parameters
Name Type Description
$domainName string
$itemName string
$attributes array|\Traverable
$replace array
methodpublicquote( string $value ) : string

Quote SDB value

Wraps it in ''

Parameters
Name Type Description
$value string
Returns
Type Description
string
methodpublicquoteName( string $name ) : string

Quote SDB column or table name

Wraps it in ``

Parameters
Name Type Description
$name string
Returns
Type Description
string
methodpublicselect( string $selectExpression, null|string $nextToken = null ) : \Zend_Service_Amazon_SimpleDb_Page

Select items from the database

Parameters
Name Type Description
$selectExpression string
$nextToken null|string
Returns
Type Description
\Zend_Service_Amazon_SimpleDb_Page
methodpublicsetEndpoint( string|\Zend_Uri_Http $endpoint ) : \Zend_Service_Amazon_SimpleDb

Set SimpleDB endpoint to use

Parameters
Name Type Description
$endpoint string|\Zend_Uri_Http
Returns
Type Description
\Zend_Service_Amazon_SimpleDb
methodpublicsetHttpClient( \Zend_Http_Client $httpClient ) : void
static

Sets the HTTP client object to use for retrieving the feeds. If none is set, the default Zend_Http_Client will be used.

Inherited from: \Zend_Service_Abstract::setHttpClient()
Parameters
Name Type Description
$httpClient \Zend_Http_Client
methodpublicsetKeys(  $accessKey,  $secretKey ) : void
static

Set the keys to use when accessing SQS.

Inherited from: \Zend_Service_Amazon_Abstract::setKeys()
Parameters
Name Type Description
$accessKey
$secretKey
Documentation was generated by DocBlox 0.13.3.