Cài đặt EC-CUBE local với Docker

Để bắt đầu lập trình với EC-CUBE, điều quan trọng đầu tiên là thiết lập môi trường phát triển trên máy tính cá nhân. Bài học này sẽ hướng dẫn bạn cách cài đặt EC-CUBE nhanh chóng và hiệu quả bằng Docker – một công cụ giúp tạo môi trường ảo hóa nhẹ. Qua đó, bạn sẽ nắm vững quy trình thiết lập hệ thống gồm PHP, cơ sở dữ liệu, web server và EC-CUBE source code sẵn sàng cho phát triển.

Cài đặt EC-CUBE local với Docker

1. Yêu cầu hệ thống

Trước khi bắt đầu, hãy đảm bảo máy tính của bạn đã cài đặt các công cụ sau:

• Docker Desktop
• [Docker Compose](tích hợp trong Docker Desktop)
• Git
• Composer
• RAM: Tối thiểu 4GB, khuyến nghị 8GB trở lên để Docker chạy mượt
• Hệ điều hành: Windows, macOS hoặc Linux đều được hỗ trợ

2. Tải source EC-CUBE từ GitHub

Bạn có 2 cách để tải mã nguồn EC-CUBE:

Cách 1: Clone từ GitHub

git clone https://github.com/EC-CUBE/ec-cube.git eccube-app
cd eccube-app

Cách 2: Tải bản phát hành zip

• Truy cập https://www.ec-cube.net/download/
• Giải nén và đổi tên thư mục thành eccube-app

3. Cấu hình .env và thiết lập cơ sở dữ liệu

• EC-CUBE dùng file .env để lưu cấu hình môi trường.
• Nếu chưa có, bạn có thể tạo file .env từ .env.dist:

cp .env.dist .env

• Chỉnh sửa các thông tin kết nối database nếu cần:

DATABASE_URL=mysql://eccube_user:eccube_pass@mysql:3306/eccube_db

Gợi ý: Với Docker Compose, tên host DB thường là mysql (do được định nghĩa trong docker-compose.yml)

4. Cài đặt EC-CUBE bằng dòng lệnh

Trước khi chạy EC-CUBE, cần cài đặt các dependency và khởi tạo hệ thống:

composer install

Sau đó chạy lệnh cài đặt EC-CUBE:

bin/console eccube:install

Làm theo các bước hướng dẫn trong terminal:

• Chọn database driver (MySQL/PostgreSQL)
• Nhập thông tin kết nối DB
• Thiết lập admin account

5. Khởi động EC-CUBE trên localhost

Dùng Docker Compose để chạy toàn bộ hệ thống:

docker-compose up -d

Truy cập trình duyệt:

• Trang chủ EC: http://localhost:8080/
• Trang quản trị: http://localhost:8080/admin

Đăng nhập bằng tài khoản admin bạn đã tạo ở bước cài đặt.

Kết luận

• Bài học này giúp bạn hoàn tất bước khởi đầu quan trọng: thiết lập môi trường phát triển EC-CUBE trên máy cá nhân.
• Docker giúp đơn giản hóa quá trình setup, tiết kiệm thời gian và đảm bảo đồng nhất môi trường giữa các thành viên trong nhóm.
• Sau khi cài đặt xong, bạn đã có thể bắt đầu khám phá cấu trúc mã nguồn EC-CUBE và thực hành tùy biến các chức năng.