DEV Community

Cover image for 7 Ways to Master Laravel File Storage 🚀
Putra Prima A
Putra Prima A

Posted on

7 Ways to Master Laravel File Storage 🚀

#php #laravel #webdev

Ever struggled with file management in Laravel? Let me show you how to solve it today.

Imagine building beautiful web applications where file uploads, downloads, and storage just... work. No more headaches with storage configurations or cloud integrations. This guide will transform how you handle files in Laravel forever.

The Power of Laravel's Filesystem Abstraction 📁

Laravel's filesystem handling isn't just good—it's exceptional. Powered by Frank de Jonge's Flysystem PHP package, Laravel gives you a unified API that works across local storage, Amazon S3, SFTP, and more.

What does this mean for you? You can develop locally using your machine's storage and deploy to production using S3 without changing a single line of code. It's that seamless.

// This same code works whether you're using local storage or S3
Storage::put('avatars/1', $fileContent);
Enter fullscreen mode Exit fullscreen mode

The magic lies in how Laravel abstracts all the complexity behind a clean, consistent interface. You focus on your application logic while Laravel handles the filesystem details.

Setting Up Your Filesystem Configuration ⚙️

Everything starts with the configuration file located at config/filesystems.php. This is your command center for all storage-related settings.

In this file, you'll find:

  • Disk configurations (local, s3, etc.)
  • Default disk settings
  • Driver-specific options

Each "disk" represents a storage location with its driver. Here's what a typical configuration looks like:

'disks' => [
    'local' => [
        'driver' => 'local',
        'root' => storage_path('app'),
        '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'),
        'endpoint' => env('AWS_ENDPOINT'),
        'use_path_style_endpoint' => env('AWS_USE_PATH_STYLE_ENDPOINT', false),
        'throw' => false,
    ],
],
Enter fullscreen mode Exit fullscreen mode

The beauty of this approach is that you can configure multiple disks, even using the same driver. Need separate S3 buckets for public and private files? No problem! Just create two different disk configurations.

Working with Local Storage 💾

The local driver is your starting point—perfect for development and smaller applications. By default, it points to storage/app/private, a directory protected from public access.

Here's how you'd write a file:

use Illuminate\Support\Facades\Storage;

Storage::disk('local')->put('example.txt', 'File contents here');
Enter fullscreen mode Exit fullscreen mode

This stores example.txt in storage/app/private/example.txt. Simple, right?

But what about files that need to be publicly accessible?

Making Files Publicly Accessible 🌐

Laravel includes a special "public" disk configuration for files that should be accessible on the web. These files are stored in storage/app/public by default.

However, there's a catch: this directory isn't accessible from the web out of the box. You need to create a symbolic link that connects it to your public directory:

php artisan storage:link
Enter fullscreen mode Exit fullscreen mode

This command creates a symbolic link from storage/app/public to public/storage, making your files accessible through a URL like:

echo asset('storage/my-file.jpg'); // Returns something like: http://yourdomain.com/storage/my-file.jpg
Enter fullscreen mode Exit fullscreen mode

You can also configure multiple symbolic links in your filesystems.php configuration:

'links' => [
    public_path('storage') => storage_path('app/public'),
    public_path('images') => storage_path('app/images'),
],
Enter fullscreen mode Exit fullscreen mode

If you need to remove these links later, Laravel provides:

php artisan storage:unlink
Enter fullscreen mode Exit fullscreen mode

Expanding to Cloud Storage with S3 ☁️

As your application grows, you'll likely want to move to cloud storage. Amazon S3 is the most popular option, and Laravel makes the transition smooth.

First, install the required package:

composer require league/flysystem-aws-s3-v3 "^3.0" --with-all-dependencies
Enter fullscreen mode Exit fullscreen mode

Then configure your .env file:

AWS_ACCESS_KEY_ID=your-key-id
AWS_SECRET_ACCESS_KEY=your-secret-access-key
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=your-bucket-name
AWS_USE_PATH_STYLE_ENDPOINT=false
Enter fullscreen mode Exit fullscreen mode

Now you can use S3 just like local storage:

Storage::disk('s3')->put('avatars/1', $fileContent);
Enter fullscreen mode Exit fullscreen mode

The best part? Your application code doesn't change at all—just the configuration.

Alternative Storage Options: FTP and SFTP 🔄

Laravel isn't limited to local and S3 storage. You can also use FTP and SFTP for file storage.

For FTP

Install the package:

composer require league/flysystem-ftp "^3.0"
Enter fullscreen mode Exit fullscreen mode

And add a configuration like:

'ftp' => [
    'driver' => 'ftp',
    'host' => env('FTP_HOST'),
    'username' => env('FTP_USERNAME'),
    'password' => env('FTP_PASSWORD'),
    'port' => env('FTP_PORT', 21),
    'root' => env('FTP_ROOT'),
    'passive' => true,
    'ssl' => true,
    'timeout' => 30,
],
Enter fullscreen mode Exit fullscreen mode

