PHPackages                             icyboy/lumen-aws-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File &amp; Storage](/categories/file-storage)
4. /
5. icyboy/lumen-aws-sdk

ActiveLibrary[File &amp; Storage](/categories/file-storage)

icyboy/lumen-aws-sdk
====================

A simple lumen 5 service provider for including the AWS SDK for PHP.

1.0.2(9y ago)013.9k[1 issues](https://github.com/icyxp/lumen-aws-sdk/issues)Apache-2.0PHPPHP &gt;=5.5.9

Since Nov 1Pushed 9y ago1 watchersCompare

[ Source](https://github.com/icyxp/lumen-aws-sdk)[ Packagist](https://packagist.org/packages/icyboy/lumen-aws-sdk)[ Docs](http://aws.amazon.com/sdkforphp2)[ RSS](/packages/icyboy-lumen-aws-sdk/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (3)Versions (4)Used By (0)

AWS Service Provider for Lumen 5
================================

[](#aws-service-provider-for-lumen-5)

This is a simple [Lumen](http://lumen.laravel.com/) service provider for making it easy to include the official [AWS SDK for PHP](https://github.com/aws/aws-sdk-php) in your Lumen applications.

This README is for version 1.x of the service provider, which is implemented to work with Version 3 of the AWS SDK for PHP and Lumen 5.X.

Installation
------------

[](#installation)

The AWS Service Provider can be installed via [Composer](http://getcomposer.org) by requiring the `icyboy/lumen-aws-sdk` package in your project's `composer.json`.

```
{
    "require": {
        "icyboy/lumen-aws-sdk": "^1.0"
    }
}
```

Then run a composer update

```
php composer.phar update
```

To use the AWS Service Provider, you must register the provider when bootstrapping your Lumen application.

Find the `providers` key in your `bootstarp/app.php` and register the AWS Service Provider.

```
    $app->register(Icyboy\LumenAws\AwsServiceProvider::class);

    class_alias('Icyboy\LumenAws\AwsFacade', 'Aws');
```

Configuration
-------------

[](#configuration)

By default, the package uses the following environment variables to auto-configure the plugin without modification:

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

```

To customize the configuration file, publish the package configuration using Artisan.

```
php artisan vendor:publish
```

Update your settings in the generated `config/aws.php` configuration file.

```
return [
    'credentials' => [
        'key'    => 'YOUR_AWS_ACCESS_KEY_ID',
        'secret' => 'YOUR_AWS_SECRET_ACCESS_KEY',
    ],
    'region' => 'us-west-2',
    'version' => 'latest',

    // You can override settings for specific services
    'Ses' => [
        'region' => 'us-east-1',
    ],

    // if you use fake s3, you must used endpoint
    'endpoint' => "http://xxxx",
];
```

Usage
-----

[](#usage)

```
$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',
));
```

If the AWS facade is registered within the `aliases` section of the application configuration, you can also use the following technique.

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

Links
-----

[](#links)

- [AWS SDK for PHP on Github](http://github.com/aws/aws-sdk-php/)
- [AWS SDK for PHP website](http://aws.amazon.com/sdkforphp/)
- [AWS on Packagist](https://packagist.org/packages/aws/)
- [License](http://aws.amazon.com/apache2.0/)
- [Lumen website](http://lumen.laravel.com/)

###  Health Score

30

—

LowBetter than 62% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

3528d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/278335?v=4)[icyboy](/maintainers/icyboy)[@icyboy](https://github.com/icyboy)

---

Top Contributors

[![icyxp](https://avatars.githubusercontent.com/u/1527903?v=4)](https://github.com/icyxp "icyxp (6 commits)")

---

Tags

amazons3sdkawsdynamodbec2lumenlumen 5

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/icyboy-lumen-aws-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/icyboy-lumen-aws-sdk/health.svg)](https://phpackages.com/packages/icyboy-lumen-aws-sdk)
```

###  Alternatives

[aws/aws-sdk-php-laravel

A simple Laravel 9/10/11/12/13 service provider for including the AWS SDK for PHP.

1.7k37.3M83](/packages/aws-aws-sdk-php-laravel)[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.2k532.1M2.5k](/packages/aws-aws-sdk-php)[aws/aws-sdk-php-resources

A resource-oriented API for interacting with AWS services

1361.9M13](/packages/aws-aws-sdk-php-resources)[aws/aws-sdk-php-silex

A simple Silex service provider for including the AWS SDK for PHP.

81627.6k2](/packages/aws-aws-sdk-php-silex)[fedemotta/yii2-aws-sdk

This extension provides the AWS SDK integration for the Yii2 framework

14443.7k2](/packages/fedemotta-yii2-aws-sdk)[platinumpixs/aws-symfony2-bundle

A simple Symfony 2 bundle for including the AWS SDK for PHP.

1374.3k1](/packages/platinumpixs-aws-symfony2-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
