Docker环境Moodle开发：php-fpm7未找到错误与PHP8适配需求

问题根源 #

Alpine Linux最新版软件源中，PHP包已从php7-*命名规则切换为php-*，对应版本为PHP8.x系列。原Dockerfile依赖的php7-fpm包已不存在，启动脚本中调用的php-fpm7命令也随之失效，再加上最新版Moodle要求PHP8.0及以上版本，因此需要全面调整镜像配置适配PHP8。

具体解决方案 #

1. 更新Dockerfile中的PHP安装指令

将原有的php7-*相关包替换为PHP8对应的php-*包，同时保留Moodle运行必需的扩展：

# 替换原PHP7安装命令，安装PHP8及Moodle所需扩展
RUN apk add --no-cache \
    php-fpm \
    php-mysqli \
    php-curl \
    php-zip \
    php-gd \
    php-xml \
    php-mbstring \
    php-intl \
    php-opcache \
    php-session \
    php-tokenizer

可根据实际需求增减扩展包，比如使用PostgreSQL时添加php-pgsql。

2. 修正启动脚本中的PHP-FPM命令

报错提示start-server脚本第28行找不到php-fpm7，需将脚本中的php-fpm7替换为php-fpm：

• 若脚本是本地文件，直接修改后重新复制到镜像中；
• 若脚本已在镜像内，可在Dockerfile中添加sed替换指令：

RUN sed -i 's/php-fpm7/php-fpm/g' /usr/local/bin/start-server

3. 调整PHP-FPM配置路径（若有相关配置）

PHP8的FPM配置目录从/etc/php7/php-fpm.d/改为/etc/php/php-fpm.d/，如果原Dockerfile有复制自定义配置的步骤，需更新路径：

# 替换配置文件目标路径
COPY ./custom-php-fpm.conf /etc/php/php-fpm.d/www.conf

4. 验证镜像构建与运行

执行构建命令：

docker build -t moodle-php8 .

启动容器验证：

docker run -d -p 80:80 moodle-php8

可通过docker logs <容器ID>查看启动日志，确认无PHP-FPM相关报错。

额外注意事项 #

• 确认使用的Moodle版本兼容对应PHP8子版本：Moodle 4.0+支持PHP8.0-8.2，避免版本不匹配导致新问题；
• 若镜像中还有其他依赖PHP7的工具（如php7-cli），需同步替换为php-cli，调用命令从php7改为php；
• 可通过apk info php命令查看当前安装的PHP版本，确保为8.x系列。

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