Laravel 9 Image Upload Example Code Tutorial

If you are looking for how to make image upload functionality in laravel then you are in the right place.

Because in this tutorial, I will show you how to make upload image functionality with validation rules in the latest version laravel 9. We will first install the laravel 9 and then see the example code of image upload functionality.

I will show step by step example guide. So you can understand the code and integrate an image upload functionality in your laravel 9 projects.

Go check out our previous tutorial about Eloquent Mutators and Accessors in Laravel 9.

Let’s get started on image upload functionality in laravel.

Image Upload Example in Laravel 9

So in this laravel image upload tutorial, we will start from scratch so you can easily understand each piece of code.

We will install the laravel 9 latest version of it, database configuration, and create a migration, model, and controller.

And final we will create two routes, one will be a GET request to show the image upload form and another will be a POST request to save the image in the database.

See Also: Create Laravel 9 CRUD Application Step by Step

So let’s start with installing laravel project.

Install Laravel Project

To install the laravel project, you need to run the following command in your terminal. Make sure you are at that place where you want to create a project directory.

composer create-project --prefer-dist laravel/laravel laravel-image-upload

For more details, see our step by step guide on how to install composer and laravel?

Database Configuration

After installing the laravel, we have to set up the database settings. To configure the database connection in laravel, open the .env file in the project root directory.

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_image_upload
DB_USERNAME=root
DB_PASSWORD=password

Configure the above details as per your’s database and server details.

Create Migration

To create the tables in a database in laravel, you need migration files that have table columns defined. So run the following command to create the migration file in the database/migrations folder.

php artisan make:migration create_products_table --create=products

Now open this migration file and make changes as per your requirements. For this tutorial, I’m taking the following columns.

public function up()
{
    Schema::create('products', function (Blueprint $table) {
        $table->bigIncrements('id');
        $table->string('name');
        $table->text('description');
        $table->text('price');
        $table->text('sku');
        $table->text('image');
        $table->timestamps();
    });
}

After making changes in the up() function of the migration file, run the following command to migrate this and create a table in a database.

php artisan migrate

Create Model

To create the model in laravel, run the following command in your terminal. It will create a new model file in your project’s app/Models folder.

php artisan make:model Product

Open the app/Models/Product.php file and add all fields in the $fillable variable. It is important to make all fields writeable because we are going to save data in these fields.

protected $fillable = [
    'name',
    'description',
    'price',
    'sku',
    'image',
];

Create Controller

Open your machine’s terminal and run the below command to create a controller in laravel. This is the file where we are going to save the image in the database.

php artisan make:controller ProductController --resource

You can also create a migration, model, and controller with resources only in one command, check that command here.

Go to the app/Http/Controllers folder and open the ProductController.php file. We will use index() and store() functions.

The index() function will use to show the image upload form (you can say product upload form with image) and the store() function will use to save the product details along with the image.

public function index()
{
    return view('product-form');
}

public function store(Request $request){
    $request->validate([
    	'image' => 'required|image|mimes:jpg,png,jpeg,gif,svg|max:5120'
    ]);

    $product = new Product;

    if($request->hasFile('image')) {
        $fileName = time().'_'.$request->image->getClientOriginalName();
        $filePath = $request->file('image')->storeAs('uploads', $fileName);
        $product->image = '/storage/' . $filePath;
    }

    $product->name = $request->name;
    $product->description = $request->description;
    $product->price = $request->price;
    $product->sku = $request->sku;

    $product->save();

    return back()
        ->with('success','Product has been created.')
        ->with('image', $fileName);
}

In the above store function, first, we check whether the image extensions allow or not along with a max of 5MB size.

Then we made a condition while checking that request has a file and get the image original name from the request using the getClientOriginalName() function.

In the next line, we store the image in the storage folder in the uploads directory, and in the next line, we save the image file path in the database by referencing the /storage folder.

And next, we store all other details for the product in an instance and then use the save() function to save them into the database.

