AWS SDK for PHP Laravel Service Provider

https://github.com/aws/aws-sdk-php-laravel
Admin
A Laravel service provider that makes it easy to include the official AWS SDK for PHP in your...
Tokens:14,532
Snippets:108
Trust Score:9.7
License:Apache-2.0
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### Example usage of provides() method

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsServiceProvider.md

Shows how to instantiate the provider and call provides() to get the list of service identifiers. The output is ['aws', 'Aws\Sdk'].

```php
$provider = new \Aws\Laravel\AwsServiceProvider($app);
$provider->provides(); // ['aws', 'Aws\Sdk']
```

--------------------------------

### Basic use of AWS facade createClient()

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsFacade.md

Example of using the AWS facade to create an S3 client and upload an object. The facade resolves the 'aws' container binding and forwards the call to the underlying Aws\Sdk instance.

```php
use Aws\Laravel\AwsFacade as AWS;

$s3 = AWS::createClient('S3');
$s3->putObject(array(
    'Bucket'     => 'YOUR_BUCKET',
    'Key'        => 'YOUR_OBJECT_KEY',
    'SourceFile' => '/the/path/to/the/file/you/are/uploading.ext',
));
```

--------------------------------

### Per-call arguments and error handling with AWS facade

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsFacade.md

Example showing how to override shared config for one client (e.g., region) and handle AWS SDK exceptions using AwsException. The catch block logs the AWS error message.

```php
use Aws\Laravel\AwsFacade as AWS;
use Aws\Exception\AwsException;

// Override the shared config for one client (e.g. a different region).
$dynamo = AWS::createClient('DynamoDb', ['region' => 'eu-west-1']);

try {
    $dynamo->putItem(array(
        'TableName' => 'my-table',
        'Item'      => array(
            'id' => array('S' => '1'),
        ),
    ));
} catch (AwsException $e) {
    // AWS SDK exception; inspect the API error code/message.
    error_log($e->getAwsErrorMessage());
}
```

--------------------------------

### Composer require aws/aws-sdk-php-laravel

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/README.md

Add the AWS Service Provider package to your project's composer.json to install it via Composer.

```json
{
    "require": {
        "aws/aws-sdk-php-laravel": "~3.0"
    }
}
```

--------------------------------

### Example .env for test suite (phpunit.xml)

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/configuration.md

Environment variables used by the test suite. Only AWS_REGION affects this package's own files when using the default config; the SDK's own credential chain also reads these variables directly.

```ini
AWS_ACCESS_KEY_ID=foo
AWS_SECRET_ACCESS_KEY=bar
AWS_REGION=baz
```

--------------------------------

### boot() method implementation

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsServiceProvider.md

Bootstraps configuration. For Laravel console apps, registers a publish group 'aws-config' to copy config/aws_publish.php to config_path('aws.php'). For Lumen, calls configure('aws'). No-op otherwise.

```php
/**
 * Bootstrap the configuration
 *
 * @return void
 */
public function boot()
{
    if ($this->app instanceof LaravelApplication && $this->app->runningInConsole()) {
        $this->publishes(
            [__DIR__.'/../config/aws_publish.php' => config_path('aws.php')],
            'aws-config'
        );
    } elseif ($this->app instanceof LumenApplication) {
        $this->app->configure('aws');
    }
}
```

--------------------------------

### Use S3 client via AWS facade

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/README.md

Use the AWS facade to create an S3 client and upload a file, requires the facade alias to be registered.

```php
$s3 = AWS::createClient('s3');
$s3->putObject(array(
    'Bucket'     => 'YOUR_BUCKET',
    'Key'        => 'YOUR_OBJECT_KEY',
    'SourceFile' => '/the/path/to/the/file/you/are/uploading.ext',
));
```

--------------------------------

### register() method implementation

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsServiceProvider.md

Registers the service provider by merging config defaults, binding the 'aws' singleton, and aliasing it to Aws\Sdk. Takes no arguments and returns void. The singleton ensures all consumers share one Aws\Sdk instance.

