Laravel 示例控制器 - PHP

Laravel 是一款流行的 PHP 框架，它提供了丰富的功能和工具来快速构建优秀的 Web 应用程序。其中一个核心组件就是控制器，用于处理来自用户的 HTTP 请求并返回合适的响应。

在本文中，我们将介绍 Laravel 中示例控制器的用法和功能。

创建示例控制器

首先，我们需要创建一个示例控制器。在 Laravel 中，控制器通常存放在 app/Http/Controllers 目录下。我们在该目录下创建一个名为 ExampleController 的控制器：

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class ExampleController extends Controller
{
    public function index()
    {
        return 'Hello, world!';
    }
}

在上面的代码片段中，我们定义了一个名为 ExampleController 的控制器，并添加了一个名为 index 的方法。该方法返回一个简单的字符串 Hello, world!。

定义路由

接下来，我们需要定义一个路由来指定该控制器的访问路径。在 Laravel 中，路由通常存放在 routes/web.php 文件中。在该文件中，我们添加以下代码片段：

Route::get('/example', 'ExampleController@index');

在上面的代码片段中，我们定义了一个 GET 请求路径 /example，它将映射到 ExampleController 控制器的 index 方法。

访问示例控制器

现在我们已经创建了示例控制器并定义了相应路由，让我们来访问该控制器并查看结果。

启动 Laravel 开发服务器并访问 http://localhost:8000/example，您应该看到 Hello, world! 字符串输出在浏览器中。

示例控制器方法参数

示例控制器的 index 方法没有参数。然而，控制器方法通常需要访问 HTTP 请求参数、路由参数、服务容器等等。在 Laravel 中，我们可以轻松地注入这些参数作为方法参数。

例如，让我们添加一个可以接收请求参数的新方法 greet。

class ExampleController extends Controller
{
    public function index()
    {
        return 'Hello, world!';
    }

    public function greet(Request $request, $name)
    {
        return sprintf('Hello, %s!', $name);
    }
}

在上面的代码片段中，我们添加了一个名为 greet 的新方法，并声明了两个参数 $request 和 $name。其中 $request 参数是来自 Illuminate\Http\Request 类型的实例，它包含了当前 HTTP 请求的信息；$name 参数是由路由定义中的占位符 {name} 来指定的路由参数。

我们还需要更新路由定义：

Route::get('/example', 'ExampleController@index');
Route::get('/example/{name}', 'ExampleController@greet');

现在访问 http://localhost:8000/example/foo，您将看到输出 Hello, foo!。

控制器中间件

在 Laravel 中，中间件用于在处理请求之前或之后执行一些操作。我们可以将中间件应用到控制器，来添加额外的逻辑验证、授权、缓存等等。

例如，让我们为 ExampleController 添加一个名为 auth 的中间件。该中间件将检查用户是否已经通过身份验证，如果没有，则将其重定向到登录页面。

首先，我们需要定义一个中间件。在 Laravel 中，中间件通常存放在 app/Http/Middleware 目录中。我们在该目录下创建一个名为 Authenticate.php 的中间件：

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Auth\Middleware\Authenticate as Middleware;

class Authenticate extends Middleware
{
    public function handle($request, Closure $next, ...$guards)
    {
        if ($this->auth->guard('web')->guest()) {
            return redirect()->guest('/login');
        }

        return $next($request);
    }
}

在上面的代码片段中，我们定义了一个名为 Authenticate 的中间件，并重写了其中的 handle 方法。在该方法中，我们检查用户是否已认证，如果没有，则将其重定向到 /login。$next 参数表示后续中间件或控制器处理的回调函数。

接下来，我们需要将该中间件应用到 ExampleController 控制器。我们可以在控制器中添加 $middleware 属性，或者在路由中使用 middleware 方法。在本例中，我们将使用后者：

Route::get('/example', 'ExampleController@index')->middleware('auth');
Route::get('/example/{name}', 'ExampleController@greet')->middleware('auth');

现在如果我们在未认证的情况下试图访问 http://localhost:8000/example/foo，我们将被重定向到登录页面。

结论

在本文中，我们介绍了 Laravel 中示例控制器的用法和功能。您应该了解如何创建和访问控制器、如何注入参数、如何应用中间件等等。掌握这些技能将有助于您构建更加高效、安全、易于维护的 Web 应用程序。