bnagydeveloper / aws-sdk-php-laravel
一个简单的Laravel 4服务提供者,用于包含AWS SDK v3 for PHP。
Requires
- php: >=5.5.9
- aws/aws-sdk-php: ~3.0
- illuminate/support: ~5.1|~6.0
Requires (Dev)
- phpunit/phpunit: ~4.0|~5.0
- vlucas/phpdotenv: ~2.0|~3.0
Suggests
- laravel/framework: To test the Laravel bindings
- laravel/lumen-framework: To test the Lumen bindings
README
这是一个简单的Laravel服务提供者,用于轻松地将官方AWS SDK for PHP集成到您的Laravel和Lumen应用程序中。
此README是针对服务提供者的3.x版本,该版本与AWS SDK for PHP的3版和Laravel 5.1兼容。
主要版本
- 3.x (您在这里) - 对于
laravel/framework:~5.1|~6.0
和aws/aws-sdk-php:~3.0
- 2.x (2.0分支) - 对于
laravel/framework:5.0.*
和aws/aws-sdk-php:~2.4
- 1.x (1.0分支) - 对于
laravel/framework:4.*
和aws/aws-sdk-php:~2.4
安装
可以通过在项目的 composer.json
中要求 aws/aws-sdk-php-laravel
包来通过 Composer 安装AWS服务提供者。
{ "require": { "aws/aws-sdk-php-laravel": "~3.0" } }
然后运行composer update
php composer.phar update
要使用AWS服务提供者,您必须在启动应用程序时注册提供者。
Lumen
在Lumen中,在 bootstrap/app.php
中找到 Register Service Providers
并注册AWS服务提供者。
$app->register(Aws\Laravel\AwsServiceProvider::class);
Laravel
在Laravel中,在 config/app.php
中找到 providers
键并注册AWS服务提供者。
'providers' => array( // ... Aws\Laravel\AwsServiceProvider::class, )
在 config/app.php
中找到 aliases
键并添加AWS外观别名。
'aliases' => array( // ... 'AWS' => Aws\Laravel\AwsFacade::class, )
配置
默认情况下,该软件包使用以下环境变量来自动配置插件,无需修改
AWS_ACCESS_KEY_ID
AWS_SECRET_ACCESS_KEY
AWS_REGION (default = us-east-1)
要自定义配置文件,请使用Artisan发布软件包配置。
php artisan vendor:publish --provider="Aws\Laravel\AwsServiceProvider"
设置可以在生成的 config/aws.php
配置文件中找到。默认情况下,凭据和区域设置将来自您的 .env
文件。
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', ], ];
请注意,如果您想使用默认SDK配置提供者链,则可以始终删除此文件中的 credentials
行。
根据Laravel 5.2.0 升级指南,如果您使用php artisan config:cache
,则必须使用配置文件而不是环境变量选项。
有关如何在SDK的用户指南上配置SDK的更多信息,请参阅。
用法
为了在您的应用程序中使用AWS SDK for PHP,您需要从Laravel服务容器获取它。以下示例使用Amazon S3客户端上传文件。
$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', ));
如果AWS外观在应用程序配置的 aliases
部分中注册,您还可以使用以下技术。
$s3 = AWS::createClient('s3'); $s3->putObject(array( 'Bucket' => 'YOUR_BUCKET', 'Key' => 'YOUR_OBJECT_KEY', 'SourceFile' => '/the/path/to/the/file/you/are/uploading.ext', ));