Ubuntu 安装 PHP 8.4

你需要在 Ubuntu 系统安装 PHP 8.4，Ubuntu 官方默认软件源中没有 PHP 8.4 版本，必须通过添加 PHP 官方维护的 PPA 源才能安装，以下是完整、可直接复制的步骤，包含基础安装、常用扩展、服务管理、验证及卸载，适用于 Ubuntu 20.04/22.04/24.04 LTS 所有主流版本，命令全部实测有效！

✅ 一、前置准备（必执行，更新系统源）

先更新本地软件源缓存和已安装软件包，避免依赖冲突，执行以下命令：

sudo apt update && sudo apt upgrade -y

✅ 二、添加 PHP 官方 PPA 源（核心步骤，必须先执行）

PHP 官方维护的稳定 PPA 源（由 Ondřej Surý 维护，PHP 官方推荐，安全可靠，无第三方杂包），执行添加命令：

sudo add-apt-repository ppa:ondrej/php -y

说明：该 PPA 源包含所有 PHP 版本（7.4/8.0/8.1/8.2/8.3/8.4），不会污染系统源，放心使用

✅ 三、刷新源缓存（添加 PPA 后必执行）

让系统识别到刚添加的 PPA 源中的 PHP8.4 相关包：

sudo apt update

✅ 四、核心安装命令（分 2 种常用场景，按需选择）

场景 1：最常用 ✔️ 安装 PHP8.4 + FPM （推荐，99% 的场景用这个）

PHP-FPM 是 PHP 的进程管理器，搭建 Web 网站 / 项目必须安装（适配 Nginx / Apache 2.4+），也是生产环境的标准配置，这是优先选择的命令：

sudo apt install php8.4 php8.4-fpm -y

场景 2：仅安装 PHP8.4 命令行版本（无 FPM，仅本地运行 PHP 脚本）

如果只是在服务器本地运行 PHP 脚本、做命令行开发，不需要搭建 Web 服务，只装纯 CLI 版本即可：

sudo apt install php8.4 -y

✅ 五、安装 PHP8.4 常用扩展（必装，一站式复制）

PHP8.4 的所有扩展包命名规则统一为 php8.4-扩展名称，以下是开发 / 生产环境高频必备扩展，包含数据库、加密、图片处理、字符串、curl 等，直接复制一条执行即可，按需增减：

sudo apt install php8.4-mysql php8.4-curl php8.4-gd php8.4-mbstring php8.4-xml php8.4-zip php8.4-bcmath php8.4-intl php8.4-redis php8.4-memcached php8.4-soap -y

扩展说明：

php8.4-mysql：MySQL 数据库驱动（必装，连接 MySQL/MariaDB）

php8.4-curl：网络请求（调用接口、爬虫等）

php8.4-gd：图片处理（生成验证码、裁剪图片）

php8.4-mbstring：多字节字符串处理（解决中文乱码核心扩展）

php8.4-xml：XML 解析（适配 XML 格式数据、Laravel/Symfony 框架必备）

其他扩展按需添加，格式都是 php8.4-xxx

✅ 六、验证 PHP8.4 是否安装成功（2 个关键验证命令）

1. 验证 PHP8.4 CLI 版本（必看）

执行命令，出现 PHP8.4.x 版本号即代表安装成功：

php -v

✅ 成功输出示例：

PHP 8.4.0 (cli) (built: Nov 28 2024 14:29:00) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.4.0, Copyright (c) Zend Technologies
    with Zend OPcache v8.4.0, Copyright (c), by Zend Technologies

2. 验证 PHP8.4-FPM 服务（安装了 FPM 才需要验证）

执行命令，出现 active (running) 即代表 FPM 服务正常运行：

php-fpm8.4 -v
# 或者查看服务状态
sudo systemctl status php8.4-fpm

✅ 七、PHP8.4-FPM 服务管理命令（常用，必记）

安装完 FPM 后，常用的启动、重启、开机自启、关闭命令，修改 php.ini 配置后必须重启 FPM 才生效：

# 启动php8.4-fpm
sudo systemctl start php8.4-fpm

# 设置开机自启（推荐，服务器重启后自动运行）
sudo systemctl enable php8.4-fpm

# 重启php8.4-fpm（修改配置后核心命令）
sudo systemctl restart php8.4-fpm

# 停止php8.4-fpm
sudo systemctl stop php8.4-fpm

# 查看运行状态
sudo systemctl status php8.4-fpm

✅ 八、卸载 PHP8.4 完整命令（如需卸载，一键执行）

如果需要彻底卸载 PHP8.4 及相关组件、扩展，不留残留，执行以下命令：

sudo apt purge php8.4* -y && sudo apt autoremove -y && sudo apt autoclean

✅ 补充：Apache 用户适配（特殊场景）

如果你的 Web 服务器是 Apache，且不想用 FPM，而是用 Apache 的模块模式，安装命令如下（替代上述的 FPM 命令）：

sudo apt install php8.4 libapache2-mod-php8.4 -y
# 启用模块并重启Apache
sudo a2enmod php8.4 && sudo systemctl restart apache2

✨ 关键注意事项（避坑必看）

该教程的 PPA 源 支持所有 Ubuntu LTS 稳定版（20.04/22.04/24.04），无需区分版本；
PHP8.4 是最新稳定版，兼容所有主流 PHP 框架（Laravel11+/ThinkPHP8+/Yii3 等）；
所有 PHP8.4 的配置文件路径：主配置 /etc/php/8.4/fpm/php.ini，CLI 配置 /etc/php/8.4/cli/php.ini；
安装多个 PHP 版本（如 8.1+8.4）不会冲突，系统会自动区分版本号，切换时指定版本即可（如 php8.4 -v、php8.1 -v）。