```php
/**
 * Register the service provider.
 *
 * @return void
 */
public function register()
{
    $this->mergeConfigFrom(
        __DIR__.'/../config/aws_default.php',
        'aws'
    );

    $this->app->singleton('aws', function ($app) {
        $config = $app->make('config')->get('aws');

        return new Sdk($config);
    });

    $this->app->alias('aws', 'Aws\Sdk');
}
```

--------------------------------

### Run composer update

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/README.md

Update Composer dependencies after adding the package to composer.json.

```sh
php composer.phar update
```

--------------------------------

### Publish AWS configuration with Artisan

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/README.md

Publish the package configuration file using Artisan to customize settings.

```sh
php artisan vendor:publish  --provider="Aws\Laravel\AwsServiceProvider"
```

--------------------------------

### Use S3 client in Lumen

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/README.md

Retrieve the AWS SDK client from the service container using app('aws') in Lumen and upload a file to S3.

```php
$s3 = app('aws')->createClient('s3');
$s3->putObject(array(
    'Bucket'     => 'YOUR_BUCKET',
    'Key'        => 'YOUR_OBJECT_KEY',
    'SourceFile' => '/the/path/to/the/file/you/are/uploading.ext',
));
```

--------------------------------

### Resolving the aws singleton and config

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsServiceProvider.md

Shows how to resolve the singleton Aws\Sdk instance and retrieve the exact config array passed to new Sdk(...) from the container. Useful for debugging or manual resolution outside the provider.

```php
// Inside a service provider or anywhere the container is available
$sdk = $app->make('aws');          // resolves the singleton Aws\Sdk
$config = $app->make('config')->get('aws'); // the exact array handed to new Sdk(...)
```

--------------------------------

### Facade - AWS::createClient(...)

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsSdk.md

Use the `AWS` facade to create AWS service clients. The facade provides a static interface to the underlying SDK instance.

```APIDOC
## Facade - AWS::createClient(...)

### Description
Use the `AWS` facade to create AWS service clients. The facade provides a static interface to the underlying SDK instance.

### Method
Static method call (not an HTTP method)

### Endpoint
`AWS::createClient($name, array $args = [])`

### Parameters
- `$name` (string) - Required - Service name for the client factory (e.g. `'s3'`, `'Ses'`).
- `$args` (array) - Optional - Per-client config overrides merged over the shared `aws` config. Default: `[]`.

### Request Example
```php
$s3 = AWS::createClient('s3');
```

### Response
Returns an instance of `Aws\AwsClientInterface` (e.g., `Aws\S3\S3Client`).
```

--------------------------------

### Resolve AWS SDK via container with app('aws') / App::make('aws')

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsSdk.md

Shows three equivalent ways to resolve the AWS SDK instance from the container: Laravel's App::make('aws'), the Lumen/Laravel helper app('aws'), and then creating an S3 client with createClient('s3').

```php
$aws = App::make('aws');       // Laravel
$aws = app('aws');             // Lumen / Laravel helper
$s3  = $aws->createClient('s3');
```

--------------------------------

### provides() method implementation in AwsServiceProvider

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsServiceProvider.md

Returns the service identifiers registered by the provider: the string binding 'aws' and its class alias 'Aws\Sdk'. Because $defer is true, register() is deferred until Laravel resolves either identifier. This method is also used when inspecting registered providers and is asserted in testServiceNameIsProvided in tests/AwsServiceProviderTest.php.

```php
/**
 * Get the services provided by the provider.
 *
 * @return array
 */
public function provides()
{
    return ['aws', 'Aws\Sdk'];
}
```

--------------------------------

### Registering AwsServiceProvider in Laravel and Lumen

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsServiceProvider.md

Shows how to register the provider in Laravel's config/app.php and Lumen's bootstrap/app.php. For Laravel, add to the 'providers' array; for Lumen, call $app->register() in the Register Service Providers section.

```php
// Laravel — config/app.php
'providers' => array(
    // ...
    Aws\Laravel\AwsServiceProvider::class,
)
```

```php
// Lumen — bootstrap/app.php (Register Service Providers section)
$app->register(Aws\Laravel\AwsServiceProvider::class);
```

