如何在 Laravel 中定义一个基础路由并关联控制器方法？

题目

如何在 Laravel 中定义一个基础路由并关联控制器方法？

信息

• 类型：问答
• 难度：⭐

考点

路由定义, 控制器关联, HTTP方法

快速回答

在 Laravel 中定义基础路由的步骤：

1. 在 routes/web.php 文件中使用路由方法（如 Route::get()）
2. 指定 URI 路径和关联的控制器方法
3. 通过 控制器名@方法名 语法绑定控制器

示例代码：
Route::get('/products', 'ProductController@index');

解析

一、原理说明

Laravel 路由是用户请求与应用逻辑之间的桥梁。当请求到达时，Laravel 会通过路由文件匹配 URI 和 HTTP 方法，然后执行绑定的控制器方法。

二、代码示例

基本路由定义（routes/web.php）：

// 关联到控制器方法
Route::get('/products', 'ProductController@index');

// 闭包函数形式（不推荐复杂逻辑）
Route::get('/welcome', function () {
    return view('welcome');
});

控制器示例（app/Http/Controllers/ProductController.php）：

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class ProductController extends Controller
{
    public function index()
    {
        // 获取产品列表逻辑
        return view('products.index');
    }
}

三、最佳实践

1. 使用控制器： 业务逻辑应放在控制器中，避免在路由文件写闭包函数
2. 路由命名： 使用 ->name() 为路由命名便于引用
   Route::get('/products', 'ProductController@index')->name('products.index');
3. 遵循 RESTful 规范：
   • GET /products → ProductController@index（列表）
   • GET /products/create → @create（创建页）
   • POST /products → @store（保存数据）

四、常见错误

• 控制器未引入： 忘记在控制器顶部添加 use App\Http\Controllers\ProductController;
• 方法不存在： 控制器缺少定义的方法（如将 @index 错写为 @show）
• 路由冲突： 相同 URI 和 HTTP 方法定义了多个路由
• 未清除路由缓存： 修改路由后需运行 php artisan route:clear

五、扩展知识

• 路由参数： Route::get('/products/{id}', 'ProductController@show');
• 路由分组： 用 Route::group() 共享前缀/中间件

  Route::prefix('admin')->group(function () {
      Route::get('/users', 'AdminController@users');
  });

• API 路由： 在 routes/api.php 中定义，自动添加 /api 前缀
• 查看所有路由： 运行 php artisan route:list