bnagydeveloper/aws-sdk-php-laravel

一个简单的Laravel 4服务提供者,用于包含AWS SDK v3 for PHP。

3.4.0 2019-09-09 21:00 UTC

README

@awsforphp on Twitter Build Status Latest Stable Version Total Downloads Gitter

这是一个简单的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.0aws/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',
));

链接