monkeyscloud/monkeyslegion-files

File storage, uploads, and helpers for the MonkeysLegion framework. No controllers; pure services and global functions.

Maintainers

Details

github.com/MonkeysCloud/MonkeysLegion-Files

Source

Issues

Installs: 19

Dependents: 1

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 0

Open Issues: 0

1.0.0 2025-07-26 20:11 UTC

Requires

Requires (Dev)

Suggests

MIT 206e951f05af1dab26506d98b475bcfb6ad0bf7e

storagefilesuploadspsr-7monkeyslegion

This package is auto-updated.

Last update: 2025-07-26 20:11:37 UTC

README

Framework-level file storage and upload helpers for the MonkeysLegion ecosystem. This package intentionally ships no controllers. It exposes:

  • Interfaces for storage backends
  • Ready-to-use Local storage driver (S3/GCS optional stubs)
  • UploadManager service
  • Global helper functions ml_files_*() for quick usage in apps
  • Config file and a lightweight ServiceProvider for DI wiring
  • Optional signed-URL utilities for private downloads

Install

composer require monkeyscloud/monkeyslegion-files

Configure

Copy or publish config/files.php, then set env vars:

FILES_DISK=local
FILES_PUBLIC_URL=
UPLOAD_MAX_BYTES=20971520
UPLOAD_MIME_ALLOW=image/jpeg,image/png,image/webp,application/pdf
FILES_SIGNING_KEY=change-me-please

Quick usage

// store a string
$path = ml_files_put_string("hello world", "text/plain");

// get a stream
$stream = ml_files_read_stream($path);

// generate a signed URL (valid for 10 minutes)
$url = ml_files_sign_url("/files/{$path}", 600);

Services

  • MonkeysLegion\Files\Contracts\FileStorage
  • MonkeysLegion\Files\Contracts\FileNamer
  • MonkeysLegion\Files\Upload\UploadManager

Security notes

  • Place local storage outside webroot.
  • Validate size and MIME types on input.
  • Use FILES_SIGNING_KEY + ml_files_sign_url() for private links.

Tests

vendor/bin/phpunit