nextstage/php

镜像概述和主要用途

本镜像提供PHP 7.4+环境，包含PHP、PHP-FPM及PHP-FPM-APACHE多种版本，集成Apache服务器、OPcache优化器、Xdebug调试工具（仅cli-dev版本）和内置Redis服务。支持通过环境变量灵活配置PHP、Apache、PHP-FPM、OPcache、Xdebug及Redis参数，同时提供Laravel/NSUtil框架的自动化操作（如数据库迁移、缓存清理等），适用于PHP应用的开发、测试与生产环境部署。

核心功能和特性

• 多版本支持：提供PHP、PHP-FPM及PHP-FPM-APACHE版本，满足不同部署需求
• 丰富扩展：集成OPcache（性能优化）、Xdebug（调试，仅cli-dev）、Redis（内置服务）
• 自动化操作：支持Laravel/NSUtil的数据库迁移、缓存清理、存储链接创建等自动化任务
• 灵活配置：通过环境变量自定义PHP、Apache、PHP-FPM、OPcache、Xdebug及Redis参数
• 安全优化：默认启用open_basedir限制、session.cookie_secure，日志重定向至stdout/stderr
• 性能调优：OPcache默认启用并优化，PHP-FPM采用dynamic模式管理进程，Apache使用mpm_event模块

支持的版本

• PHP 7.4+

可用环境变量

通用配置

AUTORUN_ENABLED=true                        # 启用自动化操作（Laravel/NSUtil）
AUTORUN_LARAVEL_MIGRATION=false             # 自动执行Laravel数据库迁移
AUTORUN_LARAVEL_REFRESH_CACHE=false         # 清理并重建Laravel缓存
AUTORUN_LARAVEL_STORAGE_LINK=false          # 创建Laravel存储目录符号链接
AUTORUN_NSUTIL_CLEAR_CACHE=false            # 清理NSUtil缓存
AUTORUN_NSUTIL_MIGRATION=false              # 执行NSUtil数据库迁移
DEBIAN_FRONTEND=noninteractive              # Debian环境配置（非交互模式）
DOCKER_MAINTENER=seu_email                  # 镜像维护者邮箱
DOCKER_PASS=sua_senha                       # Docker Hub密码
DOCKER_USER=seu_usuario                     # Docker Hub用户名
EXTRA_OPEN_BASEDIR=/tmp                     # PHP额外允许访问的目录
LANG=en_US.UTF-8                            # 语言配置
LANGUAGE=en_US:en                           # 语言配置
LC_ALL=en_US.UTF-8                          # 语言配置
PUID=9999                                   # 容器用户ID
PGID=9999                                   # 容器组ID
S6_BEHAVIOUR_IF_STAGE2_FAILS=2              # S6进程管理失败行为（0=继续，1=重启，2=停止）
S6_LOGGING=0                                # S6日志控制（0=显示所有，1=隐藏）
WEBUSER_HOME=/var/www/html                  # Web用户主目录

Apache配置（仅fpm-apache版本）

可通过 [***] 优化FPM和Apache配置

APACHE_DOCUMENT_ROOT=/var/www/html/api/      # Apache网站根目录
APACHE_HTTP_PROTOCOLS="h2 h2c http/1.1"      # 支持的HTTP协议
APACHE_MAX_CONNECTIONS_PER_CHILD=0           # 子进程最大连接数
APACHE_MAX_REQUEST_WORKERS=50                # 最大并发工作进程数
APACHE_MAX_SPARE_THREADS=25                  # 最大空闲线程数
APACHE_MIN_SPARE_THREADS=5                   # 最小空闲线程数
APACHE_RUN_GROUP=webgroup                    # Apache运行组
APACHE_RUN_USER=webuser                      # Apache运行用户
APACHE_SERVER_ADMIN=webmaster@localhost      # 服务器管理员邮箱
APACHE_SERVER_LIMIT=16                       # 服务器数量限制
APACHE_SERVER_NAME=localhost                 # 服务器名称
APACHE_START_SERVERS=2                       # 初始服务器数量
APACHE_THREAD_LIMIT=32                       # 线程限制
APACHE_THREADS_PER_CHILD=25                  # 每个子进程的线程数

PHP-FPM配置

