PHPackages                             nzo/s3-aws-bundle - 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 & Storage](/categories/file-storage)
4. /
5. nzo/s3-aws-bundle

ActiveSymfony-bundle[File & Storage](/categories/file-storage)

nzo/s3-aws-bundle
=================

The NzoS3AwsBundle is a Symfony Bundle used to handle AWS S3 Files Upload.

v2.1.0(4y ago)1535MITPHPPHP >=7.1.3

Since Oct 31Pushed 4y ago1 watchersCompare

[ Source](https://github.com/nayzo/NzoS3AwsBundle)[ Packagist](https://packagist.org/packages/nzo/s3-aws-bundle)[ RSS](/packages/nzo-s3-aws-bundle/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (6)Dependencies (3)Versions (7)Used By (0)

NzoS3AwsBundle
==============

[](#nzos3awsbundle)

[![Build Status](https://camo.githubusercontent.com/199cdc04ad4514a8c21c139c28d56ab613bb4e2db210b21cb5684ad446623ac8/68747470733a2f2f7472617669732d63692e6f72672f6e61797a6f2f4e7a6f533341777342756e646c652e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/nayzo/NzoS3AwsBundle)[![Latest Stable Version](https://camo.githubusercontent.com/c293cce80b779d6c644c34f6ce2b65e0b94ab32a5b9f29c70aebb624a5a8c950/68747470733a2f2f706f7365722e707567782e6f72672f6e7a6f2f73332d6177732d62756e646c652f762f737461626c65)](https://packagist.org/packages/nzo/s3-aws-bundle)

The **NzoS3AwsBundle** is a Symfony Bundle used to handle **AWS S3** Files Upload.

##### Compatible with **Symfony >= 4.4**

[](#compatible-with-symfony--44)

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

[](#installation)

### Through Composer:

[](#through-composer)

```
$ composer require nzo/s3-aws-bundle

```

### Register the bundle in config/bundles.php (without Flex):

[](#register-the-bundle-in-configbundlesphp-without-flex)

```
// config/bundles.php

return [
    // ...
    Nzo\S3AwsBundle\NzoS3AwsBundle::class => ['all' => true],
];
```

### Configure your application's config.yml:

[](#configure-your-applications-configyml)

```
# config/packages/nzo_s3_aws.yaml

nzo_s3_aws:
    aws_access_key: '%env(AWS_ACCESS_KEY)%'  required:
    aws_secret:     '%env(AWS_SECRET)%'      required:
    aws_region:     '%env(AWS_REGION)%'      required:  (example: eu-west-1)
    aws_bucket:     '%env(AWS_BUCKET)%'      required:  (the bucket name)
    aws_endpoint:   '%env(AWS_ENDPOINT)%'    optional:
```

Usage
-----

[](#usage)

```
use Nzo\S3AwsBundle\S3\S3AwsHandler;

    private $s3AwsHandler;

    public function __construct(S3AwsHandler $s3AwsHandler)
    {
        $this->s3AwsHandler = $s3AwsHandler;

        // without autowiring use: $this->get('nzo_s3_aws')
    }

    public function uploadFilesToS3Aws(string $key, string $filePath)
    {
        try {

            // $key: it represent the file name and path in the S3 Bucket. Example: "my_folder/my-image.jpg"
            // $filePath: is the absolute path to the file. Example: "/var/www/my-image.jpg"

            $awsResult = $this->s3AwsHandler->uploadFile($key, $filePath);

            // Public ACL (default 'private')
            $acl = 'public-read';
            $awsResult = $this->s3AwsHandler->uploadFile($key, $filePath, $acl);

        } catch (\Exception $e) {
            // Unable to upload the file to AWS S3
        }
    }
```

License
-------

[](#license)

This bundle is under the MIT license. See the complete license in the bundle:

See [LICENSE](https://github.com/nayzo/NzoS3AwsBundle/tree/master/LICENSE)

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 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 ~80 days

Recently: every ~99 days

Total

6

Last Release

1616d ago

Major Versions

v1.1.1 → v2.0.02021-05-24

### Community

Maintainers

![](https://www.gravatar.com/avatar/43973d4c7b23026540ed9f2670200cbd664d7ae7c55126feb465e62ba7a2a86f?d=identicon)[nayzo](/maintainers/nayzo)

---

Top Contributors

[![nayzo](https://avatars.githubusercontent.com/u/1272883?v=4)](https://github.com/nayzo "nayzo (9 commits)")

---

Tags

amazons3awsfilesupload

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/nzo-s3-aws-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/nzo-s3-aws-bundle/health.svg)](https://phpackages.com/packages/nzo-s3-aws-bundle)
```

###  Alternatives

[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.6k263.6M788](/packages/league-flysystem-aws-s3-v3)[aws/aws-sdk-php-laravel

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

1.7k35.6M74](/packages/aws-aws-sdk-php-laravel)[vinelab/cdn

Content Delivery Network (CDN) Package for Laravel

217240.8k1](/packages/vinelab-cdn)[publiux/laravelcdn

Content Delivery Network (CDN) Package for Laravel

155230.4k](/packages/publiux-laravelcdn)[eddturtle/direct-upload

Composer Package to build an AWS Signature ready to Direct Upload to S3

88728.1k2](/packages/eddturtle-direct-upload)[aws/aws-sdk-php-resources

A resource-oriented API for interacting with AWS services

1381.8M10](/packages/aws-aws-sdk-php-resources)

PHPackages © 2026

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