在Ubuntu系统中安装PHP可以通过系统自带的包管理工具快速完成，整个过程不需要手动编译源码，操作门槛较低，适合大多数开发场景使用。
安装前的准备工作
在安装PHP之前，需要先更新系统的软件源列表，确保能获取到最新的软件包信息，避免安装过程中出现包找不到的问题。执行以下命令更新软件源：
sudo apt update sudo apt upgrade -y
如果当前用户不是root用户，需要在命令前加上sudo获取管理员权限，执行过程中需要输入当前用户的密码。
安装默认版本的PHP
Ubuntu的官方软件源中默认包含PHP的稳定版本，直接执行安装命令即可完成安装：
sudo apt install php -y
这个命令会自动安装PHP的核心组件以及部分常用依赖，安装完成后可以通过以下命令验证是否安装成功：
php -v
如果终端输出PHP的版本信息，说明安装成功。
安装指定版本的PHP
如果需要安装特定版本的PHP，比如PHP 8.2，需要先添加PHP的第三方软件源，因为Ubuntu默认源可能不包含最新的PHP版本。执行以下命令添加源：
sudo apt install software-properties-common -y sudo add-apt-repository ppa:ondrej/php -y sudo apt update
添加源之后就可以安装指定版本的PHP了，以安装PHP 8.2为例：
sudo apt install php8.2 -y
安装完成后同样使用php -v命令验证版本，如果系统安装了多个版本的PHP，需要确认当前生效的版本是否为目标版本。
安装PHP常用扩展
PHP的很多功能需要通过扩展实现，比如连接MySQL数据库需要mysqli扩展，处理图片需要gd扩展。安装扩展的命令格式为sudo apt install php[版本号]-[扩展名] -y，以下是几个常用扩展的安装示例：
# 安装PHP 8.2的MySQL扩展 sudo apt install php8.2-mysql -y # 安装PHP 8.2的GD扩展 sudo apt install php8.2-gd -y # 安装PHP 8.2的curl扩展 sudo apt install php8.2-curl -y # 安装PHP 8.2的xml扩展 sudo apt install php8.2-xml -y
安装扩展之后不需要重启系统，PHP会自动加载新安装的扩展，可以通过php -m命令查看已安装的扩展列表。
常见问题及解决方法
安装时提示依赖缺失
如果出现依赖缺失的报错，可以先执行sudo apt -f install命令修复依赖关系，之后再重新执行PHP安装命令。
安装后无法识别php命令
这种情况可能是PHP的可执行文件路径没有加入系统环境变量，可以执行which php查看PHP的安装路径，再将路径加入环境变量，或者重新安装PHP包。
多版本PHP切换
如果系统安装了多个版本的PHP，可以使用update-alternatives命令切换默认版本：
# 查看已安装的PHP版本 sudo update-alternatives --display php # 切换PHP版本 sudo update-alternatives --config php
执行切换命令后会列出所有已安装的PHP版本，输入对应版本的数字编号即可完成切换。
LinuxPHPUbuntuapt_install修改时间：2026-06-28 16:54:24