Docker搭建PHP开发环境：Apache2无法自动启动求助

我之前踩过完全一样的坑！Docker容器的核心逻辑是必须有一个前台运行的进程才能维持存活，而Apache2默认是以守护进程（后台）模式启动的——容器启动后，Apache跑到后台运行，容器会认为主进程已经结束，直接停止运行，看起来就像是Apache压根没启动。

下面是修复后的完整Dockerfile，我会标注关键修改点：

FROM ubuntu:latest

# 更新系统并安装依赖，同时清理缓存减小镜像体积
RUN apt-get update && apt-get install -y \
    apache2 \
    php \
    libapache2-mod-php \
    php-mcrypt \
    php-mysql \
    php-cli \
    php-curl \
    php-xml \
    php-intl \
    php-mbstring \
    git \
    vim \
    composer \
    curl \
    && rm -rf /var/lib/apt/lists/*

# 复制项目文件和自定义虚拟主机配置
COPY . /var/www/example
COPY vhost.conf /etc/apache2/sites-available/example.conf

# 启用自定义站点，同时禁用默认站点避免冲突
RUN a2ensite example.conf \
    && a2dissite 000-default.conf

# 设置正确的文件权限，确保Apache运行用户能访问项目文件
RUN chown -R www-data:www-data /var/www/example \
    && chmod -R 755 /var/www/example

# 最关键的一步：让Apache以前台模式运行，维持容器存活
CMD ["apache2ctl", "-D", "FOREGROUND"]

核心修复点说明： #

• 强制Apache前台运行：最后一行的CMD ["apache2ctl", "-D", "FOREGROUND"]是解决问题的核心，它会让Apache放弃后台守护进程模式，直接在前台运行，这样容器就会一直保持运行状态，Apache也就正常启动了。
• 权限修正：确保www-data（Apache的运行用户）拥有项目目录的所有权，避免因权限不足导致Apache启动失败。
• 清理缓存与站点管理：清理APT缓存是Docker镜像优化的最佳实践，禁用默认站点则能避免和你的自定义虚拟主机配置产生冲突。

额外排查建议： #

如果还是无法启动，可以试试这两步：

1. 启动容器时加-it参数进入交互模式，手动运行apache2ctl start，直接查看报错信息：docker run -it --name your-container-name your-image-name bash
2. 用apache2ctl configtest命令验证你的vhost.conf配置是否有语法错误。

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