Khi người dùng truy cập một URL như /products, /users/10 hoặc gửi một request POST để tạo dữ liệu, Laravel cần xác định request đó sẽ được xử lý ở đâu. Laravel Route đảm nhiệm vai trò định tuyến này. Route xác định URL, HTTP method và logic hoặc Controller tương ứng để xử lý request. Hiểu Route là bước quan trọng trước khi làm việc với Controller, Middleware, Form Request hay xây dựng API trong Laravel.
Laravel Route là gì?
Route trong Laravel là quy tắc định tuyến giúp ứng dụng xác định cách xử lý một HTTP request dựa trên URL và HTTP method.
Một Route cơ bản:
use Illuminate\Support\Facades\Route;
Route::get('/hello', function () {
return 'Hello Laravel';
});
Khi người dùng truy cập:
/hello
bằng phương thức GET, Laravel sẽ thực thi đoạn code được khai báo trong Route và trả về kết quả.
Có thể hình dung:
HTTP Request
↓
Laravel Route
↓
Xác định URL + Method
↓
Controller / Closure
↓
Response
Route vì vậy đóng vai trò như điểm kết nối giữa request từ client và phần xử lý bên trong ứng dụng.
Route được khai báo ở đâu?
Các Route web thường được khai báo trong:
routes/web.php
Ví dụ:
Route::get('/products', function () {
return view('products.index');
});
Với API, Laravel thường sử dụng:
routes/api.php
tùy cấu hình và phiên bản Laravel.
Route trong web.php thường phục vụ các trang web sử dụng session và cơ chế CSRF của web middleware. Trong khi đó, API Route được sử dụng để xây dựng các endpoint cho ứng dụng khác, frontend hoặc mobile client.
Các HTTP Method trong Laravel Route
Laravel hỗ trợ các HTTP method phổ biến:
Route::get('/products', ...);
Route::post('/products', ...);
Route::put('/products/{id}', ...);
Route::patch('/products/{id}', ...);
Route::delete('/products/{id}', ...);
Ý nghĩa thường gặp:
| Method | Mục đích |
|---|---|
GET |
Lấy hoặc hiển thị dữ liệu |
POST |
Tạo dữ liệu hoặc gửi dữ liệu |
PUT |
Cập nhật tài nguyên |
PATCH |
Cập nhật một phần tài nguyên |
DELETE |
Xóa tài nguyên |
Ví dụ:
Route::get('/products', [ProductController::class, 'index']);
Route::post('/products', [ProductController::class, 'store']);
Route::get('/products/{product}', [ProductController::class, 'show']);
Route::put('/products/{product}', [ProductController::class, 'update']);
Route::delete('/products/{product}', [ProductController::class, 'destroy']);
Cách tổ chức này phù hợp với các ứng dụng CRUD và REST API.
Kết nối Route với Controller
Trong ứng dụng thực tế, không nên đặt toàn bộ logic xử lý trong Closure của Route.
Thay vào đó, Route có thể chuyển request tới Controller:
use App\Http\Controllers\ProductController;
Route::get('/products', [ProductController::class, 'index']);
Controller:
class ProductController extends Controller
{
public function index()
{
return view('products.index');
}
}
Luồng xử lý:
GET /products
↓
Route
↓
ProductController@index
↓
View
↓
Response
Cách này giúp Route chỉ tập trung vào định tuyến, còn Controller chịu trách nhiệm điều phối logic của request.
Nếu đang xây dựng kiến thức nền về cách Laravel kết nối Route, Controller và các thành phần khác, Laravel cơ bản là phần nên nắm trước khi đi sâu vào các cấu trúc định tuyến phức tạp hơn.
Route Parameter
Route có thể nhận tham số trực tiếp từ URL.
Ví dụ:
Route::get('/products/{id}', function ($id) {
return "Product: " . $id;
});
Khi truy cập:
/products/15
Laravel truyền 15 vào biến $id.
Trong Controller:
Route::get('/products/{id}', [ProductController::class, 'show']);
public function show($id)
{
// Xử lý product có id tương ứng
}
Optional Parameter
Có thể khai báo tham số không bắt buộc bằng dấu ?:
Route::get('/products/{category?}', function ($category = null) {
//
});
Khi đó cả hai URL đều có thể hợp lệ:
/products
/products/phone
Route Model Binding
Khi Route làm việc với Eloquent Model, Laravel hỗ trợ Route Model Binding để tự động tìm Model tương ứng.
Ví dụ:
Route::get('/products/{product}', [ProductController::class, 'show']);
Controller:
public function show(Product $product)
{
return $product;
}
Khi truy cập:
/products/15
Laravel có thể tự động tìm Product có ID tương ứng và truyền Model vào Controller.
Cách này giúp loại bỏ phần code tìm Model thủ công:
$product = Product::findOrFail($id);
Route Model Binding đặc biệt hữu ích trong các ứng dụng CRUD vì Route và Controller trở nên ngắn gọn hơn.
Đặt tên cho Route
Laravel cho phép đặt tên Route:
Route::get('/products', [ProductController::class, 'index'])
->name('products.index');
Sau đó có thể tạo URL bằng tên Route:
route('products.index');
Thay vì viết trực tiếp:
url('/products');
Với Route có tham số:
Route::get('/products/{product}', [ProductController::class, 'show'])
->name('products.show');
Có thể tạo URL:
route('products.show', ['product' => 15]);
Tên Route giúp giảm sự phụ thuộc vào URL cụ thể. Nếu đường dẫn thay đổi nhưng tên Route vẫn được giữ nguyên, những nơi sử dụng route() không nhất thiết phải thay đổi theo.
Middleware cho Route
Middleware cho phép kiểm tra hoặc xử lý request trước khi request đi tới Controller.
Ví dụ giới hạn Route cho người dùng đã đăng nhập:
Route::get('/dashboard', [DashboardController::class, 'index'])
->middleware('auth');
Có thể áp dụng Middleware cho nhiều Route:
Route::middleware('auth')->group(function () {
Route::get('/dashboard', [DashboardController::class, 'index']);
Route::get('/profile', [ProfileController::class, 'index']);
});
Luồng xử lý:
Request
↓
Route
↓
Middleware
↓
Controller
↓
Response
Middleware thường được sử dụng cho Authentication, kiểm tra quyền truy cập, logging hoặc các điều kiện cần xử lý trước khi Controller thực hiện công việc.
Route Group
Khi nhiều Route có chung Middleware, prefix hoặc cấu hình, có thể sử dụng Route Group.
Ví dụ thêm prefix:
Route::prefix('admin')->group(function () {
Route::get('/users', [UserController::class, 'index']);
Route::get('/products', [ProductController::class, 'index']);
});
Các URL tương ứng:
/admin/users
/admin/products
Có thể kết hợp với Middleware:
Route::middleware('auth')
->prefix('admin')
->group(function () {
Route::get('/users', [UserController::class, 'index']);
Route::get('/products', [ProductController::class, 'index']);
});
Cách này giúp tránh lặp lại cùng một cấu hình trên nhiều Route.
Resource Route
Với các chức năng CRUD, Laravel cung cấp Resource Controller và Resource Route để giảm lượng code khai báo.
Ví dụ:
Route::resource('products', ProductController::class);
Route này tạo ra các endpoint tương ứng với những hành động CRUD phổ biến:
| Method | URL | Controller |
|---|---|---|
| GET | /products |
index |
| GET | /products/create |
create |
| POST | /products |
store |
| GET | /products/{product} |
show |
| GET | /products/{product}/edit |
edit |
| PUT/PATCH | /products/{product} |
update |
| DELETE | /products/{product} |
destroy |
Resource Route đặc biệt phù hợp với những Controller có cấu trúc CRUD tiêu chuẩn.
Không phải mọi Controller đều cần Resource Route. Nếu chức năng không tuân theo cấu trúc CRUD, khai báo Route riêng thường dễ hiểu hơn.
Kiểm tra danh sách Route
Khi ứng dụng có nhiều Route, Artisan giúp kiểm tra toàn bộ Route đang được đăng ký:
php artisan route:list
Kết quả thường cho biết:
- HTTP method.
- URL.
- Route name.
- Controller hoặc Action.
- Middleware.
Ví dụ khi một URL không hoạt động như mong đợi, route:list là một trong những nơi đầu tiên nên kiểm tra.
Một số lỗi Route thường gặp
Route không được gọi
Có thể do URL hoặc HTTP method không khớp.
Ví dụ khai báo:
Route::post('/products', [ProductController::class, 'store']);
nhưng gửi request bằng GET:
GET /products
thì Route này không được sử dụng.
Route bị trùng
Nếu nhiều Route có pattern quá giống nhau, thứ tự và cách khai báo có thể ảnh hưởng đến Route được Laravel khớp.
Nên đặt Route rõ ràng và tránh khai báo các pattern quá chung khi không cần thiết.
Sai tên Controller hoặc method
Ví dụ:
Route::get('/products', [ProductController::class, 'list']);
nhưng Controller không có method list.
Laravel sẽ không thể xử lý request theo Route đó.
Không tìm thấy Route Model Binding
Ví dụ:
Route::get('/products/{product}', [ProductController::class, 'show']);
Nếu không tồn tại Product tương ứng với tham số truyền vào, Laravel có thể trả về 404.
Đây thường là hành vi mong muốn vì tài nguyên được yêu cầu không tồn tại.
Route nên chịu trách nhiệm gì?
Route nên tập trung vào việc xác định request sẽ đi đâu.
Một Route tốt thường chỉ cần thể hiện rõ:
HTTP Method
+
URL
+
Controller / Action
+
Middleware nếu cần
Không nên đưa quá nhiều business logic vào Route:
Route::post('/order', function () {
// Hàng chục dòng xử lý nghiệp vụ...
});
Thay vào đó:
Route::post('/orders', [OrderController::class, 'store']);
Controller hoặc các lớp nghiệp vụ phía sau sẽ chịu trách nhiệm xử lý phần còn lại.
Cách phân tách này giúp ứng dụng dễ mở rộng hơn khi số lượng chức năng tăng lên.
Kết luận
Laravel Route là thành phần xác định cách ứng dụng tiếp nhận và điều hướng HTTP request. Từ những Route đơn giản với GET và POST đến Route Parameter, Model Binding, Middleware, Route Group và Resource Route, Laravel cung cấp đầy đủ công cụ để tổ chức hệ thống định tuyến. Khi làm việc với Route, nên nhớ ba nguyên tắc chính: Route chịu trách nhiệm định tuyến, Controller xử lý luồng request và Middleware kiểm soát các điều kiện trước hoặc sau quá trình xử lý. Nắm chắc cách Route hoạt động sẽ giúp việc xây dựng CRUD, Authentication và API trong Laravel rõ ràng hơn. Truy cập Học Laravel để tìm hiểu sâu hơn về Controller, Middleware, Request, Validation và các thành phần liên quan.
