NỘI DUNG
Composer là một trình quản lý phụ thuộc (dependency manager) mạnh mẽ dành cho PHP, giúp đơn giản hóa quá trình quản lý các thư viện và gói (package) trong dự án của bạn. Trên môi trường máy chủ cPanel hoặc CloudLinux, việc thiết lập Composer tương đối đơn giản, mặc dù có thể cần một vài bước bổ sung do đặc thù môi trường máy chủ.
Hướng dẫn này sẽ dẫn dắt bạn qua các bước cài đặt và sử dụng Composer một cách chi tiết nhất.
Điều kiện
Trước khi bắt đầu, hãy đảm bảo bạn đáp ứng các yêu cầu sau:
- Tài khoản cPanel có quyền truy cập Terminal (SSH).
- Đã cài đặt PHP 7.2 trở lên (yêu cầu bắt buộc của Composer).
- Lưu ý về CloudLinux: Hệ điều hành này thường được dùng để cô lập các tài khoản người dùng nhằm tăng tính bảo mật. Bạn có thể cần một số quyền cụ thể để truy cập tài nguyên máy chủ nhất định.
Cài đặt Composer trên máy chủ CloudLinux/cPanel
Bước 1: Truy cập máy chủ qua SSH
Kết nối SSH bằng cách sử dụng các phần mềm như PuTTY (Windows) hoặc Terminal (macOS/Linux)
Bước 2: Cài đặt Composer
Chạy lệnh sau để tải tệp cài đặt Composer:
curl -sS https://getcomposer.org/installer | phpKiểm tra và xử lý lỗi (Nếu có). Nếu quá trình trên báo lỗi, hãy kiểm tra phiên bản PHP hiện tại:
php -vNếu hệ thống thiếu thư viện iconv, hãy cài đặt bổ sung (yêu cầu quyền root):
yum install ea-php72-php-iconvCài đặt chính thức và di chuyển vào hệ thống. Chạy lệnh cài đặt với tham số mở rộng, sau đó di chuyển Composer vào thư mục thực thi toàn cục:
# Cài đặt với quyền mở file từ xa
curl -sS https://getcomposer.org/installer | php -d allow_url_fopen=On
# Di chuyển vào thư mục bin để sử dụng lệnh 'composer'
mv composer.phar /usr/local/bin/composer
Bước 3: Cấu hình cho CloudLinux (CageFS)
Để người dùng trong môi trường CageFS có thể sử dụng được Composer, bạn cần thực hiện các bước sau:
1. Tạo cấu hình
Tạo file tại đường dẫn /etc/cagefs/conf.d/composer.cfg với nội dung:
[composer]
paths = /usr/local/bin/composer2. Cập nhật CageFS
Chạy các lệnh sau để áp dụng thay đổi:
cagefsctl --force-update
cagefsctl --addrpm composerBước 4: Kiểm tra kết quả
Đăng nhập dưới quyền người dùng cPanel và chạy lại lệnh composer -v
composer -v
Xử lý các lỗi thường gặp
Dưới đây là một số vấn đề phổ biến và cách khắc phục:
- Hết bộ nhớ (Memory Exhaustion):
Composer tiêu tốn khá nhiều RAM khi xử lý các dự án lớn. Bạn có thể tăng giới hạn bộ nhớ
php -d memory_limit=512M composer install- Bỏ qua giới hạn bộ nhớ
Nếu quá trình cài đặt bị ngắt quãng, hãy tăng thời gian thực thi:
export COMPOSER_MEMORY_LIMIT=-1
composer install- Lỗi phân quyền (Permission Issues)
Đảm bảo tài khoản của bạn có quyền ghi vào các thư mục dự án. Nếu gặp lỗi “Permission denied”, hãy kiểm tra lại CHMOD hoặc liên hệ quản trị viên.
Việc cài đặt và sử dụng Composer trên máy chủ cPanel/CloudLinux là một quy trình khá trực quan khi bạn đã có quyền truy cập SSH. Công cụ này sẽ giúp bạn quản lý dự án PHP chuyên nghiệp và hiện đại hơn.
