Nhảy tới nội dung

Cài đặt

Yêu cầu hệ thống​

Trước khi cài đặt, hãy đảm bảo hệ thống của bạn đáp ứng các yêu cầu sau:

Yêu cầuPhiên bản
PHP>= 8.3
Swoole Extension>= 5.0
MySQL>= 8.0
Redis>= 6.0
Composer>= 2.0

Cài đặt Swoole Extension​

# Ubuntu/Debian
sudo pecl install swoole

# Thêm vào php.ini
extension=swoole.so

PHP Extensions cần thiết​

# Kiểm tra extensions
php -m | grep -E "swoole|mbstring|ffi|intl|zip"

Extensions bắt buộc:

  • swoole
  • mbstring
  • ffi
  • intl
  • zip

Cài đặt Project​

Clone Repository​

git clone https://github.com/vietiso/project.git
cd project

Cài đặt Dependencies​

composer install

Cấu hình Environment​

# Copy file environment mẫu
cp .env.example .env

# Chỉnh sửa cấu hình
nano .env

Cấu hình Database​

DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database
DB_USERNAME=your_username
DB_PASSWORD=your_password

Cấu hình Redis​

REDIS_HOST=127.0.0.1
REDIS_PORT=6379
REDIS_PASSWORD=null

Khởi động Server​

Development Mode​

# Khởi động server
composer start

# Hoặc với hot reload
composer start:watch

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

Production Mode​

# Khởi động với daemon mode
php vietiso start:serve --daemonize

CLI Commands​

# Xem danh sách commands
php vietiso list

# Tạo module mới
php vietiso make:module ModuleName

# Chạy migrations
php vietiso migrate

# Clear cache
php vietiso cache:clear

Kiểm tra cài đặt​

Truy cập http://localhost:9501 để xác nhận server đang chạy.

# Hoặc dùng curl
curl http://localhost:9501/health

Xử lý lỗi thường gặp​

Lỗi: Swoole extension not found​

# Kiểm tra swoole đã cài chưa
php -m | grep swoole

# Nếu chưa có, cài đặt lại
pecl install swoole

Lỗi: Port already in use​

# Tìm process đang dùng port
lsof -i :9501

# Kill process
kill -9 <PID>

Lỗi: Permission denied​

# Cấp quyền cho thư mục storage
chmod -R 775 storage
chmod -R 775 cache