Local disk storage in Laravel - Mini Project: Build & Apply

Local Disk Storage with Laravel

📖 Scenario: You are building a simple Laravel application that needs to save user-uploaded files to the local disk storage.This is like saving your photos or documents on your computer's hard drive, but inside your Laravel app.

🎯 Goal: Learn how to configure and use Laravel's local disk storage to save a file.You will create a file, set up the storage disk, save the file, and confirm it is stored correctly.

📋 What You'll Learn

Create a file content variable with exact text

Set up a local disk storage configuration variable

Use Laravel's Storage facade to save the file to local disk

Return the file path after saving

💡 Why This Matters

🌍 Real World

Saving user files like images, documents, or logs on the server's local disk is common in many web applications.

💼 Career

Understanding Laravel's local disk storage is essential for backend developers working with file uploads and storage management.

1

Create the file content

Create a variable called $fileContent and set it to the string 'Hello, Laravel local storage!'.

Laravel

<?php

// Create the file content variable
# Your code here

Hint

Use = to assign the string to $fileContent.

2

Set up the local disk storage variable

Create a variable called $disk and set it to the string 'local' to specify the local disk storage.

Laravel

<?php

$fileContent = 'Hello, Laravel local storage!';

// Set the disk variable to 'local'
# Your code here

Hint

Assign the string 'local' to the variable $disk.

3

Save the file to local disk

Use Laravel's Storage facade with the disk method and put method to save $fileContent to a file named 'example.txt' on the $disk. Store the returned path in a variable called $filePath.

Laravel

<?php

$fileContent = 'Hello, Laravel local storage!';

$disk = 'local';

use Illuminate\Support\Facades\Storage;

// Save the file content to 'example.txt' on the local disk
# Your code here

Hint

Use Storage::disk($disk)->put('example.txt', $fileContent) and assign it to $filePath.

4

Return the saved file path

Return the variable $filePath to confirm the file was saved.

Laravel

put('example.txt', $fileContent);

// Return the file path
# Your code here

Hint

Use return $filePath; to return the saved file path.

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