PHPackages                             kiwfy/aws-bucket-php - 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 & Networking](/categories/http)
4. /
5. kiwfy/aws-bucket-php

Abandoned → [not-empty/aws-bucket-php-lib](/?search=not-empty%2Faws-bucket-php-lib)Library[HTTP & Networking](/categories/http)

kiwfy/aws-bucket-php
====================

PHP library to connect to and use AWS S3 Bucket

8.0.0(6mo ago)497GPL-3.0-onlyPHPPHP ^8.4CI passing

Since Nov 3Pushed 6mo ago2 watchersCompare

[ Source](https://github.com/not-empty/aws-bucket-php-lib)[ Packagist](https://packagist.org/packages/kiwfy/aws-bucket-php)[ RSS](/packages/kiwfy-aws-bucket-php/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (8)Dependencies (6)Versions (10)Used By (0)

AWS Bucket PHP
==============

[](#aws-bucket-php)

[![Latest Version](https://camo.githubusercontent.com/1d04514ab55785a5faa48096263b6749eb9e77c14b374baa808794cd4311b9e3/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6e6f742d656d7074792f6177732d6275636b65742d7068702d6c69622e7376673f7374796c653d666c61742d737175617265)](https://github.com/not-empty/aws-bucket-php-lib/releases)[![codecov](https://camo.githubusercontent.com/713f55c2420c92bc5d3c19c4b1652b89ce1091ce506738f77d27fb496b753cbf/68747470733a2f2f636f6465636f762e696f2f67682f6e6f742d656d7074792f6177732d6275636b65742d7068702d6c69622f67726170682f62616467652e7376673f746f6b656e3d41454d56313633555736)](https://codecov.io/gh/not-empty/aws-bucket-php-lib)[![CI Build](https://camo.githubusercontent.com/4009d4aedfb3d4df6761e2f9911368631ff79b52b661070678ff7f98259ab313/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6e6f742d656d7074792f6177732d6275636b65742d7068702d6c69622f7068702e796d6c)](https://github.com/not-empty/aws-bucket-php-lib/actions/workflows/php.yml)[![Downloads Old](https://camo.githubusercontent.com/593c19b647c805744d710e3e2d358aded3d31f1855efa78feba0543a4c33e87b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6b697766792f6177732d6275636b65742d7068703f6c6f676f3d6f6c64266c6162656c3d646f776e6c6f6164732532306c6567616379)](https://packagist.org/packages/kiwfy/aws-bucket-php)[![Downloads](https://camo.githubusercontent.com/8940dc8dd794b02d554ff4e86e11bfec5d5e75b114496a9dcf6e2074b609bb76/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e6f742d656d7074792f6177732d6275636b65742d7068702d6c69623f6c6f676f3d6f6c64266c6162656c3d646f776e6c6f616473)](https://packagist.org/packages/not-empty/aws-bucket-php-lib)[![PRs Welcome](https://camo.githubusercontent.com/25b3e6d0d42c98de74a98cbb4d149a1c09020cf6d1361993b72d7d5b8ffed363/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5052732d77656c636f6d652d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](http://makeapullrequest.com)[![Packagist License (custom server)](https://camo.githubusercontent.com/cc1a0aa59c7abe9da625c7ba4838f72b740d3247e3093a1d0cdf3aed0b8e3f5c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6e6f742d656d7074792f6177732d6275636b65742d7068702d6c6962)](https://github.com/not-empty/aws-bucket-php-lib/blob/master/LICENSE)

PHP library to connect to and use AWS S3 Bucket.

### Installation

[](#installation)

[Release 8.0.0](https://github.com/not-empty/aws-bucket-php-lib/releases/tag/8.0.0) Requires [PHP](https://php.net) 8.4

[Release 7.0.0](https://github.com/not-empty/aws-bucket-php-lib/releases/tag/7.0.0) Requires [PHP](https://php.net) 8.3

[Release 6.0.0](https://github.com/not-empty/aws-bucket-php-lib/releases/tag/6.0.0) Requires [PHP](https://php.net) 8.2

[Release 5.0.0](https://github.com/not-empty/aws-bucket-php-lib/releases/tag/5.0.0) Requires [PHP](https://php.net) 8.1

[Release 4.0.0](https://github.com/not-empty/aws-bucket-php-lib/releases/tag/4.0.0) Requires [PHP](https://php.net) 7.4

[Release 3.0.0](https://github.com/not-empty/aws-bucket-php-lib/releases/tag/2.0.0) Requires [PHP](https://php.net) 7.3

[Release 2.0.0](https://github.com/not-empty/aws-bucket-php-lib/releases/tag/2.0.0) Requires [PHP](https://php.net) 7.2

[Release 1.0.0](https://github.com/not-empty/aws-bucket-php-lib/releases/tag/1.0.0) Requires [PHP](https://php.net) 7.1

The recommended way to install is through [Composer](https://getcomposer.org/).

```
composer require not-empty/aws-bucket-php-lib
```

### Usage

[](#usage)

Putting a file

```
use AwsBucket\AwsBucket;
$config = [
   'credentials' => [
       'key' => '', //you must put your aws iam key here
       'secret' => '', //you must put your aws iam secret here
   ],
   'version' => 'latest',
   'region' => 'us-east-1', //you must put your bucket region here
];
$awsBucket = new AwsBucket($config);
$bucket = 'my-bucket'; //you must put your bucket name here
$content = 'this is your file content';
$name = 'sample';
$extension = 'txt';
$putFile = $awsBucket->putFile(
    $bucket,
    $content,
    $name,
    $extension
);
var_dump($putFile);
```

Listing files

```
$listFiles = $awsBucket->listFiles(
    $bucket
);
var_dump($listFiles);
```

If you getting 403 or 400 erros, you must configure your bucket permitions, in AWS console to allow the files uploads.

if you want an environment to run or test it, you can build and install dependences like this

```
docker build --build-arg PHP_VERSION=8.4-cli -t not-empty/aws-bucket-php-lib:php84 -f contrib/Dockerfile .
```

Access the container

```
docker run --name aws-bucket-php-lib -v ${PWD}/:/var/www/html -it not-empty/aws-bucket-php-lib:php84 bash
```

Verify if all dependencies is installed

```
composer install --no-dev --prefer-dist
```

put your credentials, region and name of bucket in sample file sample/aws-bucket-sample.php

```
...
$config = [
   'credentials' => [
       'key' => '', //you must put your aws iam key here
       'secret' => '', //you must put your aws iam secret here
   ],
   'version' => 'latest',
   'region' => 'us-east-1', //you must put your bucket region here
];
$bucket = 'my-bucket'; //you must put your bucket name here
```

and run

```
php sample/aws-bucket-sample.php
```

### Development

[](#development)

Want to contribute? Great!

The project using a simple code. Make a change in your file and be careful with your updates! **Any new code will only be accepted with all validations.**

To ensure that the entire project is fine:

First you need to building a correct environment to install all dependences

```
docker build --build-arg PHP_VERSION=8.4-cli -t not-empty/aws-bucket-php-lib:php84 -f contrib/Dockerfile .
```

Access the container

```
docker run --name aws-bucket-php-lib -v ${PWD}/:/var/www/html -it not-empty/aws-bucket-php-lib:php84 bash
```

Install all dependences

```
composer install --dev --prefer-dist
```

Run all validations

```
composer check
```

**Not Empty Foundation - Free codes, full minds**

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance66

Regular maintenance activity

Popularity15

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 76.9% 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 ~116 days

Recently: every ~204 days

Total

8

Last Release

202d ago

Major Versions

2.0.0 → 4.0.02023-11-03

3.0.0 → 5.0.02023-11-03

5.0.0 → 6.0.02023-11-03

6.0.0 → 7.0.02023-11-27

7.0.0 → 8.0.02026-01-27

PHP version history (8 changes)1.0.0PHP ^7.1

2.0.0PHP ^7.2

4.0.0PHP ^7.4

3.0.0PHP ^7.3

5.0.0PHP ^8.1

6.0.0PHP ^8.2

7.0.0PHP ^8.3

8.0.0PHP ^8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/3a8e537dba9018eff457d477dba8f79158989b41ca86bd74d1c4a1186c158caa?d=identicon)[kiwfy](/maintainers/kiwfy)

---

Top Contributors

[![leodisarli](https://avatars.githubusercontent.com/u/1638455?v=4)](https://github.com/leodisarli "leodisarli (10 commits)")[![brunavitoria](https://avatars.githubusercontent.com/u/43785466?v=4)](https://github.com/brunavitoria "brunavitoria (2 commits)")[![RafaJEstabile](https://avatars.githubusercontent.com/u/149419100?v=4)](https://github.com/RafaJEstabile "RafaJEstabile (1 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/kiwfy-aws-bucket-php/health.svg)

```
[![Health](https://phpackages.com/badges/kiwfy-aws-bucket-php/health.svg)](https://phpackages.com/packages/kiwfy-aws-bucket-php)
```

###  Alternatives

[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.7k293.8M1.2k](/packages/league-flysystem-aws-s3-v3)[laravel/ai

The official AI SDK for Laravel.

1.1k4.6M319](/packages/laravel-ai)[leantime/leantime

Open source project management system for non-project managers. Simple like Trello, powerful like Jira. Built with neurodiversity in mind.

11.3k4.0k](/packages/leantime-leantime)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

45844.8k1](/packages/pressbooks-pressbooks)[ellaisys/aws-cognito

Laravel Authentication using AWS Cognito (Web and API)

121269.8k1](/packages/ellaisys-aws-cognito)[altis/core

Core module for Altis

19233.0k4](/packages/altis-core)

PHPackages © 2026

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