cakephp-file-storageFile Storage for CakePHP

Upload, store, and serve files in virtually any backend — built on FlySystem with image variants, signed URLs, and a self-contained admin backend.

Get Started

Quick Start

Serving Files

View on GitHub

🗄️

Any Storage Backend

Local filesystem, S3, Azure, in-memory, and more through the FlySystem-based adapter abstraction. Swap backends without touching your app code.

🧩

Separation of Concerns

A file is always a row in the file_storage table. The table references the real location and keeps metadata — no file paths scattered across your schema.

🖼️

Image Variants

Generate thumbnails, crops, and modern AVIF/WebP formats with a fluent variant API, an Image helper, and a regeneration command.

🔐

Signed URLs

Built-in HMAC-signed serving for temporary, authentication-free access — with HTTP Range support for video and audio on local adapters.

🛠️

Admin Backend

A self-contained, fail-closed Bootstrap 5 admin UI for browsing files, bulk deletes, and storage cleanup — opt in when you want it.

✅

Upload Validation

Server-side MIME sniffing, extension allow-lists, size limits, and image dimension checks via reusable validation traits.