Skip to content

Hướng Dẫn Cài Đặt Laravel Chi Tiết Cho Người Mới Học

  • by

Cài Đặt Composer

Composer là công cụ quản lý dependencies không thể thiếu khi làm việc với Laravel. Dưới đây là cách cài đặt Composer trên các hệ điều hành khác nhau:

Trên Windows

  1. Tải Composer-Setup.exe
  • Truy cập: https://getcomposer.org/download/
  • Tải file Composer-Setup.exe
  1. Chạy file cài đặt
  • Chạy file Composer-Setup.exe
  • Làm theo hướng dẫn trong wizard
  • Composer sẽ tự động tìm đường dẫn PHP của bạn
  1. Kiểm tra cài đặt
    Mở Command Prompt hoặc PowerShell và chạy:
    composer –version
    Nếu hiển thị phiên bản Composer, bạn đã cài đặt thành công!

Trên macOS

  1. Sử dụng Homebrew (Khuyến nghị)
    brew install composer
  2. Hoặc tải trực tiếp
    php -r “copy(‘https://getcomposer.org/installer’, ‘composer-setup.php’);”
    php composer-setup.php
    php -r “unlink(‘composer-setup.php’);”
    sudo mv composer.phar /usr/local/bin/composer
  3. Kiểm tra cài đặt
    composer –version

Trên Linux (Ubuntu/Debian)

  1. Cài đặt dependencies
    sudo apt update
    sudo apt install php-cli php-zip php-mbstring php-xml php-curl
  2. Tải và cài đặt Composer
    curl -sS https://getcomposer.org/installer | php
    sudo mv composer.phar /usr/local/bin/composer
  3. Kiểm tra cài đặt
    composer –version

Cài Đặt Laravel

Sau khi đã cài đặt Composer, bạn có thể cài đặt Laravel theo một trong hai cách:

Cách 1: Sử dụng Laravel Installer (Khuyến nghị)

  1. Cài đặt Laravel Installer toàn cục
    composer global require laravel/installer
  2. Thêm vào PATH (Quan trọng!) Windows:
  • Thêm đường dẫn vào biến môi trường PATH:
    %USERPROFILE%\AppData\Roaming\Composer\vendor\bin
  • Hoặc tìm đường dẫn bằng lệnh:
    composer global config bin-dir –absolute macOS/Linux:
  • Thêm vào file ~/.bashrc hoặc ~/.zshrc:
    export PATH=”$PATH:$HOME/.config/composer/vendor/bin”
  • Sau đó chạy:
    source ~/.bashrc
    # hoặc
    source ~/.zshrc
  1. Kiểm tra cài đặt
    laravel –version

Cách 2: Sử dụng Composer Create-Project

Bạn có thể tạo project Laravel mới trực tiếp bằng Composer mà không cần cài Laravel Installer:

composer create-project laravel/laravel ten-project

Tạo Project Laravel Mới

Sử dụng Laravel Installer

laravel new ten-project

Sử dụng Composer

composer create-project –prefer-dist laravel/laravel ten-project

Giải thích các tham số:

  • –prefer-dist: Tải phiên bản đã nén (nhanh hơn)
  • ten-project: Tên thư mục project của bạn

Ví dụ cụ thể

Tạo project tên “my-blog”

laravel new my-blog

Hoặc với Composer

composer create-project –prefer-dist laravel/laravel my-blog

Sau khi chạy lệnh, Laravel sẽ tự động:

  • Tạo cấu trúc thư mục
  • Cài đặt tất cả dependencies
  • Tạo file cấu hình cơ bản

Cấu Hình Môi Trường

  1. Di chuyển vào thư mục project

cd ten-project

  1. Sao chép file .env

Windows

copy .env.example .env

macOS/Linux

cp .env.example .env

  1. Tạo Application Key

Laravel cần một application key để mã hóa dữ liệu. Tạo key bằng lệnh:

php artisan key:generate

Lệnh này sẽ tự động thêm APP_KEY vào file .env.

  1. Cấu hình Database (Nếu cần)

Mở file .env và cấu hình thông tin database:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=ten_database
DB_USERNAME=ten_user
DB_PASSWORD=mat_khau

Lưu ý: Nếu sử dụng SQLite, chỉ cần tạo file database:

touch database/database.sqlite

Và cấu hình trong .env:
DB_CONNECTION=sqlite
DB_DATABASE=/absolute/path/to/database/database.sqlite

  1. Cấu hình các thông tin khác

Trong file .env, bạn có thể cấu hình:

APP_NAME=”Tên Ứng Dụng”
APP_ENV=local
APP_DEBUG=true
APP_URL=http://localhost

Mail Configuration (nếu cần)

MAIL_MAILER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null

Chạy Ứng Dụng Laravel

  1. Chạy Development Server

Laravel có sẵn một development server tích hợp. Chạy lệnh sau:

php artisan serve

Server sẽ chạy tại: http://localhost:8000

  1. Truy cập ứng dụng

Mở trình duyệt và truy cập:
http://localhost:8000

Bạn sẽ thấy trang welcome của Laravel!

  1. Chạy trên port khác

php artisan serve –port=8080

  1. Chạy trên host khác

php artisan serve –host=0.0.0.0

Các Lệnh Hữu Ích

Artisan Commands

Laravel cung cấp nhiều lệnh hữu ích thông qua Artisan CLI:

Xem danh sách tất cả lệnh

php artisan list

Tạo controller

php artisan make:controller TenController

Tạo model

php artisan make:model TenModel

Tạo migration

php artisan make:migration ten_migration

Chạy migration

php artisan migrate

Tạo seeder

php artisan make:seeder TenSeeder

Chạy seeder

php artisan db:seed

Xóa cache

php artisan cache:clear
php artisan config:clear
php artisan route:clear
php artisan view:clear

Xóa tất cả cache

php artisan optimize:clear

Composer Commands

Cài đặt dependencies

composer install

Cập nhật dependencies

composer update

Tự động load class

composer dump-autoload

Xử Lý Lỗi Thường Gặp

  1. Lỗi “Composer not found”

Nguyên nhân: Composer chưa được cài đặt hoặc chưa được thêm vào PATH.

Giải pháp:

  • Kiểm tra Composer đã được cài đặt: composer –version
  • Thêm Composer vào biến môi trường PATH
  1. Lỗi “PHP extension missing”

Nguyên nhân: Thiếu các PHP extension cần thiết.

Giải pháp:

  • Mở file php.ini
  • Bỏ comment các extension cần thiết (xóa dấu ; ở đầu dòng)
  • Khởi động lại web server
  1. Lỗi “Permission denied”

Nguyên nhân: Không có quyền ghi file.

Giải pháp (Linux/macOS):
chmod -R 775 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache

  1. Lỗi “Class not found”

Nguyên nhân: Autoload chưa được cập nhật.

Giải pháp:
composer dump-autoload

  1. Lỗi “APP_KEY not set”

Nguyên nhân: Chưa tạo application key.

Giải pháp:
php artisan key:generate

  1. Lỗi kết nối database

Nguyên nhân: Thông tin database trong .env không đúng.

Giải pháp:

  • Kiểm tra lại thông tin trong file .env
  • Đảm bảo database đã được tạo
  • Kiểm tra user và password có quyền truy cập
  1. Lỗi “Port already in use”

Nguyên nhân: Port 8000 đã được sử dụng.

Giải pháp:

Sử dụng port khác

php artisan serve –port=8080

Hoặc tìm và dừng process đang dùng port 8000

Windows

netstat -ano | findstr :8000
taskkill /PID /F

Linux/macOS

lsof -ti:8000 | xargs kill

Cấu Trúc Thư Mục Laravel

Sau khi tạo project, bạn sẽ thấy cấu trúc thư mục như sau:

ten-project/
├── app/ # Thư mục chứa code chính
│ ├── Console/ # Console commands
│ ├── Exceptions/ # Exception handlers
│ ├── Http/ # Controllers, Middleware, Requests
│ │ ├── Controllers/ # Controllers
│ │ └── Middleware/ # Middleware
│ └── Models/ # Eloquent models
├── bootstrap/ # Bootstrap files
├── config/ # Configuration files
├── database/ # Migrations, seeders, factories
│ ├── migrations/ # Database migrations
│ ├── seeders/ # Database seeders
│ └── factories/ # Model factories
├── public/ # Public assets, entry point
│ └── index.php # Entry point của ứng dụng
├── resources/ # Views, assets chưa compile
│ ├── views/ # Blade templates
│ ├── css/ # CSS files
│ └── js/ # JavaScript files
├── routes/ # Route definitions
│ ├── web.php # Web routes
│ ├── api.php # API routes
│ └── console.php # Console routes
├── storage/ # Logs, cache, uploads
├── tests/ # Test files
├── vendor/ # Composer dependencies
├── .env # Environment configuration
├── .env.example # Example environment file
├── artisan # Artisan CLI
├── composer.json # Composer dependencies
└── package.json # NPM dependencies

Bước Tiếp Theo

Sau khi cài đặt thành công Laravel, bạn có thể:

  1. Học về Routing
  • Đọc file routes/web.php
  • Tạo các route mới
  1. Học về Controllers
  • Tạo controller: php artisan make:controller HomeController
  • Viết các method trong controller
  1. Học về Views
  • Tạo file Blade template trong resources/views/
  • Sử dụng Blade syntax
  1. Học về Database
  • Tạo migration: php artisan make:migration create_users_table
  • Chạy migration: php artisan migrate
  1. Học về Models
  • Tạo model: php artisan make:model User
  • Sử dụng Eloquent ORM

Kết Luận

Chúc mừng! Bạn đã hoàn thành việc cài đặt Laravel. Framework này cung cấp rất nhiều tính năng mạnh mẽ giúp bạn phát triển ứng dụng web một cách nhanh chóng và hiệu quả.

Tài Liệu Tham Khảo

  • Laravel Official Documentation: https://laravel.com/docs
  • Laravel News: https://laravel-news.com
  • Laracasts (Video tutorials): https://laracasts.com

Lời Khuyên

  • Đọc kỹ tài liệu chính thức của Laravel
  • Thực hành thường xuyên
  • Tham gia cộng đồng Laravel Việt Nam
  • Xem các video tutorial trên YouTube

Chúc bạn học tập vui vẻ và thành công với Laravel! 🚀

Tác giả: Hướng dẫn cài đặt Laravel
Ngày cập nhật: 2025
Phiên bản Laravel: 10.x trở lên

Mục Lục

1. Giới Thiệu
2. Yêu Cầu Hệ Thống
3. Cài Đặt Composer
4. Cài Đặt Laravel
5. Tạo Project Laravel Mới
6. Cấu Hình Môi Trường
7. Chạy Ứng Dụng Laravel
8. Các Lệnh Hữu Ích
9. Xử Lý Lỗi Thường Gặp
10. Kết Luận

Giới Thiệu

Laravel là một PHP framework mã nguồn mở, mạnh mẽ và dễ sử dụng, được thiết kế để phát triển các ứng dụng web hiện đại. Framework này cung cấp nhiều tính năng như routing, authentication, caching, và nhiều công cụ khác giúp việc phát triển web trở nên nhanh chóng và hiệu quả.

Bài viết này sẽ hướng dẫn bạn từng bước cách cài đặt Laravel trên máy tính của mình, phù hợp cho những người mới bắt đầu học.

Yêu Cầu Hệ Thống

Trước khi cài đặt Laravel, bạn cần đảm bảo máy tính của mình đáp ứng các yêu cầu sau:

1. PHP

Phiên bản tối thiểu: PHP 8.1 trở lên

Các extension cần thiết:
• BCMath PHP Extension
• Ctype PHP Extension
• cURL PHP Extension
• DOM PHP Extension
• Fileinfo PHP Extension
• JSON PHP Extension
• Mbstring PHP Extension
• OpenSSL PHP Extension
• PCRE PHP Extension
• PDO PHP Extension
• Tokenizer PHP Extension
• XML PHP Extension

2. Composer

Composer là công cụ quản lý dependencies cho PHP, cần thiết để cài đặt Laravel

3. Database (Tùy chọn)

• MySQL 5.7+ hoặc MariaDB 10.3+
• PostgreSQL 10+
• SQLite 3.8.8+
• SQL Server 2017+

4. Web Server

Apache hoặc Nginx (hoặc sử dụng built-in server của PHP)

Cài Đặt Composer

Composer là công cụ quản lý dependencies không thể thiếu khi làm việc với Laravel. Dưới đây là cách cài đặt Composer trên các hệ điều hành khác nhau:

Trên Windows

1. Tải Composer-Setup.exe
– Truy cập: https://getcomposer.org/download/
– Tải file Composer-Setup.exe

2. Chạy file cài đặt
– Chạy file Composer-Setup.exe
– Làm theo hướng dẫn trong wizard
– Composer sẽ tự động tìm đường dẫn PHP của bạn

3. Kiểm tra cài đặt
Mở Command Prompt hoặc PowerShell và chạy:
composer –version
Nếu hiển thị phiên bản Composer, bạn đã cài đặt thành công!

Trên macOS

1. Sử dụng Homebrew (Khuyến nghị)
brew install composer

2. Hoặc tải trực tiếp
php -r “copy(‘https://getcomposer.org/installer’, ‘composer-setup.php’);”
php composer-setup.php
php -r “unlink(‘composer-setup.php’);”
sudo mv composer.phar /usr/local/bin/composer

3. Kiểm tra cài đặt
composer –version

Trên Linux (Ubuntu/Debian)

1. Cài đặt dependencies
sudo apt update
sudo apt install php-cli php-zip php-mbstring php-xml php-curl

2. Tải và cài đặt Composer
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

3. Kiểm tra cài đặt
composer –version

Cài Đặt Laravel

Sau khi đã cài đặt Composer, bạn có thể cài đặt Laravel theo một trong hai cách:

Cách 1: Sử dụng Laravel Installer (Khuyến nghị)

1. Cài đặt Laravel Installer toàn cục
composer global require laravel/installer

2. Thêm vào PATH (Quan trọng!)

Windows:
– Thêm đường dẫn vào biến môi trường PATH:
%USERPROFILE%\AppData\Roaming\Composer\vendor\bin
– Hoặc tìm đường dẫn bằng lệnh:
composer global config bin-dir –absolute

macOS/Linux:
– Thêm vào file ~/.bashrc hoặc ~/.zshrc:
export PATH=”$PATH:$HOME/.config/composer/vendor/bin”
– Sau đó chạy:
source ~/.bashrc
# hoặc
source ~/.zshrc

3. Kiểm tra cài đặt
laravel –version

Cách 2: Sử dụng Composer Create-Project

Bạn có thể tạo project Laravel mới trực tiếp bằng Composer mà không cần cài Laravel Installer:

composer create-project laravel/laravel ten-project

Tạo Project Laravel Mới

Sử dụng Laravel Installer

laravel new ten-project

Sử dụng Composer

composer create-project –prefer-dist laravel/laravel ten-project

Giải thích các tham số:
– –prefer-dist: Tải phiên bản đã nén (nhanh hơn)
– ten-project: Tên thư mục project của bạn

Ví dụ cụ thể

# Tạo project tên “my-blog”
laravel new my-blog

# Hoặc với Composer
composer create-project –prefer-dist laravel/laravel my-blog

Sau khi chạy lệnh, Laravel sẽ tự động:
– Tạo cấu trúc thư mục
– Cài đặt tất cả dependencies
– Tạo file cấu hình cơ bản

Cấu Hình Môi Trường

1. Di chuyển vào thư mục project

cd ten-project

2. Sao chép file .env

# Windows
copy .env.example .env

# macOS/Linux
cp .env.example .env

3. Tạo Application Key

Laravel cần một application key để mã hóa dữ liệu. Tạo key bằng lệnh:

php artisan key:generate

Lệnh này sẽ tự động thêm APP_KEY vào file .env.

4. Cấu hình Database (Nếu cần)

Mở file .env và cấu hình thông tin database:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=ten_database
DB_USERNAME=ten_user
DB_PASSWORD=mat_khau

Lưu ý: Nếu sử dụng SQLite, chỉ cần tạo file database:

touch database/database.sqlite

Và cấu hình trong .env:
DB_CONNECTION=sqlite
DB_DATABASE=/absolute/path/to/database/database.sqlite

5. Cấu hình các thông tin khác

Trong file .env, bạn có thể cấu hình:

APP_NAME=”Tên Ứng Dụng”
APP_ENV=local
APP_DEBUG=true
APP_URL=http://localhost

# Mail Configuration (nếu cần)
MAIL_MAILER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null

Chạy Ứng Dụng Laravel

1. Chạy Development Server

Laravel có sẵn một development server tích hợp. Chạy lệnh sau:

php artisan serve

Server sẽ chạy tại: http://localhost:8000

2. Truy cập ứng dụng

Mở trình duyệt và truy cập:
http://localhost:8000

Bạn sẽ thấy trang welcome của Laravel!

3. Chạy trên port khác

php artisan serve –port=8080

4. Chạy trên host khác

php artisan serve –host=0.0.0.0

Các Lệnh Hữu Ích

Artisan Commands

Laravel cung cấp nhiều lệnh hữu ích thông qua Artisan CLI:

# Xem danh sách tất cả lệnh
php artisan list

# Tạo controller
php artisan make:controller TenController

# Tạo model
php artisan make:model TenModel

# Tạo migration
php artisan make:migration ten_migration

# Chạy migration
php artisan migrate

# Tạo seeder
php artisan make:seeder TenSeeder

# Chạy seeder
php artisan db:seed

# Xóa cache
php artisan cache:clear
php artisan config:clear
php artisan route:clear
php artisan view:clear

# Xóa tất cả cache
php artisan optimize:clear

Composer Commands

# Cài đặt dependencies
composer install

# Cập nhật dependencies
composer update

# Tự động load class
composer dump-autoload

Xử Lý Lỗi Thường Gặp

1. Lỗi “Composer not found”

Nguyên nhân: Composer chưa được cài đặt hoặc chưa được thêm vào PATH.

Giải pháp:
– Kiểm tra Composer đã được cài đặt: composer –version
– Thêm Composer vào biến môi trường PATH

2. Lỗi “PHP extension missing”

Nguyên nhân: Thiếu các PHP extension cần thiết.

Giải pháp:
– Mở file php.ini
– Bỏ comment các extension cần thiết (xóa dấu ; ở đầu dòng)
– Khởi động lại web server

3. Lỗi “Permission denied”

Nguyên nhân: Không có quyền ghi file.

Giải pháp (Linux/macOS):
chmod -R 775 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache

4. Lỗi “Class not found”

Nguyên nhân: Autoload chưa được cập nhật.

Giải pháp:
composer dump-autoload

5. Lỗi “APP_KEY not set”

Nguyên nhân: Chưa tạo application key.

Giải pháp:
php artisan key:generate

6. Lỗi kết nối database

Nguyên nhân: Thông tin database trong .env không đúng.

Giải pháp:
– Kiểm tra lại thông tin trong file .env
– Đảm bảo database đã được tạo
– Kiểm tra user và password có quyền truy cập

7. Lỗi “Port already in use”

Nguyên nhân: Port 8000 đã được sử dụng.

Giải pháp:
# Sử dụng port khác
php artisan serve –port=8080

# Hoặc tìm và dừng process đang dùng port 8000
# Windows
netstat -ano | findstr :8000
taskkill /PID /F

# Linux/macOS
lsof -ti:8000 | xargs kill

Cấu Trúc Thư Mục Laravel

Sau khi tạo project, bạn sẽ thấy cấu trúc thư mục như sau:

ten-project/
├── app/ # Thư mục chứa code chính
│ ├── Console/ # Console commands
│ ├── Exceptions/ # Exception handlers
│ ├── Http/ # Controllers, Middleware, Requests
│ │ ├── Controllers/ # Controllers
│ │ └── Middleware/ # Middleware
│ └── Models/ # Eloquent models
├── bootstrap/ # Bootstrap files
├── config/ # Configuration files
├── database/ # Migrations, seeders, factories
│ ├── migrations/ # Database migrations
│ ├── seeders/ # Database seeders
│ └── factories/ # Model factories
├── public/ # Public assets, entry point
│ └── index.php # Entry point của ứng dụng
├── resources/ # Views, assets chưa compile
│ ├── views/ # Blade templates
│ ├── css/ # CSS files
│ └── js/ # JavaScript files
├── routes/ # Route definitions
│ ├── web.php # Web routes
│ ├── api.php # API routes
│ └── console.php # Console routes
├── storage/ # Logs, cache, uploads
├── tests/ # Test files
├── vendor/ # Composer dependencies
├── .env # Environment configuration
├── .env.example # Example environment file
├── artisan # Artisan CLI
├── composer.json # Composer dependencies
└── package.json # NPM dependencies

Bước Tiếp Theo

Sau khi cài đặt thành công Laravel, bạn có thể:

1. Học về Routing
– Đọc file routes/web.php
– Tạo các route mới

2. Học về Controllers
– Tạo controller: php artisan make:controller HomeController
– Viết các method trong controller

3. Học về Views
– Tạo file Blade template trong resources/views/
– Sử dụng Blade syntax

4. Học về Database
– Tạo migration: php artisan make:migration create_users_table
– Chạy migration: php artisan migrate

5. Học về Models
– Tạo model: php artisan make:model User
– Sử dụng Eloquent ORM

Kết Luận

Chúc mừng! Bạn đã hoàn thành việc cài đặt Laravel. Framework này cung cấp rất nhiều tính năng mạnh mẽ giúp bạn phát triển ứng dụng web một cách nhanh chóng và hiệu quả.

Tài Liệu Tham Khảo

• Laravel Official Documentation: https://laravel.com/docs
• Laravel News: https://laravel-news.com
• Laracasts (Video tutorials): https://laracasts.com

Lời Khuyên

• Đọc kỹ tài liệu chính thức của Laravel
• Thực hành thường xuyên
• Tham gia cộng đồng Laravel Việt Nam
• Xem các video tutorial trên YouTube

Chúc bạn học tập vui vẻ và thành công với Laravel! 🚀

Tác giả: Hướng dẫn cài đặt Laravel
Ngày cập nhật: 2025
Phiên bản Laravel: 10.x trở lên

Leave a Reply

Your email address will not be published. Required fields are marked *