Apache PHP8 Composer Ubuntu 镜像文档

镜像概述和主要用途

本镜像基于Ubuntu系统构建，集成了Apache Web服务器、PHP 8环境、Composer依赖管理工具及Node.js运行时，旨在为Laravel等PHP Web框架项目提供开箱即用的开发和部署环境。镜像预配置了必要的系统依赖、PHP扩展、Apache模块及目录权限，可直接用于Web应用的构建、测试和运行。

核心功能和特性

核心组件

• 基础环境：基于newdeveloper/apache-php镜像，底层为Ubuntu系统
• Web服务器：Apache（支持SSL、Rewrite模块）
• PHP环境：PHP 8及扩展（mysql、mbstring、xml、gd、zip、curl、tidy、gmp等）
• 开发工具：Composer（依赖管理）、Node.js 8.x、npm（最新版）、Git、Vim、Nano
• 系统配置：时区默认设置为Europe/Amsterdam，支持自定义调整

关键特性

• 预启用Apache重写（Rewrite）模块，支持URL重写需求
• 集成SSL支持，默认配置SSL证书路径（/etc/apache2/ssl/example/）
• 自动设置/var/www/html目录权限（www-data用户组），避免权限问题
• 支持通过src目录挂载项目代码，快速部署应用
• 内置run.sh启动脚本，简化容器启动流程

使用场景和适用范围

适用项目类型

• Laravel、Symfony等主流PHP Web框架项目
• 需要LAMP（Linux+Apache+MySQL+PHP）环境的传统PHP应用
• 依赖Composer进行依赖管理的PHP项目
• 需要Node.js工具链（如前端资源编译、npm脚本）的PHP应用

适用场景

• 本地开发环境：快速搭建一致的开发环境，避免"在我电脑上能运行"问题
• 测试环境：简化测试服务器部署流程，确保环境一致性
• 小型生产环境：适用于轻量应用的容器化部署（建议生产环境额外配置安全加固）

详细使用方法和配置说明

前提条件

• 已安装Docker Engine（20.10+版本推荐）
• 项目目录结构包含：
  • src/：存放PHP应用源代码
  • settings/000-default.conf：Apache站点配置文件
  • ssl/：存放SSL证书文件（server.crt、server.key）
  • run.sh：容器启动脚本（可选，如无自定义需求可使用默认）

构建镜像

在项目根目录执行以下命令构建镜像：

docker build -t apache-php-composer .

运行容器

基础运行命令

docker run -d -p 80:80 -p 443:443 --name php-app apache-php-composer

挂载本地代码目录（开发模式）

docker run -d -p 80:80 -p 443:443 -v $(pwd)/src:/var/www/html --name php-app-dev apache-php-composer

自定义时区配置

docker run -d -p 80:80 -p 443:443 -e TZ=Asia/Shanghai --name php-app-cn apache-php-composer

目录结构说明

配置文件说明

Apache站点配置（000-default.conf）

需自定义settings/000-default.conf文件，示例配置（参考默认逻辑）：

<VirtualHost *:80>
    DocumentRoot /var/www/html/public  # 适用于Laravel等框架的public目录
    <Directory /var/www/html/public>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

<VirtualHost *:443>
    SSLEngine on
    SSLCertificateFile /etc/apache2/ssl/example/server.crt
    SSLCertificateKeyFile /etc/apache2/ssl/example/server.key
    DocumentRoot /var/www/html/public
    <Directory /var/www/html/public>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

环境变量说明

注意事项

• 生产环境使用时，建议替换默认SSL证书为可信证书（如Let's Encrypt）
• Node.js版本默认为8.x，如需更高版本需修改Dockerfile中的nodesource配置（如setup_18.x）
• 基础镜像newdeveloper/apache-php可能包含特定配置，建议确认其版本兼容性
• 如需持久化日志，可通过-v参数挂载/var/log/apache2目录到宿主机