seoda/php-fpm-for-laravel

PHP-FPM 增强版 Docker 镜像

镜像概述

本镜像基于 Docker 官方 PHP 镜像的 php-fpm 标签构建，专为现代 PHP 应用程序设计。在官方镜像的基础上，预装并启用了多种高频使用的 PHP 扩展，旨在提供一个开箱即用、高性能且功能完备的 PHP-FPM 运行环境，大幅减少开发者在构建镜像时的扩展编译与配置时间。

核心功能与特性

镜像内置并启用了以下 9 个核心 PHP 扩展：

• gd: 用于图像处理和生成（如缩略图裁剪、验证码生成）。
• pdo_mysql: 提供通过 PDO 驱动连接和操作 MySQL/MariaDB 数据库的支持。
• zip: 支持 ZIP 压缩文件的读取、创建与解压。
• pcntl: 提供进程控制支持，常用于队列消费者、定时任务及守护进程。
• bcmath: 提供任意精度的数学运算，适用于***、电商等对数值精度要求极高的场景。
• intl: 提供国际化（i18n）支持，处理多语言、日期、货币和数字格式化。
• igbinary: 高效的二进制序列化器，可替代 PHP 原生的 serialize，显著提升 Redis 或 Session 的读写性能。
• redis: 提供与 Redis 内存数据库通信的高性能客户端支持。
• opcache: 将 PHP 脚本预编译为字节码并缓存在共享内存中，大幅提升 PHP 代码执行效率。

使用场景

• 现代 PHP 框架部署：完美适配 Laravel、Symfony、ThinkPHP 等依赖丰富扩展的现代 PHP 框架。
• 高并发 Web 应用：结合 Opcache 和 Redis 扩展，适合需要高性能缓存和会话管理的 Web 服务。
• 后台队列与定时任务：借助 pcntl 扩展，可稳定运行 Laravel Horizon、Supervisor 管理的后台队列消费者。
• 电商与*系统**：利用 bcmath 和 intl 扩展，满足精确计算与多语言/多币种国际化需求。

使用方法与部署示例

1. 基础运行 (Docker Run)

将本地项目目录挂载到容器的 /var/www/html 目录，并暴露 9000 端口：

bash
docker run -d \
  --name my-php-app \
  -v /path/to/your/php/project:/var/www/html \
  -p 9000:9000 \
  your-registry/php-fpm-extended:latest

2. 结合 Nginx 部署 (Docker Compose)

PHP-FPM 通常需要与 Web 服务器（如 Nginx）配合使用。以下是完整的 docker-compose.yml 生产环境示例：

yaml
version: '3.8'

services:
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./src:/var/www/html
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - php-fpm

  php-fpm:
    image: your-registry/php-fpm-extended:latest
    volumes:
      - ./src:/var/www/html
      # 挂载自定义 PHP 配置
      - ./custom-php.ini:/usr/local/etc/php/conf.d/custom.ini
      # 挂载自定义 FPM 进程池配置
      - ./custom-www.conf:/usr/local/etc/php-fpm.d/www.conf

配置说明

自定义 PHP 配置 (php.ini)

如需调整 PHP 运行参数（如上传大小、内存限制），可创建自定义 custom.ini 文件并挂载到容器中：

ini
; custom.ini
memory_limit = 256M
upload_max_filesize = 50M
post_max_size = 50M
max_execution_time = 300

挂载路径：/usr/local/etc/php/conf.d/custom.ini

自定义 PHP-FPM 配置 ([***]

如需调整 FPM 进程池参数以优化并发性能，可修改 www.conf 并挂载：

ini
; www.conf
pm = dynamic
pm.max_children = 50
pm.start_servers = 10
pm.min_spare_servers = 5
pm.max_spare_servers = 20

挂载路径：/usr/local/etc/php-fpm.d/www.conf

扩展验证

进入容器后，可通过以下命令验证扩展是否已成功加载：

bash
docker exec -it my-php-app php -m