foun10/eden-phpfpm

EDEN - PHPFPM

镜像概述和主要用途

该容器提供PHP 5.6、7.0、7.1、7.2及7.3版本的PHP-FPM环境，是foun10的eden项目的一部分。主要用于运行PHP应用，支持通过环境变量配置应用目录、数据库连接、文件权限等参数，并提供初始化脚本、备份恢复、自定义命令钩子等功能，适用于PHP应用的开发与部署场景。

核心功能和特性

• 多PHP版本支持：集成PHP 5.6、7.0、7.1、7.2、7.3版本的PHP-FPM
• 灵活的环境配置：通过环境变量自定义应用目录、数据库连接、文件权限等
• 启动钩子命令：支持在启动过程中执行pre、post、always类型的自定义脚本
• 数据库初始化：首次运行时可从指定的dump文件或目录导入数据库查询
• 备份恢复：支持从URL下载并解压.tar.gz格式的备份文件到应用目录
• 文件权限管理：可自定义应用目录下文件的权限和UID
• gitignore自动更新：配置后可自动更新gitignore文件

使用场景和适用范围

• 需要在不同PHP版本（5.6-7.3）下运行的PHP应用开发或部署
• 需自动化完成数据库初始化、备份恢复的PHP项目
• 需要自定义文件权限、用户ID以适配特定运行环境的场景
• 需要在容器启动过程中执行自定义命令（如配置初始化、依赖安装）的PHP应用

使用方法和配置说明

环境变量配置

通过以下环境变量可配置容器行为：

额外命令

容器支持在启动时执行自定义命令，通过以下钩子实现：在APP_DIR/eden-phpfpm/目录下放置TYPE.sh文件（TYPE可为pre、post、always），启动时将执行对应脚本。

首次运行

• 首次运行后会生成init.lock文件，删除该文件可重新运行设置脚本。
• 若提供数据库dump文件或目录，运行脚本将执行查询：
  • 若为目录，查询按字母顺序执行，建议文件命名加数字前缀（如000_dump.sql）。
• 若提供备份URL，将下载并解压备份到应用目录：
  • 备份文件必须为.tar.gz格式。
  • 警告：解压前会删除所有非版本控制文件。

部署示例

bash
docker run -d \
  -e APP_DIR=/var/www/myapp \
  -e DB_HOST=mysql \
  -e DB_NAME=myappdb \
  -e DB_USER=appuser \
  -e DB_PASS=apppass \
  -v ./myapp:/var/www/myapp \
  --name eden-phpfpm \
  foun10/eden-phpfpm