--------------------------------

### Use S3 client via Laravel service container

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/README.md

Retrieve the AWS SDK client from the Laravel service container using App::make('aws') and upload a file to S3.

```php
$s3 = App::make('aws')->createClient('s3');
$s3->putObject(array(
    'Bucket'     => 'YOUR_BUCKET',
    'Key'        => 'YOUR_OBJECT_KEY',
    'SourceFile' => '/the/path/to/the/file/you/are/uploading.ext',
));
```

--------------------------------

### Publish config file command

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsServiceProvider.md

Command to publish the AWS config file in Laravel from the console, creating config/aws.php.

```php
// Publish the config file (Laravel, from the console)
php artisan vendor:publish --provider="Aws\Laravel\AwsServiceProvider"
// → creates config/aws.php
```

--------------------------------

### createClient()

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsSdk.md

Create an AWS service client using the resolved SDK instance. This is the primary method for interacting with AWS services.

```APIDOC
## createClient()

### Description
Create an AWS service client using the resolved SDK instance. This is the primary method for interacting with AWS services.

### Method
Method call (not an HTTP method)

### Endpoint
`$aws->createClient($name, array $args = [])`

### Parameters
- `$name` (string) - Required - Service name for the client factory (e.g. `'s3'`, `'Ses'`).
- `$args` (array) - Optional - Per-client config overrides merged over the shared `aws` config. Default: `[]`.

### Request Example
```php
$s3 = $aws->createClient('s3');
```

### Response
Returns an instance of `Aws\AwsClientInterface` (e.g., `Aws\S3\S3Client`).
```

--------------------------------

### Constructor injection of Aws\Sdk via type-hint

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsSdk.md

The 'Aws\Sdk' alias makes the same instance injectable by type-hint. Use this in a class constructor to receive the AWS SDK instance automatically.

```php
use Aws\Sdk;

class ReportGenerator
{
    public function __construct(private Sdk $aws)
    {
    }
}
```

--------------------------------

### Container Resolution - app('aws') / App::make('aws')

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsSdk.md

Resolve the AWS SDK instance from the Laravel or Lumen container. Use the returned instance to create AWS service clients.

```APIDOC
## Container Resolution

### Description
Resolve the AWS SDK instance from the Laravel or Lumen container. Use the returned instance to create AWS service clients.

### Method
Container resolution (not an HTTP method)

### Endpoint
`app('aws')` or `App::make('aws')`

### Parameters
None

### Request Example
```php
$aws = App::make('aws');       // Laravel
$aws = app('aws');             // Lumen / Laravel helper
$s3  = $aws->createClient('s3');
```

### Response
Returns an instance of `Aws\Sdk` (the AWS SDK builder).
```

--------------------------------

### Lumen: create S3 client and upload object without facade

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsSdk.md

In Lumen, no facade is required—resolve from the container with app('aws') and call createClient('s3') to upload an object using putObject with Bucket, Key, and SourceFile parameters.

```php
// Lumen: no facade required — resolve from the container
$s3 = app('aws')->createClient('s3');
$s3->putObject(array(
    'Bucket'     => 'YOUR_BUCKET',
    'Key'        => 'YOUR_OBJECT_KEY',
    'SourceFile' => '/the/path/to/the/file/you/are/uploading.ext',
));
```

--------------------------------

### provides()

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsServiceProvider.md

Returns the service identifiers registered by the AwsServiceProvider. This method is used for deferred provider loading and inspection of registered providers.

```APIDOC
## provides()

### Description
Returns the service identifiers registered by the AwsServiceProvider. This method is used for deferred provider loading and inspection of registered providers.

### Method
provides()

### Endpoint
N/A (PHP method)

### Parameters
#### Path Parameters
- *(none)* - No parameters.

#### Query Parameters
- *(none)* - No parameters.

#### Request Body
- *(none)* - No parameters.

### Request Example
```php
$provider = new \Aws\Laravel\AwsServiceProvider($app);
$provider->provides();
```

### Response
#### Success Response (200)
- **return** (array of string) - The service identifiers: `'aws'` and `'Aws\Sdk'`.

#### Response Example
```php
['aws', 'Aws\Sdk']
```
```

