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

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

vatandoost/filemanager
======================

Yii2 filemanager

10598↓82.9%PHP

Since Oct 3Pushed 4y ago1 watchersCompare

[ Source](https://github.com/vatandoost/filemanager)[ Packagist](https://packagist.org/packages/vatandoost/filemanager)[ RSS](/packages/vatandoost-filemanager/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependenciesVersions (2)Used By (0)

Yii2 FileManager
================

[](#yii2-filemanager)

this module is an easy way to save and manage your files in yii2

features:
---------

[](#features)

- manage files in two main category :
    - private
    - public
- multiple handlers :
    - ftp or sftp
    - local
- manger classes to manage any file type
- selector widget for select files from filemanager
- filetrait for models class to easily manage and save files
- filemanager UI:
    - preview files
        - google docs viewer
        - lightbox image viewer
        - pdf viewer
        - jplayer video and audio preview
        - local office viewer by using unoconv
    - rename files
    - delete files
    - search and sort files
- upload files from another url
- resize image
- upload files using blueimp jquery file upload
- FileHelper class to manage files in your app
- get files query in your app to merge with other queries by selecting file addresses
- use bootstrap4 theme
- multi language

Demo
----

[](#demo)

[sample demo](https://github.com/vatandoost/filemanager_demo)

**Screenshots**

[ ![yii2 filemanager ui](https://camo.githubusercontent.com/2d7820a07c646a9c5366e9e94f75c5b03f181c34dedc4f3ad160619f74bc5db0/687474703a2f2f766174616e646f6f73742e636f6d2f6173736574732f66696c656d616e616765722f312e706e67)](http://vatandoost.com/assets/filemanager/1.png)[ ![yii2 filemanager upload](https://camo.githubusercontent.com/9cfb6064d9711f779d89e9d26452db1fe51fe0349da649fd4b864280207cf53e/687474703a2f2f766174616e646f6f73742e636f6d2f6173736574732f66696c656d616e616765722f322e706e67)](http://vatandoost.com/assets/filemanager/2.png)[ ![yii2 filemanager selector](https://camo.githubusercontent.com/cb9735c6d06c3fbf07eb962c4b596166c2c5cb153b00c8738c7afa7bc419a720/687474703a2f2f766174616e646f6f73742e636f6d2f6173736574732f66696c656d616e616765722f332e706e67)](http://vatandoost.com/assets/filemanager/3.png)[ ![yii2 filemanager preview box](https://camo.githubusercontent.com/bf82b1df35f60baf9c50ee1691312cc7c92322337569d19cf51c39602ce5292c/687474703a2f2f766174616e646f6f73742e636f6d2f6173736574732f66696c656d616e616765722f342e706e67)](http://vatandoost.com/assets/filemanager/4.png)Installation
------------

[](#installation)

use composer

```
composer require vatandoost/filemanager

```

Apply migration

```
yii migrate --migrationPath=vendor/vatandoost/filemanager/migrations

```

Configuration

In your configuration file add filemanager module in modules and also add filemanager module to your bootstrap components

```
'modules' => [
    'filemanager' => [
        'class' => 'vatandoost\filemanager\Module',
        'publicFiles' => '@frontend/web/uploads',
        'privateFiles' => '@frontend/uploads',
    ]
],
'bootstrap' => ['filemanager']

```

available configurations :

```
'filemanager' => [
    'class' => 'vatandoost\filemanager\Module',
    'title' => 'Yii2 filemanager',
    'publicFiles' => '@frontend/web/uploads',
    'privateFiles' => '@frontend/uploads',
    'publicFilesUrl' => '/uploads',
    'host' => 'http://optional.com:20180', // this param is option, if not exist it uses current server info
    'params' => [
        'upload_files' => true,
        'url_upload' => true,
        'default_handler' => FileType::HANDLER_TYPE_LOCAL,

        'jplayer_exts' => array("mp4", "flv", "webmv", "webma", "webm", "m4a", "m4v", "ogv", "oga", "mp3", "midi", "mid", "ogg", "wav"),
        'cad_exts' => array('dwg', 'dxf', 'hpgl', 'plt', 'spl', 'step', 'stp', 'iges', 'igs', 'sat', 'cgm', 'svg'),

        // Preview with Google Documents
        'googledoc_enabled' => true,
        'googledoc_file_exts' => array('doc', 'docx', 'xls', 'xlsx', 'ppt', 'pptx', 'pdf', 'odt', 'odp', 'ods'),

        'image_extensions' => ['jpg', 'jpeg', 'png', 'gif', 'bmp', 'svg', 'ico'],
        'file_extensions' => ['doc', 'docx', 'rtf', 'pdf', 'xls', 'xlsx', 'txt', 'csv', 'html', 'xhtml', 'psd', 'sql', 'log', 'fla', 'xml', 'ade', 'adp', 'mdb', 'accdb', 'ppt', 'pptx', 'odt', 'ots', 'ott', 'odb', 'odg', 'otp', 'otg', 'odf', 'ods', 'odp', 'css', 'ai', 'kmz', 'dwg', 'dxf', 'hpgl', 'plt', 'spl', 'step', 'stp', 'iges', 'igs', 'sat', 'cgm', 'tiff', ''], //Files
        'video_extensions' => ['mov', 'mpeg', 'm4v', 'mp4', 'avi', 'mpg', 'wma', "flv", "webm"],
        'audio_extensions' => ['mp3', 'mpga', 'm4a', 'ac3', 'aiff', 'mid', 'ogg', 'wav'],
        'misc_extensions' => ['zip', 'rar', 'gz', 'tar', 'iso', 'dmg'],

        //size of image boxes in filemanager ui
        'image_preview_size' => [
            'w' => 120,
            'h' => 100,
        ],
        'rename_files' => true,
        'delete_files' => true,
        // ftp handler options
        'ftp' => [
            'ftp_host' => "example.com", //put the FTP host
            'ftp_user' => "example",
            'ftp_pass' => "*****",
            'ftp_public_folder' => "/public_html/filemanager",
            'ftp_private_folder' => "/filemanager/uploads",
            'ftp_base_url' => "https://example.com/filemanager",
            'ftp_ssl' => false,
            'ftp_port' => 21,
        ],

        // convert office files to pdf format
        'convert_pdf_preview' => false,
        'unoconvBaseUrl' => 'localhost',
    ],
    'superAdminRole' => 'filemanager_admin',
]

```

How it works
------------

[](#how-it-works)

there are two table to save files informations

- table file\_type
- table files

**table file\_type:**it maintain information about files in a type . to use filemanager you have to create a file\_type row at first.

if you don't define that when file saved in model it will be create.

each file type have a manager class to manage their files ( Yii2 model classes )

fileType fields:

```
    'file_type_id' => 'File Type ID', // integer autoincrement
    'name' => 'Name', // unique name
    'title' => 'Title', // title to show in filemanager ui
    'is_public' => 'Is Public', // (boolean) show files are public or private
    'mime_types' => 'Mime Types',
    'max_size' => 'Max Size', // maximum file size to upload
    'extensions' => 'Extensions', // like  "img,png,jpg"
    'files_path' => 'Files Path', // directory path to save files
    'manager_class' => 'manager class', // class to manage files if empty it will use \vatandoost\filemanager\libs\BaseManager
    'handler_type' => 'type of handler class', // 1 for local handler 2 for Ftp Handler
    'has_public_thumb' => 'public thumbnail', // if files are private they can have public thumbnail for performance
    'has_force_relation_id' => 'force to has relation id to work with filemanager',
```

manager class always is a model that it can change some of behaviors of filemanager.

you can check bellow class to see available options and you can define any of them to your model

\\vatandoost\\filemanager\\libs\\BaseManager

- filterQueryFiles($query, $fileType, $relation\_id = null)
- canView($file)
- canDelete($file)
- beforeFileDelete($file)
- afterFileDelete($file)
- fileTypeConfig($fileType, $relationId = null)

filemanager ui is an iframe that show files to select or manage. you can use it as an standalone page or you can add it to your page

options to open filemanager : "filemanager/dialog/index"

- unique\_name : its combine of file\_type\_name and relation id that joined together with ','
- selector: if you send selector=off , it disable selecting files only show them
- callback: function name from parent window to call after select
- field\_id: input id to put file Ids into its value
- multiple: (0/1) it shows can select multiple files or not ( default : 1) for example :

[http://localhost/filemanager/frontend/web/filemanager/dialog/index?callback=filemanager\_selector\_callback&unique\_name=frontend\_models\_testfile,36&multiple=1&field\_id=testfile-files\_str](http://localhost/filemanager/frontend/web/filemanager/dialog/index?callback=filemanager_selector_callback&unique_name=frontend_models_testfile,36&multiple=1&field_id=testfile-files_str)

usage
-----

[](#usage)

you can use this module without UI and selector, It can help you to upload files and access them easily

you need to add fileTrait to your model and then define your attributes

example model (manager class)

```
class TestFile extends \yii\db\ActiveRecord
{

   use \vatandoost\filemanager\libs\FileTrait;

   public $file;

   public static function tableName()
   {
       return 'test_file';
   }

   public function rules()
   {
       return [
           [
               ['file'],
               'vatandoost\filemanager\libs\FileValidator', // you have to use this file validator or extend of that
               'file_type_name' => '', // if you did not define this it will complete based on class name
               'relation_field' => 'id', // use this attribute to save in relation field in files table
               //'target_field' => 'file_id', // file id will save in this attribute after save if multiple false
               'thumb' => [250, 250], // thumbnail size if files are image
               'multiple' => true // we can add multiple files for this field
               // you can define any other \yii\validators\FileValidator properties here
           ],
           // other attributes
           //[['file_id'], 'integer'],
           [['name'], 'string', 'max' => 255],
           [['name'], 'required'],
           [['files_str'], 'string', 'max' => 255],
       ];
   }

   public function attributeLabels()
   {
       return [
           'id' => 'ID',
           'name' => 'Name',
           //'file_id' => 'File ID',
           'files_str' => 'File list',
       ];
   }
}
```

for upload files in yii2 you just need to run this function

```
$model->saveFiles()
```

example use of file upload in controller

```
public function actionCreate()
{
    $model = new TestFile();

    if ($model->load(Yii::$app->request->post()) && $model->save() && $model->saveFiles()) {
        return $this->redirect(['view', 'id' => $model->id]);
    }

    return $this->render('create', [
        'model' => $model,
    ]);
}
```

example use of file upload input:

```
echo $form->field($model, 'file')->fileInput();
```

example use of file selector:

```
echo $form->field($model, 'files_str')->widget(\vatandoost\filemanager\widgets\selector\Selector::class, [
    'fileTypeName' => 'frontend_models_testfile',
    'relationId' => $model->id,
    'multiple' => true
]);
```

there are some other functions to use :

- $model->getFiles($attribute, $onlyModels = false) // to get all files from model
- $model->filesQuery($file\_type\_name = null) // to get ActiveQuery class to merge with other tables

there is a helper class too. you can use that's static functions to work with your files across your app:

\\vatandoost\\filemanager\\libs\\FileHelper

- FileHelper::getFileUrl($file\_id, $thumb = false)
- FileHelper::getFileInfo($file\_id)
- FileHelper::getFileInfoByModel(File $file)
- FileHelper::deleteFile($file\_id, $checkPermissions = true)
- FileHelper::renameFile($file\_id, $new\_name)
- FileHelper::deleteFileByModel(File $model, $checkPermissions = true)
- FileHelper::getFileContent($id = null, $model = null)
- FileHelper::getLocalFilePath($file, $fileType = null)

Console Commands
----------------

[](#console-commands)

after install module you can use below commands to manage file types:

```
#list of file types
php yii filemanager/files/types

# create new file type
php yii filemanager/files/create-type

```

###  Health Score

22

—

LowBetter than 21% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity22

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity30

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/4774669?v=4)[Masoud Vatandoost](/maintainers/vatandoost)[@vatandoost](https://github.com/vatandoost)

---

Top Contributors

[![vatandoost](https://avatars.githubusercontent.com/u/4774669?v=4)](https://github.com/vatandoost "vatandoost (7 commits)")

### Embed Badge

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

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

PHPackages © 2026

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