README

Fork of league/flysystem-aws-s3-v3 with extended PHP compatibility.

• PHP 7.4 – 8.4
• Flysystem 2.x (PHP 7.4+)
• Flysystem 3.x (PHP 8.0+)

Installation

composer require aclyte/flysystem-aws-s3-v3

PHP version notes

On PHP 7.4, Composer may resolve an older aws/aws-sdk-php release. That is expected.

Usage

Using Aws\S3\S3Client:

<?php

use Aws\S3\S3Client;
use League\Flysystem\AwsS3V3\AwsS3V3Adapter;
use League\Flysystem\Filesystem;

require __DIR__ . '/vendor/autoload.php';

$client = new S3Client([
    'credentials' => [
        'key'    => 'your-key',
        'secret' => 'your-secret',
    ],
    'region' => 'your-region',
    'version' => 'latest',
]);

$adapter = new AwsS3V3Adapter($client, 'your-bucket-name');
$filesystem = new Filesystem($adapter);

Using Aws\S3\S3MultiRegionClient (no region required):

<?php

use Aws\S3\S3MultiRegionClient;
use League\Flysystem\AwsS3V3\AwsS3V3Adapter;
use League\Flysystem\Filesystem;

require __DIR__ . '/vendor/autoload.php';

$client = new S3MultiRegionClient([
    'credentials' => [
        'key'    => 'your-key',
        'secret' => 'your-secret',
    ],
    'version' => 'latest',
]);

$adapter = new AwsS3V3Adapter($client, 'your-bucket-name');
$filesystem = new Filesystem($adapter);

Publishing on Packagist

1. Push this repository to GitHub (public).
2. Create a release tag, for example 1.1.0:

   git tag -a 1.1.0 -m "PHP 7.4–8.4 compatibility"
   git push origin 1.1.0

3. Register the package at packagist.org:
   • Repository URL: https://github.com/aclyte/flysystem-aws-s3-v3
4. Enable the Packagist GitHub hook so new tags are picked up automatically.

Note: This repository may contain legacy upstream git tags. Packagist imports all tags as versions. For a clean version history, publish only tags that match this fork (for example 1.1.x).

License

MIT. See LICENSE.