Cài đặt PHP trên Windows, Mac và Linux (kiểm tra php -v)

Để cài đặt PHP, hãy chạy một lệnh phù hợp với hệ điều hành của bạn: winget install PHP.PHP.8.3 trên Windows, brew install php trên macOS, hoặc sudo apt install php-cli trên Ubuntu và Debian. Sau đó mở một terminal mới và chạy php -v. Nếu lệnh in ra số phiên bản, PHP đã được cài đặt.

php -v

PHP 8.3.19 (cli) (built: Mar 27 2025 11:08:15) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.3.19, Copyright (c) Zend Technologies
    with Zend OPcache v8.3.19, Copyright (c), by Zend Technologies

Phiên bản và ngày build của bạn sẽ khác. Bên trong script, cùng thông tin đó có được từ PHP_VERSION và phpversion(). Bấm Chạy để xem PHP của trang này báo gì:

<?php
echo "PHP version: " . phpversion() . "\n";
echo "Version as a number: " . PHP_VERSION_ID . "\n";
echo "Operating system family: " . PHP_OS_FAMILY . "\n";
echo "Integer size: " . PHP_INT_SIZE * 8 . " bit\n";

Cài đặt PHP trên Windows

Cách nhanh nhất là winget, có sẵn trong Windows 10 và 11. Mở PowerShell hoặc Windows Terminal:

winget install PHP.PHP.8.3

Đóng terminal, mở một terminal mới rồi chạy php -v. Cần mở cửa sổ mới vì terminal giữ nguyên PATH từ lúc nó khởi động.

Nếu muốn cài thủ công:

1. Tải tệp zip "VS16 x64 Non Thread Safe" từ windows.php.net/download.
2. Giải nén vào một đường dẫn ngắn như C:\php.
3. Sao chép php.ini-development thành php.ini trong cùng thư mục.
4. Thêm C:\php vào biến Path (menu Start, "Edit the system environment variables", Environment Variables).
5. Mở một terminal mới và chạy php -v.

Nếu bạn muốn có cả Apache và MySQL trong một bộ cài, XAMPP và Laragon đóng gói chúng cùng PHP.

Cài đặt PHP trên macOS

macOS không còn đi kèm PHP. Hãy cài bằng Homebrew:

brew install php
php -v

brew install php cài bản phát hành mới nhất. Để cố định một phiên bản, hãy cài theo tên, ví dụ brew install php@8.3. Các formula có số phiên bản không được link mặc định, nên hãy thêm nó vào PATH bằng lệnh mà Homebrew in ra ở cuối quá trình cài. Về sau, brew upgrade php sẽ cập nhật nó.

Cài đặt PHP trên Linux

Ubuntu 24.04 và Debian 13 có sẵn PHP 8.3 hoặc mới hơn trong repository của chúng:

sudo apt update
sudo apt install php-cli php-mbstring php-xml php-curl
php -v

Trên Fedora, RHEL và các hệ tương tự:

sudo dnf install php-cli php-mbstring php-xml
php -v

Extension là các package riêng có tên php-<name>: trên Debian và Ubuntu, php-mysql thêm driver MySQL (php-mysqlnd trên Fedora) còn php-intl thêm extension intl. Nếu cần PHP mới hơn bản mà Ubuntu cung cấp, repository ppa:ondrej/php được dùng rộng rãi có đủ mọi phiên bản đang được hỗ trợ:

sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install php8.3-cli

Kiểm tra phiên bản PHP trong code

Thư viện thường yêu cầu một phiên bản tối thiểu. version_compare so sánh chuỗi phiên bản theo cách của PHP, còn PHP_VERSION_ID cho một số nguyên đơn giản (80300 nghĩa là 8.3.0) rất dễ so sánh:

<?php
$required = '8.1.0';

if (version_compare(PHP_VERSION, $required, '>=')) {
    echo "PHP " . PHP_VERSION . " is new enough (need $required)\n";
} else {
    echo "Please upgrade: this code needs PHP $required\n";
}

echo PHP_VERSION_ID >= 80300 ? "8.3 features are available\n" : "Older than 8.3\n";
echo "Major: " . PHP_MAJOR_VERSION . ", minor: " . PHP_MINOR_VERSION . "\n";

Kiểm tra các extension đã cài

Nhiều lỗi sau khi mới cài là do thiếu extension. Trong terminal, php -m liệt kê mọi extension đã được nạp. Trong code, extension_loaded kiểm tra từng extension theo tên:

<?php
$needed = ['mbstring', 'json', 'ctype', 'dom'];

foreach ($needed as $ext) {
    $status = extension_loaded($ext) ? 'loaded' : 'MISSING';
    printf("%-10s %s\n", $ext, $status);
}

echo "\nTotal extensions loaded: " . count(get_loaded_extensions()) . "\n";

Thêm tên các extension dự án của bạn cần (ví dụ pdo_mysql, intl, gd) rồi chạy trên máy của bạn để biết cần cài gì.

Tìm php.ini

Các thiết lập như display_errors, memory_limit và upload_max_filesize nằm trong php.ini. Lệnh terminal php --ini in ra tệp nào đang được nạp. Từ code:

<?php
$ini = php_ini_loaded_file();
echo $ini === false ? "No php.ini loaded, PHP uses its defaults\n" : "Loaded: $ini\n";

echo "memory_limit = " . ini_get('memory_limit') . "\n";
echo "max_execution_time = " . ini_get('max_execution_time') . "\n";

CLI và web server có thể dùng các tệp php.ini khác nhau, nên một thiết lập đổi cho bên này không phải lúc nào cũng áp dụng cho bên kia. Trang báo lỗi (error reporting) chỉ ra những thiết lập nên đổi trước tiên trên máy phát triển.

Lỗi thường gặp: terminal vẫn chạy phiên bản cũ

Sau khi nâng cấp, php -v đôi khi vẫn báo phiên bản trước. Chạy which php (macOS, Linux) hoặc where php (Windows) để xem terminal tìm thấy tệp thực thi nào trước. Trên macOS, đây thường là một phiên bản Homebrew đã cài nhưng chưa được link; trên Windows, thường là một thư mục cũ hơn nằm trước trong Path, chẳng hạn thư mục bên trong XAMPP. Sửa lại thứ tự, mở một terminal mới rồi kiểm tra lại. Sau đó tiếp tục với chạy file PHP.