PHPackages                             miladimos/laravel-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. miladimos/laravel-filemanager

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

miladimos/laravel-filemanager
=============================

a powerful, flexible laravel file manager

v0.6.4(4y ago)121171MITPHPPHP >=7.4|^8

Since Jul 18Pushed 9mo ago2 watchersCompare

[ Source](https://github.com/miladimos/laravel-filemanager)[ Packagist](https://packagist.org/packages/miladimos/laravel-filemanager)[ Docs](https://github.com/miladimos/laravel-filemanager)[ Fund](https://idpay.ir/miladimos)[ RSS](/packages/miladimos-laravel-filemanager/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (6)Versions (14)Used By (0)

[![Starts](https://camo.githubusercontent.com/f909d1f83bdec72134018507d36e5044693a01e05a8a9047693f38b5317903eb/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6d696c6164696d6f732f6c61726176656c2d66696c656d616e616765723f7374796c653d666c6174266c6f676f3d676974687562)](https://github.com/miladimos/laravel-filemanager/forks)[![Forks](https://camo.githubusercontent.com/c3138c74ab8902edd705f3d8f46ec85a077f58323a0b93a73fa325e955e81feb/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f6d696c6164696d6f732f6c61726176656c2d66696c656d616e616765723f7374796c653d666c6174266c6f676f3d676974687562)](https://github.com/miladimos/laravel-filemanager/stargazers)

Under Development
=================

[](#under-development)

##### help us for development :)

[](#help-us-for-development-)

### for installation in root of your project do these steps:

[](#for-installation-in-root-of-your-project-do-these-steps)

```
composer require miladimos/laravel-filemanager
```

2. Open your config/app.php and add the following lines:

```
// in providers
Miladimos\FileManager\Providers\FileManagerServiceProvider::class,

// in aliases
Miladimos\FileManager\Facades\FileManagerFacade::class,
```

3. Run the command below to install package:

```
php artisan filemanager:install

```

### Configuration ! important !

[](#configuration--important-)

next go to the file

```
config/filemanager.php;
```

for initialize file manager first set these confings:

1. set default storage to upload file (default is: local)
2. set base directory name for file manager (default is: filemanager/)

and run bellow command for initialize:

```
php artisan filemanager:init
```

then create tables:

```
php artisan migrate
```

just it :)

if you are set public disk run bellow command:

```
php artisan storage:link
```

and if you want use ftp add these config in your config/filesystems.php:

```
'ftp' => [
    'driver' => 'ftp',
    'host' => 'ftp.example.com',
    'username' => 'your-username',
    'password' => 'your-password',

    // Optional FTP Settings...
    // 'port' => 21,
    // 'root' => '',
    // 'passive' => true,
    // 'ssl' => true,
    // 'timeout' => 30,
],
```

and for sftp use this:

```
'sftp' => [
    'driver' => 'sftp',
    'host' => 'example.com',
    'username' => 'your-username',
    'password' => 'your-password',

    // Settings for SSH key based authentication...
    'privateKey' => '/path/to/privateKey',
    'password' => 'encryption-password',

    // Optional SFTP Settings...
    // 'port' => 22,
    // 'root' => '',
    // 'timeout' => 30,
],
```

### Features ❤️

[](#features-️)

#### You are free to use whatever you like 😎 ( you can just use services in your coding or use apis for your graphical file manager or whatever ...)

[](#you-are-free-to-use-whatever-you-like---you-can-just-use-services-in-your-coding-or-use-apis-for-your-graphical-file-manager-or-whatever-)

### Backend Services:

[](#backend-services)

##### Directory service:

[](#directory-service)

```
use Miladimos\FileManager\Services\DirectoryService;

$service = new DirectoryService();
$service->createDirectory($name); // name of directory for create
$service->deleteDirectory($uuid); // uuid of directory for delete in db and disk
$service->listDirectories($path) // list all directories in given path
$service->listDirectoriesRecursive($path); // list all directories in given path Recursively
```

##### File service:

[](#file-service)

```
use Miladimos\FileManager\Services\FileService;

$service = new FileService(); // or resolve(FileService::class)
```

##### FileGroup service:

[](#filegroup-service)

```
use Miladimos\FileManager\Services\FileGroupService;

$service = new FileGroupService();
$service->allFileGroups();
$service->createFileGroup(array $data); //  $data = ['title', 'description']
$service->updateFileGroup(FileGroup $fileGroup, array $data); //  $data = ['title', 'description']
$service->deleteFileGroup(FileGroup $fileGroup);
```

##### Image service:

[](#image-service)

```
use Miladimos\FileManager\Services\ImageService;

$service = new ImageService();
```

##### Upload service:

[](#upload-service)

```
use Miladimos\FileManager\Services\UploadService;

$service = new UploadService();
```

### API over backend services:

[](#api-over-backend-services)

for all requests set these headers:

Content-Type : application/x-www-form-urlencoded

```
prefix = /api_prefix/filemanager_api_version/route_prefix

// Directories
POST   -> prefix/directories // store new directory
DELETE -> prefix/directories // receive directories field: it can be array of uuid or one uuid of directories for delete

// File Groups
GET    -> prefix/filegroups // return all available file groups
POST   -> prefix/filegroups // store new file groups -> receive : title, description
PUT    -> prefix/filegroups/{filegroup}/update // update file groups -> receive : title, description
DELETE -> prefix/filegroups/{filegroup} // delete file groups

```

### BACKEND TODO:

[](#backend-todo)

- Directory service - list, list recursive, create, delete, move
- File service - list, delete, move
- Upload service -
- Image service -
- FileGroup service -
- Archive service - zip, tar

### FRONTEND TODO:

[](#frontend-todo)

- Web view -

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance40

Moderate activity, may be stable

Popularity18

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 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 ~10 days

Recently: every ~28 days

Total

13

Last Release

1632d ago

PHP version history (2 changes)v0.5.0PHP >=7.4

v0.6.2PHP >=7.4|^8

### Community

Maintainers

![](https://www.gravatar.com/avatar/ad21d122619aec18469a011bdeb0f7c7067401fc3d907679c55424eccc9e4e4f?d=identicon)[miladimos](/maintainers/miladimos)

---

Top Contributors

[![miladimos](https://avatars.githubusercontent.com/u/31257147?v=4)](https://github.com/miladimos "miladimos (24 commits)")

---

Tags

file-managerfilemanagerfilesystemlaravellaravel-file-managerlaravel-file-uploadlaravel-filemanagerlaravel-filesystemlaravel-frameworklaravel-helperslaravel-packagelaravel-storagelaravel-uploaderphpstorageuploaderlaravellaravel-packagesfile manageruploaderlumen packageslumen supportLaravel-Supportfile-uploaderlaravel-filemanager

### Embed Badge

![Health badge](/badges/miladimos-laravel-filemanager/health.svg)

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

###  Alternatives

[irazasyed/larasupport

Adds Laravel Package Support in Lumen.

130669.8k4](/packages/irazasyed-larasupport)[mafftor/laravel-file-manager

The file manager intended for using Laravel with CKEditor / TinyMCE / Colorbox

3619.3k](/packages/mafftor-laravel-file-manager)

PHPackages © 2026

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