控制器不必继承 App\Http\Controllers\Controller，但不继承将无法使用 middleware()、validate()、authorize() 等关键方法；文件须置于 app/Http/Controllers 目录，命名严格为大驼峰+Controller 后缀；路由绑定需显式 use 并用数组语法 [Controller::class, 'method']；参数按位置绑定，变量名无关；返回值类型决定响应内容。
控制器不是必须继承 App\Http\Controllers\Controller，但不继承就用不了 middleware()、validate()、authorize() 这些关键方法——实际项目里几乎没人裸写。
控制器文件位置和命名必须严格遵循约定
Laravel 默认只在 app/Http/Controllers 目录下自动加载控制器，且命名必须是「大驼峰 + Controller」后缀，比如 ProductController、ApiAuthController。手动生成文件时如果写成 product_controller.php 或放在 app/Controllers 下，路由会报 Class not found。
- Artisan 命令生成最安全：
php artisan make:controller ProductController - 若需 RESTful 资源控制器（含 index/store/show 等 7 个方法），加
--resource参数：php artisan make:controller ProductController --resource - 单动作控制器（如部署脚本）用
--invokable，生成带__invoke()方法的类
路由绑定控制器时，命名空间和 use 引入缺一不可
在 routes/web.php 或 routes/api.php 中，不能只写 'ProductController@index' —— 这是 Laravel 8 以前的字符串语法，已弃用且在新项目中默认不启用。现在必须显式 use 并传入数组形式：
use App\Http\Controllers\ProductController;
Route::get('/products', [ProductController::class, 'index']);
Route::post('/products', [ProductController::class, 'store']);
- 漏掉
use会导致Class 'ProductController' not found - 用字符串写法（如
'ProductController@index'）在 Laravel 9+ 默认关闭，除非手动启用RouteServiceProvider中的旧式解析 - 资源路由更简洁：
Route::resource('products', ProductController::class)，但前提是控制器已按资源方式生成
路由参数传递只认顺序，不认变量名
定义路由 Route::get('/user/{id}/post/{slug}', [PostController::class, 'show'])，控制器方法签名必须是 public function show($id, $slug)。哪怕你写成 public function show($userId, $postSlug)，Laravel 依然按位置把第一个路由参数塞给 $userId，第二个塞给 $postSlug——变量名完全无关。
- 类型提示（如
int $id）会被 Laravel 自动 cast，但不会影响参数绑定顺序 - 可选参数必须写在最后，且路由中要用
{id?}，控制器方法对应参数需设默认值：public function show($id, $tab = 'overview') - 请求查询参数（如
?page=2&sort=name）要通过request()->query()或Request $request对象获取，和路由参数完全隔离
最容易被忽略的是：控制器方法返回值直接决定响应内容类型。返回字符串就是纯文本；返回数组会转成 JSON（API 场景）；返回 view() 是 HTML 渲染；返回 redirect() 是跳转。没写返回值或写错类型，页面就空白或报 500，但错误日志里往往只显示“Undefined variable”之类误导信息。
