Extended PHP 镜像文档

1. 镜像概述

Extended PHP 镜像是一款专为运行 PHP 应用程序定制的 Docker 镜像，基于*** PHP 镜像扩展构建。该镜像支持多种环境组合（Web 服务器、PHP 模式及基础系统），提供灵活的配置选项，适用于 PHP 应用的开发、测试与生产部署场景。

2. 镜像标签

镜像提供以下标签，对应不同的环境组合：

2.1 Debian + Apache + mod_php

• touch4it/php8:php8.1-apache
• touch4it/php8:php8.2-apache
• touch4it/php8:php8.3-apache

2.2 Debian + Apache + PHP-FPM

• touch4it/php8:php8.1-fpm-apache
• touch4it/php8:php8.2-fpm-apache
• touch4it/php8:php8.3-fpm-apache

2.3 Alpine + Nginx + PHP-FPM

• touch4it/php8:latest（默认，对应最新 PHP 版本的 Alpine+Nginx+PHP-FPM）
• touch4it/php8:php8.1-fpm-nginx
• touch4it/php8:php8.1-fpm-nginx-dev（开发版）
• touch4it/php8:php8.2-fpm-nginx
• touch4it/php8:php8.2-fpm-nginx-dev（开发版）
• touch4it/php8:php8.3-fpm-nginx
• touch4it/php8:php8.3-fpm-nginx-dev（开发版）

3. 核心功能与特性

• 多环境支持：兼容 Apache（mod_php/PHP-FPM 模式）和 Nginx（PHP-FPM 模式），基础系统可选 Debian 或轻量级 Alpine Linux。
• PHP 版本覆盖：支持 PHP 8.1、8.2、8.3 稳定版本。
• 默认扩展丰富：预安装常用 PHP 扩展（如 bcmath、gd、intl、pdo_mysql 等）及 Apache 模块（mod_rewrite、mod_http2）。
• 灵活配置：通过环境变量或挂载配置文件自定义 PHP 及 Web 服务器参数。
• 开发/生产适配：提供开发版标签（-dev）及生产构建方案，满足不同阶段需求。

4. 使用场景

• 开发环境：快速搭建本地 PHP 开发环境，支持代码热更新（通过卷挂载）。
• 生产部署：构建轻量级生产镜像，适配 Apache 或 Nginx 服务器架构。
• 多版本测试：通过不同 PHP 版本标签，验证应用在多版本下的兼容性。

5. 使用方法

5.1 开发环境配置（docker-compose）

通过 docker-compose.yml 快速启动开发环境：

www:
  image: touch4it/php8:php8.2-fpm-nginx  # 选择合适的标签
  volumes:
    - ./app:/var/www/html/web  # 挂载本地代码目录到容器
  ports:
    - "80:80"  # 映射端口（宿主机:容器）
  # 可选：添加数据库、缓存等关联服务
  # depends_on:
  #   - db
# db:
#   image: mysql:8.0

启动命令：

docker-compose up -d

5.2 完整配置示例（docker-compose）

挂载自定义配置文件（PHP、PHP-FPM、Nginx）以覆盖默认配置：

www:
  image: touch4it/php8:php8.2-fpm-nginx
  volumes:
    - ./app:/var/www/html/web  # 应用代码
    - ./php.ini:/usr/local/etc/php/conf.d/docker-vars.ini  # PHP 自定义配置
    - ./[***]  # PHP-FPM 配置
    - ./nginx.conf:/etc/nginx/nginx.conf  # Nginx 主配置
    - ./nginx.vh.default.conf:/etc/nginx/conf.d/default.conf  # Nginx 虚拟主机配置
  ports:
    - "80:80"

5.3 生产镜像构建（Dockerfile）

基于该镜像构建包含应用代码的生产镜像：

FROM touch4it/php8:latest  # 使用最新稳定版标签
ADD ./app /var/www/html  # 复制应用代码到容器
# 可选：安装依赖、配置权限等
# RUN composer install --no-dev --optimize-autoloader

构建命令：

docker build -t my-php-app:prod .

5.4 环境变量配置

通过环境变量自定义 PHP 及服务器参数，无需修改配置文件：

配置示例：
在 docker-compose.yml 中添加环境变量：

www:
  image: touch4it/php8:php8.3-apache
  environment:
    - PHP_TIME_ZONE=Asia/Shanghai
    - PHP_MEMORY_LIMIT=512M
    - ADMIN_EMAIL=***
  # ... 其他配置

6. 常见问题

6.1 默认启用哪些扩展/模块？

Apache 模块（Apache 镜像）

• mod_rewrite：支持 URL 重写。
• mod_http2：支持 HTTP/2（Apache 2.4.26+ 镜像）。

PHP 扩展（所有镜像）

• bcmath、exif、gd、gettext、intl、mbstring、opcache、pgsql、pdo、pdo_mysql、pdo_pgsql、zip。

6.2 如何安装额外 PHP 扩展？

基于*** PHP 镜像构建，可使用 docker-php-ext-install 命令安装扩展：

FROM touch4it/php8:php8.3-fpm-nginx
RUN docker-php-ext-install mysqli  # 安装 mysqli 扩展

更多说明参考 *** PHP 镜像文档。

6.3 如何修改默认 PHP 配置？

通过挂载自定义 *.ini 文件到容器的 $PHP_INI_DIR/conf.d 目录（通常为 /usr/local/etc/php/conf.d）：

volumes:
  - ./my-php.ini:/usr/local/etc/php/conf.d/my-php.ini

my-php.ini 内容示例：

upload_max_filesize = 64M
post_max_size = 64M

6.4 为什么 .htaccess 文件不生效？

.htaccess 是 Apache 配置文件，Nginx 镜像不支持。若需 URL 重写，需在 Nginx 配置文件（如 default.conf）中添加 rewrite 规则。

6.5 Apache/Nginx 版本信息？

• Apache 版本：与*** PHP Apache 镜像版本一致（如 php:8.3-apache 对应***版本）。
• Nginx 版本：1.22.6（所有 Nginx 镜像）。

6.6 还有哪些相关镜像？

• Drupal 专用镜像：touch4it/drupal-php-fpm-nginx（[***]
• Symfony 专用镜像：touch4it/php-nginx-symfony（[***]