Laravel 9/10从路由向控制器传递变量的正确方法

问题背景 #

现有两个路由，分别对应控制器的不同方法，用于展示带不同筛选选项的列表：

Route::get('/events', [EventsController::class, 'eventsList'])->name('event-list');
Route::get('/courses', [EventsController::class, 'allCoursesList'])->name('all-events');

希望合并为一个控制器方法，通过传递变量（如all=1）区分处理逻辑，但使用旧写法时触发错误：

Route::get('/courses', [
    'all' => 1,
    'uses' => 'EventsController@CourseList'
])->name('all-events');

报错信息：

Target class [EventsController] does not exist.

正确实现方式 #

方式1：查询参数/路由名称判断（兼容原URL结构） #

保留原有两个路由入口，在控制器中通过查询参数或路由名称区分逻辑：

// 保留原路由定义
Route::get('/events', [EventsController::class, 'combinedList'])->name('event-list');
Route::get('/courses', [EventsController::class, 'combinedList'])->name('all-events');

控制器方法实现：

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Route;

public function combinedList(Request $request)
{
    // 方式A：通过查询参数判断
    $isAll = $request->query('all', 0);
    
    // 方式B：通过路由名称判断（更贴合原需求）
    $isAll = Route::currentRouteName() === 'all-events' ? 1 : 0;

    // 根据$isAll执行不同筛选逻辑
    if ($isAll) {
        // 全量课程列表逻辑
    } else {
        // 普通活动列表逻辑
    }
}

方式2：路由默认参数注入（Laravel 9+原生支持） #

使用defaults方法为路由绑定固定参数，控制器直接接收：

Route::get('/courses', [EventsController::class, 'combinedList'])
    ->defaults('all', 1)
    ->name('all-events');

Route::get('/events', [EventsController::class, 'combinedList'])
    ->defaults('all', 0)
    ->name('event-list');

控制器方法：

public function combinedList(Request $request, $all = 0)
{
    // $all会自动获取路由中设置的默认值
    // 后续筛选逻辑处理
}

方式3：路由参数定义（精简URL结构） #

将类型作为URL参数，直接传递给控制器：

Route::get('/{type}', [EventsController::class, 'combinedList'])
    ->whereIn('type', ['events', 'courses']) // 限制参数合法取值
    ->name('combined-list');

控制器方法：

public function combinedList($type)
{
    $isAll = $type === 'courses' ? 1 : 0;
    // 根据类型执行对应逻辑
}

错误原因说明 #

你使用的是Laravel 8及之前的字符串控制器语法，而Laravel 9+默认要求使用**完全限定类名（FQCN）**的写法，直接写'uses' => 'EventsController@CourseList'会导致框架无法找到对应类。即使改为[EventsController::class, 'CourseList']，旧的数组参数传递方式也已被废弃，需使用上述原生支持的参数传递方案。

内容的提问来源于stack exchange，提问作者Nifty Matrix