PHPackages                             anfallnorr/file-manager-system - 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. anfallnorr/file-manager-system

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

anfallnorr/file-manager-system
==============================

A Symfony bundle for file management (move, copy, delete, resize, etc.).

1.0.55(1mo ago)1155MITPHPPHP >=8.4

Since Mar 24Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/Anfallnorr/FileManagerSystem)[ Packagist](https://packagist.org/packages/anfallnorr/file-manager-system)[ Docs](https://github.com/Anfallnorr/FileManagerSystem)[ RSS](/packages/anfallnorr-file-manager-system/feed)WikiDiscussions main Synced yesterday

READMEChangelog (2)Dependencies (37)Versions (36)Used By (0)

FileManagerSystem (v1.0.55)
===========================

[](#filemanagersystem-v1055)

FileManagerSystem is a Symfony bundle that provides easy and intuitive management of files and directories: creation, deletion, moving, MIME type handling, image resizing, and more.

It is designed to simplify file management within any Symfony application.

⚠️ State Management
-------------------

[](#️-state-management)

This bundle is **stateful**: it maintains a navigation context (e.g. current directory, browsing state) across requests.

The state is securely isolated per user session, ensuring that each user interacts with their own file system context without interference.

---

🚀 Installation
--------------

[](#-installation)

Install the bundle via Composer:

```
composer require anfallnorr/file-manager-system
```

---

⚙️ Configuration
----------------

[](#️-configuration)

### 1. Register the Bundle

[](#1-register-the-bundle)

Add the bundle to your `config/bundles.php` file:

```
return [
    // ...
    Anfallnorr\FileManagerSystem\FileManagerSystem::class => ['all' => true],
];
```

### 2. AssetMapper Configuration (Optional)

[](#2-assetmapper-configuration-optional)

Warning

If you want to use the built-in controller and assets provided by the bundle, create the following configuration files.

**Create** `config/packages/file_manager_system.yaml`:

```
framework:
    asset_mapper:
        paths:
            - '%kernel.project_dir%/vendor/anfallnorr/file-manager-system/assets'
```

**Create** `config/routes/file_manager_system.yaml`:

```
file_manager_system:
    resource: '../../vendor/anfallnorr/file-manager-system/src/Controller/'
    type: attribute
    prefix: /files-manager
```

---

💡 Usage
-------

[](#-usage)

### Service Injection

[](#service-injection)

Inject the `FileManagerService` into your controller or service:

```
public function __construct(
    private FileManagerService $fmService
) {
    $this->fmService->setDefaultDirectory('/var/uploads');
}
```

For convenience in examples below:

```
$fmService = $this->fmService;
```

---

📂 1. Directory Management
-------------------------

[](#-1-directory-management)

### 📌 Get the Default Upload Directory

[](#-get-the-default-upload-directory)

```
$defaultDirectory = $fmService->getDefaultDirectory();
// Returns: /path/to/project/public/uploads
```

### 📌 Set a New Default Upload Directory

[](#-set-a-new-default-upload-directory)

```
$directory = $fmService
    ->setDefaultDirectory('/var/uploads')
    ->getDefaultDirectory();
// Returns: /path/to/project/var/uploads
```

---

### 📁 1.1. Listing Directories

[](#-11-listing-directories)

The `getDirs()` method allows you to explore the file system with support for exclusions, depth control, and relative paths.

**Method Signature:**

```
getDirs(
    string $path = '/',
    string $excludeDir = '',
    string|array|null $depth = '== 0'
): array
```

**Parameters:**

- `$path` — Base directory path to search within
- `$excludeDir` — Directory name pattern to exclude from results
- `$depth` — Depth filter using comparison operators (`==`, `>`, `getDirs();
// Returns directories found at depth 0 in the default directory
```

**List directories inside a specific subfolder:**

```
$dirs = $fmService->getDirs(path: 'uploads');
// Returns all directories inside /uploads at depth 0
```

**Control search depth:**

```
$dirs = $fmService->getDirs(path: 'uploads', depth: '== 1');
// Returns only directories exactly 1 level below /uploads
```

**Exclude specific directories:**

```
$dirs = $fmService->getDirs(path: 'uploads', excludeDir: 'temp');
// Returns all directories except those containing "temp" in their path
```

**Combine all parameters:**

```
$dirs = $fmService->getDirs(path: 'uploads', excludeDir: 'temp', depth: '== 1');
// Returns directories at depth 1 under "uploads", excluding folders containing "temp"
```

---

### 📁 1.2. Creating Directories

[](#-12-creating-directories)

Create a new directory within the default directory.

**Method Signature:**

```
createDir(
    string $directory,
    bool $returnDetails = false
): array
```

**Parameters:**

- `$directory` — Directory name (will be slugified automatically)
- `$returnDetails` — If `true`, returns detailed path information

**Return Value:**

- `array` — Directory details (if `$returnDetails` is `true`)

#### Examples

[](#examples-1)

**Simple directory creation:**

```
$fmService->createDir(directory: 'Hello World!');
// Creates directory: /path/to/project/public/uploads/hello-world
```

**Get detailed information:**

```
$details = $fmService->createDir(directory: 'Hello World!', returnDetails: true);
// Returns:
// [
//     'absolute' => '/var/www/absolute/path/hello-world',
//     'relative' => '/path/hello-world',
//     'ltrimmed_relative' => 'path/hello-world',
//     'foldername' => 'hello-world'
// ]
```

---

📄 2. File Management
--------------------

[](#-2-file-management)

### 📄 2.1. Listing Files

[](#-21-listing-files)

The `getFiles()` method offers complete control over file search: depth, extension, folder filtering, and more.

**Method Signature:**

```
getFiles(
    string $path = '/',
    string|array|null $depth = '== 0',
    ?string $folder = null,
    ?string $ext = null
): array|bool
```

**Parameters:**

- `$path` — Base directory path to search within
- `$depth` — Depth filter using comparison operators (`==`, `>`, `getFiles();
// Returns files at depth 0 from the default directory, or false if none found
```

**Get files from a subfolder:**

```
$files = $fmService->getFiles(path: 'uploads');
// Returns files from /uploads at depth 0
```

**Limit search by depth:**

```
$files = $fmService->getFiles(path: 'uploads', depth: '== 1');
// Returns files located exactly 1 level below /uploads
```

**Filter by folder name:**

```
$files = $fmService->getFiles(path: 'uploads', folder: 'images');
// Returns only files within folders containing "images"
```

**Filter by file extension:**

```
$files = $fmService->getFiles(path: 'uploads', ext: 'jpg');
// Returns only .jpg files
```

**Combine all filters:**

```
$files = $fmService->getFiles(
    path: 'uploads',
    depth: '== 2',
    folder: 'products',
    ext: 'png'
);
// Returns .png files inside folders containing "products", at depth 2 under "uploads"
```

---

### 📄 2.2. Creating Files

[](#-22-creating-files)

Create a new file with optional content.

**Method Signature:**

```
createFile(
    string $filename,
    string $content = ''
): void
```

**Parameters:**

- `$filename` — File name (will be slugified automatically)
- `$content` — File content (defaults to basic HTML template)

**Return Value:**

- `void`

#### Examples

[](#examples-3)

**Create an HTML file with custom content:**

```
$fmService->createFile(
    filename: 'Hello World.html',
    content: 'Hello World! I\'m Js Info'
);
// Creates: /path/to/project/public/uploads/hello-world.html
```

**Create a file with default HTML template:**

```
$fmService->createFile(filename: 'welcome.html');
// Creates file with default HTML content
```

### 📄 2.3. Uploading Files

[](#-23-uploading-files)

The `upload()` method allows you to upload one or multiple files to a specific directory. It handles filename slugification, optional renaming, and automatically generates useful metadata (size, MIME type, dimensions, etc.).

**Method Signature:**

```
upload(
	UploadedFile|array $files,
	string $folder,
	string $newName = '',
	bool $returnDetails = false
): array|bool
```

**Parameters:**

- `$files` — A single UploadedFile instance or an array of files
- `$folder` — Target directory (absolute path recommended)
- `$newName` — Optional new filename (for multiple files, a numeric suffix will be added)
- `$returnDetails` — If true, returns detailed information about uploaded files

**Return Value:**

- `array` — Detailed information about uploaded files (if $returnDetails is true)
- `true` — If upload succeeds and $returnDetails is false

#### Examples

[](#examples-4)

**Upload a single file:**

```
$fmService->upload($file, '/var/www/uploads');
```

**Upload a file with a custom name and get details:**

```
$uploaded = $fmService->upload(
	$file,
	'/var/www/uploads',
	'my-file',
	true
);

// Example result:
[
	[
		'absolute' => '/var/www/uploads/my-file.jpg',
		'relative' => 'uploads/my-file.jpg',
		'filename' => 'my-file.jpg',
		'filesize' => '1.2 MB',
		'filemtime' => 1698200000,
		'extension' => 'jpg',
		'mime' => 'image/jpeg',
		'dimensions' => ['width' => 800, 'height' => 600]
	]
]
```

---

🔧 3. Utilities
--------------

[](#-3-utilities)

### 🧩 Retrieve All Available MIME Types

[](#-retrieve-all-available-mime-types)

Get a complete list of supported MIME types.

```
$mimeTypes = $fmService->getMimeTypes();
// Returns: ['pdf' => 'application/pdf', 'jpg' => 'image/jpeg', ...]
```

### 🧩 Get MIME Type for Specific Extension

[](#-get-mime-type-for-specific-extension)

Retrieve the MIME type for a given file extension.

```
$mimeType = $fmService->getMimeType(key: 'pdf');
// Returns: 'application/pdf'
```

### 🧩 Create URL-Friendly Slugs

[](#-create-url-friendly-slugs)

Convert any string into a URL-safe slug.

```
$slug = $fmService->createSlug('Hello World !');
// Returns: 'hello-world'
```

---

🎨 4. Optional: Twig Integration
-------------------------------

[](#-4-optional-twig-integration)

If you are using Twig and want Bootstrap-styled forms, add the following to your Twig configuration.

**Edit** `config/packages/twig.yaml`:

```
twig:
    form_themes: ['bootstrap_5_layout.html.twig']
```

---

📚 Additional Resources
----------------------

[](#-additional-resources)

- [Symfony Documentation](https://symfony.com/doc/current/index.html)
- [AssetMapper Component](https://symfony.com/doc/current/frontend/asset_mapper.html)

---

📝 License
---------

[](#-license)

This bundle is open-source and available under the MIT License.

###  Health Score

48

—

FairBetter than 93% of packages

Maintenance94

Actively maintained with recent releases

Popularity12

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~12 days

Recently: every ~7 days

Total

35

Last Release

33d ago

PHP version history (2 changes)1.0.21PHP >=8.3

1.0.28PHP >=8.4

### Community

Maintainers

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

---

Top Contributors

[![Anfallnorr](https://avatars.githubusercontent.com/u/90765278?v=4)](https://github.com/Anfallnorr "Anfallnorr (337 commits)")

---

Tags

copy-filescreate-directorycreate-filedelete-files-and-directoriesfilesystemmove-files-and-directoriesrename-files-and-directoriesresize-imagesupload-filesymfonyfilesystemfile managerSymfony Bundlefile systemfile-uploadfile deletefile-copyfile-move

### Embed Badge

![Health badge](/badges/anfallnorr-file-manager-system/health.svg)

```
[![Health](https://phpackages.com/badges/anfallnorr-file-manager-system/health.svg)](https://phpackages.com/packages/anfallnorr-file-manager-system)
```

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.9M386](/packages/easycorp-easyadmin-bundle)[kimai/kimai

Kimai - Time Tracking

4.8k9.0k1](/packages/kimai-kimai)[chameleon-system/chameleon-base

The Chameleon System core.

1028.6k5](/packages/chameleon-system-chameleon-base)[oro/platform

Business Application Platform (BAP)

645143.5k115](/packages/oro-platform)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M574](/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)

PHPackages © 2026

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