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 & Storage](/categories/file-storage)
4. /
5. mezcalito/ux-filemanager

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

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

Effortless file management with Symfony UX and Mezcalito UX FileManager

0.1.7(5mo ago)221.8k↓50%2[2 issues](https://github.com/Mezcalito/ux-filemanager/issues)MITPHPPHP >=8.3CI passing

Since Aug 20Pushed 5mo 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 1mo 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

44

—

FairBetter than 92% of packages

Maintenance71

Regular maintenance activity

Popularity30

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

153d ago

### Community

Maintainers

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

![](https://www.gravatar.com/avatar/87b528c4ce7ea642ea06af47294bf7948a03bb780f5b0ef0b7ebfe0b02ed53cd?d=identicon)[julienj](/maintainers/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

[sylius/sylius

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

8.4k5.6M650](/packages/sylius-sylius)[prestashop/prestashop

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

9.0k15.4k](/packages/prestashop-prestashop)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[drupal/core

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

19462.3M1.3k](/packages/drupal-core)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[contao/core-bundle

Contao Open Source CMS

1231.6M2.3k](/packages/contao-core-bundle)

PHPackages © 2026

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