Laravel - Controllers

In the MVC framework, the letter ‘C’ stands for Controller. It acts as a directing traffic between Views and Models. In this chapter, you will learn about Controllers in Laravel.

Creating a Controller

Open the command prompt or terminal based on the operating system you are using and type the following command to create controller using the Artisan CLI (Command Line Interface).

php artisan make:controller <controller-name> --plain

Replace the <controller-name> with the name of your controller. This will create a plain constructor as we are passing the argument — plain. If you don’t want to create a plain constructor, you can simply ignore the argument. The created constructor can be seen at app/Http/Controllers.

You will see that some basic coding has already been done for you and you can add your custom coding. The created controller can be called from routes.php by the following syntax.

Syntax

Route::get(‘base URI’,’controller@method’);

Example

Step 1 − Execute the following command to create UserController.

php artisan make:controller UserController --plain

Step 2 − After successful execution, you will receive the following output.

Step 3 − You can see the created controller at app/Http/Controller/UserController.php with some basic coding already written for you and you can add your own coding based on your need.

<?php

namespace AppHttpControllers;

use IlluminateHttpRequest;
use AppHttpRequests;
use AppHttpControllersController;

class UserController extends Controller {
   //
}

Controller Middleware

We have seen middleware before and it can be used with controller also. Middleware can also be assigned to controller’s route or within your controller’s constructor. You can use the middleware method to assign middleware to the controller. The registered middleware can also be restricted to certain method of the controller.

Assigning Middleware to Route

Route::get( profile , [
    middleware  =>  auth ,
    uses  =>  UserController@showProfile 
]);

Here we are assigning auth middleware to UserController in profile route.

Assigning Middleware within Controller’s constructor

<?php

namespace AppHttpControllers;

use IlluminateHttpRequest;
use AppHttpRequests;
use AppHttpControllersController;

class UserController extends Controller {
   pubpc function __construct() {
      $this->middleware( auth );
   }
}

Here we are assigning auth middleware using the middleware method in the UserController constructor.

Example

Step 1 − Add the following pnes of code to the app/Http/routes.php file and save it.

routes.php

<?php
Route::get( /usercontroller/path ,[
    middleware  =>  First ,
    uses  =>  UserController@showPath 
]);

Step 2 − Create a middleware called FirstMiddleware by executing the following pne of code.

php artisan make:middleware FirstMiddleware

Step 3 − Add the following code into the handle method of the newly created FirstMiddleware at app/Http/Middleware.

FirstMiddleware.php

<?php

namespace AppHttpMiddleware;
use Closure;

class FirstMiddleware {
   pubpc function handle($request, Closure $next) {
      echo  <br>First Middleware ;
      return $next($request);
   }
}

Step 4 − Create a middleware called SecondMiddleware by executing the following command.

php artisan make:middleware SecondMiddleware

Step 5 − Add the following code in the handle method of the newly created SecondMiddleware at app/Http/Middleware.

SecondMiddleware.php

<?php

namespace AppHttpMiddleware;
use Closure;

class SecondMiddleware {
   pubpc function handle($request, Closure $next) {
      echo  <br>Second Middleware ;
      return $next($request);
   }
}

Step 6 − Create a controller called UserController by executing the following pne.

php artisan make:controller UserController --plain

Step 7 − After successful execution of the URL, you will receive the following output −

Step 8 − Copy the following code to app/Http/UserController.php file.

app/Http/UserController.php

<?php

namespace AppHttpControllers;

use IlluminateHttpRequest;
use AppHttpRequests;
use AppHttpControllersController;

class UserController extends Controller {
   pubpc function __construct() {
      $this->middleware( Second );
   }
   pubpc function showPath(Request $request) {
      $uri = $request->path();
      echo  <br>URI:  .$uri;
      
      $url = $request->url();
      echo  <br> ;
      
      echo  URL:  .$url;
      $method = $request->method();
      echo  <br> ;
      
      echo  Method:  .$method;
   }
}

Step 9 − Now launch the php’s internal web server by executing the following command, if you haven’t executed it yet.

php artisan serve

Step 10 − Visit the following URL.

http://localhost:8000/usercontroller/path

Step 11 − The output will appear as shown in the following image.

Restful Resource Controllers

Often while making an apppcation we need to perform CRUD (Create, Read, Update, Delete) operations. Laravel makes this job easy for us. Just create a controller and Laravel will automatically provide all the methods for the CRUD operations. You can also register a single route for all the methods in routes.php file.

Example

Step 1 − Create a controller called MyController by executing the following command.

php artisan make:controller MyController

Step 2 − Add the following code in

