edyan/php

PHP FPM Docker镜像

Docker Hub: https://hub.docker.com/r/edyan/php

镜像概述和主要用途

本Docker容器用于提供PHP FPM服务，支持PHP 5.3至8.0多个版本，预安装了主要PHP扩展（如curl、pdo、gd等）及XDebug。主要为开发环境设计，也可用于生产环境。旨在与docker-compose配合使用，尤其适用于https://github.com/stakkr-org/stakkr%E3%80%82

核心功能和特性

• 系统一致性：基于Debian/Ubuntu系统，与多数生产主机环境一致，确保开发与生产环境一致性
• 官方PHP版本：优先使用系统官方PHP版本，减少额外仓库依赖
• 扩展丰富：包含常用PHP扩展及XDebug调试工具
• 灵活配置：支持通过环境变量自定义用户/组ID、开发/生产模式及启用模块
• 安全控制：集成iptables，配合Stakkr工具阻止SMTP端口，避免开发中误发邮件

使用场景和适用范围

• 本地开发环境：提供与生产一致的PHP运行环境
• 生产环境部署：作为PHP FPM服务运行
• 与docker-compose或Stakkr工具配合构建完整的Web服务栈

使用方法和配置说明

Docker Compose配置示例

在docker-compose.yml中添加以下配置：

yaml
php:
    image: docker.xuanyuan.run/edyan/php:7.3
    environment:
        FPM_UID: 1000
        FPM_GID: 1000
        PHP_ENABLED_MODULES: "curl sqlite3"

环境变量

• FPM_UID：覆盖www-data用户ID，使容器内文件权限与宿主机用户匹配
• FPM_GID：覆盖www-data组ID，同上
• ENVIRONMENT：设置运行环境
  • dev：开发环境，将max_execution_time设为-1，display_errors设为On
  • 其他值（如production）：生产环境，执行相反配置
• PHP_ENABLED_MODULES：指定要启用的PHP模块，以空格分隔，如"curl sqlite3"

自定义php.ini指令

如需修改PHP配置，可挂载包含.conf文件的目录到以下路径：

• PHP 5.x：/etc/php5/fpm/user-conf.d/
• PHP 7.x：/etc/php/7.x/fpm/user-conf.d/（x为具体版本号）

示例：

yaml
volumes:
    - ./conf/php-fpm-override:/etc/php/current/fpm/user-conf.d

在./conf/php-fpm-override/memory.conf中添加：

conf
php_value[memory_limit] = 127M

修改后需重启容器使配置生效。

PHP版本选择

通过镜像标签指定PHP版本，格式为edyan/php:版本号，支持以下版本：

• PHP 8.0（基于Ubuntu 20.04 + sury包）
• PHP 7.4（基于Ubuntu 20.04）
• PHP 7.3（基于buster slim）
• PHP 7.2（基于Ubuntu 18.04）
• PHP 7.1（基于stretch slim + sury包）
• PHP 7.0（基于stretch slim）
• PHP 5.6（基于jessie slim）
• PHP 5.5（基于Ubuntu 14.04）
• PHP 5.4（基于wheezy slim）
• PHP 5.3（基于Ubuntu 12.04）

特定版本

• edyan/x.x-sqlsrv：包含SQL Server驱动（MS Drivers）的版本