Local disk storage in Laravel

Introduction

Local disk storage lets your Laravel app save files directly on your server's hard drive. This is useful for storing images, documents, or backups safely and quickly.

You want to save user-uploaded photos or files on your own server.

You need to store temporary files during processing.

You want to keep backups or logs locally for easy access.

You are developing on your local machine and want to test file storage.

You want fast access to files without relying on external services.

Syntax

Laravel

use Illuminate\Support\Facades\Storage;

// Save a file
Storage::disk('local')->put('filename.txt', 'File contents');

// Get a file
$content = Storage::disk('local')->get('filename.txt');

// Delete a file
Storage::disk('local')->delete('filename.txt');

The 'local' disk stores files in the storage/app folder by default.

Use the Storage facade to interact with files easily.

Examples

This saves a file named notes.txt with the text 'Hello Laravel!' inside the local storage folder.

Laravel

Storage::disk('local')->put('notes.txt', 'Hello Laravel!');

This reads the content of notes.txt from local storage and prints it.

Laravel

$content = Storage::disk('local')->get('notes.txt');
echo $content;

This deletes the notes.txt file from local storage.

Laravel

Storage::disk('local')->delete('notes.txt');

Sample Program

This Laravel controller has three methods: one to save a file named example.txt with some text, one to read and return its content, and one to delete the file. It uses the local disk storage.

Laravel

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;

class FileController extends Controller
{
    public function saveFile()
    {
        Storage::disk('local')->put('example.txt', 'This is a test file.');
        return 'File saved successfully!';
    }

    public function readFile()
    {
        if (Storage::disk('local')->exists('example.txt')) {
            $content = Storage::disk('local')->get('example.txt');
            return $content;
        }
        return 'File not found.';
    }

    public function deleteFile()
    {
        Storage::disk('local')->delete('example.txt');
        return 'File deleted successfully!';
    }
}

Important Notes

Files saved on the local disk are stored in storage/app. You can change this path in config/filesystems.php.

Remember to run php artisan storage:link if you want to make files publicly accessible via public/storage.

Local disk storage is fast but only works on the server where your app runs.

Summary

Local disk storage saves files on your server's hard drive inside storage/app.

Use the Storage facade with disk('local') to put, get, and delete files.

This method is great for quick, private file storage during development or on your own server.

Practice

1. What does the local disk in Laravel's storage system refer to?

easy

A. A remote FTP server

B. A cloud storage service like AWS S3

C. A temporary cache in memory

D. The server's own hard drive inside storage/app

Solution

1. Step 1: Understand Laravel's local disk meaning

   The local disk stores files on the server's hard drive, specifically inside the storage/app directory.

2. Step 2: Compare with other storage options

   Other options like cloud or FTP are not called local. The local disk is always the server's own storage.

3. Final Answer:

   The server's own hard drive inside storage/app -> Option D

4. Quick Check:

   Local disk = server hard drive storage [OK]

Hint: Local disk means server's own storage folder [OK]

Common Mistakes:

• Confusing local disk with cloud storage
• Thinking local disk is temporary memory
• Assuming local disk is remote storage

2. Which of the following is the correct syntax to save a file named example.txt with content 'Hello' on the local disk in Laravel?

easy

A. Storage::disk('example.txt')->put('local', 'Hello');

B. Storage::disk('local')->put('example.txt', 'Hello');

C. Storage::put('local', 'example.txt', 'Hello');

D. Storage::local()->put('example.txt', 'Hello');

Solution

1. Step 1: Identify correct method chaining

   Laravel uses Storage::disk('local')->put(filename, content) to save files on the local disk.

2. Step 2: Check method and parameter order

   Storage::disk('local')->put('example.txt', 'Hello'); correctly calls disk('local') then put('example.txt', 'Hello'). Others mix parameters or methods incorrectly.

3. Final Answer:

   Storage::disk('local')->put('example.txt', 'Hello'); -> Option B

4. Quick Check:

   Use disk('local')->put(filename, content) [OK]

Hint: Use Storage::disk('local')->put(filename, content) [OK]

Common Mistakes:

• Swapping parameters in put method
• Calling disk() with filename instead of 'local'
• Using Storage::local() which does not exist

3. What will be the output of this Laravel code snippet?

Storage::disk('local')->put('note.txt', 'Hi there');
$content = Storage::disk('local')->get('note.txt');
echo $content;

medium

A. Hi there

B. note.txt

C. Storage::disk('local')->put

D. File not found error

Solution

1. Step 1: Save content to local disk

   The put method writes 'Hi there' into 'note.txt' on the local disk.

2. Step 2: Retrieve and echo the file content

   The get method reads the content of 'note.txt', which is 'Hi there', then echoes it.

3. Final Answer:

   Hi there -> Option A

4. Quick Check:

   Put then get returns saved content [OK]

Hint: put saves file, get reads content back [OK]

Common Mistakes:

• Expecting filename instead of content output
• Assuming get returns boolean
• Forgetting to use disk('local')

4. Identify the error in this Laravel code that tries to delete a file from local disk:

Storage::disk('local')->delete('file.txt');

Assuming file.txt does not exist, what happens?

medium

A. Returns false but no exception is thrown

B. Deletes all files in the local disk

C. Creates an empty file named file.txt

D. Throws an exception and stops execution

Solution

1. Step 1: Understand delete behavior on missing files

   Laravel's delete method returns false if the file does not exist but does not throw an error.

2. Step 2: Confirm no side effects

   No file is created or deleted besides the target. Execution continues normally.

3. Final Answer:

   Returns false but no exception is thrown -> Option A

4. Quick Check:

   Delete missing file returns false, no error [OK]

Hint: Delete returns false if file missing, no crash [OK]

Common Mistakes:

• Expecting an exception on missing file
• Thinking delete creates files
• Assuming delete removes all files

5. You want to save a user-uploaded image on the local disk with a unique name to avoid overwriting. Which Laravel code snippet correctly achieves this?

hard

A. Storage::disk('local')->put('image.jpg', $imageContent);

B. Storage::disk('local')->putFileAs('', $imageFile, 'image.jpg');

C. Storage::disk('local')->putFile('', $imageFile);

D. Storage::disk('local')->put('image.jpg', $imageFile);

Solution

1. Step 1: Understand putFile and putFileAs methods

   putFile stores the file with a unique generated name automatically. putFileAs requires you to specify the filename.

2. Step 2: Check options for unique naming

   Storage::disk('local')->putFile('', $imageFile); uses putFile which auto-generates a unique name, preventing overwrites. The distractors use fixed filenames such as 'image.jpg', which risk overwriting existing files.

3. Final Answer:

   Storage::disk('local')->putFile('', $imageFile); -> Option C

4. Quick Check:

   putFile auto-names files uniquely [OK]

Hint: Use putFile to auto-generate unique file names [OK]

Common Mistakes:

• Using put which overwrites files
• Manually generating names incorrectly
• Using putFileAs without unique names