Search by

uxf / storage

uxf

Package info

gitlab.com/uxf/storage

Issues

pkg:composer/uxf/storage

Statistics

Installs: 20 480

Dependents: 4

Suggesters: 0

Stars: 0

3.90.0 2026-11-18 14:39 UTC

This package is auto-updated.

Last update: 2026-11-18 13:49:48 UTC


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
        ],
    ]);
};
StorageDSNcomposer
Locallocal://default/%kernel.project_dir%/public/upload
AWS S3aws://key:secret@domain.com/bucketleague/flysystem-async-aws-s3
Azureazure://accountName:accountKey@core.windows.net/containerleague/flysystem-azure-blob-storage
S3s3://key:secret@domain.com/bucket
S3 https3://key:secret@domain.com/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);
    }
}

Security

Autorizace endpointů. Bundle registruje HTTP endpointy pod /api/cms/storage/** (upload, čtení, patch, delete, copy) a sám na nich neprovádí žádnou autorizaci – objekt se načítá pouze podle id z URL. Hostitelská aplikace je musí ochránit firewallem, jinak hrozí neoprávněný přístup a IDOR (čtení/úprava/smazání cizích souborů podle uhádnutého id):

// config/packages/security.php
'access_control' => [
    ['path' => '^/api/cms', 'roles' => 'ROLE_ADMIN'],
],

Pokud je potřeba autorizace na úrovni jednotlivého objektu (ownership), doplňte ji ve vlastním controlleru / voteru.

Upload. Bundle přebírá MIME typ i příponu tak, jak je deklaruje klient – obsah souboru se nevaliduje. Uložit tedy lze i aktivní obsah (SVG, HTML, .php, …); ochrana je plně na hostitelské aplikaci. U local storage do web-rootu (public/upload) hrozí RCE a same-origin stored XSS, na S3/Azure hrozí stored XSS na originu bucketu/CDN (objekty se zapisují jako veřejné a Flysystem jim nastavuje Content-Type odvozený z obsahu).

Servírování. Uživatelský obsah proto servírujte výhradně z odděleného originu / CDN (bez sdílené parent domény a cookies s aplikací), nebo s hlavičkami Content-Disposition: attachment a Content-Type: application/octet-stream, aby ho prohlížeč neinterpretoval v kontextu aplikace.