构建Laravel Docker镜像时php8.1-pgsql包找不到的求助

核心问题分析 #

你遇到的php8.1-pgsql找不到的问题，本质是Debian Bookworm（基础镜像的系统版本）默认软件源仅包含PHP 8.2及以上版本，而你尝试添加的Ubuntu专属PPA（ppa:ondrej/php）与Debian不兼容，导致公钥验证失败且无法获取对应包。同时，权限错误源于你混淆了基础镜像的默认用户组。

解决方案一：使用基础镜像内置的扩展安装工具（推荐） #

serversideup/php镜像内置了install-php-extensions脚本，专门用于适配镜像内的PHP版本安装扩展，无需手动添加外部源：

FROM serversideup/php:8.1-fpm-nginx

ENV SSL_MODE "off"

USER root

# 用内置脚本安装pgsql扩展，自动适配PHP版本
RUN install-php-extensions pgsql

# 安装其他系统依赖包
RUN apt update && apt install -y --no-install-recommends git curl wget libxrender1 cron fonts-freefont-ttf \
    && apt autoclean && apt autoremove \
    && rm -rf /tmp/* /var/tmp/* /usr/share/doc/*

USER www-data

# 复制代码时使用镜像默认用户组，避免权限错误
COPY --chown=www-data:www-data . /var/www/html/

# Composer生产环境优化安装
RUN composer install --no-dev --optimize-autoloader
RUN composer dump-autoload --optimize

# 设置启动脚本权限并执行
RUN chmod +x ./scripts/start.sh
RUN ./scripts/start.sh

解决方案二：添加Debian兼容的PHP源（备选） #

如果必须通过apt安装扩展，可添加Debian官方支持的sury.org PHP源，避免Ubuntu PPA的兼容性问题：

FROM serversideup/php:8.1-fpm-nginx

ENV SSL_MODE "off"

USER root

# 安装源依赖并添加sury.org PHP源
RUN apt update && apt install -y --no-install-recommends ca-certificates apt-transport-https gnupg2
RUN curl -fsSL https://packages.sury.org/php/apt.gpg | gpg --dearmor -o /usr/share/keyrings/sury-php-archive-keyring.gpg
RUN echo "deb [signed-by=/usr/share/keyrings/sury-php-archive-keyring.gpg] https://packages.sury.org/php/ bookworm main" > /etc/apt/sources.list.d/sury-php.list

# 更新源并安装所需包
RUN apt update && apt install -y --no-install-recommends git curl wget php8.1-pgsql libxrender1 cron fonts-freefont-ttf \
    && apt autoclean && apt autoremove \
    && rm -rf /tmp/* /var/tmp/* /usr/share/doc/*

USER www-data

COPY --chown=www-data:www-data . /var/www/html/

RUN composer install --no-dev --optimize-autoloader
RUN composer dump-autoload --optimize

RUN chmod +x ./scripts/start.sh
RUN ./scripts/start.sh

关键修复点说明 #

1. 权限错误解决：基础镜像默认用户是www-data，而非webuser，所有文件操作需对齐该用户组，避免权限拒绝。
2. 扩展安装修复：放弃Ubuntu专属PPA，改用镜像内置工具或Debian兼容源，确保能获取到PHP 8.1对应的pgsql扩展包。
3. 生产环境优化：添加--no-dev参数跳过Composer开发依赖，提升镜像轻量化程度。

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