MIT Licensed

Secure file managementfor PHP and Symfony

An MIT-licensed file manager with local and S3-compatible storage, granular access control, resilient uploads and image tools.

Get started
Configuration
View on GitHub
Install in seconds
Composer
composer require sohophp/sofinder:^0.1@beta
Actively developed · MIT licensed · PHP 8.2+

Secure by design

Sandboxed paths, private quarantine, CSRF protection, inherited ACLs and operation gates.

Learn about security

Productive file browser

Responsive file browser with folders, previews, search, drag and drop, bulk operations and recycle bin.

Explore the interface

Flexible storage

Local and S3-compatible storage including AWS S3, Cloudflare R2 and MinIO.

Storage options

Framework-friendly core

Symfony bundle, public PHP contracts, events, tagged services and extensible APIs.

Integrate SoFinder

Ready for real applications

Image processing, resilient uploads, picker mode, stable asset IDs and private delivery.

Explore capabilities

Operationally bounded

Quotas, pagination, rate limits, maintenance commands and deploy-time security audits.

Production operations

30-second quick start

From install to your first file browser

Create a Symfony-authorized local file resource in three focused steps.

01

Install

Bash
composer require sohophp/sofinder:^0.1@beta
02

Configure storage

YAMLconfig/packages/so_finder.yaml
so_finder:
  resources:
    Files:
      adapter: local
      root: '%kernel.project_dir%/var/files'
      delivery_mode: proxy
      roles: [ROLE_USER]
Provider-independent

Choose storage behind one API

Start locally, then add the independent S3 adapter when needed. The core stays free of cloud-vendor coupling.

Compare storage options
LLocal Storage
S3AWS S3
R2Cloudflare R2
MMinIO
+Other S3-compatible providers
Editor integrations

Keep the picker editor-independent

CKEditor, TinyMCE and custom editors depend only on the public JavaScript API while authorization and storage remain consistent.

CKEditor 4CKEditor 5TinyMCECustom editorCustom picker
1Editor
2SoFinder JS API
3SoFinder Backend
4Storage
Explore editor integrations
MIT LicensedPHP 8.2+Symfony 6.4+S3 CompatibleOpen Source

Install in a Symfony application ​

bash
composer require sohophp/sofinder:^0.1@beta

Register the bundle, import its routes and define at least one storage resource. The installation guide provides a working minimal configuration; the Symfony guide covers authorization, delivery modes, UI options and host-generated URLs.

Beta release

SoFinder is currently in public beta. Pin an explicit beta constraint, read the changelog before upgrading and treat public extension interfaces according to the versioning policy.

Choose a storage model ​

RequirementRecommended setup
Public website imagesLocal or S3 storage with delivery_mode: public and an explicit public/CDN URL
Private documentsLocal or S3 storage with delivery_mode: proxy
Recoverable local deletionLocal adapter with the built-in private recycle bin
Recoverable S3 deletionProvider-side bucket versioning and lifecycle protection
Database-owned download URLsConfigure entry_url and provide host application context

Start with the storage adapter guide, or go directly to S3-compatible storage.

Using an existing installation? Start with the file manager user guide, image guide or editor integrations. Building an integration? See the developer guide and HTTP API reference.