Laravel từ bên trong: service container, request lifecycle, kiến trúc ứng dụng lớn
Hiểu Laravel hoạt động thế nào: vòng đời request, service container và provider, facade, middleware pipeline, event/listener; và cách tổ chức codebase Laravel lớn bằng Action, domain module, DDD vừa đủ. So sánh ngắn với Symfony.
Developer Laravel junior biết 'dùng' framework; senior biết framework làm gì bên dưới để mở rộng, debug và test nó. Câu hỏi 'service container giải quyết dependency thế nào', 'facade khác DI ra sao', 'bạn tổ chức một ứng dụng Laravel 200 model thế nào' gần như chắc chắn xuất hiện ở vòng phỏng vấn kỹ thuật cho vị trí PHP lương cao.
🎯 Mục tiêu học tập
- Mô tả vòng đời request của Laravel từ public/index.php tới response
- Dùng service container: bind, singleton, scoped, contextual binding, autowiring
- Hiểu facade, real-time facade và khi nào nên inject thay vì dùng facade
- Viết middleware, event/listener, observer đúng chỗ
- Tổ chức ứng dụng lớn: Action class, module theo domain, ranh giới rõ
Vòng đời request
public/index.php
→ nạp autoload, tạo Application (container)
→ bootstrap: nạp env/config, đăng ký & boot service provider
→ HTTP Kernel đưa request qua middleware toàn cục
→ Router tìm route → middleware của route/group → controller (dependency được container inject)
→ response đi ngược qua middleware → gửi về client
→ terminate(): middleware terminable, dọn dẹp
Hiệu năng bootstrap phụ thuộc số provider và cấu hình: production luôn chạy
php artisan optimize (cache config, route, event, view).
Service container và provider
// app/Providers/AppServiceProvider.php
public function register(): void
{
$this->app->bind(PaymentGateway::class, StripeGateway::class); // mới mỗi lần resolve
$this->app->singleton(ExchangeRates::class, fn () => new CachedExchangeRates(...)); // một instance mỗi app
$this->app->scoped(TenantContext::class); // một instance mỗi request/job — an toàn với Octane
$this->app->when(InvoiceMailer::class) // contextual binding
->needs(Filesystem::class)
->give(fn () => Storage::disk('invoices'));
}
public function boot(): void
{
Model::shouldBeStrict(! $this->app->isProduction()); // chặn lazy loading, gán thuộc tính không tồn tại khi dev
}
register()chỉ đăng ký binding;boot()chạy sau khi mọi provider đã đăng ký (dùng được service khác).- Autowiring: class cụ thể không cần bind — container đọc kiểu tham số constructor bằng reflection.
- Singleton chứa state theo request là bug với Octane → dùng
scoped.
Facade, helper và dependency injection
Facade (Cache::get) | Constructor injection | |
|---|---|---|
| Cơ chế | Proxy tĩnh, resolve object thật từ container khi gọi | Phụ thuộc khai báo rõ trong chữ ký |
| Test | Có Cache::shouldReceive(), Queue::fake() | Truyền fake/mock trực tiếp |
| Nhìn thấy phụ thuộc | Ẩn trong thân hàm | Rõ ràng — class cần quá nhiều phụ thuộc là dấu hiệu cần tách |
Quy ước hợp lý: facade/helper trong controller, route, view, test; inject interface trong service/domain để code nghiệp vụ không phụ thuộc framework.
Middleware, event, observer, pipeline
- Middleware: việc cắt ngang theo request — xác thực, tenant, locale, request id, rate limit. Không đặt logic nghiệp vụ.
- Event/Listener: tách hệ quả phụ khỏi hành động chính (
OrderPaid→ gửi email, cập nhật thống kê, tích điểm). Listener nặng implementShouldQueue. - Observer trên model: tiện nhưng là "phép thuật ẩn" — logic quan trọng (tính tiền, phân quyền) không nên giấu trong
saving. - Pipeline: chuỗi bước xử lý tuỳ biến (
Pipeline::send($order)->through([ApplyCoupon::class, CalculateTax::class])->thenReturn()). DB::afterCommit/ShouldDispatchAfterCommit: chỉ phát event/job sau khi transaction commit — tránh job chạy khi dữ liệu chưa tồn tại.
Tổ chức codebase Laravel lớn
app/
├── Http/ (Controllers, Requests, Resources, Middleware) # chỉ tầng HTTP
├── Actions/Projects/CreateProject.php # một use case = một class, gọi được từ HTTP, CLI, job, test
└── ...
src/Domain/Billing/ # module theo domain khi ứng dụng lớn
├── Models/ Actions/ Events/ Enums/ ValueObjects/ Policies/
└── BillingServiceProvider.php
| Mức | Khi nào |
|---|---|
| Cấu trúc mặc định + Action class | Hầu hết ứng dụng vừa — đơn giản, dễ onboard |
| Module theo domain (Billing, Projects, Identity) | Team nhiều người, nhiều bounded context, ranh giới cần được giữ |
| DDD/hexagonal đầy đủ | Nghiệp vụ phức tạp, quy tắc thay đổi liên tục — chỉ cho module lõi |
Symfony là lựa chọn phổ biến khác ở doanh nghiệp châu Âu: cấu hình tường minh hơn, Doctrine (Data Mapper) thay Eloquent (Active Record), component dùng độc lập được. Hiểu container và vòng đời ở Laravel giúp chuyển sang Symfony rất nhanh.
🏋️ Bài tập thực hành
Trên API Module 4: (1) chuyển mọi logic nghiệp vụ vào Action class có test riêng; (2) tạo module
Domain/Billing với provider riêng; (3) bind PaymentGateway theo môi trường (fake ở test, sandbox ở staging);
(4) TenantContext scoped + middleware đặt tenant từ user; (5) event TaskCompleted với listener queue và
afterCommit; (6) bật Model::shouldBeStrict(). Viết docs/adr/001-cau-truc-ung-dung.md giải thích lựa chọn.
📚 Tài nguyên học tập
-
Laravel — Request LifecycleVòng đời requestDocs
-
Laravel — Service ContainerBinding, contextual binding, scopedDocs
-
Laravel Beyond CRUD (Spatie)Tổ chức ứng dụng Laravel lớn theo domainSách
-
Symfony DocumentationFramework PHP doanh nghiệpDocs
✅ Tự đánh giá hoàn thành
- Vẽ được vòng đời request của Laravel
- Phân biệt bind, singleton, scoped và khi nào dùng
- Giải thích facade hoạt động thế nào và khi nào nên inject
- Code nghiệp vụ nằm trong Action/domain, có test độc lập