PHPackages                             bf-dsf/aws-wrappers - 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. [HTTP &amp; Networking](/categories/http)
4. /
5. bf-dsf/aws-wrappers

ActiveLibrary[HTTP &amp; Networking](/categories/http)

bf-dsf/aws-wrappers
===================

Wrappers for AWS SDK

v2.14.5(3y ago)0172.9k↓66.7%1[1 PRs](https://github.com/bf-dsf/php-aws-wrappers/pulls)1MITPHPPHP ^7.1 || ^8.0

Since Dec 29Pushed 2y agoCompare

[ Source](https://github.com/bf-dsf/php-aws-wrappers)[ Packagist](https://packagist.org/packages/bf-dsf/aws-wrappers)[ RSS](/packages/bf-dsf-aws-wrappers/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (7)Versions (82)Used By (1)

bf-dsf/aws-wrappers
===================

[](#bf-dsfaws-wrappers)

The bf-dsf/aws-wrappers component provides a collection of object oriented warppers for Amazon's official [aws/aws-php-sdk](https://github.com/aws/aws-sdk-php/ "Official Repository").

Features
--------

[](#features)

- Only a limited number of widely used AWS services are wrapped.
- One purpose of using the wrapper class is to avoid having to remember too many string constants in AWS SDK.
- The wrapper classes provides simple-and-clear interface by sacrificing many advnaced feature of the original SDK.
- The wrapper classes are extendable, and it is appreciated if you can help extend the wrappers' functionalities.

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

[](#installation)

The bf-dsf/aws-wrappers is an open-source component available at `packagist.org`. To require the package, try the following in your project directory:

```
composer require bf-dsf/aws-wrappers
```

Prerequisite
------------

[](#prerequisite)

#### Credentials

[](#credentials)

Because bf-dsf/aws-wrappers is only a wrapper on top of [aws/aws-php-sdk](https://github.com/aws/aws-sdk-php/ "Official Repository"), it relies on the official SDK to authenticate client credentials. Please refer to the [official documentation](http://docs.aws.amazon.com/aws-sdk-php/v3/guide/guide/credentials.html "Official Documentation") to find out how you specify credentials to the SDK

The most commonly used credential supplying method is to use the **Profile**. You will need to setup a correct AWS profile as instructed below:

Please prepare your `~/.aws/credentials` file with permission 600 and content like below:

```
[tester]
aws_access_key_id =
aws_secret_access_key =
```

After that, you can specify the profile name when constructing a wrapped client object, e.g. `"profile" => "tester"`

> **NOTE**: you may also use the `"credentials"` parameter to make use of other authentication/authorization methods

> **NOTE**: if your project runs on an EC2 server and use the IAM role of the EC2 server as authentication method, you can specify `"iamrole" => true` instead of giving `"profile"` or `"credentials"`

#### Policy Permission

[](#policy-permission)

When using AWS SDK, one thing that is overlooked most of the time is the policy permission. You will have to visit the AWS IAM console to attach correct policy to your IAM account used in the profile setup. Detailed discussion on how to setup a correct policy using policy generator can be found [here](http://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-generator).

Service Wrappers
----------------

[](#service-wrappers)

- [DynamoDB](docs/DynamoDB.md)
- [SNS](docs/SnsPublisher.md)
- [Redshift import/export](docs/Redshift.md)
- [S3](docs/S3Client.md)
- [SQS](docs/SQS.md)

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity30

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity83

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 91.5% 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 ~33 days

Recently: every ~66 days

Total

79

Last Release

1211d ago

Major Versions

v1.7.1 → v2.0.02017-01-06

### Community

Maintainers

![](https://www.gravatar.com/avatar/c132fa184536d80e68463c9b8fe248aebd287cc898b5ef38c47257047e9a73e2?d=identicon)[bf-dsf](/maintainers/bf-dsf)

---

Top Contributors

[![no7mks](https://avatars.githubusercontent.com/u/1235585?v=4)](https://github.com/no7mks "no7mks (86 commits)")[![Darlinkster](https://avatars.githubusercontent.com/u/8401495?v=4)](https://github.com/Darlinkster "Darlinkster (4 commits)")[![joseph11](https://avatars.githubusercontent.com/u/1120228?v=4)](https://github.com/joseph11 "joseph11 (2 commits)")[![zhangxuchang](https://avatars.githubusercontent.com/u/9128453?v=4)](https://github.com/zhangxuchang "zhangxuchang (2 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/bf-dsf-aws-wrappers/health.svg)

```
[![Health](https://phpackages.com/badges/bf-dsf-aws-wrappers/health.svg)](https://phpackages.com/packages/bf-dsf-aws-wrappers)
```

###  Alternatives

[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)[api-platform/doctrine-common

Common files used by api-platform/doctrine-orm and api-platform/doctrine-odm

223.1M19](/packages/api-platform-doctrine-common)[georgeboot/laravel-echo-api-gateway

Use Laravel Echo with API Gateway Websockets

10435.5k](/packages/georgeboot-laravel-echo-api-gateway)[meema/laravel-cloudfront

Easily &amp; quickly integrate your application with AWS CloudFront.

31113.4k](/packages/meema-laravel-cloudfront)

PHPackages © 2026

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