Store Image in Public Folder

$request->image->move(public_path('uploads'), $fileName);

// public/uploads/image.png

Store Image in S3

$request->image->storeAs('uploads', $fileName, 's3');

// S3 dynamic URL

Store Image in Storage Folder

$request->image->storeAs('uploads', $fileName);

// storage/app/uploads/image.png

Create Blade Files

Now let’s create the blade view file for showing the product upload form with the image and all other details.

Create a product-form.blade.php file in the /resources/views folder. You can also create a new folder inside the view folder.

/resources/views/product-form.blade.php

<!DOCTYPE html>
<html lang="en">
<head>
    <title>Laravel 9 Image Upload Functionality Step by Step Guide</title>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/css/bootstrap.min.css" rel="stylesheet">
</head>
<body>
	<div class="container">
	    <div class="row">
	        <div class="col-lg-12 text-center">
	            <h2>Laravel 9 Image Upload Tutorial - Product Form</h2>
	        </div>
	    </div>
	 
	    @if($message = Session::get('success'))
	        <div class="alert alert-success">
	            <div>{{ $message }}</div>
	        </div>
	    @endif

	    @if($message = Session::get('image'))
	        <div class="alert alert-success">
	            <img src="uploads/{{ Session::get('image') }}">
	        </div>
	    @endif
	 	
	    @if(count($errors) > 0)
            <div class="alert alert-danger">
                <ul>
                    @foreach ($errors->all() as $error)
                      <li>{{ $error }}</li>
                    @endforeach
                </ul>
            </div>
        @endif

	 	<div class="row">
        	<form action="{{ route('product.store') }}" method="POST" enctype="multipart/form-data">
	            
	            @csrf

	            <div class="col-lg-6">
	            	<label class="form-label" for="name">Product Name:</label>
	                <input type="text" name="name" id="name" class="form-control">
	            </div>

	            <div class="col-lg-6">
	            	<label class="form-label" for="price">Product Price:</label>
	                <input type="text" name="price" id="price" class="form-control">
	            </div>

	            <div class="col-lg-6">
	            	<label class="form-label" for="sku">Product SKU:</label>
	                <input type="text" name="sku" id="sku" class="form-control">
	            </div>

	            <div class="col-lg-6">
	            	<label class="form-label" for="image">Featured Image:</label>
	                <input type="file" name="image" id="image" class="form-control @error('image') is-invalid @enderror">
	            </div>

	            <div class="col-lg-6">
	            	<label class="form-label" for="description">Product Description:</label>
	                <textarea name="description" id="description" class="form-control w-100" rwos="10"></textarea>
	            </div>
	   
	            <div class="mb-3">
	                <button type="submit" class="btn btn-success">Save Product</button>
	            </div>		       
	        </form>
	    </div>

	</div>
</body>
</html>

In this blade view file, we made a form that has product name, description, price, SKU, and of course image upload fields, which is the main point of this tutorial.

In the form tag, make sure you have added the POST method, enctype attribute, and action route.

Let’s now create the routes for showing the form and saving the product fields data and also with images.

Create Routes

Add the routes on the web.php file in the /routes folder (routes/web.php), so simply take a reference of the below code and add the routes of your application.

use App\Http\Controllers\ProductController;

Route::get('/product-form', [ProductController::class, 'index']);
Route::post('/upload-product-with-image', [ProductController::class, 'store'])->name('product.store');

Run Laravel Application

If you have successfully done all the above steps, so now it’s time to run our functionality which we have built to upload image with laravel 9 version. To run the laravel application, you need to run the following command in the terminal.

php artisan serve

It will start to serve your laravel application in your browser or give you a link with a port to check your application.

http://localhost:8000/product-form

Hope you understand all code and each step about how to upload image in laravel latest version 9. If you still face any issues or have any queries please do let me know in the comment section. I will help you with that. Thanks.

See Also: Create Laravel 9 CRUD Application Step by Step