PHP_DATE_TIMEZONE=UTC                        # PHP时区
PHP_DISPLAY_ERRORS=Off                       # 是否显示PHP错误
PHP_ERROR_REPORTING="E_ALL & ~E_NOTICE & ~E_STRICT"  # PHP错误报告级别
PHP_MAX_EXECUTION_TIME=30                    # 最大执行时间（秒）
PHP_MEMORY_LIMIT=256M                        # PHP内存限制
PHP_PM_CONTROL=dynamic                       # 进程管理模式（static/dynamic/ondemand）
PHP_PM_MAX_CHILDREN=86                       # 最大子进程数
PHP_PM_MAX_SPARE_SERVERS=4                   # 最大空闲服务器数
PHP_PM_MIN_SPARE_SERVERS=2                   # 最小空闲服务器数
PHP_PM_START_SERVERS=4                       # 初始服务器数
PHP_POOL_NAME=www                            # PHP-FPM池名称
PHP_POST_MAX_SIZE=20M                        # POST数据最大大小
PHP_UPLOAD_MAX_FILE_SIZE=20M                 # 文件上传最大大小

OPcache配置

OPCACHE_ENABLE=1                             # 启用OPcache
OPCACHE_ENABLE_CLI=1                         # 为CLI启用OPcache
OPCACHE_FAST_SHUTDOWN=1                      # 启用OPcache快速关闭
OPCACHE_INTERNED_STRINGS_BUFFER=8            # 内部字符串缓冲区大小（MB）
OPCACHE_MAX_ACCELERATED_FILES=4000           # 最大加速文件数
OPCACHE_MEMORY_CONSUMPTION=128               # OPcache内存消耗（MB）
OPCACHE_REVALIDATE_FREQ=600                  # 重新验证频率（秒）

Xdebug配置（仅cli-dev版本）

XDEBUG_CLIENT_HOST=host.docker.internal      # Xdebug客户端主机（IDE）
XDEBUG_CLIENT_PORT=9003                      # Xdebug客户端端口（IDE）
XDEBUG_DISCOVER_CLIENT_HOST=1                # 自动发现客户端主机（0=禁用，1=启用）
XDEBUG_MODE=debug                            # Xdebug模式（debug,develop,coverage,profile,trace）
XDEBUG_OUTPUT_DIR=/var/log/xdebug            # Xdebug输出目录（日志和跟踪文件）
XDEBUG_START_WITH_REQUEST=yes                # 是否随请求启动（yes=启动，no=等待XDEBUG_TRIGGER触发）

内置Redis服务配置

每个镜像均包含Redis服务，可暴露本地端口。默认数据持久化目录为/var/lib/redis/data，如需持久化请映射卷。

REDIS_PORT=6379                              # Redis端口
REDIS_MAXMEM=256mb                           # Redis最大内存
REDIS_PASSWORD=""                            # Redis密码（生产环境建议设置）
REDIS_PERSIST=true                           # Redis持久化开关，true时数据将保存到磁盘

重要注意事项

1. 特定镜像变量：部分变量仅适用于特定镜像版本

   • Xdebug相关变量：仅cli-dev版本支持
   • Apache相关变量：仅fpm-apache版本支持
   • FPM相关变量：仅fpm和fpm-apache版本支持

2. 覆盖默认值：可在容器启动时通过-e参数覆盖默认值：

   bash
   docker run -e PHP_MEMORY_LIMIT=512M -e REDIS_PASSWORD=secret ...
   

3. 变量依赖关系：部分变量需配合配置

   • PHP-FPM：PHP_PM_CONTROL会影响其他PM相关变量的行为
   • Apache：APACHE_THREAD_LIMIT需大于APACHE_THREADS_PER_CHILD

4. 安全配置：自动应用以下安全设置

   • open_basedir限制目录访问
   • 默认启用session.cookie_secure
   • 日志重定向至stdout/stderr

5. 性能优化：默认配置针对生产环境优化

   • OPcache启用并优化配置
   • PHP-FPM使用dynamic模式高效管理资源
   • Apache使用mpm_event模块提升性能

使用示例

Docker Compose示例

yaml
services:
  app:
    container_name: php_app
    hostname: your-hostname-to-container
    restart: always
    image: nextstage/php:${PHP_VERSION}-fpm-apache  # 指定PHP版本和类型（如7.4-fpm-apache）
    ports:
      - 80:80  # 映射Apache端口
      - 6379:6379  # 映射Redis端口（如需外部访问）
    volumes:
      - .:/var/www/html  # 挂载应用代码
      - ../persist/redis-data:/var/lib/redis/data  # 持久化Redis数据
    env_file:
      - ./.env  # 从.env文件加载环境变量
    extra_hosts:
      - "host.docker.internal:host-gateway"  # 允许容器访问宿主机服务（如IDE的Xdebug）