Login

Cài đặt Laravel trên Windows với PHP, Composer và chạy trang chào đầu tiên

  • author-image

    Nguyễn Đình Cường

  • blog-tag
  • blog-comment 0 comment
  • created-date 09 Nov, 2026
blog-thumbnail

Laravel là framework PHP phổ biến với cú pháp dễ đọc và hệ sinh thái phong phú. Bài này hướng dẫn bạn chuẩn bị PHP và Composer trên Windows, tạo dự án Laravel đầu tiên và viết một route trả về trang chào, cùng cách xử lý các lỗi cài đặt hay gặp.

Laravel cần những gì

Để chạy Laravel bạn cần:

  • PHP: phiên bản đáp ứng yêu cầu của bản Laravel bạn chọn (xem tài liệu chính thức để biết phiên bản tối thiểu).
  • Composer: trình quản lý thư viện cho PHP, tương tự npm của Node.js.
  • Cơ sở dữ liệu (tùy chọn ở giai đoạn đầu): mặc định các bản mới có thể dùng SQLite nên bạn chưa cần cài MySQL ngay.

Bước 1: Cài PHP

Có hai hướng phổ biến cho người mới. Hướng thứ nhất là dùng gói tích hợp như XAMPP hoặc Laragon, cài một lần có sẵn PHP, Apache và MySQL. Laragon cho phép đổi phiên bản PHP dễ dàng. Hướng thứ hai là tải PHP bản Windows, giải nén vào một thư mục như C:\php rồi thêm thư mục này vào biến môi trường PATH.

Với hướng thứ hai, sao chép file php.ini-development thành php.ini và bỏ dấu chấm phẩy trước các dòng bật phần mở rộng cần thiết như extension=mbstring, extension=openssl, extension=pdo_sqlite, extension=fileinfo. Kiểm tra bằng lệnh:

php -v
php -m

Bước 2: Cài Composer

Tải trình cài đặt Composer cho Windows từ trang chủ getcomposer.org. Trình cài sẽ tự nhận đường dẫn PHP. Sau khi cài, mở terminal mới và chạy:

composer --version

Bước 3: Tạo dự án Laravel

Dùng Composer để tạo dự án mới tên my-app:

composer create-project laravel/laravel my-app
cd my-app
php artisan serve

Lệnh php artisan serve khởi chạy máy chủ phát triển, thường ở địa chỉ http://127.0.0.1:8000. Mở địa chỉ này trong trình duyệt, nếu thấy trang chào của Laravel thì bạn đã cài thành công.

Bước 4: Tìm hiểu cấu trúc thư mục

  • routes/web.php: nơi khai báo các đường dẫn của trang web.
  • app/: mã nguồn chính như controller, model.
  • resources/views/: các file giao diện Blade.
  • database/migrations/: lịch sử cấu trúc bảng dữ liệu.
  • .env: cấu hình môi trường như kết nối cơ sở dữ liệu. Không đưa file này lên kho mã công khai.

Bước 5: Route và view đầu tiên

Mở routes/web.php và thêm route mới:

use Illuminate\Support\Facades\Route;

Route::get('/xin-chao/{ten}', function (string $ten) {
    return view('xinchao', ['ten' => $ten]);
});

Tạo file resources/views/xinchao.blade.php:

<!DOCTYPE html>
<html lang="vi">
<head>
    <meta charset="UTF-8">
    <title>Xin chào</title>
</head>
<body>
    <h1>Xin chào, {{ $ten }}!</h1>
</body>
</html>

Truy cập http://127.0.0.1:8000/xin-chao/Lan. Cú pháp {{ }} của Blade tự động escape nội dung để tránh lỗi bảo mật XSS.

Lỗi thường gặp khi cài

  • Thiếu extension: Composer báo thiếu ext-mbstring hay ext-fileinfo. Bật trong php.ini rồi mở lại terminal.
  • Chứng chỉ SSL: lỗi tải gói do thiếu cấu hình curl.cainfo hoặc openssl.cafile trong php.ini.
  • Cổng 8000 đang bận: chạy php artisan serve --port=8080.
  • Lỗi quyền thư mục: đảm bảo thư mục storage và bootstrap/cache ghi được.

Câu hỏi thường gặp

Nên dùng XAMPP, Laragon hay cài PHP thủ công? Với người mới, Laragon hoặc XAMPP tiết kiệm thời gian vì có sẵn máy chủ và cơ sở dữ liệu. Cài thủ công cho bạn hiểu rõ hơn từng thành phần, hợp với ai muốn kiểm soát phiên bản. Cả hai đều dùng được với Laravel.

Có bắt buộc phải có MySQL không? Không. Ở giai đoạn học, bạn có thể dùng SQLite, chỉ là một file trong dự án. Khi cần gần với môi trường thật hơn, hãy chuyển sang MySQL hoặc PostgreSQL bằng cách đổi cấu hình trong file .env rồi chạy lại php artisan migrate.

Vì sao nên học dùng terminal? Artisan, Composer, Git đều làm việc qua dòng lệnh. Làm quen sớm sẽ giúp bạn thao tác nhanh hơn và hiểu rõ chuyện gì đang xảy ra phía sau các công cụ giao diện.

Kết luận

Bạn đã có môi trường Laravel hoạt động và hiểu luồng cơ bản: route nhận yêu cầu, view hiển thị kết quả. Bước tiếp theo nên là làm quen với migration, Eloquent và controller để xây ứng dụng thật.

Khi bạn sẵn sàng học Laravel một cách có hệ thống, hãy xem các khóa học backend tại codebem.com.

author_photo
Nguyễn Đình Cường

0 comment