Installation guide

signature.service The signature service scope for Signature V4. See Setting a custom endpoint.

signature.region The signature region scope for Signature V4. See Setting a custom endpoint.

Generic Client Options

Options Description

ssl.certificate_authoritySet to true to use the SDK bundled SSL certificate bundle (this is used by

default), 'system' to use the bundle on your system, a string pointing to a file

to use a specific certificate file, a string pointing to a directory to use multiple

certificates, or false to disable SSL validation (not recommended).

When using the aws.phar, the bundled SSL certificate will be extracted to your

system's temp folder, and each time a client is created an MD5 check will be

performed to ensure the integrity of the certificate.

curl.options Associative array of cURL options to apply to every request created by the

client. If either the key or value of an entry in the array is a string, Guzzle will

attempt to find a matching defined cURL constant automatically (e.g.

"CURLOPT_PROXY" will be converted to the constant CURLOPT_PROXY).

request.options Associative array of Guzzle request options to apply to every request created by

the client.

command.params An associative array of default options to set on each command created by the

client.

client.backoff.logger A Guzzle\Log\LogAdapterInterface object used to log backoff retries.

Use 'debug' to emit PHP warnings when a retry is issued.

client.backoff.logger.templateOptional template to use for exponential backoff log messages. See the

Guzzle\Plugin\Backoff\BackoffLogger class for formatting information.

Specifying a region

Some clients require a region configuration setting. You can find out if the client you are using requires a region

and the regions available to a client by consulting the documentation for that particular client (see Service-Specific

Guides).

Here's an example of creating an Amazon DynamoDB client that uses the us-west-1 region:

require 'vendor/autoload.php';

use Aws\DynamoDb\DynamoDbClient;

// Create a client that uses the us-west-1 region

$client = DynamoDbClient::factory(array(

'key' => 'YOUR_AWS_ACCESS_KEY_ID',

'secret' => 'YOUR_AWS_SECRET_ACCESS_KEY',

'region' => 'us-west-1'

));

Setting a custom endpoint

You can specify a completely customized endpoint for a client using the client's base_url option. If the client you

are using requires a region, then must still specify the name of the region using the region option. Setting a

custom endpoint can be useful if you're using a mock web server that emulates a web service, you're testing against

a private beta endpoint, or you are trying to a use a new region not yet supported by the SDK.

Here's an example of creating an Amazon DynamoDB client that uses a completely customized endpoint:

require 'vendor/autoload.php';

use Aws\DynamoDb\DynamoDbClient;

// Create a client that that contacts a completely customized base URL

Configuring the SDK