Local disk storage in Laravel - Step-by-Step Execution

Concept Flow - Local disk storage

Start: Request to store file

↓

Call Storage facade with disk 'local'

↓

Check if 'local' disk is configured

↓

Save file to storage/app directory

↓

Return file path or success response

↓

End

This flow shows how Laravel stores a file on the local disk by calling the Storage facade, checking configuration, saving the file, and returning the path.

Execution Sample

Laravel

use Illuminate\Support\Facades\Storage;

$filePath = Storage::disk('local')->put('example.txt', 'Hello Laravel!');

return $filePath;

This code saves a text file named 'example.txt' with content 'Hello Laravel!' to the local disk and returns the saved file path.

Execution Table

Step	Action	Disk Selected	File Path	Result
1	Call Storage::disk('local')	local	N/A	Disk instance ready
2	Put file 'example.txt' with content	local	example.txt	File saved in storage/app/example.txt
3	Return file path	local	example.txt	example.txt returned

💡 File saved successfully on local disk, path returned

Variable Tracker

Variable	Start	After Step 1	After Step 2	Final
$filePath	null	null	true	true

Key Moments - 3 Insights

Why do we specify 'local' in Storage::disk('local')?

Because Laravel supports multiple disks, specifying 'local' tells it to use the local filesystem configured in config/filesystems.php. See execution_table step 1.

Where is the file actually saved on the server?

The file is saved inside the storage/app directory by default when using the 'local' disk. This is shown in execution_table step 2.

What does the put() method return?

The put() method returns true on success or false on failure, not the file path. To get the file path, you use the path or url methods. See Laravel documentation.

Visual Quiz - 3 Questions

Look at the execution_table, what is the value of $filePath after step 2?

A true

B null

C 'example.txt'

D 'storage/app/example.txt'

💡 Hint

The put() method returns true on success, not the file path.

At which step does Laravel confirm the file is saved on disk?

A Step 1

B Step 3

C Step 2

D No confirmation step

💡 Hint

Look at the 'Result' column in execution_table for Step 2

If you change 'local' to 'public' in Storage::disk('local'), what changes in the execution?

A File saves to storage/app directory

B File saves to storage/app/public directory

C File saves to root directory

D File is not saved

💡 Hint

Recall that 'public' disk points to storage/app/public, different from 'local' disk

Concept Snapshot

Laravel Local Disk Storage:
- Use Storage::disk('local') to select local disk
- put('filename', content) saves file in storage/app
- Returns true on success
- Configured in config/filesystems.php
- Default local disk stores files privately

Full Transcript

This lesson shows how Laravel stores files on the local disk using the Storage facade. First, the code calls Storage::disk('local') to select the local disk configured in the application. Then, it uses the put method to save a file named 'example.txt' with the content 'Hello Laravel!' inside the storage/app directory. The put method returns true on success. This process ensures files are saved privately on the server's local filesystem. The execution table traces each step, showing the disk selection, file saving, and returned status. Variables like $filePath update accordingly. Key points include why specifying the disk matters, where files are saved, and what put returns. The quiz tests understanding of these steps and effects of changing disks. This helps beginners see exactly how Laravel handles local file storage step-by-step.