Laravel : abstraction de systĂšme de fichiers et stockage compatible S3
La façade Storage de Laravel enveloppe League/Flysystem derriĂšre une API indiffĂ©rente au support. Le mĂȘme code Ă©crit sur le disque local en dĂ©veloppement et sur S3 en production, et la configuration seule dĂ©cide lequel.
// config/filesystems.php
return [
'disks' => [
's3' => [
'driver' => 's3',
'key' => env('AWS_ACCESS_KEY_ID'),
'secret' => env('AWS_SECRET_ACCESS_KEY'),
'region' => env('AWS_DEFAULT_REGION'),
'bucket' => env('AWS_BUCKET'),
],
],
];
use Illuminate\Support\Facades\Storage;
// storing an uploaded file
$path = $request->file('avatar')->store('avatars', 's3');
// generating a temporary, signed download link
$url = Storage::disk('s3')->temporaryUrl($path, now()->addMinutes(10));
// reading it back
$contents = Storage::disk('s3')->get($path);
Remplacez 'driver' => 's3' par 'driver' => 'local' pour le dĂ©veloppement, ou pointez-le vers un endpoint DigitalOcean Spaces ou Cloudflare R2 en production. Rien dâautre ne change dans lâapplication.
Quand le choisir
Toute fonctionnalitĂ© avec des fichiers envoyĂ©s par les utilisateurs : avatars, piĂšces jointes, PDF gĂ©nĂ©rĂ©s, exports. Câest la façon ennuyeuse et correcte de gĂ©rer des fichiers dans une application Laravel, et lâennui est prĂ©cisĂ©ment ce que vous cherchez ici.
Quand ce nâest pas le bon outil
Une demande de partage, de synchronisation et de collaboration (voir Nextcloud) plutĂŽt que dâenvoi et de lecture. Storage gĂšre des fichiers. Il ne vous donne ni liens de partage, ni historique des versions, ni client de synchronisation.
Sous le capot :
temporaryUrl()gĂ©nĂšre une URL prĂ©-signĂ©e, un lien dont la signature cryptographique et la date dâexpiration sont inscrites dans la chaĂźne de requĂȘte, et que S3 vĂ©rifie lui-mĂȘme sans quâaucune requĂȘte nâatteigne votre application Laravel. Servir un fichier privĂ© de cette façon ne coĂ»te aucune bande passante Ă votre serveur.