PHP 安装教程：Windows、Mac 和 Linux（php -v）

要安装 PHP，只需为你的系统运行一条命令：Windows 上是 winget install PHP.PHP.8.3，macOS 上是 brew install php，Ubuntu 和 Debian 上是 sudo apt install php-cli。然后打开一个新的终端，运行 php -v。如果它输出了版本号，PHP 就安装好了。

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

你的版本和构建日期会有所不同。在脚本中，同样的信息可以从 PHP_VERSION 和 phpversion() 获得。点“运行”，看看这个页面上的 PHP 报告了什么：

<?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";

在 Windows 上安装 PHP

最快的方式是 winget，Windows 10 和 11 自带这个工具。打开 PowerShell 或 Windows 终端：

winget install PHP.PHP.8.3

关闭终端，再打开一个新的终端，然后运行 php -v。之所以需要新窗口，是因为终端会一直使用它启动时的 PATH。

如果想手动安装：

1. 从 windows.php.net/download 下载 "VS16 x64 Non Thread Safe" 压缩包。
2. 把它解压到一个较短的路径，例如 C:\php。
3. 在同一个文件夹中，把 php.ini-development 复制一份并命名为 php.ini。
4. 把 C:\php 添加到 Path 变量中（开始菜单，“编辑系统环境变量”，环境变量）。
5. 打开一个新的终端，运行 php -v。

如果你还想用一个安装程序同时装好 Apache 和 MySQL，XAMPP 和 Laragon 会把它们和 PHP 打包在一起。

在 macOS 上安装 PHP

macOS 已经不再自带 PHP。用 Homebrew 安装：

brew install php
php -v

brew install php 会安装最新版本。要固定某个版本，就按名字安装，例如 brew install php@8.3。带版本号的 formula 默认不会被链接，所以要用 Homebrew 在安装结束时输出的命令把它添加到 PATH 中。以后用 brew upgrade php 更新。

在 Linux 上安装 PHP

Ubuntu 24.04 和 Debian 13 的官方软件源中自带 PHP 8.3 或更新的版本：

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

在 Fedora、RHEL 和类似的系统上：

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

扩展是单独的软件包，名为 php-<name>：在 Debian 和 Ubuntu 上，php-mysql 添加 MySQL 驱动（Fedora 上是 php-mysqlnd），php-intl 添加 intl 扩展。如果在 Ubuntu 上需要比发行版提供的更新的 PHP，广泛使用的 ppa:ondrej/php 软件源包含了所有受支持的版本：

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

在代码中检查 PHP 版本

库通常要求一个最低版本。version_compare 按 PHP 的方式比较版本字符串，PHP_VERSION_ID 则给出一个便于比较的普通整数（80300 表示 8.3.0）：

<?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";

检查安装了哪些扩展

刚装好 PHP 后遇到的很多错误都是因为缺少扩展。在终端中，php -m 会列出所有已加载的扩展。在代码中，extension_loaded 可以按名字检查某一个扩展：

<?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";

加上你的项目需要的扩展名（例如 pdo_mysql、intl、gd），然后在你自己的电脑上运行，看看需要安装哪些。

找到 php.ini

display_errors、memory_limit 和 upload_max_filesize 等设置保存在 php.ini 中。终端命令 php --ini 会显示加载的是哪个文件。在代码中：

<?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";

命令行和 Web 服务器可能使用不同的 php.ini 文件，所以为其中一个修改的设置不一定对另一个生效。错误报告页面介绍了在开发机器上最值得优先修改的设置。

常见问题：终端运行的仍然是旧版本

升级之后，php -v 有时报告的还是之前的版本。运行 which php（macOS、Linux）或 where php（Windows），看看终端首先找到的是哪个可执行文件。在 macOS 上，这通常是一个已安装但未链接的 Homebrew 版本；在 Windows 上，通常是 Path 中排在前面的旧文件夹，比如 XAMPP 里的那个。调整好顺序，打开一个新的终端，再检查一次。接下来请继续阅读运行 PHP 文件。