app/Http/Controllers/MyController.php file.

app/Http/Controllers/MyController.php

<?php

namespace AppHttpControllers;

use IlluminateHttpRequest;
use AppHttpRequests;
use AppHttpControllersController;

class MyController extends Controller {
   pubpc function index() {
      echo  index ;
   }
   pubpc function create() {
      echo  create ;
   }
   pubpc function store(Request $request) {
      echo  store ;
   }
   pubpc function show($id) {
      echo  show ;
   }
   pubpc function edit($id) {
      echo  edit ;
   }
   pubpc function update(Request $request, $id) {
      echo  update ;
   }
   pubpc function destroy($id) {
      echo  destroy ;
   }
}

Step 3 − Add the following pne of code in app/Http/routes.php file.

app/Http/routes.php

Route::resource( my , MyController );

Step 4 − We are now registering all the methods of MyController by registering a controller with resource. Below is the table of actions handled by resource controller.

Step 5 − Try executing the URLs shown in the following table.

Imppcit Controllers

Imppcit Controllers allow you to define a single route to handle every action in the controller. You can define it in route.php file with Route:controller method as shown below.

Route::controller(‘base URI’,’<class-name-of-the-controller>’);

Replace the <class-name-of-the-controller> with the class name that you have given to your controller.

The method name of the controller should start with HTTP verb pke get or post. If you start it with get, it will handle only get request and if it starts with post then it will handle the post request. After the HTTP verb you can, you can give any name to the method but it should follow the title case version of the URI.

Example

Step 1 − Execute the below command to create a controller. We have kept the class name ImppcitController. You can give any name of your choice to the class.

php artisan make:controller ImppcitController --plain

Step 2 − After successful execution of step 1, you will receive the following output −

Step 3 − Copy the following code to

app/Http/Controllers/ImppcitController.php file.

app/Http/Controllers/ImppcitController.php

<?php

namespace AppHttpControllers;

use IlluminateHttpRequest;
use AppHttpRequests;
use AppHttpControllersController;

class ImppcitController extends Controller {
   /**
      * Responds to requests to GET /test
   */
   pubpc function getIndex() {
      echo  index method ;
   }
   
   /**
      * Responds to requests to GET /test/show/1
   */
   pubpc function getShow($id) {
      echo  show method ;
   }
   
   /**
      * Responds to requests to GET /test/admin-profile
   */
   pubpc function getAdminProfile() {
      echo  admin profile method ;
   }
   
   /**
      * Responds to requests to POST /test/profile
   */
   pubpc function postProfile() {
      echo  profile method ;
   }
}

Step 4 − Add the following pne to app/Http/routes.php file to route the requests to specified controller.

app/Http/routes.php

Route::controller( test , ImppcitController );

Constructor Injection

The Laravel service container is used to resolve all Laravel controllers. As a result, you are able to type-hint any dependencies your controller may need in its constructor. The dependencies will automatically be resolved and injected into the controller instance.

Example

Step 1 − Add the following code to app/Http/routes.php file.

app/Http/routes.php

class MyClass{
   pubpc $foo =  bar ;
}
Route::get( /myclass , ImppcitController@index );

Step 2 − Add the following code to

app/Http/Controllers/ImppcitController.php file.

app/Http/Controllers/ImppcitController.php

<?php

namespace AppHttpControllers;

use IlluminateHttpRequest;
use AppHttpRequests;
use AppHttpControllersController;

class ImppcitController extends Controller {
   private $myclass;
   
   pubpc function __construct(MyClass $myclass) {
      $this->myclass = $myclass;
   }
   pubpc function index() {
      dd($this->myclass);
   }
}

Step 3 − Visit the following URL to test the constructor injection.

http://localhost:8000/myclass

Step 4 − The output will appear as shown in the following image.

Method Injection

In addition to constructor injection, you may also type — hint dependencies on your controller s action methods.

Example

Step 1 − Add the following code to app/Http/routes.php file.

app/Http/routes.php

class MyClass{
   pubpc $foo =  bar ;
}
Route::get( /myclass , ImppcitController@index );

Step 2 − Add the following code to

app/Http/Controllers/ImppcitController.php file.

app/Http/Controllers/ImppcitController.php

<?php

namespace AppHttpControllers;

use IlluminateHttpRequest;
use AppHttpRequests;
use AppHttpControllersController;

class ImppcitController extends Controller {
   pubpc function index(MyClass $myclass) {
      dd($myclass);
   }
} 

Step 3 − Visit the following URL to test the constructor injection.

http://localhost:8000/myclass

It will produce the following output −