README

Description

File Manager adds Enso file uploads, browsing, sharing, and type administration.

The package stores files and uploads, supports recent and favorite lists, generates temporary links, exposes signed share links for public access, and lets administrators manage file types through form and table endpoints.

It is intended to back the Enso file-manager UI and other modules that need attachable files.

Installation

Install the package:

composer require laravel-enso/files

Run the package migrations:

php artisan migrate

Optional publishes:

php artisan vendor:publish --tag=files-config
php artisan vendor:publish --tag=files-factory

Features

• Upload store and destroy endpoints.
• File browsing, download, show, rename, favorite, recent, and visibility-toggle endpoints.
• Signed share links for externally accessible files.
• File-type CRUD with form and table builders.
• Image processing hooks and upload validation services.

Usage

Main route groups:

• core.files.*
• core.uploads.*
• administration.fileTypes.*

Signed sharing is exposed through:

route('core.files.share', ['file' => $file]);

API

HTTP routes

• GET api/core/files/link/{file}
• GET api/core/files/download/{file}
• DELETE api/core/files/{file}
• GET api/core/files/show/{file}
• GET api/core/files/browse/{type}
• GET api/core/files/recent
• GET api/core/files/favorites
• PATCH api/core/files/{file}
• PATCH api/core/files/makePublic/{file}
• PATCH api/core/files/makePrivate/{file}
• PATCH api/core/files/favorite/{file}
• POST api/core/uploads/store
• DELETE api/core/uploads/{upload}
• GET api/administration/fileTypes/create
• POST api/administration/fileTypes
• GET api/administration/fileTypes/{type}/edit
• PATCH api/administration/fileTypes/{type}
• DELETE api/administration/fileTypes/{type}

Depends On

Required Enso packages:

• laravel-enso/core ↗
• laravel-enso/helpers ↗
• laravel-enso/image-transformer ↗
• laravel-enso/migrator ↗
• laravel-enso/track-who ↗

Companion frontend package:

• @enso-ui/files ↗

Contributions

are welcome. Pull requests are great, but issues are good too.

Thank you to all the people who already contributed to Enso!