解决shivammathur/setup-php项目中PHP安装冲突问题

在Ubuntu系统上使用shivammathur/setup-php项目安装特定PHP版本时，可能会遇到一个常见的签名冲突问题。这个问题主要出现在自托管运行器上安装PHP 8.0和8.2版本时，但其他版本也可能受到影响。

问题现象

当尝试安装PHP时，系统会报错显示签名冲突：

E: Conflicting values set for option Signed-By regarding source https://ppa.launchpadcontent.net/ondrej/php/ubuntu/ jammy: /usr/share/keyrings/ondrej-php-keyring.gpg != 
E: The list of sources could not be read.

这个错误表明系统中有多个源文件指向Ondřej Surý的PHP PPA，但它们的签名验证方式不一致，导致APT包管理器无法正确处理这些源。

问题根源

经过分析，这个问题通常由以下两种情况引起：

1. 系统镜像中预先配置了Ondřej的PHP PPA（通过add-apt-repository命令）
2. setup-php动作在运行时又添加了另一个配置相同PPA但使用不同签名方式的源文件

具体表现为系统中同时存在两个源文件：

• /etc/apt/sources.list.d/ondrej-php.list（由setup-php添加）
• /etc/apt/sources.list.d/ondrej-ubuntu-php-jammy.list（由系统预先配置）

这两个文件都指向同一个PPA，但使用了不同的签名验证方式，导致APT无法确定应该使用哪一个。

解决方案

临时解决方案

对于立即需要解决问题的用户，可以采取以下步骤：

1. 检查系统中所有包含ondrej/php的源文件：

grep -R "ondrej/php" /etc/apt/sources.list.d/

2. 保留使用签名验证的文件（通常是/etc/apt/sources.list.d/ondrej-php.list），删除其他重复的源文件

3. 运行apt-get update更新源列表

长期解决方案

对于长期使用，建议采取以下措施之一：

1. 修改系统镜像构建：如果系统镜像仅用于CI环境，建议从Dockerfile中移除预先添加PPA的命令：

# 移除这行
RUN add-apt-repository ppa:ondrej/php -y

2. 等待项目更新：shivammathur/setup-php项目已在2.34.0版本中修复了这个问题。升级到最新版本可以避免这个冲突。

技术背景

这个问题涉及到APT源管理的一个重要方面——源签名验证。现代Ubuntu系统使用签名来验证软件源的可靠性。当同一个源被多次添加但使用不同的签名方式时，APT无法确定应该信任哪个签名，因此会拒绝处理这些源。

在PHP生态系统中，Ondřej Surý维护的PPA是最常用的PHP源之一。许多工具和脚本都会尝试添加这个源，如果不加以协调，就容易出现这种签名冲突的情况。

最佳实践

为了避免类似问题，建议：

1. 在构建系统镜像时，避免预先添加可能被工具自动添加的PPA
2. 使用工具时，确保了解它会如何处理系统源
3. 定期更新工具到最新版本，以获取问题修复
4. 在CI环境中，考虑使用最小化的基础镜像，按需添加所需组件

通过理解这个问题的根源和解决方案，开发者可以更有效地在自托管环境中配置PHP开发环境，避免因源冲突导致的工作流中断。