Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

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.