PHPackages                             escolalms/files - 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. escolalms/files

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

escolalms/files
===============

Escola file repository API.

0.1.29(2y ago)0232.8k↓28.1%9MITPHPPHP &gt;=7.4

Since Apr 28Pushed 2y ago1 watchersCompare

[ Source](https://github.com/EscolaLMS/Files)[ Packagist](https://packagist.org/packages/escolalms/files)[ RSS](/packages/escolalms-files/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (5)Versions (40)Used By (9)

Files
=====

[](#files)

Files browser package

[![swagger](https://camo.githubusercontent.com/bf46f50926ef796b1bb0b6e41af746af52ff3aacdffb0533450f3b614a7334a2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f63756d656e746174696f6e2d737761676765722d677265656e)](https://escolalms.github.io/Files/)[![codecov](https://camo.githubusercontent.com/56b989cfd57686b30ff545f80c1abea2176ea0dd6754267e4ab49eea927aaaf3/68747470733a2f2f636f6465636f762e696f2f67682f4573636f6c614c4d532f46696c65732f6272616e63682f6d61696e2f67726170682f62616467652e7376673f746f6b656e3d4e52414e34523841475a)](https://codecov.io/gh/EscolaLMS/Files)[![phpunit](https://github.com/EscolaLMS/Files/actions/workflows/test.yml/badge.svg)](https://github.com/EscolaLMS/Files/actions/workflows/test.yml)[![downloads](https://camo.githubusercontent.com/4232787aa16a7cc8c03362551848b7b2096f0a7b1755ae5c038a46c3e82ed8e0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6573636f6c616c6d732f66696c6573)](https://packagist.org/packages/escolalms/files)[![downloads](https://camo.githubusercontent.com/ededc21d00ef55a7b9a14ac5499b738ea0467c60e840f43f14ee91faf5efead1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6573636f6c616c6d732f66696c6573)](https://packagist.org/packages/escolalms/files)[![downloads](https://camo.githubusercontent.com/6b277ea09bb2887a37ca5aff0c64ba6f00b0f0c13a4639f9ffc70276ac51d544/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6573636f6c616c6d732f66696c6573)](https://packagist.org/packages/escolalms/files)[![Maintainability](https://camo.githubusercontent.com/92447cfaae26c404dbbf164af9b2f36779182002bcd1d4db08737b8390954a67/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f39396533663331373937346437373131336136612f6d61696e7461696e6162696c697479)](https://codeclimate.com/github/EscolaLMS/Files/maintainability)

What does it do
---------------

[](#what-does-it-do)

This package is used to upload, delete and reuse files.

Installing
----------

[](#installing)

- `composer require escolalms/files`
- `php artisan migrate`
- `php artisan db:seed --class="EscolaLms\Files\Database\Seeders\PermissionTableSeeder"`

Database
--------

[](#database)

This package adds `access_to_directories` column to the users table.

Endpoints
---------

[](#endpoints)

All the endpoints are defined in [![swagger](https://camo.githubusercontent.com/bf46f50926ef796b1bb0b6e41af746af52ff3aacdffb0533450f3b614a7334a2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f63756d656e746174696f6e2d737761676765722d677265656e)](https://escolalms.github.io/Files/)

Tests
-----

[](#tests)

Run `./vendor/bin/phpunit` to run tests. [![phpunit](https://github.com/EscolaLMS/Files/actions/workflows/test.yml/badge.svg)](https://github.com/EscolaLMS/Files/actions/workflows/test.yml)[![codecov](https://camo.githubusercontent.com/56b989cfd57686b30ff545f80c1abea2176ea0dd6754267e4ab49eea927aaaf3/68747470733a2f2f636f6465636f762e696f2f67682f4573636f6c614c4d532f46696c65732f6272616e63682f6d61696e2f67726170682f62616467652e7376673f746f6b656e3d4e52414e34523841475a)](https://codecov.io/gh/EscolaLMS/Files)

Events
------

[](#events)

This package does not dispatch any events.

Listeners
---------

[](#listeners)

This package listens for events and adds or removes user access to directories.

- `EscolaLms\Auth\Events\AccountConfirmed` - add user access to directory `avatars/{user_id}`
- `EscolaLms\Courses\Events\CourseTutorAssigned` - add user access to directory `course/{course_id}`
- `EscolaLms\Courses\Events\CourseTutorUnassigned` - remove user access to directory `course/{course_id}`
- `EscolaLms\Webinar\Events\WebinarTrainerAssigned` - add user access to directory `webinar/{webinar_id}`
- `EscolaLms\Webinar\Events\WebinarTrainerUnassigned` - remove user access to directory `webinar/{webinar_id}`
- `EscolaLms\StationaryEvents\Events\StationaryEventAuthorAssigned` - add user access to directory `stationary-events/{stationary_evet_id}`
- `EscolaLms\StationaryEvents\Events\StationaryEventAuthorUnassigned` - remove user access to directory `stationary-events/{stationary_evet_id}`

How to use this on frontend
---------------------------

[](#how-to-use-this-on-frontend)

### Admin panel

[](#admin-panel)

**Left menu**[![Menu](docs/menu.png "Menu")](docs/menu.png)

**Files browser**[![List](docs/list.png "List")](docs/list.png)

**File finder**[![Finder](docs/finder.png "File finder")](docs/finder.png)

**Upload the file to the selected directory**[![Upload](docs/upload.png "Upload")](docs/upload.png)

Permissions
-----------

[](#permissions)

Permissions are defined in [seeder](database/seeders/PermissionTableSeeder.php)

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity32

Limited adoption so far

Community25

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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

Recently: every ~103 days

Total

29

Last Release

942d ago

### Community

Maintainers

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

---

Top Contributors

[![shdpl](https://avatars.githubusercontent.com/u/279424?v=4)](https://github.com/shdpl "shdpl (27 commits)")[![mako321](https://avatars.githubusercontent.com/u/59456825?v=4)](https://github.com/mako321 "mako321 (14 commits)")[![qunabu](https://avatars.githubusercontent.com/u/214608?v=4)](https://github.com/qunabu "qunabu (14 commits)")[![HerbertIV](https://avatars.githubusercontent.com/u/62691459?v=4)](https://github.com/HerbertIV "HerbertIV (6 commits)")[![dicani0](https://avatars.githubusercontent.com/u/58490533?v=4)](https://github.com/dicani0 "dicani0 (2 commits)")[![dyfero](https://avatars.githubusercontent.com/u/59400506?v=4)](https://github.com/dyfero "dyfero (2 commits)")[![KrzysztofDziedziechEscolasoft](https://avatars.githubusercontent.com/u/96292232?v=4)](https://github.com/KrzysztofDziedziechEscolasoft "KrzysztofDziedziechEscolasoft (1 commits)")[![daVitekPL](https://avatars.githubusercontent.com/u/58150098?v=4)](https://github.com/daVitekPL "daVitekPL (1 commits)")[![pa-cholek](https://avatars.githubusercontent.com/u/5345420?v=4)](https://github.com/pa-cholek "pa-cholek (1 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![ArtKob](https://avatars.githubusercontent.com/u/108077902?v=4)](https://github.com/ArtKob "ArtKob (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/escolalms-files/health.svg)

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

###  Alternatives

[overtrue/laravel-filesystem-qiniu

A Qiniu storage filesystem for Laravel.

482229.7k16](/packages/overtrue-laravel-filesystem-qiniu)[rahulhaque/laravel-filepond

Use FilePond the Laravel way

261114.4k2](/packages/rahulhaque-laravel-filepond)[overtrue/laravel-filesystem-cos

A Cos storage filesystem for Laravel.

92128.4k7](/packages/overtrue-laravel-filesystem-cos)

PHPackages © 2026

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