joseluisq/php-fpm

Alpine PHP-FPM

镜像概述和主要用途

Alpine PHP-FPM是基于最新Alpine Linux构建的轻量级优化多架构Docker镜像，支持PHP-FPM（PHP 8.0、8.1、8.2版本），包含丰富的必要扩展。该镜像支持x86_64、arm、arm64架构，旨在提供高性能、低资源消耗的PHP运行环境。

核心功能和特性

稳定版本

内置扩展

curl, ftp, hash (mhash), libedit, libsodium, mbstring, mysqlnd, openssl, password-argon2, pdo-sqlite, pear, sqlite3, zlib

额外扩展

脚注：(?) 表示该扩展已过时/未维护/不推荐使用，或暂不支持。

使用场景和适用范围

适用于需要轻量级、高性能PHP-FPM环境的Web应用开发与部署，如基于Laravel、Symfony、WordPress等PHP框架的应用。支持多架构部署，适合在x86_64、arm、arm64等不同硬件平台运行，尤其适合对镜像大小和资源占用有严格要求的场景。

使用方法和配置说明

拉取镜像

从Docker Hub拉取不同PHP版本的镜像：

sh
docker pull joseluisq/php-fpm:8.0
# 或
docker pull joseluisq/php-fpm:8.1
# 或
docker pull joseluisq/php-fpm:8.2

Dockerfile示例

在Dockerfile中引用该镜像：

Dockerfile
FROM joseluisq/php-fpm:8.0
# 或
FROM joseluisq/php-fpm:8.1
# 或
FROM joseluisq/php-fpm:8.2

运行容器

快速启动测试容器，访问localhost:8088查看PHP信息：

sh
docker run --rm -p 8088:80 joseluisq/php-fpm:8.2 sh -c "echo '<?php phpinfo();' > index.php; php -S [::]:80 -t ."
# 或
docker run --rm -p 8088:80 joseluisq/php-fpm:8.1 sh -c "echo '<?php phpinfo();' > index.php; php -S [::]:80 -t ."
# 或
docker run --rm -p 8088:80 joseluisq/php-fpm:8.0 sh -c "echo '<?php phpinfo();' > index.php; php -S [::]:80 -t ."

Docker Compose示例

提供Nginx和Apache服务器的Docker Compose配置示例，位于https://github.com/joseluisq/alpine-php-fpm%E7%9A%84%60examples%60%E7%9B%AE%E5%BD%95%E3%80%82

Nginx示例

sh
docker-compose -f examples/nginx/docker-compose.yml up

Apache示例

sh
docker-compose -f examples/apache/docker-compose.yml up

默认路径

• Docker默认工作目录：/var/www/html
• PHP额外配置文件加载目录：/usr/local/etc/php/conf.d
• 自定义PHP配置文件（仅当ENV_SUBSTITUTION_ENABLE=true时生成）：/usr/local/etc/php/conf.d/default-php.ini

可配置环境变量

通过环境变量可覆盖PHP-FPM和PHP配置，需设置ENV_SUBSTITUTION_ENABLE=true（默认禁用）启用替换功能。

PHP-FPM配置

全局FPM设置

替换/usr/local/etc/php-fpm.conf文件中的配置：

• PHP_FPM_ERROR_LOG=/proc/self/fd/2：错误日志路径
• PHP_FPM_LOG_LEVEL=error：日志级别

FPM WWW池设置

替换/usr/local/etc/php-fpm.d/www.conf文件中的配置：

• PHP_FPM_LISTEN=9000：监听端口
• PHP_FPM_USER=www-data：运行用户
• PHP_FPM_GROUP=www-data：运行组
• PHP_FPM_LISTEN_OWNER=www-data：监听套接字所有者
• PHP_FPM_LISTEN_GROUP=www-data：监听套接字组

PHP配置

替换/usr/local/etc/php/conf.d/default-php.ini文件（php.ini）中的配置：

• PHP_MEMORY_LIMIT=512M：内存限制
• PHP_EXPOSE_PHP=On：是否暴露PHP版本信息
• PHP_SESSION_GC_MAXLIFETIME=1440：会话垃圾回收最大生命周期（秒）

贡献

欢迎提交https://github.com/joseluisq/alpine-php-fpm/pulls%E6%88%96%E5%8F%8D%E9%A6%88https://github.com/joseluisq/alpine-php-fpm/issues%E3%80%82

许可

本项目主要采用MIT许可和Apache许可（版本2.0）进行分发。

© 2020-present Jose Quintana