rogerdz/php-fpm

PHP扩展镜像文档

镜像概述

本Docker镜像为PHP环境预集成了多种常用第三方扩展，旨在简化需要特定扩展依赖的PHP应用部署流程。用户无需手动安装和配置扩展，可通过环境变量快速指定并启用所需扩展，适用于各类PHP应用的开发、测试与生产环境。

核心功能与特性

• 丰富扩展支持：内置多种流行第三方PHP扩展，覆盖数据处理、缓存、数据库连接、调试等多种场景需求
• 灵活配置：通过环境变量灵活选择启用所需扩展，无需修改镜像底层配置
• 即开即用：扩展预编译集成，容器启动即可使用，减少部署耗时

支持的第三方PHP扩展

镜像支持以下第三方PHP扩展：
amqp apcu blackfire bz2 elastic_apm excimer exif gettext imagick imap ioncube ldap lz4 mailparse mcrypt memcached mongodb mysqli newrelic oauth opcache pcov pdo_dblib pdo_pgsql pdo_sqlsrv pgsql redis shmop sourceguardian spx sqlsrv ssh2 swoole tideways tidy uploadprogress xdebug xhprof xmlrpc xsl zookeeper yaml

使用场景

• 需要多种PHP扩展的Web应用（如Laravel、WordPress、Symfony等框架应用）部署
• 快速搭建包含特定扩展依赖的PHP开发/测试环境
• 构建需要调试工具（如xdebug、xhprof）或性能分析工具（如tideways、spx）的PHP运行环境
• 部署依赖数据库（如MySQL、PostgreSQL、MongoDB）或缓存服务（如Redis、Memcached）的PHP应用

使用方法与配置说明

环境变量配置

部署示例

Docker Run 命令

通过docker run命令启动容器并指定启用扩展：

bash
docker run -d \
  -e PHP_EXTENSIONS_ENABLE="imagick mysqli redis xdebug" \
  -p 80:80 \
  --name php-app \
  [镜像名称]:[标签]

Docker Compose 配置

在docker-compose.yml中配置扩展启用：

yaml
version: '3.8'
services:
  php:
    image: docker.xuanyuan.run/[镜像名称]:[标签]
    environment:
      - PHP_EXTENSIONS_ENABLE=imagick ioncube mysqli redis swoole
    ports:
      - "80:80"
    volumes:
      - ./php-app:/var/www/html
    restart: always

注意事项

• 扩展名称需与"支持的第三方PHP扩展"列表中的名称完全一致
• 部分扩展可能存在依赖关系（如pdo_sqlsrv依赖sqlsrv），启用时建议同时包含相关依赖扩展
• 调试类扩展（如xdebug）在生产环境建议禁用，以避免性能损耗