PHPackages                             reconnect/s3bundle - 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. reconnect/s3bundle

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

reconnect/s3bundle
==================

Symfony S3 Bundle

3.0.0(5mo ago)44.5k3MITPHPPHP >=7.4.0

Since Jan 31Pushed 5mo agoCompare

[ Source](https://github.com/re-connect/s3Bundle)[ Packagist](https://packagist.org/packages/reconnect/s3bundle)[ RSS](/packages/reconnect-s3bundle/feed)WikiDiscussions main Synced yesterday

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

S3Bundle
========

[](#s3bundle)

S3Bundle helps you connect you Symfony application to a S3 bucket, or any bucket that implements S3 API. It is a wrapper around the great `league/flysystem-aws-s3-v3` library

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

[](#installation)

```
composer require reconnect/s3bundle
```

If you are not using Symfony flex, you will need a few extra steps to enable and configure the bundle

Usage
-----

[](#usage)

You need to update the following environment variables to make this bundle works

```
BUCKET_HOST=http://localhost:9000/ // For a local bucket for example
BUCKET_NAME=files
BUCKET_KEY=files_access
BUCKET_SECRET=files_secret
```

Then, you can inject the `FlysystemS3Client.php` to do some common operations on buckets, such as :

### Fetching a document presigned URL

[](#fetching-a-document-presigned-url)

```
use Reconnect\S3Bundle\Service\FlysystemS3Client;
// ...
private FlysystemS3Client $S3Client;

public function __construct(FlysystemS3Client $s3Adapter)
{
    $this->documentService = $S3Client;
}
// ...
// The  $objectKey is the key we used to identify the file in the bucket
$presignedUrl = $S3Client->getPresignedUrl($objectKey);
```

### Posting a document

[](#posting-a-document)

```
use Reconnect\S3Bundle\Service\FlysystemS3Client;
// ...
private FlysystemS3Client $S3Client;

public function __construct(FlysystemS3Client $s3Adapter)
{
    $this->documentService = $S3Client;
}
// ...
// Get a file as an instance of File
// This method returns the key of the uploaded file in the bucket
// This $key is a random UuidV4
$key = $S3Client->uploadFile($file);
```

### Generating a thumbnail

[](#generating-a-thumbnail)

You can also generate a thumbnail, it handles images and pdfs

```
use Reconnect\S3Bundle\Service\FlysystemS3Client;
// ...
private FlysystemS3Client $S3Client;

public function __construct(FlysystemS3Client $s3Adapter)
{
    $this->documentService = $S3Client;
}
// ...
// Get a file as an instance of UploadedFile
// This method returns the key of the uploaded thumbnail file in the bucket
// This $key is a random UuidV4
$thumbnailKey = $S3Client->generateThumbnail($file);
```

Configuration reference
-----------------------

[](#configuration-reference)

```
# Default configuration for extension with alias: "reconnect_s3"
reconnect_s3:
    bucketHost: ~ # Required
    bucketName: ~ # Required
    bucketKey: ~ # Required
    bucketSecret: ~ # Required
```

if you use .env file, you can import values from the env file

```
reconnect_s3:
    bucketHost: '%env(BUCKET_HOST)%'
    bucketName: '%env(BUCKET_NAME)%'
    bucketKey: '%env(BUCKET_KEY)%'
    bucketSecret: '%env(BUCKET_SECRET)%'
```

and define them in the .env file

```
BUCKET_HOST=https://localhost:9000/
BUCKET_NAME=bucket
BUCKET_KEY=bucket_key
BUCKET_SECRET=bucket_secret
```

###  Health Score

47

—

FairBetter than 93% of packages

Maintenance71

Regular maintenance activity

Popularity30

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 91.1% 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 ~86 days

Recently: every ~34 days

Total

22

Last Release

166d ago

Major Versions

v0.1.6 → v1.0.72021-05-11

1.6.0 → 2.0.02025-12-08

2.0.0 → 3.0.02026-01-18

PHP version history (2 changes)0.1.0PHP 7.4.\*

v1.0.7PHP >=7.4.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/ed541f8629a852368ada574098bd82db5f1eb2ac785e419adbdef3cc9685e7be?d=identicon)[tcheymol](/maintainers/tcheymol)

---

Top Contributors

[![tcheymol](https://avatars.githubusercontent.com/u/9215726?v=4)](https://github.com/tcheymol "tcheymol (41 commits)")[![NilsRec](https://avatars.githubusercontent.com/u/112855393?v=4)](https://github.com/NilsRec "NilsRec (2 commits)")[![AntoineAresu](https://avatars.githubusercontent.com/u/81411164?v=4)](https://github.com/AntoineAresu "AntoineAresu (1 commits)")[![vdev85](https://avatars.githubusercontent.com/u/55835210?v=4)](https://github.com/vdev85 "vdev85 (1 commits)")

### Embed Badge

![Health badge](/badges/reconnect-s3bundle/health.svg)

```
[![Health](https://phpackages.com/badges/reconnect-s3bundle/health.svg)](https://phpackages.com/packages/reconnect-s3bundle)
```

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.9M388](/packages/easycorp-easyadmin-bundle)[flow-php/flow

PHP ETL - Extract Transform Load - Data processing framework

85036.3k](/packages/flow-php-flow)[open-dxp/opendxp

Content & Product Management Framework (CMS/PIM)

9421.6k61](/packages/open-dxp-opendxp)[chameleon-system/chameleon-base

The Chameleon System core.

1028.6k5](/packages/chameleon-system-chameleon-base)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M574](/packages/shopware-core)

PHPackages © 2026

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