makasim/nginx-php-fpm Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

docker-nginx-php-fpm 镜像文档

镜像概述和主要用途

docker-nginx-php-fpm是一个集成Nginx Web服务器与PHP-FPM的Docker镜像，用于快速部署PHP应用。当请求的文件在文件系统中存在时，由Nginx直接提供静态文件服务；当文件不存在时，Nginx会将请求代理到PHP-FPM处理。项目根目录必须包含app.php作为PHP请求的入口文件。

核心功能和特性

• 集成Nginx和PHP-FPM，无需单独配置两者联动
• 自动区分静态文件和PHP请求，静态文件直接服务，动态请求代理至PHP-FPM
• 支持通过环境变量自定义Nginx和PHP-FPM配置
• 简单易用，仅需挂载项目目录即可快速启动服务

使用场景和适用范围

适用于快速部署小型PHP应用、个人网站、Web应用原型验证等场景，尤其适合需要同时处理静态资源和PHP动态内容的轻量级应用。

使用方法和配置说明

部署示例

1. 准备项目文件

在项目目录中创建必要的PHP入口文件和静态文件（必须包含app.php）：

bash
echo "<?php phpinfo();" > app.php  # 创建PHP入口文件
echo "<h1>Hello world</h1>" > hello.html  # 创建静态HTML文件

2. 启动容器

通过docker run命令挂载项目目录并启动服务：

bash
docker run -d -p 8080:80 -v $(pwd):/var/www/html formapro/nginx-php-fpm

• -d：后台运行容器
• -p 8080:80：将容器的80端口映射到主机的8080端口
• -v $(pwd):/var/www/html：将当前目录挂载到容器内的Web根目录/var/www/html

3. 验证服务

使用curl命令测试服务是否正常运行：

bash
curl -X GET localhost:8080  # 访问PHP入口文件，输出phpinfo信息
curl -X GET localhost:8080/hello.html  # 访问静态文件，显示"Hello world"

环境变量配置

可通过环境变量自定义Nginx和PHP-FPM的配置参数，以下是可用环境变量及其默认值：

环境变量使用示例

修改Web根目录为/app：

bash
docker run -d -p 8080:80 -e NGINX_WEB_ROOT=/app -v $(pwd):/app formapro/nginx-php-fpm