For SFTP

Install the SFTP package:

composer require league/flysystem-sftp-v3 "^3.0"
Enter fullscreen mode Exit fullscreen mode

And configure it:

'sftp' => [
    'driver' => 'sftp',
    'host' => env('SFTP_HOST'),
    'username' => env('SFTP_USERNAME'),
    'password' => env('SFTP_PASSWORD'),
    'privateKey' => env('SFTP_PRIVATE_KEY'),
    'passphrase' => env('SFTP_PASSPHRASE'),
    'visibility' => 'private',
    'directory_visibility' => 'private',
    'port' => env('SFTP_PORT', 22),
    'root' => env('SFTP_ROOT', ''),
    'timeout' => 30,
],
Enter fullscreen mode Exit fullscreen mode

With these configurations, you can seamlessly work with remote file servers using the same Storage facade API.

Advanced Filesystem Features 🔥

Laravel's filesystem goes beyond basic file operations with advanced features like scoped and read-only filesystems.

Scoped Filesystems

Need to restrict operations to a specific directory? Scoped filesystems are the answer:

composer require league/flysystem-path-prefixing "^3.0"
Enter fullscreen mode Exit fullscreen mode

Then configure your scoped disk:

's3-videos' => [
    'driver' => 'scoped',
    'disk' => 's3',
    'prefix' => 'path/to/videos',
],
Enter fullscreen mode Exit fullscreen mode

Now, when you use Storage::disk('s3-videos'), all operations will be automatically prefixed with path/to/videos.

Read-Only Filesystems

For security, you might want to prevent write operations on certain disks:

composer require league/flysystem-read-only "^3.0"
Enter fullscreen mode Exit fullscreen mode

Then add the read-only flag:

's3-archives' => [
    'driver' => 's3',
    // other settings...
    'read-only' => true,
],
Enter fullscreen mode Exit fullscreen mode

Now any attempts to write to this disk will fail, protecting your archived data.

S3-Compatible Alternatives 💡

Not a fan of Amazon S3? Laravel works great with S3-compatible alternatives like:

  • MinIO
  • DigitalOcean Spaces
  • Cloudflare R2
  • Vultr Object Storage
  • Hetzner Cloud Storage

Just update your credentials and endpoint:

'endpoint' => env('AWS_ENDPOINT', 'https://minio:9000'),
Enter fullscreen mode Exit fullscreen mode

For MinIO specifically, you'll want to configure the URL for proper linking:

AWS_URL=http://localhost:9000/local
Enter fullscreen mode Exit fullscreen mode

Using the Storage Facade in Your Application 🧩

The Storage facade is your gateway to all filesystem operations. Here's how to use it effectively:

Using the Default Disk

If you don't specify a disk, Laravel uses the default disk from your configuration:

use Illuminate\Support\Facades\Storage;

// Uses the default disk
Storage::put('file.txt', 'Contents');
Enter fullscreen mode Exit fullscreen mode

Working with Specific Disks

You can specify which disk to use:

// Uses the S3 disk
Storage::disk('s3')->put('file.txt', 'Contents');
Enter fullscreen mode Exit fullscreen mode

Creating On-Demand Disks

Sometimes you need a temporary disk not defined in your config. Laravel has you covered:

use Illuminate\Support\Facades\Storage;

$disk = Storage::build([
    'driver' => 'local',
    'root' => '/path/to/specific/folder',
]);

$disk->put('image.jpg', $content);
Enter fullscreen mode Exit fullscreen mode

This creates a custom disk at runtime without modifying your configuration files—perfect for dynamic scenarios.

What's Next? Taking Your Laravel File Storage Skills Further 🚀

Now that you understand Laravel's filesystem basics, you're ready to dive deeper. In your Laravel journey, you'll learn how to:

  • Stream large files efficiently
  • Generate pre-signed URLs for secure, temporary access
  • Implement file uploads with progress bars
  • Create custom filesystem drivers for specialized storage systems
  • Test your file operations in isolation

The possibilities are endless when you master Laravel's filesystem.

Ready to become a Laravel file storage expert? Raise your hand if you want more advanced tutorials on specific file storage topics! 👋

Need more Laravel tips and resources? Connect with me:

Drop a comment below with your biggest Laravel file storage challenge—I'd love to help solve it! 💬

Top comments (0)

Read next

million_formula_3be3d915d profile image

A Beginner's Guide to C# Programming

Million Formula -

jyotich15 profile image

Ways to convert a specified number to an array of digits

Jyoti chaudhary -

snehalkadwe profile image

How to Use Maatwebsite Excel in Laravel for Importing & Exporting Data

Snehal Rajeev Moon -

hardikidea profile image

🚀 Embrace the Power of Functional Programming in JavaScript and TypeScript 🚀

Er Hardik Chauhan -