uxf/storage

3.80.3 2026-06-10 11:04 UTC

Requires

• php: ^8.4
• ext-json: *
• league/flysystem: ^3.0
• league/flysystem-async-aws-s3: ^3.0
• ramsey/uuid-doctrine: ^2.0
• uxf/core: 3.80.3

Suggests

• azure-oss/storage-blob-flysystem: Allow use Azure Blob Storage
• league/flysystem-async-aws-s3: Allow use S3

MIT

• UXF

README

Install

$ composer req uxf/storage

Migration

$this->addSql("
    INSERT INTO uxf_storage.object
    (parent_id, file_id, document_id, name, path, variant, \"order\", deleted, created_at, updated_at, type, locked)
    VALUES
    (NULL, NULL, NULL, '', '/', 'basic', 0, FALSE, NOW(), NOW(), 'folder', TRUE)
");

Config

// config/routes/uxf.php
use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;

return static function (RoutingConfigurator $routes): void {
    $routes->import('@UXFStorageBundle/config/routes.php');
};

// config/packages/uxf.php
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $containerConfigurator->extension('uxf_storage', [
        'filesystems' => [
            'default' => '%env(STORAGE_DSN)%', // default local
        ],
    ]);
};

Storage	DSN	composer
Local	local://default/%kernel.project_dir%/public/upload
AWS S3	aws://key:[e-mail]/bucket	league/flysystem-async-aws-s3
Azure	azure://accountName:[e-mail]/container	league/flysystem-azure-blob-storage
S3	s3://key:[e-mail]/bucket
S3 http	s3://key:[e-mail]/bucket?schema=http

Usage

FileCreator

use League\Flysystem\FilesystemOperator;
use Symfony\Component\HttpFoundation\File\UploadedFile;
use UXF\Core\SystemProvider\Uuid;
use UXF\Storage\Entity\File;
use UXF\Storage\Entity\Image;
use UXF\Storage\Utils\DestinationDirHelper;
use UXF\Storage\Utils\MimeTypeHelper;

class UploadedFileCreator implements FileCreator
{
    public function __construct(private readonly FilesystemOperator $defaultFilesystem)
    {
    }

    public function createFile(object $file, ?string $namespace): ?File
    {
        if (!$file instanceof UploadedFile) {
            return null;
        }

        $uuid = Uuid::uuid4();

        $type = $file->getClientMimeType();
        $ext = $file->getClientOriginalExtension();
        $ext = $ext !== '' ? $ext : (MimeTypeHelper::convertToExtension($type) ?? 'jpg');
        $size = $file->getSize();
        $raw = $file->getContent();

        $destDir = DestinationDirHelper::getDir($uuid, $namespace);
        $this->defaultFilesystem->write("$destDir/$uuid.$ext", $file->getContent());

        $originalName = $file->getClientOriginalName();

        if (MimeTypeHelper::isImage($type)) {
            $result = getimagesizefromstring($raw);
            assert($result !== false);
            [$width, $height] = $result;
            return new Image($uuid, $ext, $type, $originalName, $namespace, $size, $width ?? 0, $height ?? 0);
        }

        return new File($uuid, $ext, $type, $originalName, $namespace, $size);
    }
}