Storage Disk: Local, Public, dan Cloud

// config/filesystems.php
'default' => env('FILESYSTEM_DISK', 'local'),

'disks' => [
    'local' => [
        'driver' => 'local',
        'root' => storage_path('app'),
        'throw' => false,
    ],
    'public' => [
        'driver' => 'local',
        'root' => storage_path('app/public'),
        'url' => env('APP_URL').'/storage',
        'visibility' => 'public',
        'throw' => false,
    ],
    's3' => [
        'driver' => 's3',
        'key' => env('AWS_ACCESS_KEY_ID'),
        'secret' => env('AWS_SECRET_ACCESS_KEY'),
        'region' => env('AWS_DEFAULT_REGION'),
        'bucket' => env('AWS_BUCKET'),
        'url' => env('AWS_URL'),
    ],
],

composer require league/flysystem-aws-s3-v3

# .env
FILESYSTEM_DISK=s3
AWS_ACCESS_KEY_ID=AKIA...
AWS_SECRET_ACCESS_KEY=...
AWS_DEFAULT_REGION=ap-southeast-1
AWS_BUCKET=nama-bucket

// app/Services/DokumenService.php
namespace App\Services;

use Illuminate\Support\Facades\Storage;

class DokumenService
{
    public function simpan(string $nama, string $isi): string
    {
        // put() mengembalikan path relatif, bukan boolean
        return Storage::disk('local')->put('dokumen/'.$nama, $isi);
    }

    public function baca(string $path): ?string
    {
        if (! Storage::disk('local')->exists($path)) {
            return null;
        }

        return Storage::disk('local')->get($path);
    }

    public function tautanPublik(string $path): string
    {
        // hanya masuk akal untuk disk public/s3
        return Storage::disk('public')->url($path);
    }
}

$url = Storage::disk('s3')->temporaryUrl(
    'invoice/INV-001.pdf',
    now()->addMinutes(15)
);

// app/Http/Controllers/DokumenController.php
namespace App\Http\Controllers;

use Illuminate\Support\Facades\Storage;

class DokumenController extends Controller
{
    public function unduh(string $file)
    {
        // cegah path traversal: ambil nama file saja
        $file = basename($file);
        $path = 'dokumen-pribadi/'.$file;

        abort_unless(Storage::disk('local')->exists($path), 404);

        // contoh cek kepemilikan via model Dokumen
        $dokumen = \App\Models\Dokumen::where('path', $path)->firstOrFail();
        $this->authorize('view', $dokumen);

        return Storage::disk('local')->download($path);
    }
}