ilios/fpm Docker 镜像 - 轩辕镜像

Ilios FPM镜像文档

1. 镜像概述

本镜像为Ilios教育管理平台提供FPM（FastCGI Process Manager）运行环境，基于PHP-FPM构建，专门用于处理Ilios应用的PHP代码执行和Web请求处理。作为Ilios部署架构的核心组件，该镜像需与Web服务器（如Nginx）配合使用，共同构成完整的Ilios服务体系。

2. 核心功能与特性

• PHP-FPM支持：集成PHP-FPM进程管理器，支持FastCGI协议，高效处理PHP请求
• Ilios兼容性：预配置以匹配Ilios应用的PHP版本及扩展需求，确保无缝运行
• 进程管理：支持动态调整子进程数量，可根据负载自动优化资源占用
• 安全优化：遵循Ilios安全最佳实践，限制不必要的PHP函数，降低安全风险
• 轻量级设计：基于官方PHP镜像构建，精简镜像体积，提升部署效率

3. 使用场景

• 生产环境部署Ilios教育管理平台的后端PHP服务
• 开发/测试环境中运行Ilios应用，进行功能开发与测试
• 构建Ilios容器化部署架构（如配合Nginx、数据库容器实现完整服务栈）

4. 使用方法

4.1 基本运行命令

bash
docker run -d \
  --name ilios-fpm \
  -v /path/to/ilios/code:/var/www/html \
  -e DB_HOST=db.example.com \
  -e DB_NAME=ilios \
  -e DB_USER=ilios_user \
  -e DB_PASS=secure_password \
  ilios/fpm:latest

4.2 与Nginx配合使用

4.2.1 Nginx配置示例

nginx
server {
    listen 80;
    server_name ilios.example.com;
    root /var/www/html/web;

    location / {
        try_files $uri /app.php$is_args$args;
    }

    location ~ ^/app\.php(/|$) {
        fastcgi_pass ilios-fpm:9000;
        fastcgi_split_path_info ^(.+\.php)(/.*)$;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param DOCUMENT_ROOT $document_root;
    }
}

4.2.2 Docker Compose配置

yaml
version: '3'
services:
  ilios-fpm:
    image: ilios/fpm:latest
    volumes:
      - ./ilios-code:/var/www/html
    environment:
      - DB_HOST=db
      - DB_NAME=ilios
      - DB_USER=ilios_user
      - DB_PASS=secure_password
    depends_on:
      - db

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

  db:
    image: mysql:5.7
    environment:
      - MYSQL_DATABASE=ilios
      - MYSQL_USER=ilios_user
      - MYSQL_PASSWORD=secure_password
      - MYSQL_ROOT_PASSWORD=root_password
    volumes:
      - mysql-data:/var/lib/mysql

volumes:
  mysql-data:

4.3 环境变量配置

4.4 数据卷挂载

5. 注意事项

• 镜像需配合Web服务器（如Nginx）使用，单独运行无法处理HTTP请求
• 首次运行前需确保数据库已初始化并包含Ilios所需表结构
• 生产环境中建议使用docker secrets或环境变量管理敏感信息（如数据库密码）
• 定期更新镜像以获取安全补丁和功能更新

6. 版本信息

• 基础镜像：php:<version>-fpm（具体版本取决于Ilios兼容性要求）
• 支持的Ilios版本：请参考Ilios官方文档获取兼容信息