PHP The Right Way 系列：在 Ubuntu / Debian 上安装最新版 PHP——PPA 与 sury.org bikeshed 完整实战指南-育师

文档
教程

【免费下载链接】php-the-right-way

An easy-to-read, quick reference for PHP best practices, accepted coding standards, and links to authoritative tutorials around the Web

项目地址：https://gitcode.com/gh_mirrors/ph/php-the-right-way

点击查看免费下载

绝大多数 GNU/Linux 发行版的官方软件仓库虽然自带 PHP，但版本往往滞后于当前稳定版。本文以 PHP: The Right Way 项目的 Linux 环境搭建章节为核心，完整讲解在 Ubuntu 系与 Debian 系发行版上，通过 Ondřej Surý 维护的 PPA 与 bikeshed（Debian 版 PPA）获取最新版 PHP 的标准操作流程，并延伸到安装后的版本切换、内置 Web 服务器与 CLI 开发验证，让读者拿到一份可直接照做的 Linux PHP 开发环境搭建手册。

为什么 Linux 官方仓库的 PHP 总是"差半拍"

仓库文档 Use the Current Stable Version 明确指出：如果刚开始学习 PHP，应从当前稳定版PHP 8.3起步。PHP 8.x 在 7.x、5.x 基础上带来了大量新特性，引擎大规模重写后性能大幅提升；同时 PHP 7.4 已到达生命周期终点（End of Life），官方不再提供安全修复。这意味着停留在旧版本不仅缺少新特性，还面临未修复安全漏洞的风险。

然而，Debian 系与 Ubuntu 系发行版的官方仓库通常只打包"足够稳定"但版本偏旧的 PHP，原因在于发行版更看重长期支持而非第一时间跟进上游新版本。因此，在 Linux 上想要使用 PHP 8.3 这类较新版本，通常有以下几条路径：

使用第三方维护的软件源，让apt直接安装新版 PHP（本文重点）；
使用 Docker 等容器方案，通过官方镜像直接运行对应 PHP 版本（见 Docker）；
直接编译 PHP 源码，自行控制版本与编译参数。

对于 Ubuntu 与 Debian 系发行版而言，最贴近原生包管理习惯的方案，就是使用Ondřej Surý维护的 Personal Package Archive（PPA，Ubuntu 平台）和 bikeshed（Debian 平台）。下面分别给出完整操作步骤。

Ubuntu 系发行版：添加 ondrej/php PPA

对于 Ubuntu，Ondřej Surý 的 PPA 提供受支持的 PHP 版本，同时还打包了大量 PECL 扩展，安装扩展时无需再单独编译，直接apt install即可。

在终端中按以下两步操作：

将 PPA 添加到系统的软件源列表：
```
sudo add-apt-repository ppa:ondrej/php
```
更新系统的软件包索引：
```
sudo apt update
```

执行完sudo apt update后，系统即可访问 PPA 中的最新 PHP 软件包。之后便可以用apt直接安装所需的 PHP 版本与扩展，例如：

sudo apt install php8.3 php8.3-cli php8.3-fpm php8.3-mysql php8.3-xml php8.3-curl

其中php8.3-fpm提供 FastCGI 进程管理器，适合配合 Nginx 使用；php8.3-cli则是命令行版本，安装后即可运行php -v验证版本号。

实用提示：如果系统提示add-apt-repository命令不存在，通常需要先安装software-properties-common软件包：sudo apt install software-properties-common。add-apt-repository本质上是在/etc/apt/sources.list.d/下写入 PPA 的源描述文件，并导入对应的 GPG 密钥，因此该前置包是必备的。

Debian 系发行版：配置 sury.org bikeshed 软件源

Debian 平台上，Ondřej Surý 提供的是 bikeshed（PPA 的 Debian 等价物），仓库地址托管于 packages.sury.org。与 Ubuntu 的add-apt-repository一键添加不同，Debian 需要手工完成签名密钥下载与源文件写入，一共六步：

确保拥有 root 权限。如果当前用户没有 root 权限，后续命令需要加sudo。
更新系统软件包列表：
```
sudo apt-get update
```
安装三个前置工具：lsb-release（用于读取发行版代号）、ca-certificates（CA 证书，保证 HTTPS 下载可信）、curl（下载工具）：
```
sudo apt-get -y install lsb-release ca-certificates curl
```
下载仓库签名密钥，保存到/usr/share/keyrings/目录（这是 Debian 11+ 推荐的 keyring 存放位置，配合signed-by使用可避免密钥被全局信任）：
```
sudo curl -sSLo /usr/share/keyrings/deb.sury.org-php.gpg https://packages.sury.org/php/apt.gpg
```
参数说明：-sS静默但保留错误输出，-L跟随重定向，-o指定输出文件路径。
写入软件源配置。这里的核心技巧是用lsb_release -sc动态获取当前 Debian 的代号（如bookworm、bullseye），确保源行与你的发行版匹配：
```
sudo sh -c 'echo "deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list'
```
其中[signed-by=...]限定只信任上一步下载的密钥来校验该仓库的软件包，属于更安全的签名校验实践。
再次更新软件包列表，使新仓库中的 PHP 包可见：
```
sudo apt-get update
```

