如何在Docker中搭建集成Apache2的PHP运行环境

现有构建流程的报错根因 #

• 你选用的ubuntu:latest当前对应Ubuntu 24.04版本，官方软件源根本没有适配的PHP7.4安装包，即便手动添加第三方PPA源，PHP7.4已进入维护末期，和新版Ubuntu的依赖索引存在天然冲突，执行安装指令时就会触发“包不存在”“依赖关系无法满足”的报错
• 构建逻辑存在大量冗余：多轮独立执行apt-get update、重复写gcc/g++软链接指令，不仅拉长构建时长，还会生成大量无用镜像层，最终镜像体积会比最优方案大3倍以上
• 权限配置不安全：给web目录开777全权限，违背容器最小权限原则，存在明确安全隐患
• 指令冗余：手动配置的APACHE_RUN_USER等环境变量，在Apache的系统启动脚本中已经默认写入，重复设置没有实际作用

可直接落地的优化搭建方案 #

方案1：优先复用官方预构建镜像（零适配成本，构建最快） #

这是目前实际项目里PHP+Apache容器化的通用落地方式，不需要自己从零编译、搭环境，能完全规避源适配、版本错配的问题：

• 基础镜像直接选用和你需求匹配的php:7.4-apache，镜像内置了已经完成模块联动的Apache和PHP7.4，所有运行权限、路径配置都是调优完成的
• PHP扩展安装直接用镜像内置的docker-php-ext-install工具，不需要手动找deb包，比如安装MySQL相关扩展的指令为：

  # 安装MySQL相关PHP扩展
  RUN docker-php-ext-install mysqli pdo_mysql
  # 启用Apache伪静态重写模块
  RUN a2enmod rewrite
  

• 目录权限修正为和运行用户匹配的配置，替代不安全的777权限：

  RUN chown -R www-data:www-data /var/www/html \
      && chmod -R 755 /var/www/html
  

• 后续项目文件复制、移除默认首页、启动服务的逻辑和你原有思路完全一致，官方镜像内置的前台启动指令apache2-foreground可以直接用，不需要手动调用apache2ctl

方案2：必须基于ubuntu自定义构建的修正方案 #

如果有强制要求必须用ubuntu基础镜像的场景，把基础镜像替换为和PHP7.4适配的ubuntu:20.04，不要使用latest版本，修正后可直接运行的Dockerfile核心逻辑为：

FROM ubuntu:20.04
# 全局设置非交互安装模式，避免安装过程卡交互提示
ENV DEBIAN_FRONTEND=noninteractive
# 合并所有apt操作到单条指令，减少镜像层、避免源索引失效
RUN apt-get update \
    && apt-get install -y --no-install-recommends \
        tzdata software-properties-common gcc g++ \
        apache2 curl lynx-common \
    && add-apt-repository -y ppa:ondrej/php \
    && apt-get update \
    && apt-get install -y --no-install-recommends \
        php7.4 libapache2-mod-php7.4 php7.4-mysql \
    # 清理apt缓存，压缩镜像体积
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/*
# 启用Apache需要的模块
RUN a2enmod php7.4 rewrite
# 配置web目录权限
RUN chown -R www-data:www-data /var/www/html \
    && chmod -R 755 /var/www/html
# 复制项目代码、移除Apache默认首页
COPY editor /var/www/html/
RUN rm -f /var/www/html/index.html
# 前台启动Apache服务
CMD ["apache2-foreground"]

关键避坑提示 #

• 所有apt-get update必须和对应的安装命令写在同一条RUN指令里，分开写的话，后续镜像层执行时会因为源索引失效触发报错
• 不要重复执行gcc、g++的软链接指令，系统安装完成后默认软链接已经是正确配置，重复执行没有任何意义
• 不要使用chmod 777给web目录放权，统一归属www-data用户、配置755权限就完全能满足应用的正常读写需求
• 不需要手动配置APACHE开头的那一系列环境变量，Apache的启动脚本已经内置了这些参数的默认值，重复配置纯属冗余

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