--------------------------------

### createClient() @method phpdoc declaration

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsFacade.md

The @method phpdoc declaration for the createClient() static method on the facade. The actual method lives on the resolved Aws\Sdk instance and is forwarded via __callStatic.

```php
/**
 * @method static AwsClientInterface createClient($name, array $args = []) Get a client from the service builder.
 */
```

--------------------------------

### $defer property declaration

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsServiceProvider.md

Declares the protected $defer property as true, marking the provider as deferred so Laravel does not call boot() until a service declared by provides() is resolved.

```php
/**
 * Indicates if loading of the provider is deferred.
 *
 * @var bool
 */
protected $defer = true;
```

--------------------------------

### Generated config/aws.php configuration

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/README.md

Default configuration file generated after publishing. Credentials and region pull from .env. You can delete the 'credentials' line to use the default SDK Configuration Provider chain.

```php
return [
    'credentials' => [
        'key'    => env('AWS_ACCESS_KEY_ID', ''),
        'secret' => env('AWS_SECRET_ACCESS_KEY', ''),
    ],
    'region' => env('AWS_REGION', 'us-east-1'),
    'version' => 'latest',
    // You can override settings for specific services
    'Ses' => [
        'region' => 'us-east-1',
    ],
];
```

--------------------------------

### Constructor Injection - Aws\Sdk

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsSdk.md

Inject the AWS SDK instance via constructor type-hinting. The `'Aws\Sdk'` alias makes the same instance injectable.

```APIDOC
## Constructor Injection

### Description
Inject the AWS SDK instance via constructor type-hinting. The `'Aws\Sdk'` alias makes the same instance injectable.

### Method
Dependency injection (not an HTTP method)

### Endpoint
Constructor parameter type-hinted with `Aws\Sdk`

### Parameters
- `$aws` (Aws\Sdk) - Required - The AWS SDK instance.

### Request Example
```php
use Aws\Sdk;

class ReportGenerator
{
    public function __construct(private Sdk $aws)
    {
    }
}
```

### Response
No return value (constructor).
```

--------------------------------

### AWS::createClient($name, array $args = [])

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsFacade.md

Static method on the AwsFacade that resolves the underlying Aws\Sdk service from the Laravel container and forwards the call to its createClient() method. Returns an AWS client instance for the specified service.

```APIDOC
## [STATIC] AWS::createClient($name, array $args = [])

### Description
Get a client from the service builder. This static method on the AwsFacade resolves the `aws` service from the Laravel container and forwards the call to the underlying `Aws\Sdk` instance's `createClient()` method.

### Method
STATIC

### Endpoint
AWS::createClient($name, array $args = [])

### Parameters
#### Path Parameters
- **$name** (string) - Required - AWS service name used by the service builder to create a client (e.g. `'S3'`, `'DynamoDb'`, `'Ec2'`).

#### Query Parameters
- **$args** (array) - Optional - Per-service client constructor options (e.g. `region`, `credentials`, `version`). Merged over the shared `aws` config. Default: `[]`.

### Request Example
```php
use Aws\Laravel\AwsFacade as AWS;

$s3 = AWS::createClient('S3');
$s3->putObject(array(
    'Bucket'     => 'YOUR_BUCKET',
    'Key'        => 'YOUR_OBJECT_KEY',
    'SourceFile' => '/the/path/to/the/file/you/are/uploading.ext',
));
```

### Response
#### Success Response (200)
- **return** (Aws\AwsClientInterface) - An AWS client instance (concrete classes such as `Aws\S3\S3Client` implement this interface).

#### Response Example
```php
// Returns an instance of Aws\S3\S3Client (or other concrete client class)
```

### Error Handling
No exception types are declared in this package's source. Failure conditions (unknown service name, invalid credentials, network errors at call time) are raised by the AWS SDK and propagate uncaught through the facade.
```

--------------------------------

### Access AwsServiceProvider::VERSION

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsServiceProvider.md

Shows how to access the VERSION constant, returning the string "3.7.0".

