Docker镜像中安装php-apcu时提示Unable to locate package的问题

这种情况我碰到过好几次，大概率是Docker镜像的软件源配置、仓库支持或者PHP版本匹配的问题，毕竟本地机器的环境和Docker镜像的基础环境往往不一样。给你几个排查和解决的方向：

1. 先确认镜像的系统版本与仓库配置 #

首先进入你的Docker容器，看看系统版本和本地是否一致：

docker exec -it [你的容器名称/ID] bash
lsb_release -a

如果本地是Ubuntu 22.04但镜像用的是18.04，包名可能会有差异。另外，Ubuntu系统需要确保universe仓库已经启用——很多基础镜像默认没开这个仓库，而php-apcu就放在这里：

# 检查universe仓库是否存在
apt-cache policy | grep universe
# 如果没找到，先安装工具并启用仓库
apt-get update && apt-get install -y software-properties-common
add-apt-repository universe
apt-get update

之后再尝试安装php-apcu。

2. 官方PHP镜像的特殊处理 #

如果你用的是Docker Hub官方的php系列镜像（比如php:8.1-fpm、php:7.4-apache），官方并不推荐用apt-get装PHP扩展，而是用pecl来安装APCU，步骤如下：

# 先安装编译依赖
apt-get update && apt-get install -y libapcu-dev
# 安装APCU
pecl install apcu
# 把扩展配置加入PHP配置文件
echo "extension=apcu.so" > /usr/local/etc/php/conf.d/apcu.ini

这样安装的版本通常也更适配镜像里的PHP版本。

3. 确保包名与PHP版本匹配 #

有些系统里，php-apcu的包名会跟着PHP版本走，比如Debian 11中PHP7.4对应的包是php7.4-apcu，PHP8.0是php8.0-apcu。你可以先查看镜像里的PHP版本：

php -v

然后安装对应版本的包：

apt-get update && apt-get install -y php[版本号]-apcu

比如PHP7.4就装php7.4-apcu。

4. 更换软件源（如果源同步有问题） #

部分基础镜像的默认源可能同步不及时或者访问缓慢，导致找不到包。可以换成国内的源试试，比如Ubuntu 22.04换成阿里云源：

# 备份原有源文件
cp /etc/apt/sources.list /etc/apt/sources.list.bak
# 写入阿里云源
cat > /etc/apt/sources.list << EOF
deb http://mirrors.aliyun.com/ubuntu/ jammy main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ jammy-updates main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ jammy-backports main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ jammy-security main restricted universe multiverse
EOF
# 更新源后再安装
apt-get update && apt-get install php-apcu

按照这几个步骤排查，应该能解决找不到包的问题。

内容的提问来源于stack exchange，提问作者Sakolzer