Uploading files in Laravel

Introduction

Uploading files lets users send pictures, documents, or other data to your website. It helps you save and use these files later.

When users need to add profile pictures to their accounts.

When customers upload documents for verification.

When users submit images or files in a form.

When you want to store user-generated content like photos or PDFs.

Syntax

Laravel

<?php

// In your controller method
public function upload(Request $request)
{
    $request->validate([
        'file' => 'required|file|max:10240', // max 10MB
    ]);

    $path = $request->file('file')->store('uploads');

    return back()->with('success', 'File uploaded to ' . $path);
}

Use store() to save files in the default storage folder.

Validate files to check size and type before saving.

Examples

This saves the file with its original name inside the 'uploads' folder.

Laravel

<?php
// Store file in 'uploads' folder with original name
$path = $request->file('file')->storeAs('uploads', $request->file('file')->getClientOriginalName());

This stores the file in the 'uploads' folder and makes it publicly accessible.

Laravel

<?php
// Store file publicly accessible
$path = $request->file('file')->store('uploads', 'public');

This ensures only JPG, PNG, or PDF files up to 5MB are accepted.

Laravel

<?php
// Validate file type and size
$request->validate([
    'file' => 'required|mimes:jpg,png,pdf|max:5120',
]);

Sample Program

This example shows a simple Laravel controller with two methods: one to display the upload form and one to handle the file upload. The form uses enctype="multipart/form-data" to send files. The controller validates the file and stores it in the 'uploads' folder. After uploading, it shows a success message with the file path.

Laravel

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class FileUploadController extends Controller
{
    public function showForm()
    {
        return view('upload-form');
    }

    public function upload(Request $request)
    {
        $request->validate([
            'file' => 'required|file|max:2048', // max 2MB
        ]);

        $path = $request->file('file')->store('uploads');

        return back()->with('success', "File uploaded to: $path");
    }
}

// Blade view: resources/views/upload-form.blade.php
//
// <form method="POST" action="{{ route('file.upload') }}" enctype="multipart/form-data">
//     @csrf
//     <input type="file" name="file" aria-label="Choose file to upload" required>
//     <button type="submit">Upload</button>
// </form>
//
// @if(session('success'))
//     <p>{{ session('success') }}</p>
// @endif

Important Notes

Always use enctype="multipart/form-data" in your HTML form to allow file uploads.

Use Laravel's validation to protect your app from unwanted file types or large files.

Files are stored in the storage/app folder by default. Use php artisan storage:link to make files accessible publicly.

Summary

Uploading files lets users send data to your app.

Use Laravel's store() method to save files easily.

Always validate files and set proper form encoding.

Practice

1. What is the main purpose of Laravel's store() method when uploading files?

easy

A. To save the uploaded file to a specified disk or folder

B. To validate the file type and size before upload

C. To display the uploaded file on the webpage

D. To delete the uploaded file from the server

Solution

1. Step 1: Understand the role of store() in file uploads

   The store() method in Laravel is designed to save the uploaded file to a disk or folder configured in the app.

2. Step 2: Differentiate from validation and display

   Validation is done separately using Laravel's validation rules, and displaying files is handled by views or frontend code, not store().

3. Final Answer:

   To save the uploaded file to a specified disk or folder -> Option A

4. Quick Check:

   store() saves files [OK]

Hint: Remember: store() saves files, validation is separate [OK]

Common Mistakes:

• Confusing store() with validation methods
• Thinking store() displays files
• Assuming store() deletes files

2. Which HTML form attribute is required to upload files correctly in Laravel?

easy

A. method="get"

B. enctype="multipart/form-data"

C. action="upload.php"

D. target="_blank"

Solution

1. Step 1: Identify the form attribute for file uploads

   To upload files, the form must have enctype="multipart/form-data" so the browser sends file data properly.

2. Step 2: Understand other attributes

   method="get" is not suitable for file uploads; action specifies URL but is not enough; target controls where to open response.

3. Final Answer:

   enctype="multipart/form-data" -> Option B

4. Quick Check:

   Form needs enctype multipart/form-data [OK]

Hint: File uploads always need enctype multipart/form-data [OK]

Common Mistakes:

• Omitting enctype attribute
• Using method="get" instead of post
• Confusing action URL with enctype

3. Given this Laravel controller code snippet, what will be the value of $path after uploading a file named photo.jpg?

public function upload(Request $request) {
    $path = $request->file('image')->store('photos');
    return $path;
}

medium

A. "photos/unique_generated_name.jpg"

B. "/storage/photos/photo.jpg"

C. "photos/photo.jpg"

D. "/public/photos/photo.jpg"

Solution

1. Step 1: Understand how store() names files

   The store() method saves the file in the given folder but generates a unique filename to avoid overwriting.

2. Step 2: Check the returned path format

   The returned path is relative to the storage disk root and includes the folder plus the unique filename, not the original name.

3. Final Answer:

   "photos/unique_generated_name.jpg" -> Option A

4. Quick Check:

   store() returns folder + unique filename [OK]

Hint: store() auto-renames files to unique names [OK]

Common Mistakes:

• Assuming original filename is kept
• Expecting absolute URL path
• Confusing storage path with public URL

4. What is wrong with this Laravel file upload code?

public function upload(Request $request) {
    $file = $request->file('photo');
    $file->storeAs('uploads');
    return 'File uploaded';
}

medium

A. The storeAs() method cannot be used in Laravel

B. The file() method should be files()

C. The storeAs() method requires a second argument for filename

D. The uploads folder must be inside storage/app

Solution

1. Step 1: Check storeAs() method usage

   The storeAs() method requires two arguments: destination path and filename. Here only destination is given.

2. Step 2: Verify other method correctness

   file() is correct to get uploaded file; storeAs() is valid but needs filename; folder location depends on app setup.

3. Final Answer:

   The storeAs() method requires a second argument for filename -> Option C

4. Quick Check:

   storeAs() needs destination and filename [OK]

Hint: storeAs() always needs destination path and filename [OK]

Common Mistakes:

• Passing only destination to storeAs()
• Confusing file() with files()
• Assuming storeAs() is invalid in Laravel

5. You want to upload multiple images and save their paths in the database. Which Laravel code snippet correctly handles multiple file uploads and stores their paths in an array?

hard

A. $paths = $request->file('images')->move('gallery');

B. $paths = $request->file('images')->store('gallery');

C. foreach ($request->images as $image) {
$paths[] = $image->move('gallery');
}

D. foreach ($request->file('images') as $image) {
$paths[] = $image->store('gallery');
}

Solution

1. Step 1: Understand handling multiple files

   When uploading multiple files, $request->file('images') returns an array of files, so we loop through each.

2. Step 2: Use store() inside loop and collect paths

   Each file is stored individually with store(), and the returned paths are saved in an array.

3. Final Answer:

   foreach ($request->file('images') as $image) { $paths[] = $image->store('gallery'); } -> Option D

4. Quick Check:

   Loop files, store each, collect paths [OK]

Hint: Loop multiple files, store each, save paths in array [OK]

Common Mistakes:

• Calling store() on array directly
• Using move() without filename in loop
• Not looping over multiple files