PHPackages                             mezcalito/ux-filemanager - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File &amp; Storage](/categories/file-storage)
4. /
5. mezcalito/ux-filemanager

ActiveSymfony-bundle[File &amp; Storage](/categories/file-storage)

mezcalito/ux-filemanager
========================

Effortless file management with Symfony UX and Mezcalito UX FileManager

0.1.7(6mo ago)222.4k↑33.9%2[2 issues](https://github.com/Mezcalito/ux-filemanager/issues)MITPHPPHP &gt;=8.3CI passing

Since Aug 20Pushed 6mo ago4 watchersCompare

[ Source](https://github.com/Mezcalito/ux-filemanager)[ Packagist](https://packagist.org/packages/mezcalito/ux-filemanager)[ Docs](https://github.com/Mezcalito/ux-filemanager)[ RSS](/packages/mezcalito-ux-filemanager/feed)WikiDiscussions main Synced 3d ago

READMEChangelog (8)Dependencies (22)Versions (9)Used By (0)

Mezcalito UX FileManager
========================

[](#mezcalito-ux-filemanager)

Overview
--------

[](#overview)

The Mezcalito File Manager Bundle provides an easy-to-use file management system in your Symfony application using Twig Components and Live Components. It allows you to create and manage multiple storages, each with its unique configuration. Currently, the bundle supports only a local filesystem provider.

[![Effortless file management with Symfony UX and Mezcalito UX FileManager](/doc/images/ux-filemanager-promo.png)](/doc/images/ux-filemanager-promo.png)

Installation
------------

[](#installation)

Add [mezcalito/ux-filemanager](https://packagist.org/packages/mezcalito/ux-filemanager) to your composer.json file:

```
composer require mezcalito/ux-filemanager
```

Register and configure the bundle
---------------------------------

[](#register-and-configure-the-bundle)

If you are using Symfony Flex, the following steps should be done automatically. Otherwise, follow the instructions.

### Register the bundle

[](#register-the-bundle)

Inside `config/bundles.php`, add the following line:

```
// config/bundles.php

return [
    // ...
    Mezcalito\FileManagerBundle\MezcalitoFileManagerBundle::class => ['all' => true],
];
```

### Add routes

[](#add-routes)

Create a new routing file to add UX FileManager's routes:

```
# config/routes/mezcalito_file_manager.yaml
mezcalito_file_manager:
    resource: '@MezcalitoFileManagerBundle/config/routes.php'
    prefix: '/filemanager'
```

Configuration
-------------

[](#configuration)

To configure the bundle, add the following configuration to your `config/packages/mezcalito_file_manager.yaml` file. This example demonstrates how to set up a local storage:

```
mezcalito_file_manager:
    storages:
        local:
            uri_prefix: /media
            provider: local
            options:
                path: '%kernel.project_dir%/public/uploads/storages/local'
                media_url: 'https://media.yourdomain.com/'
                ignore_dot_files: true
```

Storage Configuration Options

NameTypeRequiredDefault valueDescriptionpathstringYesThe path to the directory where files will be storedmedia\_urlstringNodomain from current requestThe URL used to generate media links. If not set, the current domain will be usedignore\_dot\_filesboolNotrueIf true, hidden files and directories (starting with a dot) will be ignored. Defaults to trueUsage
-----

[](#usage)

Once the bundle is installed and configured, you can use the file manager in your Twig templates. Here's how to include it in your template:

### Using Twig Syntax

[](#using-twig-syntax)

```
{{ component('Mezcalito:FileManager:FileSystem', { storage: 'local' }) }}
```

### Using HTML-like Syntax

[](#using-html-like-syntax)

```

```

In both cases, replace `local` with the name of the storage you want to use.

Issues and feature requests
---------------------------

[](#issues-and-feature-requests)

Please report issues and request features at .

License
-------

[](#license)

This bundle is under the MIT license. For the whole copyright, see the LICENSE file distributed with this source code.

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance64

Regular maintenance activity

Popularity31

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 81% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~67 days

Total

8

Last Release

208d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/911eee5cdea5a7a363c88e69d05e828b21e544ebdf573df9f887e72b2c6f0eb8?d=identicon)[LoicSapone](/maintainers/LoicSapone)

![](https://avatars.githubusercontent.com/u/193469?v=4)[Julien Jacottet](/maintainers/julienj)[@julienj](https://github.com/julienj)

![](https://www.gravatar.com/avatar/582573cebeeaa82d77a0e84fc4ae5a1bef63a77cd22c75e9d27be549c237eb3d?d=identicon)[mezcalito](/maintainers/mezcalito)

---

Top Contributors

[![loicsapone](https://avatars.githubusercontent.com/u/4466694?v=4)](https://github.com/loicsapone "loicsapone (68 commits)")[![robinsimonklein](https://avatars.githubusercontent.com/u/36634414?v=4)](https://github.com/robinsimonklein "robinsimonklein (10 commits)")[![AlexandrePetrone](https://avatars.githubusercontent.com/u/6663426?v=4)](https://github.com/AlexandrePetrone "AlexandrePetrone (5 commits)")[![julienj](https://avatars.githubusercontent.com/u/193469?v=4)](https://github.com/julienj "julienj (1 commits)")

---

Tags

filemanagersymfonysymfony-bundlesymfony-uxsymfony-uxfilemanager

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/mezcalito-ux-filemanager/health.svg)

```
[![Health](https://phpackages.com/badges/mezcalito-ux-filemanager/health.svg)](https://phpackages.com/packages/mezcalito-ux-filemanager)
```

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.9M388](/packages/easycorp-easyadmin-bundle)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k5.9M738](/packages/sylius-sylius)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M576](/packages/shopware-core)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.1k17.8k](/packages/prestashop-prestashop)[open-dxp/opendxp

Content &amp; Product Management Framework (CMS/PIM)

9421.6k61](/packages/open-dxp-opendxp)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

21866.0M1.7k](/packages/drupal-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
