在 Ubuntu 上升级 PHP 配置,通常分为几个步骤:升级 PHP 版本 → 切换 CLI / Web 服务器使用的 PHP → 调整 php.ini 配置。下面按常见场景给你一份完整指南。
一、确认当前 PHP 版本
php -v
或查看已安装版本:
dpkg -l | grep php
二、添加 PHP 官方 PPA(推荐)
Ubuntu 默认源里的 PHP 版本一般较旧,建议使用 Ondřej Surý 的 PPA(最常用、最稳定)。
sudo apt update
sudo apt install -y software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update
三、安装新版本 PHP
例如升级到 PHP 8.2(可按需改为 8.1 / 8.3):
sudo apt install php8.2
常见扩展(按需安装)
sudo apt install php8.2-cli php8.2-fpm \
php8.2-mysql php8.2-curl php8.2-gd \
php8.2-mbstring php8.2-xml php8.2-zip
四、切换 PHP CLI 版本
sudo update-alternatives --config php
选择对应 PHP 版本即可。
验证:
php -v
五、Web 服务器切换 PHP(重点)
✅ Nginx + PHP-FPM
- 安装对应版本 FPM(一般已装):
sudo apt install php8.2-fpm
- 修改 Nginx 配置(示例):
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
- 重启服务:
sudo systemctl restart php8.2-fpm
sudo systemctl restart nginx
✅ Apache
若使用 mod_php
sudo a2dismod php7.4
sudo a2enmod php8.2
sudo systemctl restart apache2
若使用 PHP-FPM(推荐)
sudo a2enmod proxy_fcgi setenvif
sudo a2enconf php8.2-fpm
sudo systemctl restart apache2
六、升级 PHP 配置(php.ini)
1️⃣ 找到配置文件
php --ini
常见路径:
/etc/php/8.2/cli/php.ini
/etc/php/8.2/fpm/php.ini
2️⃣ 常见配置项(示例)
upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M
max_execution_time = 120
date.timezone = Asia/Shanghai
3️⃣ 修改后重启
sudo systemctl restart php8.2-fpm
七、卸载旧版本 PHP(可选)
sudo apt remove php7.4 php7.4-fpm
sudo apt autoremove
八、常见问题排查
❌ PHP 版本不生效
- 确认 Nginx / Apache 使用的是对应
php-fpm.sock - 确认
phpinfo()显示的是哪个php.ini
❌ 扩展不存在
php -m
或:
sudo apt install php8.2-xxx
九、示例升级路径总结
| 当前 | 升级到 |
|---|---|
| Ubuntu 20.04 + PHP 7.4 | PHP 8.1 / 8.2 |
| Ubuntu 22.04 + PHP 8.1 | PHP 8.2 / 8.3 |
如果你愿意,可以告诉我:
- ✅ Ubuntu 版本
- ✅ 当前 PHP 版本
- ✅ Web 服务器(Nginx / Apache)
- ✅ 使用场景(Laravel / WordPress / 原生 PHP)
我可以给你精确到命令级别的升级方案。