完成以上六步后，你的 Debian 系统即可从 bikeshed 安装最新 PHP 软件包，安装命令与 Ubuntu 一致（如sudo apt-get install php8.3-cli php8.3-fpm）。值得注意的是，bikeshed 不仅提供 PHP 本体，还提供配套的扩展包与常见 Web 服务器（Apache、Nginx）的对接包，方便一条命令搭起完整运行环境。

安装后必做验证：确认版本与 CLI 可用

无论走 PPA 还是 bikeshed 路径，装完后第一件事就是验证。仓库文档 Command Line Interface 提供了两个最实用的命令：

php -i：输出当前 PHP 的完整配置信息，效果等价于 Web 环境中的phpinfo()，可用于核对 PHP 版本、编译参数、已启用扩展与配置文件加载路径；
php -a：进入交互式 Shell（类似 Ruby 的 IRB、Python 的交互终端），适合快速验证语法或测试小段代码。

如果系统中同时安装了多个 PHP 主版本，apt的update-alternatives机制会管理php命令的默认指向，可以通过sudo update-alternatives --config php手工切换，或在安装时指定php8.2、php8.3这类带版本号的具体包名来精确控制。

快速上手：用内置 Web 服务器立即开发

新版 PHP 自带命令行 Web 服务器，无需安装和配置完整 Web 服务器即可开始学习与本地调试。仓库文档 Built-in Web Server 给出了核心用法——在项目的 Web 根目录执行：

php -S localhost:8000

随后浏览器访问http://localhost:8000即可看到项目页面。该内置服务器自 PHP 5.4 起内置，对学习、原型验证和轻量本地开发非常友好；需要自定义路由时可加-t指定文档根目录，例如php -S localhost:8000 -t public。

别忘了规范的目录结构

在动手写代码前，仓库文档 Common Directory Structure 给出了一个值得从一开始就遵守的约定：出于安全考虑，配置文件不能放在 Web 访问目录内——公开脚本放在public/目录（DocumentRoot指向它），私有配置与数据放在public/之外；单元测试放在tests/，第三方依赖库放在vendor/（由 Composer 管理）。遵循这套结构，配合上面安装好的 PHP 8.3，你便拥有了一个目录清晰、安全边界明确、可随时部署的开发环境。

其他获取最新版 PHP 的途径

除了 PPA / bikeshed，文档还提到了两条常用备选方案：

Docker 容器：仓库文档 Docker 展示了一条命令启动带最新 PHP 的 Apache 容器：
```
docker run -d --name my-php-webserver -p 8080:80 -v /path/to/your/php/files:/var/www/html/ php:apache
```
-d让容器后台运行，-p 8080:80将本机 8080 端口映射到容器内 80 端口，-v把本地 PHP 文件目录挂载为容器文档根目录。停止与重启只需docker stop my-php-webserver与docker start my-php-webserver。这种方式不污染宿主机环境，多个项目各用各的 PHP 版本互不干扰，尤其适合同时开发多套不同版本需求的站点。
编译 PHP 源码：这是控制力最强的方案，可以精确选择版本、扩展与编译选项，但需要自行处理依赖与后续升级维护，成本最高，一般只在定制需求明确时才推荐。

此外，若你在团队开发或跨平台部署（例如 Windows 开发、Linux 生产）中遇到"环境不一致导致上线才暴露的诡异 Bug"，可参考 Virtualization 的思路，用虚拟机或容器统一开发与生产环境，从根源上消除版本差异问题。

小结

在 Ubuntu / Debian 系 Linux 上获取最新 PHP，核心路径就两条：Ubuntu 用户执行sudo add-apt-repository ppa:ondrej/php && sudo apt update两步走；Debian 用户则需按"装工具 → 下载密钥 → 写源 → 更新"的六步流程接入 sury.org bikeshed。装好后用php -v确认版本、用php -i检查配置、用php -S localhost:8000立即开始本地开发，同时保持public/与私有配置分离的目录纪律。若想彻底免去宿主机环境管理，Docker 官方镜像则是同样值得推荐的平行方案。

本文内容基于 PHP: The Right Way 仓库的 _posts/01-06-01-Linux-Setup.md 整理扩充，并交叉引用了仓库中 Use the Current Stable Version、Built-in Web Server、Command Line Interface、Common Directory Structure、Docker 与 Virtualization 等章节，供读者在搭建 Linux PHP 环境后继续深入对应主题。