apko/wolfi php-fpm 镜像文档

镜像概述与主要用途

apko/wolfi php-fpm镜像是基于Wolfi最小化Linux发行版构建的PHP-FPM（FastCGI进程管理器）容器镜像。Wolfi是专为容器设计的安全强化型Linux发行版，以最小化***面、精简体积和定期安全更新为核心特性；apko是用于构建OCI兼容镜像的工具，确保镜像构建过程的可重现性和安全性。该镜像将Wolfi的安全精简特性与PHP-FPM的高性能PHP请求处理能力相结合，为PHP应用提供安全、高效且资源友好的运行环境，主要用于与Nginx、Apache等Web服务器配合，处理PHP应用的动态请求。

核心功能与特性

安全与精简基础

• Wolfi发行版优势：采用最小化设计，仅包含运行PHP-FPM所需的核心组件，显著减少***面；默认启用安全强化机制，包括非root用户运行、定期漏洞修复和供应链安全验证。
• apko构建保障：通过apko工具构建，遵循OCI镜像标准，确保构建过程可重现、依赖项透明，降低镜像篡改风险。

高性能PHP处理

• PHP-FPM进程管理：集成PHP-FPM，支持动态进程管理（如pm.max_children、pm.start_servers等参数），可根据请求负载自动调整进程数，提升并发处理能力。
• 资源优化：精简的基础镜像减少内存和磁盘占用，缩短容器启动时间，适合资源受限环境。

灵活配置能力

• 环境变量配置：支持通过环境变量自定义PHP.ini和PHP-FPM配置参数，无需修改基础镜像。
• 卷挂载扩展：可挂载本地应用代码、自定义配置文件或扩展模块，满足多样化应用需求。

使用场景与适用范围

适用场景

• 生产环境PHP应用部署：适用于电商平台、CMS系统（如WordPress、Drupal）、企业内部PHP应用等生产环境，需兼顾安全性和性能的场景。
• 微服务架构：作为微服务架构中的PHP处理节点，与API网关或Web服务器配合，提供轻量级PHP服务。
• CI/CD流程集成：用于PHP应用的自动化测试、构建和部署环节，确保环境一致性。
• 边缘计算/轻量容器平台：在资源受限的边缘设备或轻量级容器平台（如K3s）中部署，降低资源消耗。

不适用场景

• 需要大量系统依赖或非标准PHP扩展的复杂应用（建议基于此镜像构建自定义镜像补充依赖）。
• 对PHP版本有特殊要求（需确认镜像内置PHP版本是否匹配）。

使用方法与配置说明

基本使用（docker run）

启动默认配置容器

bash
docker run -d --name php-fpm -p 9000:9000 apko/wolfi php-fpm

说明：默认暴露9000端口（PHP-FPM标准端口），可通过php -v查看PHP版本：

bash
docker exec -it php-fpm php -v

挂载PHP应用代码

将本地PHP应用目录挂载到容器内（示例挂载到/app目录）：

bash
docker run -d --name php-fpm \
  -v /path/to/local/app:/app \
  -p 9000:9000 \
  apko/wolfi php-fpm

与Nginx配合使用（docker-compose示例）

docker-compose.yml配置

yaml
version: '3.8'

services:
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf  # Nginx配置
      - ./app:/app  # PHP应用代码（与php-fpm共享）
    depends_on:
      - php-fpm

  php-fpm:
    image: apko/wolfi php-fpm
    volumes:
      - ./app:/app  # PHP应用代码
    environment:
      - PHP_INI_memory_limit=256M  # 自定义PHP内存限制
      - PHP_FPM_PM_MAX_CHILDREN=30  # 自定义FPM最大进程数

Nginx配置示例（nginx.conf）

nginx
server {
    listen 80;
    server_name localhost;
    root /app;  # 对应PHP应用代码目录
    index index.php index.html;

    # 转发PHP请求到PHP-FPM
    location ~ \.php$ {
        fastcgi_pass php-fpm:9000;  # 容器名:端口（与docker-compose服务名对应）
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

配置参数说明

环境变量配置

通过-e参数设置环境变量，自定义PHP和FPM配置：

示例：

bash
docker run -d --name php-fpm \
  -e PHP_INI_post_max_size=10M \
  -e PHP_INI_upload_max_filesize=5M \
  -e PHP_FPM_PM_MAX_CHILDREN=20 \
  apko/wolfi php-fpm

卷挂载配置

注意事项

1. 非root用户运行：Wolfi镜像默认以非root用户启动，挂载目录时需确保容器用户对目录有读写权限，可通过chmod调整本地目录权限或在docker run中添加--user root临时测试（生产环境不建议）。

2. 扩展安装：如需额外PHP扩展（如mysqli、redis），可基于此镜像构建自定义Dockerfile：

   dockerfile
   FROM apko/wolfi php-fpm
   RUN apk add php-mysqli php-redis  # Wolfi使用apk作为包管理器
   

3. 版本兼容性：通过docker run --rm apko/wolfi php-fpm php -v确认PHP版本，确保与应用兼容。

4. 日志查看：PHP-FPM日志默认输出到stdout，可通过docker logs php-fpm查看。