FMElfinderBundle

FMElfinderBundle brings the elFinder web file manager into Symfony applications, giving your users a full-featured, jQuery UI-based interface to upload, browse, rename, move, and manage files and images directly in the browser. It exposes elFinder’s PHP connector through Symfony controllers and configuration so you can mount one or more file-management instances with just a few lines of YAML.

The bundle is built to pair with rich-text editors: it integrates cleanly with TinyMCE, CKEditor, and Summernote so content authors can pick or upload images and assets while editing. It supports multiple storage drivers, access-control hooks, and per-instance configuration, making it a common choice for CMS-style backends in Symfony.

What You Get

• A ready-to-mount elFinder file manager served through Symfony controllers and routes
• Configuration-driven instances with per-root drivers, permissions, and options
• Integration hooks for TinyMCE, CKEditor, and Summernote WYSIWYG editors
• An installer console command to publish elFinder’s front-end assets
• Event and security layers for customizing access and reacting to file operations
• Support for Flysystem and other elFinder drivers for varied storage backends

Common Use Cases

• Adding an image/asset picker to a WYSIWYG editor in a Symfony CMS
• Providing an admin file manager for uploading and organizing media
• Exposing a browser-based file browser over local or cloud storage
• Letting content editors manage downloads and documents without FTP

Under The Hood

Architecture - At the core, FMElfinderExtension and a Configuration tree read your bundle config, and an ElFinderConfigurationPass compiler pass plus ElFinderConfigurationReader build per-instance settings. ElFinderController serves the manager view and delegates file operations to ElFinderConnector/ElFinderBridge, which drive Studio-42’s elFinder connector. Additional layers cover Twig rendering, form type integration (TwigFormPass), events, security, and session handling, with an ElFinderInstallerCommand for asset publishing.

Tech Stack - PHP 8.1+ on Symfony 6.4/7/8 (framework-bundle, twig-bundle, form, asset, console) wrapping studio-42/elfinder ~2.1.62. The front end is elFinder’s jQuery UI client, with Twig templates and some JavaScript. Optional drivers (Flysystem, Dropbox) extend storage.

Code Quality - The project runs GitHub Actions tests with Codecov coverage and uses Symfony config/DI test helpers (matthiasnoback packages) plus php-cs-fixer. The tests/ tree mirrors the source structure across Command, Configuration, DependencyInjection, Event, and Form, indicating solid coverage of the bundle’s wiring.

API Design - Day-to-day use is declarative: developers configure named elFinder instances in YAML and drop a rendered widget into templates, rather than writing connector code by hand. The main cost is understanding elFinder’s configuration surface (roots, drivers, permissions), which the docs directory and editor-integration guides help flatten.