Controller methods and actions in Laravel - Step-by-Step Execution

Concept Flow - Controller methods and actions

HTTP Request Received

↓

Route Matches URL

↓

Controller Method Called

↓

Method Executes Action

↓

Return Response (View/Redirect/JSON)

↓

Response Sent to Browser

When a user visits a URL, Laravel finds the matching route, calls the controller method, which runs code and returns a response.

Execution Sample

Laravel

public function show($id) {
    $user = User::find($id);
    return view('user.profile', ['user' => $user]);
}

This method gets a user by ID and returns a profile view with user data.

Execution Table

Step	Action	Input/State	Output/Result
1	HTTP request to /user/5	URL: /user/5	Route matches 'user/{id}'
2	Call Controller@show	Parameter id=5	Method show(5) called
3	Find user by ID	User::find(5)	User object with id=5 or null
4	Return view	view('user.profile', ['user' => $user])	HTML page with user data
5	Send response	HTML content	Browser displays user profile

💡 Response sent to browser, request cycle ends

Variable Tracker

Variable	Start	After Step 3	After Step 4	Final
id	undefined	5	5	5
user	undefined	User object or null	User object or null	User object or null

Key Moments - 3 Insights

Why does the controller method receive the $id parameter?

Because the route defines a placeholder {id}, Laravel extracts it from the URL and passes it to the controller method as $id (see execution_table step 2).

What happens if User::find($id) returns null?

The method still returns the view, but the user variable will be null. The view should handle this case to avoid errors (see execution_table step 3).

How does the controller return a response to the browser?

By returning a view or other response object, Laravel converts it to HTML and sends it back to the browser (see execution_table steps 4 and 5).

Visual Quiz - 3 Questions

Look at the execution table, what is the value of $id when the controller method is called?

A null

B undefined

C 5

D user object

💡 Hint

Check execution_table step 2 where the method is called with id=5

At which step does Laravel find the user object from the database?

A Step 1

B Step 3

C Step 2

D Step 4

💡 Hint

Look at execution_table step 3 where User::find is called

If the route URL was /user/10, how would the variable tracker change?

A $id would be 10 instead of 5

B $user would be null always

C $id would be undefined

D No change in variables

💡 Hint

Variable $id tracks the route parameter, see variable_tracker for $id values

Concept Snapshot

Controller methods handle requests matched by routes.
Parameters from URLs are passed as method arguments.
Methods perform actions like fetching data.
Return views or responses to send HTML or JSON.
Laravel manages request to response flow automatically.

Full Transcript

When a user visits a URL, Laravel matches it to a route. The route calls a controller method, passing URL parts as parameters. The method runs code, like fetching a user by ID. It then returns a view with data. Laravel sends this view as HTML back to the browser. Variables like $id and $user change as the method runs. If the user is not found, the method still returns the view but with null data. This flow ensures user requests get proper responses.

Practice

1. What is the main purpose of a controller method (action) in Laravel?

easy

A. To handle a specific user request and return a response

B. To define database schema

C. To style the HTML output

D. To manage server configuration

Solution

1. Step 1: Understand controller role

   Controllers group related logic into methods called actions.

2. Step 2: Identify action purpose

   Each action handles a user request and returns a response like a view or JSON.

3. Final Answer:

   To handle a specific user request and return a response -> Option A

4. Quick Check:

   Controller action = handle request and respond [OK]

Hint: Controllers handle requests and responses, not styling or config [OK]

Common Mistakes:

• Confusing controller methods with database or styling tasks
• Thinking controllers manage server settings
• Assuming controllers only return views

2. Which of the following is the correct syntax to define a controller method named show in Laravel?

easy

A. function show() public { /* code */ }

B. public function show() { /* code */ }

C. public show function() { /* code */ }

D. def show() { /* code */ }

Solution

1. Step 1: Recall PHP method syntax

   In PHP, methods are defined with visibility, function keyword, name, and parentheses.

2. Step 2: Match Laravel controller method syntax

   Laravel uses PHP syntax: public function methodName() {}.

3. Final Answer:

   public function show() { /* code */ } -> Option B

4. Quick Check:

   PHP method = public function name() [OK]

Hint: Remember PHP method syntax: visibility + function + name() [OK]

Common Mistakes:

• Placing visibility after function keyword
• Using Python style def keyword
• Omitting parentheses after method name

3. Given this controller method in Laravel:

public function greet($name) {
    return "Hello, " . $name . "!";
}

What will be the output if called with $controller->greet('Anna')?

medium

A. "Hello, Anna!"

B. "Hello, $name!"

C. Error: Undefined variable

D. "Hello, !"

Solution

1. Step 1: Understand method parameter usage

   The method receives $name and concatenates it with strings.

2. Step 2: Substitute argument value

   Calling with 'Anna' replaces $name with 'Anna', so output is "Hello, Anna!".

3. Final Answer:

   "Hello, Anna!" -> Option A

4. Quick Check:

   Parameter value used in string = "Hello, Anna!" [OK]

Hint: Replace parameter with argument value to find output [OK]

Common Mistakes:

• Treating $name as literal string
• Expecting error due to missing variable
• Ignoring string concatenation

4. Identify the error in this Laravel controller method:

public function index()
{
    return view('welcome')
}

medium

A. View name should be capitalized

B. Incorrect method name

C. Missing semicolon after return statement

D. Missing parentheses in view() call

Solution

1. Step 1: Check PHP syntax in method

   PHP statements must end with a semicolon; here it is missing after return view('welcome').

2. Step 2: Validate other parts

   Method name and view call syntax are correct; view name case is not an error.

3. Final Answer:

   Missing semicolon after return statement -> Option C

4. Quick Check:

   PHP statements end with ; [OK]

Hint: Check for missing semicolons after return statements [OK]

Common Mistakes:

• Ignoring missing semicolon causing syntax error
• Thinking view names must be capitalized
• Assuming parentheses are missing in view()

5. You want to create a Laravel controller method that returns a JSON response with a user's name and email. Which method correctly does this?

public function userInfo()
{
    $user = ['name' => 'John', 'email' => '[e-mail]'];
    // Fill in the return statement
}

hard

A. return json($user);

B. return json_response($user);

C. return response->json($user);

D. return response()->json($user);

Solution

1. Step 1: Recall Laravel JSON response syntax

   Laravel uses response()->json() helper to return JSON responses.

2. Step 2: Check each option's syntax

   return response()->json($user); correctly calls response()->json($user);. Others are invalid or incorrect syntax.

3. Final Answer:

   return response()->json($user); -> Option D

4. Quick Check:

   Use response()->json() for JSON output [OK]

Hint: Use response()->json() helper to return JSON [OK]

Common Mistakes:

• Using undefined functions like json() or json_response()
• Missing parentheses or arrow operator in response call
• Confusing PHP syntax for method calls