Laravel 11 从入门到精通指南

Laravel 11 并非 Laravel 10 的平滑升级，而是一次彻底的架构重写：它废除了传统的 Kernel 和 Providers 目录结构，将入口逻辑全部收束至 bootstrap/app.php，路由统一为单文件 routes.php，所有中间件、服务提供者、异常处理器均需显式注册——隐式约定几乎归零，容错率大幅降低但控制力空前增强；从项目创建（需指定 ^11.0 版本、Composer 3.x）、密钥生成（不再自动执行）、到中间件绑定、迁移写法，每一步都要求开发者直面底层契约，真正卡住人的不再是功能缺失，而是那些被“简化”掉却至关重要的显式声明——想顺利上手？务必死盯 bootstrap/app.php、routes.php 和数据库迁移这三大核心战场。

直接说结论：Laravel 11 不是“升级版 Laravel 10”，它是框架逻辑的重写——没有 app/Http/Kernel.php，没有 app/Providers 目录，默认不加载任何服务提供者，routes/web.php 和 routes/api.php 合并为单文件 routes.php。你不能照搬旧项目结构跑起来，必须按新约定重写入口和路由组织方式。

composer create-project 装不出 Laravel 11？检查三件事

默认命令 composer create-project laravel/laravel 极大概率拉到 v10.48 或更早版本，因为 Packagist 的 latest 标签未同步。必须显式指定版本约束：

• 用 composer create-project laravel/laravel:^11.0（注意 ^，允许小版本更新）
• 确认 Composer 是 3.x：composer --version 输出应为 3.x；Composer 2.x 会卡在依赖解析
• 加 --no-interaction 参数，否则初始化脚本可能跳过 .env 写入或 APP_KEY 生成

装完立刻进目录执行 php artisan key:generate——Laravel 11 不再自动做这件事，APP_KEY 为空会导致 session、加密、签名 URL 全部失效。

bootstrap/app.php 是新内核，不是“启动脚本”

这个文件现在承担了旧版 app/Http/Kernel.php + config/app.php + app/Providers 的职责。常见错误是只改路由、不动这里，结果报 Middleware group [api] does not exist：

• 中间件组必须显式注册：$app->withMiddleware(function (Middleware $middleware) { $middleware->group('api', [...]); });
• AppServiceProvider 不再自动 boot，得手动 $app->register(AppServiceProvider::class)
• 自定义异常处理器（如 App\Exceptions\Handler）要靠 $app->withExceptions() 挂载，漏掉就退回到默认错误页

别把它当“可选配置”跳过——它现在就是应用的主干逻辑定义点。

routes.php 里写 API 路由，middleware 必须显式声明

旧习惯用 Route::prefix('api')->middleware('api') 自动包裹？Laravel 11 不再支持这种隐式绑定。所有 API 路由必须逐条或分组显式挂 ->middleware('api')：

Route::middleware('api')->group(function () {
    Route::get('/users', [UserController::class, 'index']);
    Route::post('/users', [UserController::class, 'store']);
});

资源路由也一样：Route::apiResource('posts', PostController::class)->middleware('api')。不加这句，请求会走 web 中间件栈，CSRF 验证失败、session 无法写入、request()->user() 返回 null。

迁移文件里 default(now()) 在 MySQL 5.6 下直接报错

新生成的迁移默认给 created_at 和 updated_at 加了 ->default(now())，看着省事，但实际踩坑密集：

• MySQL 5.6 及以下不支持函数作为列默认值，报错 Invalid default value for 'created_at'
• PostgreSQL 要用 ->useCurrent() 或 ->default(DB::raw('CURRENT_TIMESTAMP'))，now() 会被转成字符串字面量
• 已有表数据不受影响，该字段对存量行仍是 NULL；想补全历史记录，得手写 DB::table()->update(['created_at' => now()])

最稳妥的做法：新建迁移时删掉 ->default(now())，改用 ->useCurrent()（兼容 MySQL 5.7+ 和 PostgreSQL），并在 up() 方法里单独处理存量数据。

真正卡住人的从来不是功能多寡，而是那些被“简化”掉的隐式约定——比如 bootstrap/app.php 里漏掉一行 $app->withExceptions()，整个异常处理就失效；比如 routes.php 里少写一个 ->middleware('api')，前端拿不到用户信息还查不出原因。Laravel 11 把“默认行为”砍掉了大半，剩下全是显式声明，容错率低，但可控性高。动手前，先盯紧这三个文件：bootstrap/app.php、routes.php、database/migrations。

理论要掌握，实操不能落！以上关于《Laravel 11 从入门到精通指南》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！