04.5 阶段 4:框架主线 Laravel
本页目录
一、阶段定位
前三个阶段解决"语言写得对、工程化跑通"。本阶段解决"用框架把业务系统快速交付出来"。Laravel 是 PHP 生态最主流的全栈框架,它把路由、容器、ORM、队列、缓存、认证全部统一在一套约定里。学 Laravel 的关键不是"背命令",而是理解请求生命周期:一个 HTTP 请求进来,经过哪些中间件、容器怎么解析控制器、Eloquent 怎么查库、响应怎么返回。
与前后阶段的衔接:往上是 04.4 阶段 3 Composer、PSR 与工程化,Laravel 本身就是 Composer 包,服务容器就是 PSR-11 的实现;往下接 04.6 阶段 5 数据层、缓存与队列,那里讨论 Eloquent 的 N+1、Redis 缓存、RabbitMQ 队列的底层原理。跳过本阶段直接学数据层,会在"为什么 with() 能消除 N+1""队列任务怎么进数据库""任务调度怎么配"这些问题上反复返工。
原始卡点展开成可判断的现象依据:
- 把 Facade 当静态类理解:判断标准是认为
DB::table()是静态方法,不知道它背后是__callStatic把调用转发到容器解析的db实例。 - Eloquent 不做预加载引发 N+1:判断标准是接口里
foreach ($users as $u) { echo $u->profile->name; },开 SQL 日志看到 N+1 条查询。 - 记不清服务提供者与中间件的加载顺序:判断标准是在中间件里用了某 Facade 但报"未绑定",因为 Facade 在
boot之后才可用。
二、阶段目标与投入
| 能力目标(可验证的行为) | 验证方式 |
|---|---|
| 能用 Laravel 独立起一个项目,路由与控制器跑通 | php artisan serve 后浏览器访问返回 JSON |
| 能画出请求从入口到响应经过的中间件、容器、控制器链路 | 口述 + 画时序图 |
| 能写服务提供者绑定接口到实现,用构造器注入 | 换实现时只改一处绑定 |
能写 Eloquent 模型、关联、迁移,用 with() 消除 N+1 |
SQL 日志从 N+1 降到 2 条 |
| 能配队列、事件、任务调度 | php artisan queue:work 消费任务,schedule:run 定时跑 |
| 能说清 Facade 背后解析到容器哪个实例,以及 ThinkPHP/Symfony/Hyperf 的定位 | 面试问答能区分 |
建议学时:
- 全职(每天 4–6 小时):3 周,约 90 小时。
- 在职(每天 2 小时、周末补 4 小时):6–8 周,约 90 小时。
学时分配:请求生命周期与目录 15%、路由与中间件 15%、容器与服务提供者 20%、Eloquent 与迁移 20%、队列事件调度 15%、ThinkPHP/Symfony/Hyperf 对比 15%。容器与生命周期是面试重灾区,时间给够。
三、先修自检
| 先修项 | 合格标准 | 不合格时回到 |
|---|---|---|
| Composer 可用 | composer -V 有输出 |
04.4 阶段 3 Composer、PSR 与工程化 |
| 类型声明与命名参数 | 函数与类有完整类型 | 04.3 阶段 2 类型系统与现代特性 |
| 命名空间与自动加载 | 能读 PSR-4 映射 | 04.4 阶段 3 Composer、PSR 与工程化 |
| HTTP 与 Nginx | 知道请求链路 | 04.1 阶段 0 环境与工程基础 |
经验判断:写过 ThinkPHP 的人迁移到 Laravel 会觉得"目录结构不一样但思想类似";写过 Java Spring 的人会发现 Laravel 容器与 Spring DI 高度相似,只是语法更动态。
四、知识地图
| 模块 | 知识点 | 掌握程度 | 对应题库章节 |
|---|---|---|---|
| 请求生命周期 | public/index.php、bootstrap/app.php、HTTP Kernel、中间件、路由、控制器、响应 |
能讲清原理 | 06.5 PHP 后端 |
| 路由与中间件 | Route::get、路由分组、前缀、中间件别名、前置/后置 |
会用 | 06.5 PHP 后端 |
| 服务容器 | App::bind、App::singleton、app()、resolve()、构造器注入 |
能讲清原理 | 06.5 PHP 后端 |
| 服务提供者 | register() 与 boot()、config/app.php providers |
会用 | 06.5 PHP 后端 |
| Facade | __callStatic、getFacadeRoot、DB/Auth/Cache 背后实例 |
能讲清原理 | 06.5 PHP 后端 |
| Eloquent ORM | 模型、关联 hasOne/hasMany/belongsTo、with() 预加载、访问器 |
能讲清原理 | 06.5 PHP 后端 |
| 迁移与队列 | php artisan make:migration、migrate、queue:work、事件、调度 |
会用 | 06.5 PHP 后端 |
| 其他框架定位 | ThinkPHP 约定、Symfony 组件、Hyperf/Swoole 协程 | 了解 | 06.5 PHP 后端 |
进度管理建议:请求生命周期与容器解析能口述清楚再进阶段 5。全量清单见 04.10 知识点全清单。
五、分模块精讲
5.1 Laravel 请求生命周期与目录结构
为什么需要它:不理解生命周期,所有"为什么我在这里调用 Facade 报错""为什么中间件里拿不到 request"都无法定位。Laravel 是"约定优于配置",目录结构就是生命周期的投影。
核心机制:
- 入口
public/index.php:加载vendor/autoload.php,引入bootstrap/app.php创建应用实例。 - HTTP Kernel(
App\Http\Kernel):$middleware全局中间件列表(每个请求都过);$middlewareGroups分组中间件(web/api);$routeMiddleware路由别名(如auth、admin)。
- 流程:请求 → 全局中间件 → 路由匹配 → 分组/路由中间件 → 控制器方法 → 中间件后置 → 响应。
- 目录:
app/Http/Controllers、app/Models、app/Services、app/Providers、routes/web.php、routes/api.php、config/、database/migrations、storage/。
最小可运行示例:
# 新建项目
composer create-project laravel/laravel my-app
cd my-app
php artisan serve --port=8000
# 看路由列表
php artisan route:list
# 常用 Artisan
php artisan make:controller OrderController
php artisan make:model Order -m # -m 同时生成迁移
php artisan migrate
php artisan config:clear
php artisan cache:clear
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 改了 config 不生效 | 配置被缓存 | php artisan config:clear 或 config:cache |
storage/ 权限错 |
FPM 用户无写权限 | chown -R www-data storage bootstrap/cache |
| 路由 404 | 路由没注册或方法错 | php artisan route:list 看实际注册 |
面试考法:"Laravel 一个请求的完整生命周期"。答到:入口加载 autoload → Kernel 处理 → 全局中间件 → 路由分发 → 路由中间件 → 控制器 → 响应 → terminable 中间件后置。
5.2 路由、路由分组与中间件
为什么需要它:路由是 URL 到控制器的映射;中间件是横切关注点(鉴权、日志、CORS)的统一入口。Laravel 的分组与别名让它们可组合。
核心机制:
- 基础路由:
Route::get('/orders', [OrderController::class, 'index']);。 - 路由分组:
Route::prefix('api')->middleware('auth')->group(function () { ... });,前缀、中间件、命名空间统一生效。 - 路由模型绑定:
Route::get('/orders/{order}', function (Order $order) { ... });,Laravel 自动按 ID 查模型,查不到直接 404。 - 中间件:
php artisan make:middleware EnsureTokenIsValid,在handle方法里前置/后置逻辑;注册到$routeMiddleware后用别名。
最小可运行示例:
<?php
// routes/api.php
use Illuminate\Support\Facades\Route;
Route::middleware('auth:sanctum')->prefix('v1')->group(function () {
Route::get('/orders', [OrderController::class, 'index']);
Route::get('/orders/{order}', [OrderController::class, 'show']);
Route::post('/orders', [OrderController::class, 'store']);
});
<?php
// app/Http/Middleware/EnsureTokenIsValid.php
public function handle(Request $request, Closure $next): Response {
if ($request->header('X-Token') !== config('app.api_token')) {
return response()->json(['error' => 'unauthorized'], 401);
}
return $next($request); // 前置:放行继续
}
public function terminate(Request $request, Response $response): void {
// 后置:响应已发出后执行(如写访问日志)
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 路由模型绑定查不到模型返回 404 | ID 不存在 | 这是预期;想自定义错误用 missing 回调 |
| 中间件里用了 Facade 报错 | 中间件在 Facade 注册前执行 | 把逻辑移到 boot 之后,或用构造器注入 |
| 路由分组中间件不生效 | 别名没注册 | 在 Kernel::$routeMiddleware 注册 |
面试考法:"中间件前置与后置区别""路由模型绑定原理"。答到:handle 里 $next($request) 之前是前置,之后是后置;模型绑定是容器在解析控制器参数时按类型提示查库。
5.3 服务容器与依赖注入
为什么需要它:容器是 Laravel 的心脏。控制器不自己 new 依赖,而是通过构造函数声明需要什么,容器自动解析并注入。这让代码可测试、可替换。
核心机制:
- 容器绑定:
App::bind(Interface::class, Concrete::class)(每次解析新建实例);App::singleton(Interface::class, fn() => new X())(单例)。 - 自动装配:容器能自动解析未绑定的类(构造函数参数类型提示有类名就 new)。
- 构造器注入:控制器
__construct(private OrderService $svc),容器实例化控制器时自动注入。 - 手动解析:
app(OrderService::class)或resolve(OrderService::class)。
最小可运行示例:
<?php
// app/Providers/AppServiceProvider.php
public function register(): void {
$this->app->bind(PaymentGateway::class, AlipayGateway::class);
$this->app->singleton(PaymentGateway::class, function ($app) {
return new AlipayGateway(config('services.alipay.key'));
});
}
<?php
// app/Http/Controllers/OrderController.php
class OrderController extends Controller {
// 容器自动注入 OrderService
public function __construct(private OrderService $svc) {}
public function index(Request $request) {
return $this->svc->list($request->user());
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
Target class [X] does not exist |
接口未绑定 | 在服务提供者 register 里绑定 |
| 每次解析都新建实例 | 用了 bind 而非 singleton |
改 singleton |
| 循环依赖 | A 依赖 B,B 依赖 A | 重构,或用 when/with 解 |
面试考法:"容器怎么解析依赖""bind 与 singleton 区别"。答到:容器反射构造函数参数类型,自动 new 依赖并递归;bind 每次新建,singleton 全程一个实例。
5.4 服务提供者与 Facade 门面
为什么需要它:服务提供者是框架"启动"的入口;Facade 是"静态调用语法糖"。不懂这两者,就看不懂 Laravel 怎么把 DB::table() 这种静态写法跑起来。
核心机制:
- 服务提供者两个方法:
register():只绑定到容器,不能依赖其他服务(此时容器还没完全启动);boot():所有服务注册完后执行,可注入任意依赖。
- 所有 providers 在
config/app.php的providers数组注册。 - Facade:每个 Facade 类继承
Illuminate\Support\Facades\Facade,实现getFacadeAccessor()返回容器里的键名(如'db'、'auth');调用静态方法时__callStatic把调用转发到容器解析的实例。 DB::table()等价于app('db')->table()。
最小可运行示例:
<?php
// 自定义 Facade
namespace App\Facades;
use Illuminate\Support\Facades\Facade;
class SMS extends Facade {
protected static function getFacadeAccessor(): string {
return 'sms'; // 容器里绑定的键
}
}
// 服务提供者 register
$this->app->singleton('sms', function ($app) {
return new SmsService(config('services.sms.key'));
});
// 使用
use App\Facades\SMS;
SMS::send('13800000000', '验证码 1234'); // 等价于 app('sms')->send(...)
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 把 Facade 当静态类 | 不理解 __callStatic |
它是代理,背后是容器实例 |
register 里用了其他 Facade |
此时容器未启动 | 移到 boot |
| Facade 类名冲突 | 自定义 Facade 命名空间 | 用 use 显式导入 |
面试考法:"Facade 是静态类吗""register 与 boot 区别"。答到:不是,是代理到容器实例的语法糖;register 只绑定,boot 在所有注册完成后执行。
5.5 Eloquent ORM 与迁移
为什么需要它:Eloquent 是 Laravel 的 Active Record ORM,让"查表"变成"操作对象"。但它也是 N+1 问题的重灾区,必须理解预加载。
核心机制:
- 模型:
class Order extends Model { protected $table = 'orders'; protected $fillable = ['user_id','amount']; }。 - 关联:
hasOne(一对一)、hasMany(一对多)、belongsTo(反向)、belongsToMany(多对多)。 - 预加载:
Order::with('user')->get(),一次性查出所有关联 user,消除 N+1。 - 迁移:
php artisan make:migration create_orders_table,写up()与down();php artisan migrate执行,migrate:rollback回滚。 - 查询构造器:
Order::where('amount', '>', 100)->get()、paginate(15)。
最小可运行示例:
<?php
// app/Models/Order.php
class Order extends Model {
protected $fillable = ['user_id', 'amount', 'status'];
public function user() {
return $this->belongsTo(User::class);
}
}
// 控制器里:N+1 vs 预加载
// 错误:N+1,循环里每个 order 查一次 user
$orders = Order::all();
foreach ($orders as $o) { echo $o->user->name; } // 1 + N 条 SQL
// 正确:预加载,2 条 SQL
$orders = Order::with('user')->get();
foreach ($orders as $o) { echo $o->user->name; }
php artisan make:migration create_orders_table
php artisan migrate
php artisan migrate:rollback
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 列表接口 SQL 日志 N+1 条 | 没 with() 预加载 |
改 Order::with('user')->get() |
MassAssignmentException |
字段不在 $fillable |
加 $fillable 或用 $guarded=[] |
| 迁移回滚失败 | down() 没写或写错 |
严格对应 up() 反向操作 |
面试考法:"什么是 N+1""Eloquent 与查询构造器区别"。答到:循环里逐个查关联导致 1+N 条 SQL,用 with 预加载消除;Eloquent 是 Active Record 对象映射,查询构造器是 SQL 链式 builder。
5.6 队列、事件与任务调度
为什么需要它:耗时任务(发邮件、生成报表、调外部 API)不能阻塞 HTTP 请求。队列把它们丢到后台异步处理;事件让模块间解耦;调度替代 Linux crontab。
核心机制:
- 队列:实现
ShouldQueue接口,dispatch(new SendEmail($user));php artisan queue:work消费。 - 队列驱动:database、redis、sqs;生产用 Redis 或 RabbitMQ。
- 事件:
event(new OrderPaid($order)),监听器在EventServiceProvider注册。 - 任务调度:在
app/Console/Kernel.php的schedule()里写$schedule->command('report:daily')->dailyAt('08:00');,Linux crontab 只需配一条php artisan schedule:run每分钟跑。
最小可运行示例:
<?php
// app/Jobs/SendEmailJob.php
class SendEmailJob implements ShouldQueue {
use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
public function __construct(public User $user) {}
public function handle(Mailer $mailer): void {
$mailer->to($this->user->email)->send(new WelcomeMail());
}
}
// 控制器里 dispatch
SendEmailJob::dispatch($user)->onQueue('emails');
php artisan queue:work --queue=emails
php artisan schedule:run
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 任务重复执行 | 消费失败没 ack,重试机制 | 实现幂等,或用 failed_jobs 表 |
| 调度没跑 | crontab 没配 schedule:run |
配 * * * * * cd /app && php artisan schedule:run |
| 队列 worker 内存涨 | 静态属性/全局变量污染 | 用 --memory=128 限制,或常驻模型用连接池 |
面试考法:"队列任务怎么保证不重复消费""Laravel 调度与 crontab 关系"。答到:消费端做幂等(用唯一业务键判断);调度是在 crontab 每分钟触发下统一分发。
5.7 ThinkPHP 与 Symfony 的定位
为什么需要它:国内中小项目大量用 ThinkPHP;Symfony 是 Laravel 的底层组件来源。面试常问"你怎么选框架"。
核心机制:
- ThinkPHP:国内轻量框架,目录约定
application/controller/model,路由默认按模块/控制器/方法;版本 6 后也支持容器与中间件。学习成本低,适合快速交付。 - Symfony:组件化框架,Laravel 的 HTTP Kernel、Routing、Console 都来自 Symfony 组件;Symfony 本身是全栈框架,适合大型企业项目。
- 选型判断:快速交付中小后台用 Laravel 或 ThinkPHP;大型企业强规范项目用 Symfony;需要常驻协程用 Hyperf(见 5.8)。
最小可运行示例:ThinkPHP 控制器示例(对照 Laravel 差异):
<?php
// ThinkPHP 6:app/controller/Order.php
namespace app\controller;
use app\model\Order;
use think\facade\Db;
class Order {
public function list() {
$orders = Order::where('status', 1)->select();
return json(['list' => $orders]);
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| ThinkPHP 与 Laravel 目录混淆 | 两者约定不同 | 按各自文档,不要混用 |
| Symfony 组件直接用在 Laravel | 版本不匹配 | 用 Laravel 封装好的 Facade |
面试考法:"Laravel 与 Symfony 关系"。答到:Laravel 站在 Symfony 组件上,提供更简洁的约定;Symfony 更灵活但更重。
5.8 Hyperf/Swoole 协程常驻概念
为什么需要它:FPM 每请求重新初始化,Hyperf/Swoole 常驻内存,协程在 IO 等待时让出执行流。这是阶段 6 的前置概念,本阶段先知道它的存在。
核心机制:
- FPM 模型:每请求 = 重新引导框架、重新解析容器、请求结束销毁。
- Swoole 模型:主进程常驻,worker 进程处理请求,协程在
Coroutine::sleep或 IO 时让出,切换到其他协程。 - Hyperf:基于 Swoole 的协程框架,用注解路由(
#[Controller]、#[GetMapping]),提供协程 MySQL/Redis 客户端与连接池。 - 关键差异:常驻内存意味着全局变量、静态属性会跨请求残留,必须做隔离;这是阶段 6 的重点。
最小可运行示例(Hyperf 注解路由概念):
<?php
// Hyperf 控制器:注解路由
#[Controller(prefix: '/orders')]
class OrderController {
#[GetMapping('')]
public function list() {
return ['list' => Order::limit(10)->get()];
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
协程下用了同步阻塞函数(如 sleep) |
阻塞整个 worker | 用 Swoole 协程版 Co::sleep 或客户端 |
| 静态属性跨请求串数据 | 常驻内存不清理 | 请求结束后重置,或用上下文 |
面试考法:"协程与线程区别""为什么 FPM 不能常驻"。答到:协程是用户态调度,切换成本低,不需要内核;FPM 每请求隔离,常驻会带来状态污染问题。
六、分层练习
6.1 复现型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 新建 Laravel 项目 | composer create-project,起 hello 路由 |
php artisan serve 访问返回 JSON |
1 小时 |
| 写一个带中间件的 API | 配 Token 鉴权中间件 | 无 Token 返回 401,有 Token 返回 200 | 2 小时 |
| 写模型与迁移 | Order 模型 + users 关联 | php artisan migrate 成功 |
2 小时 |
| 复现 N+1 并修复 | 先 all() 后 with() |
SQL 日志从 N+1 降到 2 条 | 2 小时 |
| 配队列 | 写 SendEmailJob 并 dispatch | queue:work 消费成功 |
2 小时 |
6.2 改造型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 把控制器逻辑抽到 Service | OrderController 变薄 | 构造器注入 Service,可单测 | 3 小时 |
| 接口绑定实现 | PaymentGateway 接口绑 Alipay | 换 WeChat 只改一处绑定 | 2 小时 |
| 自定义 Facade | 写 Sms Facade | 静态调用等价于 app('sms') |
2 小时 |
| 配任务调度 | 每天 8 点生成报表 | schedule:run 触发 |
1 小时 |
6.3 设计型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 完整业务系统 | 含 RBAC、缓存、队列、权限 | 见 04.13 实战项目阶梯 项目二 | 20 小时 |
| 画请求生命周期图 | 从 Nginx 到响应全链路 | 中间件、容器、控制器、ORM 节点齐全 | 2 小时 |
| 框架选型报告 | 对比 Laravel/ThinkPHP/Symfony/Hyperf | 给出场景推荐与理由 | 2 小时 |
七、排障表
| 现象 | 可能原因 | 排查步骤 | 解决办法 |
|---|---|---|---|
Target class [X] does not exist |
接口未绑定 | 看服务提供者 register | 绑定接口到实现 |
| 改 config 不生效 | 配置被缓存 | php artisan config:clear |
开发时不要 config:cache |
| 路由 404 | 路由没注册 | php artisan route:list |
补路由或清 route:cache |
| N+1 慢查询 | 循环里访问关联 | 开 SQL 日志 | 用 with() 预加载 |
MassAssignmentException |
字段不在 fillable | 看模型 fillable | 加字段或用 $guarded=[] |
| 队列任务不执行 | worker 没起 | ps aux | grep queue |
php artisan queue:work |
| 调度没跑 | crontab 没配 | crontab -l |
配 * * * * * php artisan schedule:run |
| storage 权限错 | FPM 用户无写权限 | ls -l storage |
chown -R www-data storage |
八、出口条件
全部勾选后进入 04.6 阶段 5 数据层、缓存与队列。
- [ ] 能独立起 Laravel 项目,路由/控制器/中间件跑通
- [ ] 能画出请求从入口到响应的完整生命周期
- [ ] 能用服务容器绑定接口,构造器注入替代 new
- [ ] 能解释 Facade 背后是容器实例,不是静态类
- [ ] 能用 Eloquent 预加载消除 N+1,能写迁移并回滚
- [ ] 能配队列、事件、任务调度
- [ ] 排障表随机抽三个现象,5 分钟内给出排查路径
自测题:
- 一个 Laravel 请求经过哪些环节?
- 要点:入口 → Kernel → 全局中间件 → 路由 → 分组/路由中间件 → 控制器 → 响应 → 后置中间件。
DB::table()是静态方法吗?背后是什么?- 要点:不是。Facade 的
__callStatic转发到容器里db实例的方法。
- 要点:不是。Facade 的
bind与singleton区别?- 要点:bind 每次解析新建实例;singleton 全程一个实例。
- N+1 怎么产生、怎么消除?
- 要点:循环里逐个访问关联触发额外 SQL;用
with('relation')预加载。
- 要点:循环里逐个访问关联触发额外 SQL;用
register()与boot()区别?- 要点:register 只绑定容器,不能依赖其他服务;boot 在所有注册完成后执行。
- Laravel 队列怎么配到 crontab?
- 要点:crontab 每分钟跑
php artisan schedule:run,由它分发到schedule()里定义的任务。
- 要点:crontab 每分钟跑
- Hyperf/Swoole 与 FPM 最大的模型差异是什么?
- 要点:FPM 每请求重新初始化;Swoole 常驻内存,全局/静态变量跨请求残留,必须做隔离。