Built-in credential providers in the Amazon SDK for PHP Version 3 - Amazon SDK for PHP
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Built-in credential providers in the Amazon SDK for PHP Version 3

The SDK provides several built-in credential providers that you can use individually or combine in a custom credential provider chain.

When you specify a credential provider during service client creation, the SDK attempts to load credentials by using only the specified credential provider. It does not use the default credential provider chain. If you know that you want a service client to use the instanceProfile provider, you can short-circuit the default chain by specifying the instanceProfile provider in the service client constructor:

use Aws\Credentials\CredentialProvider; use Aws\S3\S3Client; $provider = CredentialProvider::instanceProfile(); // Be sure to memoize the credentials $memoizedProvider = CredentialProvider::memoize($provider); $client = new S3Client([ 'region' => 'us-west-2', 'credentials' => $memoizedProvider // The default credential provider chain is not used. ]);
Important

Credential providers are invoked every time an API operation is performed. If loading credentials is an expensive task (e.g., loading from disk or a network resource), or if credentials are not cached by your provider, consider wrapping your credential provider in an Aws\Credentials\CredentialProvider::memoize function. The default credential provider used by the SDK is automatically memoized.