```php
$userAgent = \Aws\Laravel\AwsServiceProvider::VERSION; // "3.7.0"
```

--------------------------------

### Resolving the accessor directly

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsFacade.md

Shows that resolving the 'aws' container binding directly is equivalent to using the facade. app('aws') returns the same instance as AWS::getFacadeRoot().

```php
// The accessor string is what backs the facade; resolving it directly is equivalent:
$aws = app('aws');                     // same instance as AWS::getFacadeRoot()
$s3   = $aws->createClient('s3');
```

--------------------------------

### Register AWS Service Provider in Lumen

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/README.md

Register the AWS Service Provider in the 'Register Service Providers' section of bootstrap/app.php for Lumen applications.

```php
    $app->register(Aws\Laravel\AwsServiceProvider::class);
```

--------------------------------

### Register Aws\Sdk as singleton in Laravel container

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsSdk.md

Binds an Aws\Sdk instance into the Laravel/Lumen container under the 'aws' identifier, reading the merged 'aws' config array and passing it verbatim to the SDK constructor. Also aliases 'aws' to 'Aws\Sdk' so both identifiers resolve to the same singleton instance.

```php
$this->app->singleton('aws', function ($app) {
    $config = $app->make('config')->get('aws');

    return new Sdk($config);
});

$this->app->alias('aws', 'Aws\Sdk');
```

--------------------------------

### AwsServiceProvider constructor signature

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsServiceProvider.md

Constructor inherited from Illuminate\Support\ServiceProvider, not re-declared in this class. Takes the application container instance and stores it in the inherited protected $app property.

```php
public function __construct($app)
```

--------------------------------

### Add AWS facade alias in Laravel

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/README.md

Add the AWS facade alias to the 'aliases' array in config/app.php to use the AWS facade.

```php
    'aliases' => array(
        // ...
        'AWS' => Aws\Laravel\AwsFacade::class,
    )
```

--------------------------------

### Register AWS Service Provider in Laravel

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/README.md

Add the AWS Service Provider to the 'providers' array in config/app.php for Laravel applications.

```php
    'providers' => array(
        // ...
        Aws\Laravel\AwsServiceProvider::class,
    )
```

--------------------------------

### Publish AWS config with artisan vendor:publish

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/configuration.md

Publishes the package config to config_path('aws.php'). The commented line is an equivalent command using the aws-config tag.

```shell
php artisan vendor:publish --provider="Aws\Laravel\AwsServiceProvider"
# equivalent: php artisan vendor:publish --tag=aws-config
```

--------------------------------

### Environment variables for auto-configuration

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/README.md

Default environment variables used by the package for auto-configuration. AWS_REGION defaults to us-east-1.

```text
AWS_ACCESS_KEY_ID
AWS_SECRET_ACCESS_KEY
AWS_REGION (default = us-east-1)
```

--------------------------------

### AwsFacade class definition

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsFacade.md

The AwsFacade class extends Illuminate\Support\Facades\Facade and is the Laravel facade for the AWS service. It declares the createClient() static method via @method phpdoc.

```php
namespace Aws\Laravel;

use Aws\AwsClientInterface;
use Illuminate\Support\Facades\Facade;

/**
 * Facade for the AWS service
 *
 * @method static AwsClientInterface createClient($name, array $args = []) Get a client from the service builder.
 */
class AwsFacade extends Facade
```

--------------------------------

### Register AWS facade alias in Laravel config/app.php

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsFacade.md

Manual registration of the AWS facade alias in Laravel's config/app.php file. This is an alternative to auto-discovery via composer.json.

```php
// Laravel — config/app.php
'aliases' => array(
    // ...
    'AWS' => Aws\Laravel\AwsFacade::class,
)
```

--------------------------------

### AwsServiceProvider class declaration

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsServiceProvider.md

The Laravel service provider that integrates the AWS SDK for PHP into Laravel or Lumen applications. Registers the 'aws' singleton, aliases it as Aws\Sdk, merges default configuration, and publishes a user-editable config file. Source: src/AwsServiceProvider.php, FQCN: Aws\Laravel\AwsServiceProvider, parent: Illuminate\Support\ServiceProvider.

