HƯỚNG DẪN CÀI ĐẶT PHP TRÊN WSL (UBUNTU) CHO LẬP TRÌNH VIÊN BACKEND

đối với một lập trình viên Backend chuyên nghiệp (đặc biệt là dân chuyên Laravel), việc phát triển ứng dụng trên hệ điều hành Linux thông qua WSL (Windows Subsystem for Linux) là tiêu chuẩn vàng. Nó giúp bạn tận dụng sự mượt mà của Windows nhưng vẫn giữ được môi trường chạy code "chuẩn chỉnh" y hệt như trên Server Production thực tế.

Dưới đây là cẩm nang hướng dẫn toàn tập từ A-Z cách cài đặt PHP trên môi trường Linux (WSL - cụ thể là Ubuntu) một cách chuẩn mực, sạch sẽ và tối ưu nhất.

Trước khi bắt đầu, hãy mở cửa sổ WSL (Ubuntu) của bạn lên và đảm bảo hệ thống đã được cập nhật mới nhất bằng câu lệnh:

Bash

sudo apt update && sudo apt upgrade -y

Bước 1: Thêm PPA Kho Lưu Trữ Ondřej Surý (Bắt buộc cho PHP)

Mặc định, kho phần mềm cũ của Ubuntu có thể không chứa các phiên bản PHP mới nhất (như PHP 8.2, 8.3 hoặc mới hơn). Chúng ta sẽ sử dụng kho lưu trữ uy tín của Ondřej Surý — người duy trì chính các gói PHP cho Ubuntu.

Chạy các lệnh sau để cài đặt công cụ hỗ trợ và thêm PPA:

Bash

sudo apt install software-properties-common -y
sudo add-apt-repository ppa:ondrej/php
sudo apt update

Bước 2: Cài Đặt PHP và Các Extension Thiết Yếu

Tùy vào phiên bản dự án bạn đang làm (ví dụ PHP 8.2 hoặc 8.3), hãy thay thế số phiên bản tương ứng. Ở đây chúng ta sẽ cài PHP kèm theo hàng loạt extension tối quan trọng cho Laravel/Web Backend:

Bash

sudo apt install php8.2 php8.2-cli php8.2-common php8.2-mysql php8.2-zip php8.2-gd php8.2-mbstring php8.2-curl php8.2-xml php8.2-bcmath php8.2-intl php8.2-sqlite3 -y

Sau khi cài xong, kiểm tra lại xem PHP đã nhận diện thành công chưa bằng lệnh:

Bash

php -v

Nếu màn hình hiện ra thông tin phiên bản PHP kèm số build chính xác, bạn đã đi được nửa chặng đường!

Bước 3: Cài Đặt Công Cụ Quản Lý Thư Viện Composer

Đã có PHP thì không thể thiếu Composer — linh hồn của hệ sinh thái PHP hiện đại. Hãy chạy chuỗi lệnh sau để tải và cài đặt Composer chuẩn toàn hệ thống (Global):

Bash

# 1. Tải trình cài đặt chính thức
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

# 2. Cài đặt và đưa vào thư mục chứa lệnh toàn cục (/usr/local/bin)
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer

# 3. Dọn dẹp file tạm
php -r "unlink('composer-setup.php');"

Kiểm tra lại bằng lệnh:

Bash

composer --version

Bước 4: Tinh Chỉnh Cấu Hình PHP (php.ini) cho Development

Để môi trường Local chạy mượt mà và không bị kẹt ở các giới hạn bộ nhớ mặc định, bạn cần chỉnh sửa file cấu hình php.ini.

Tìm đường dẫn file cấu hình PHP CLI bằng lệnh:

Bash

php --ini

Mở file php.ini (thường nằm ở /etc/php/8.2/cli/php.ini) bằng trình soạn thảo nano:

Bash

sudo nano /etc/php/8.2/cli/php.ini

Tìm và điều chỉnh lại các thông số sau cho phù hợp với môi trường phát triển:

• memory_limit = 512M (Tăng dung lượng RAM tối đa cho phép một tiến trình PHP sử dụng, tránh lỗi cạn kiệt RAM khi chạy seed dữ liệu lớn).

• upload_max_filesize = 64M (Cho phép upload file dung lượng lớn).

• post_max_size = 64M

(Bấm Ctrl + O rồi Enter để lưu, và Ctrl + X để thoát nano).

Bước 5: Kiểm Tra Tương Tác Giữa WSL và Windows (Mẹo quan trọng)

• Vị trí mã nguồn: Bạn nên đặt các thư mục dự án code của mình nằm trực tiếp bên trong không gian Linux của WSL (ví dụ: ở thư mục nhà /home/username/projects/), tuyệt đối không đặt code ở ổ đĩa Windows (/mnt/c/...) rồi chạy qua WSL. Việc truy xuất chéo ổ đĩa qua lại giữa Windows và Linux sẽ làm tốc độ chạy Composer hoặc Artisan chậm đi gấp nhiều lần.

• Mở code bằng VS Code: Từ terminal WSL, bạn chỉ cần trỏ vào thư mục dự án và gõ lệnh:

  Bash

  code .
  
  

  Lập tức VS Code trên Windows sẽ bật lên và tự động kết nối qua extension WSL Remote, cho phép bạn code mượt mà trên môi trường Linux ngay giao diện Windows quen thuộc.

💡 Lời Kết

Hoàn tất các bước trên, bạn đã sở hữu một môi trường chạy PHP mạnh mẽ, sạch sẽ, tốc độ cao và đồng bộ tuyệt đối với hệ thống Server Linux thực tế trên Production. Sẵn sàng đểclone repo và chạy mọi câu lệnh Artisan hay Composer một cách mượt mà nhất!