Laravel怎么创建控制器_Laravel怎么生成资源控制器【技巧】

先说一个最基础的操作：php artisan make:controller。默认跑完这条命令，生成的是一个空控制器，躺在app/Http/Controllers目录下，里头空荡荡的，一个方法都没有。很多人以为它自带__invoke或什么CRUD方法——其实想多了。要是你不加--invokable，它就是个空壳。

用 php artisan make:controller 创建普通控制器

这个命令的典型场景就是自定义逻辑。生成后你得自己往里面写方法。常见的翻车现场：命令跑完就去访问路由，结果404——因为连路由都没注册。还有朋友以为加了--plain参数会不一样，其实新版Lara vel默认就是plain，加不加都一样。

• 加-m参数能顺便创建一个模型文件，但注意只是省去手动创建的步骤，并不会自动关联。
• 如果要扔到子目录下，比如Api/V1/UsersController，命令写成php artisan make:controller Api/V1/UsersController就行，斜杠不用转义。
• 类名必须PascalCase，文件名必须和类名严格一致，否则自动加载直接罢工。

用 php artisan make:controller --resource 生成资源控制器

这个坑踩的人最多：命令执行后，它确实生成了七个标准方法（index、create、store等），但不会自动注册路由。跑完命令直接访问/posts，等着你的绝对是404。资源控制器本质是代码模板，不是开箱即用的功能模块。

• 加--api参数会砍掉create和edit这两个返回视图的方法，适合前后端分离项目。
• HTTP动词映射是写死的，没法通过参数让index对应POST——想改就必须手动重写路由。
• 如果已经存在同名控制器，命令会报错，不会覆盖，只能先删文件或者换名。
• store和update方法默认用validate做表单验证，但实际项目更常用FormRequest类，这些默认逻辑得手动替换掉。

路由注册时别漏掉 ->middleware() 和命名

资源路由用Route::resource('posts', [PostController::class])注册后，所有方法默认没有中间件。登录态、API认证、权限检查都得显式加上。另外，Lara vel的命名路由（比如posts.index）在跳转和生成URL时非常依赖，漏命名会导致route()函数报错。

• 批量加中间件：->middleware(['auth', 'can:view,App\Models\Post'])
• 给单个动作加中间件：->only(['index', 'show'])->middleware('cache.headers')
• 改命名前缀：->names('admin.posts')，然后route('admin.posts.index')才管用。
• 如果控制器方法名被改过（比如把index改成listAll），对应路由会失效，必须用->actions()显式映射。

资源控制器的「隐式绑定」要小心字段名

当路由定义为/posts/{post}，控制器方法签名是show(Post $post)，Lara vel会自动按主键查模型——前提是路由参数名和类型提示的变量名一致，且模型主键是id。一旦你把主键改成uuid或字段叫post_id，又没配getRouteKeyName()，ModelNotFoundException就会直接抛出来。

• 在模型里加public function getRouteKeyName() { return 'slug'; }可切换查找字段。
• 如果路由参数是{post_slug}，但类型提示还是Post $post，绑定会失败——必须同步改变量名为$post_slug。
• 资源路由的隐式绑定只对show、edit、update、destroy生效，index和create不走这逻辑。

控制器本身不难生成，真正卡住人的永远是路由怎么连、中间件怎么套、绑定字段对不对——这些地方一错，请求根本到不了方法里。