Creating controllers with Artisan in Laravel

Introduction

Controllers help organize your app's logic. Artisan makes creating them fast and easy.

When you want to handle user requests in a clean way.

When you need to group related actions like showing, creating, or deleting data.

When building a new feature that needs its own set of functions.

When you want to follow Laravel's recommended structure for apps.

When you want to quickly generate controller files without writing boilerplate code.

Syntax

Laravel

php artisan make:controller ControllerName

Replace ControllerName with your desired controller name.

You can add options like --resource to create a controller with common methods.

Examples

Creates a simple controller named UserController.

Laravel

php artisan make:controller UserController

Creates a controller with methods for common actions like index, create, store, show, edit, update, and destroy.

Laravel

php artisan make:controller ProductController --resource

Creates a controller inside the Admin folder to organize admin-related controllers.

Laravel

php artisan make:controller Admin/DashboardController

Sample Program

This is a simple controller named ArticleController with two methods: index to list articles and show to display a single article by ID.

Laravel

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class ArticleController extends Controller
{
    public function index()
    {
        return 'List of articles';
    }

    public function show($id)
    {
        return "Showing article with ID: $id";
    }
}

Important Notes

Controllers created with Artisan are saved in app/Http/Controllers by default.

Use the --resource flag to quickly scaffold common CRUD methods.

Remember to register your controller routes in routes/web.php or routes/api.php to make them accessible.

Summary

Artisan helps you create controllers quickly with simple commands.

Controllers organize your app's logic and handle user requests.

Use options like --resource to generate common methods automatically.

Practice

1. What does the Artisan command php artisan make:controller do in a Laravel project?

easy

A. It runs the Laravel server to test the application.

B. It creates a new controller file in the app/Http/Controllers directory.

C. It installs Laravel dependencies via Composer.

D. It creates a new database migration file.

Solution

1. Step 1: Understand the purpose of the make:controller command

   The command php artisan make:controller is designed to generate a new controller file automatically.

2. Step 2: Identify the location of the created controller

   By default, the new controller is placed in the app/Http/Controllers directory to organize application logic.

3. Final Answer:

   It creates a new controller file in the app/Http/Controllers directory. -> Option B

4. Quick Check:

   make:controller creates controller file [OK]

Hint: Remember: make:controller creates controller files [OK]

Common Mistakes:

• Confusing make:controller with server start commands
• Thinking it creates migrations or installs packages
• Assuming it runs the app instead of creating files

2. Which of the following is the correct Artisan command to create a resource controller named ProductController?

easy

A. php artisan make:controller ProductController --resource

B. php artisan create:controller ProductController --resource

C. php artisan make:controller ProductController -r

D. php artisan generate:controller ProductController --resource

Solution

1. Step 1: Recall the correct Artisan syntax for resource controllers

   The correct command uses make:controller with the --resource option to generate all resource methods.

2. Step 2: Verify the command spelling and options

   Only php artisan make:controller ProductController --resource matches Laravel's official syntax exactly.

3. Final Answer:

   php artisan make:controller ProductController --resource -> Option A

4. Quick Check:

   Use make:controller with --resource option [OK]

Hint: Use make:controller with --resource for full methods [OK]

Common Mistakes:

• Using create:controller or generate:controller commands
• Using short option -r which is invalid
• Misspelling make:controller

3. What will be the result of running php artisan make:controller UserController --resource in a Laravel project?

medium

A. Creates a UserController with methods like index, create, store, show, edit, update, and destroy.

B. Creates a UserController with only an index method.

C. Creates a UserController without any methods inside.

D. Throws an error because --resource is not a valid option.

Solution

1. Step 1: Understand the --resource option effect

   The --resource flag tells Artisan to generate a controller with all standard resource methods.

2. Step 2: List the methods generated

   These methods include index, create, store, show, edit, update, and destroy.

3. Final Answer:

   Creates a UserController with methods like index, create, store, show, edit, update, and destroy. -> Option A

4. Quick Check:

   --resource adds all resource methods [OK]

Hint: --resource adds all common controller methods [OK]

Common Mistakes:

• Thinking it creates empty controller without methods
• Assuming only index method is created
• Believing --resource is invalid option

4. You run php artisan make:controller AdminController -resource but get an error. What is the likely cause?

medium

A. AdminController name is reserved and cannot be used.

B. The make:controller command requires a namespace option.

C. You must run the command inside the database directory.

D. The short option -resource is invalid; it should be --resource.

Solution

1. Step 1: Check the option syntax used

   The command uses -resource which is incorrect; Laravel requires double dashes for options.

2. Step 2: Confirm correct option format

   The correct option is --resource with two dashes, not one.

3. Final Answer:

   The short option -resource is invalid; it should be --resource. -> Option D

4. Quick Check:

   Options need double dashes like --resource [OK]

Hint: Use double dashes for options like --resource [OK]

Common Mistakes:

• Using single dash for long options
• Thinking controller names are restricted
• Running commands outside project root

5. You want to create a controller named OrderController that includes resource methods and also API-specific methods without views. Which Artisan command should you use?

hard

A. php artisan make:controller OrderController --resource

B. php artisan make:controller OrderController --api

C. php artisan make:controller OrderController --resource --api

D. php artisan make:controller OrderController --viewless

Solution

1. Step 1: Understand the need for resource and API methods

   You want all resource methods but tailored for API use, which excludes view-related methods.

2. Step 2: Identify the correct Artisan options

   The --resource option adds resource methods, and --api modifies them to exclude create/edit views.

3. Step 3: Combine options correctly

   Using both --resource --api together creates a resource controller optimized for API.

4. Final Answer:

   php artisan make:controller OrderController --resource --api -> Option C

5. Quick Check:

   Use --resource and --api for API resource controllers [OK]

Hint: Combine --resource and --api for API-only controllers [OK]

Common Mistakes:

• Using only --api which creates minimal controller
• Using --resource alone which includes view methods
• Assuming --viewless is a valid option