aws / aws-sdk-php-laravel5
A simple Laravel 4/5 service provider for including the AWS SDK for PHP.
Requires
- php: >=5.3.3
- aws/aws-sdk-php: ~2.2
- illuminate/foundation: 4.*
- illuminate/support: 4.*
Requires (Dev)
- phpunit/phpunit: 3.7.*
This package is not auto-updated.
Last update: 2020-05-17 09:09:05 UTC
README
A simple Laravel 5 service provider for including the AWS SDK for PHP.
Installation
The AWS Service Provider can be installed via Composer by requiring the
aws/aws-sdk-php-laravel5
package in your project's composer.json
.
{ "require": { "aws/aws-sdk-php-laravel5": "1.*" } }
Then run a composer update
php composer.phar update
Configuration
To use the AWS Service Provider, you must register the provider when bootstrapping your Laravel application.
Publish the package configuration using Artisan.
php artisan config:publish aws/aws-sdk-php-laravel5
Update your settings in the generated app/config/packages/aws/aws-sdk-php-laravel5
configuration file.
return array( 'key' => 'YOUR_AWS_ACCESS_KEY_ID', 'secret' => 'YOUR_AWS_SECRET_KEY', 'region' => 'us-east-1', 'config_file' => null, );
Find the providers
key in your app/config/app.php
and register the AWS Service Provider.
'providers' => array( // ... 'Aws\Laravel\AwsServiceProvider', )
Find the aliases
key in your app/config/app.php
and add the AWS facade alias.
'aliases' => array( // ... 'AWS' => 'Aws\Laravel\AwsFacade', )
Usage
In order to use the AWS SDK for PHP within your app, you need to retrieve it from the Laravel IoC Container. The following example uses the Amazon S3 client to upload a file.
$s3 = App::make('aws')->get('s3'); $s3->putObject(array( 'Bucket' => 'YOUR_BUCKET', 'Key' => 'YOUR_OBJECT_KEY', 'SourceFile' => '/the/path/to/the/file/you/are/uploading.ext', ));
If the AWS facade is registered within the aliases
section of the application configuration, you can also use the
following technique.
$s3 = AWS::get('s3'); $s3->putObject(array( 'Bucket' => 'YOUR_BUCKET', 'Key' => 'YOUR_OBJECT_KEY', 'SourceFile' => '/the/path/to/the/file/you/are/uploading.ext', ));