t3easy/php

PHP FPM Docker镜像

镜像概述和主要用途

该镜像可用作PHP应用的基础镜像或用于运行测试。用户需将应用映射或复制到/app目录。

核心功能和特性

• 支持通过环境变量灵活配置PHP参数
• 提供生产和开发两种环境配置
• 生产环境包含基础PHP性能和资源配置参数
• 开发环境集成Blackfire、Xdebug、Composer等开发工具
• 预设PATH包含应用依赖的二进制文件目录（生产环境：/app/vendor/bin；开发环境：/app/vendor/bin和/tmp/vendor/bin）

使用场景和适用范围

• PHP应用开发环境搭建
• PHP单元测试运行（如PHPUnit）
• 代码静态分析工具运行（如PHPStan）
• Composer依赖管理操作
• PHP应用生产环境部署基础镜像

环境变量配置说明

生产和开发环境通用变量

PHP_APC_SHM_SIZE="128M"          # APC共享内存大小
PHP_MAX_EXECUTION_TIME="240"      # 最大执行时间（秒）
PHP_MAX_INPUT_VARS="1500"         # 最大输入变量数
PHP_MEMORY_LIMIT="128M"           # 内存限制
PHP_OPCACHE_VALIDATE_TIMESTAMPS="0" # OPCache时间戳验证（生产默认关闭）
PHP_OPCACHE_MAX_ACCELERATED_FILES="10000" # OPCache加速文件最大数量
PHP_OPCACHE_MEMORY_CONSUMPTION="192" # OPCache内存消耗（MB）
PHP_OPCACHE_MAX_WASTED_PERCENTAGE="10" # OPCache最大浪费百分比
PHP_PM_MAX_CHILDREN="5"           # FPM最大子进程数
PHP_PM_START_SERVERS="2"          # FPM启动时的服务器数量
PHP_PM_MIN_SPARE_SERVERS="1"      # FPM最小空闲服务器数量
PHP_PM_MAX_SPARE_SERVERS="3"      # FPM最大空闲服务器数量
PHP_POST_MAX_SIZE="32M"           # POST数据最大大小
PHP_UPLOAD_MAX_FILESIZE="32M"     # 上传文件最大大小

开发环境专用变量

BLACKFIRE_HOST="blackfire"        # Blackfire主机
BLACKFIRE_PORT="8707"             # Blackfire端口
COMPOSER_ALLOW_SUPERUSER=1        # 允许超级用户运行Composer
COMPOSER_HOME="/tmp"              # Composer主目录
DBGP_IDEKEY="PHPSTORM"            # Xdebug IDE密钥
PHP_OPCACHE_VALIDATE_TIMESTAMPS="1" # OPCache时间戳验证（开发默认开启）
XDEBUG_MODE="off"                 # Xdebug模式（默认关闭）
XDEBUG_CONFIG="client_host=host.docker.internal" # Xdebug配置

使用示例

运行PHPUnit测试

shell
docker run --rm -v $PWD:/app t3easy/php:7.4-development phpunit tests

运行PHPStan静态分析

shell
docker run --rm -v $PWD:/app -e PHP_MEMORY_LIMIT=256M t3easy/php:7.4-development phpstan analyse --ansi

运行Composer命令

shell
docker run --rm -v $PWD:/app t3easy/php:7.4-development composer update --dry-run