```php
namespace Aws\Laravel;

use Aws\Sdk;
use Illuminate\Foundation\Application as LaravelApplication;
use Illuminate\Support\ServiceProvider;
use Laravel\Lumen\Application as LumenApplication;

/**
 * AWS SDK for PHP service provider for Laravel applications
 */
class AwsServiceProvider extends ServiceProvider
```

--------------------------------

### Per-service overrides in config/aws.php

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/configuration.md

Configuration array passed to Aws\Sdk; settings under a service-name key override top-level settings for that service's clients. Any option accepted by the Aws\Sdk constructor can be added.

```php
// config/aws.php
return [
    'credentials' => [
        'key'    => env('AWS_ACCESS_KEY_ID', ''),
        'secret' => env('AWS_SECRET_ACCESS_KEY', ''),
    ],
    'region' => env('AWS_REGION', 'us-east-1'),
    'version' => 'latest',
    // You can override settings for specific services
    'Ses' => [
        'region' => 'us-east-1',
    ],
];
```

--------------------------------

### Published AWS config file (config/aws_publish.php)

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/configuration.md

Default configuration published to config_path('aws.php'). Includes static credentials from environment variables, region, API version, and a user-agent suffix. Deleting the credentials key re-enables the SDK default credential-provider chain.

```php
<?php

use Aws\Laravel\AwsServiceProvider;

return [

    'credentials' => [
        'key'    => env('AWS_ACCESS_KEY_ID', ''),
        'secret' => env('AWS_SECRET_ACCESS_KEY', ''),
    ],
    'region' => env('AWS_REGION', 'us-east-1'),
    'version' => 'latest',
    'ua_append' => [
        'L5MOD/' . AwsServiceProvider::VERSION,
    ],
];
```

--------------------------------

### Default AWS configuration (config/aws_default.php)

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/configuration.md

Merged into the 'aws' config key at registration; user config values win on key collision. Sets region from AWS_REGION env with 'us-east-1' fallback, API version 'latest', and appends 'L5MOD/' version to user-agent. No credentials key, so SDK falls back to default credential-provider chain.

```php
<?php

use Aws\Laravel\AwsServiceProvider;

return [

    'region' => env('AWS_REGION', 'us-east-1'),
    'version' => 'latest',
    'ua_append' => [
        'L5MOD/' . AwsServiceProvider::VERSION,
    ],
];
```

--------------------------------

### getFacadeAccessor() method implementation

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsFacade.md

The getFacadeAccessor() method returns the container binding name 'aws' that the facade resolves. This is the hook every Laravel facade implements.

```php
/**
 * Get the registered name of the component.
 *
 * @return string
 */
protected static function getFacadeAccessor()
{
    return 'aws';
}
```

--------------------------------

### AwsServiceProvider::VERSION constant definition

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsServiceProvider.md

Defines the package version constant used in the SDK user-agent string via the ua_append config option. The value is asserted by testVersionInformationIsProvidedToSdkUserAgent.

```php
const VERSION = '3.7.0';
```

--------------------------------

### AWS::getFacadeAccessor()

Source: https://github.com/aws/aws-sdk-php-laravel/blob/master/_autodocs/api-reference/AwsFacade.md

Protected static method that returns the container binding name ('aws') that the facade resolves. This is the hook every Laravel facade implements, used by the base Facade class in its static proxy magic.

```APIDOC
## [STATIC] AWS::getFacadeAccessor()

### Description
Get the registered name of the component. This protected static method returns the container binding name (`'aws'`) that the facade resolves. It is called by the base `Facade` class in its static proxy magic to look up the service.

### Method
STATIC

### Endpoint
AWS::getFacadeAccessor()

### Parameters
#### Path Parameters
- *(none)* - No arguments.

### Request Example
```php
// This method is called internally by the Facade base class; not typically called directly.
```

### Response
#### Success Response (200)
- **return** (string) - The container binding name (`'aws'`) that the facade resolves.

#### Response Example
```php
// Returns 'aws'
```
```
Tokens:
Raw