staysafe/php-apache-common

PHP-Apache集成镜像文档

镜像概述

本镜像基于PHP构建，集成Apache Web服务器，预装常用PHP扩展及服务器工具包，旨在为PHP Web应用提供开箱即用的运行环境，简化开发、测试及CI/CD流程中的部署工作。

核心功能与特性

1. 基础运行环境

• PHP+Apache集成：内置Apache Web服务器，无需额外配置即可运行PHP应用
• 文档根目录预设：Web服务器文档根目录固定为/var/www/html/web，应用代码需放置于此路径

2. 常用PHP扩展

包含开发和运行PHP应用所需的核心扩展：

• 图像处理：gd
• 数据库连接：pdo
• 数据格式处理：xml、mbstring、json

3. 服务器工具包

预装适用于CI流程和调试的实用工具：

• 文本编辑：nano
• 压缩/解压缩：zip、unzip
• 版本控制：git
• 网络诊断：iputils-ping（ping命令）、net-tools（如ifconfig、netstat）
• 权限管理：acl

使用场景与适用范围

• PHP Web应用开发与测试环境
• CI/CD流程中的自动化构建与部署
• 需要快速调试网络、权限或文件操作的场景
• 中小型PHP项目的生产环境（需结合安全配置）

使用方法与配置说明

基本部署示例

通过docker run命令快速启动容器：

bash
docker run -d \
  -p 80:80 \  # 映射容器80端口到主机80端口
  -v /本地应用目录:/var/www/html/web \  # 挂载本地代码到文档根目录
  --name php-apache-app \
  [镜像名称]

替换/本地应用目录为实际PHP项目路径，[镜像名称]为该镜像的标签。

进入容器调试

如需使用工具包进行调试，可通过exec进入容器：

bash
docker exec -it php-apache-app bash

# 示例操作：
nano /var/www/html/web/index.php  # 编辑PHP文件
git pull  # 拉取代码更新（需项目已初始化git）
ping example.com  # 测试网络连通性

自定义配置

如需修改Apache或PHP配置，可通过挂载配置文件覆盖容器内默认配置：

• Apache配置路径：/etc/apache2/
• PHP配置路径：/etc/php/[版本]/apache2/php.ini（需根据实际PHP版本调整路径）

注意事项

• 文档根目录固定为/var/www/html/web，若应用代码结构不同，需调整挂载路径或修改Apache配置
• 生产环境建议添加安全加固（如HTTPS配置、权限限制等）