Download the PHP package eduvl/laravel-filekit without Composer

Laravel FileKit

Typed upload services for Laravel: images, audio, video and generic files with safe paths, MIME whitelists, and signed URLs for private disks.

✨ Features

• ✅ Upload from UploadedFile, local path, HTTP URL, data:base64, or raw bytes
• ✅ Per-type MIME whitelists and size limits
• ✅ Signed routes for private disks (filekit.show, filekit.download)
• ✅ Clean result object: UploadResult { path, url, disk, mime, size }
• ✅ Extensible (add your own VideoService, etc.)
• ✅ Laravel auto-discovery and publishable config

📚 Contents

• Requirements
• Installation
• Publish Config
• Quick Start
• API
• Signed URLs
• Validation
• Extending
• Security Notes
• Testing (Testbench)
• Troubleshooting
• Versioning
• Contributing
• License

✅ Requirements

📦 Installation

Packagist (when published)

From GitHub (VCS)

Add to your app’s composer.json:

Then:

Local path (for development)

Uses Laravel auto-discovery — no manual provider registration.

⚙️ Publish Config

This creates config/filekit.php:

Using the local public disk? Run:

🚀 Quick Start

🧰 API

Facade → manager → services:

Upload

Allowed $input types

• UploadedFile (form upload)
• Local path string (/tmp/x.png)
• HTTP URL (https://…) — downloaded via Laravel HTTP Client
• Data URL (data:image/png;base64,…)
• Raw bytes string

Result object

Delete

Moving and Copying Files

You can move (rename) or copy files inside the same storage disk.

php use Illuminate\Support\Facades\URL;

$url = URL::temporarySignedRoute( 'filekit.download', now()->addMinutes(60), ['path' => $res->path] ); bash composer require --dev "orchestra/testbench:^9.0" bash vendor/bin/phpunit

---

<a id="troubleshooting"></a>
## 🛠️ Troubleshooting

- **Windows & `|` in Composer constraints**  
  On `cmd.exe` use ranges instead of pipes:  
  `"illuminate/support:>=10.0 <12.0"`.

- **404 when accessing URL**  
  Ensure the file exists on the configured disk and the path matches.  
  For public disk: `php artisan storage:link`.

- **IDE highlights helpers in the package**  
  Outside a Laravel app those helpers aren’t loaded — it’s fine.  
  Keeping **Testbench** in `require-dev` restores helper awareness for IDE/tests.

---

<a id="versioning"></a>
## 🔢 Versioning

- `0.x` — development, API may change.
- `1.x` — stable; breaking changes only in `2.0`.

---

<a id="contributing"></a>
## 🤝 Contributing

PRs and issues are welcome!

1. `git clone`
2. `composer install`
3. `vendor/bin/phpunit`
4. Don’t commit `vendor/` or `composer.lock` (libraries usually don’t ship lockfiles)

---

<a id="license"></a>
## 📄 License

**MIT** — see `LICENSE`.