当前位置：首页 > 文章列表 > 文章 > php教程 > Ubuntu下PHP安装教程：apt-get命令全解析

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

2026-03-01 15:01:04 0浏览收藏

本文详解了在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稳稳跑起来。

php怎么下载安装到ubuntu系统_apt-get安装命令详解【指南】

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

再确保 Nginx 配置里有类似 fastcgi_pass unix:/run/php/php8.3-fpm.sock; 的转发规则。

想换版本或同时保留多个 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学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！