Ubuntu下PHP安装教程：apt-get命令全解析

本文详解了在Ubuntu系统中使用apt-get命令安装PHP的完整流程与关键细节，涵盖默认安装版本规律（如22.04装PHP 8.1、24.04装8.3）、CLI与Web服务器模块的分离特性（仅装php命令不等于网站能运行PHP）、配置文件路径与版本隔离机制、常见500错误或空白页的根源及Apache/Nginx针对性解决方案，并重点介绍了通过ondrej/php PPA实现多版本并存、精准安装扩展和安全切换全局PHP版本的实用技巧——帮你避开“装了却用不了”“版本对不上”“扩展找不到”等高频坑，真正把PHP稳稳跑起来。

Ubuntu 下直接用 apt-get 安装 PHP 会装什么版本？

Ubuntu 自带的 apt-get install php 默认安装的是系统仓库维护的稳定版，不是最新版。比如 Ubuntu 22.04 默认装 php8.1，Ubuntu 24.04 默认是 php8.3。这个版本由 Ubuntu 官方打包，已预编译、带常用扩展（如 curl、json、mbstring），但不包含 opcache 或 gd 这类需显式启用的模块。

执行 apt-get install php 后，PHP 可执行文件在哪？

安装后，主二进制文件路径是 /usr/bin/php；配置文件在 /etc/php/*/cli/php.ini（CLI 模式）和 /etc/php/*/apache2/php.ini（Apache 模块模式）。注意：* 是版本号占位符，如 8.1 或 8.3，不同版本配置独立存放，互不影响。

• 查看当前 CLI 版本：php -v
• 确认加载的配置文件：php --ini
• 列出已启用的扩展：php -m

为什么装完 php 命令可用，但 web 页面却报 500 或空白？

因为 apt-get install php 只装 CLI 版本，**不自动启用 Apache 或 Nginx 的 PHP 处理模块**。常见错误现象包括：

• Apache 返回 “Internal Server Error” 且 error.log 提示 “PHP module not loaded”
• Nginx 返回 “File not found” 或直接输出 .php 源码
• phpinfo() 页面不解析，浏览器下载或显示纯文本

解决方法取决于 Web 服务器：

如果是 Apache：

sudo a2enmod php8.3
sudo systemctl restart apache2

如果是 Nginx：

sudo apt-get install php8.3-fpm
sudo systemctl enable php8.3-fpm
sudo systemctl start php8.3-fpm

想换版本或同时保留多个 PHP 版本怎么办？

Ubuntu 官方仓库只提供一个默认版本（如 22.04 的 php8.1），若要安装其他版本（如 php8.2 或 php8.3），必须添加第三方仓库——最常用的是 ondrej/php PPA：

sudo apt update
sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update

之后可自由安装：sudo apt-get install php8.2、php8.3-cli、php8.3-mysql 等。注意：ondrej/php 不替换系统默认 PHP，而是并行安装，各版本二进制路径为 /usr/bin/php8.2、/usr/bin/php8.3，用 update-alternatives 切换全局 php 命令指向。

容易被忽略的一点：PPA 包含的扩展名严格对应版本号，php-mysql 是旧版别名，新版本必须写全称如 php8.3-mysql，否则 apt 会提示 “unable to locate package”。

今天关于《Ubuntu下PHP安装教程：apt-get命令全解析》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！