docker-php-fpm 镜像文档

镜像概述和主要用途

该Docker镜像用于管理ZOL的php-fpm DockerHub构建，集成PHP-FPM和Composer，采用分支和标签系统（而非目录结构）组织版本，适用于开发环境。所有可用版本信息见CHANGELOG。

核心功能和特性

• 基础镜像：所有版本基于官方PHP-FPM镜像（非Alpine版本）
• 版本规范：PHP版本需指定具体版本号（如7.3.16而非仅7.3）
• 权限优化：默认将www-data用户的UID/GID调整为1000，避免挂载目录时的权限冲突
• 工具集成：包含Composer及多种开发工具，满足开发需求
• 变更管理：每次代码变更需同步更新CHANGELOG

使用场景和适用范围

• ZOL内部开发环境的PHP应用构建与运行
• 需要PHP-FPM和Composer的本地开发场景
• 需解决挂载目录权限问题的开发环境（通过统一www-data用户的UID/GID）

详细使用方法和配置说明

镜像更新方法

如需更新镜像，操作步骤如下：

1. 检出需基于的当前标签
2. 创建新分支并应用更新
3. 标记变更并更新CHANGELOG
4. 推送前本地构建测试：

   docker build -t php-fpm:test .
   

标签使用规则

• 不建议使用latest标签：latest标签的更新顺序基于ZOL内部需求，而非PHP版本，建议使用具体标签
• 标签格式示例：
  • 基础版本：7.3.16
  • 带Composer版本：7.4.4-composer-1.10.1
  • master分支对应latest标签（仅用于内部更新，不建议外部使用）

配置说明

UID/GID调整

若需修改www-data用户的UID/GID（如本地用户UID/GID非1000），可通过扩展本镜像实现。示例（将UID/GID改为1001）：

FROM zolweb/php-fpm:7.3.16
RUN usermod -u 1001 www-data \
    && groupmod -g 1001 www-data \
    && find / -user 1000 -exec chown -h 1001 {} \; || true \
    && find / -group 1000 -exec chgrp -h 1001 {} \; || true \
    && usermod -g 1001 www-data \
    && chown -R 1001:1001 /opt/scripts

部署示例

基础运行命令

docker run --rm -v $(pwd):/app zolweb/php-fpm:7.3.16

Docker Compose基础配置

version: '3'
services:
  php-fpm:
    image: zolweb/php-fpm:7.3.16
    volumes:
      - ./app:/app  # 挂载应用代码目录
    environment:
      - PHP_INI_SCAN_DIR=/usr/local/etc/php/conf.d  # PHP配置扫描目录

注意事项

• 镜像仅用于开发环境，包含的部分工具可能不适用于生产环境
• 避免使用latest标签，建议指定具体版本标签以确保环境一致性
• 扩展镜像调整UID/GID时，需替换示例中的1001为实际需求的UID/GID