Laravel怎么创建控制器_Laravel怎么生成资源控制器【技巧】
先说一个最基础的操作:php artisan make:controller。默认跑完这条命令,生成的是一个空控制器,躺在app/Http/Controllers目录下,里头空荡荡的,一个方法都没有。很多人以为它自带__invoke或什么CRUD方法——其实想多了。要是你不加--invokable,
先说一个最基础的操作: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不走这逻辑。
控制器本身不难生成,真正卡住人的永远是路由怎么连、中间件怎么套、绑定字段对不对——这些地方一错,请求根本到不了方法里。


































