docker-php-nginx快速上手指南：从安装到运行第一个PHP应用的简单教程

【免费下载链接】docker-php-nginx Docker image with PHP-FPM 8.2 & Nginx 1.24 on Alpine Linux 项目地址: https://gitcode.com/gh_mirrors/do/docker-php-nginx

docker-php-nginx是一个基于Alpine Linux构建的Docker镜像，集成了PHP-FPM 8.4和Nginx 1.28，专为快速部署PHP应用而设计。本教程将帮助新手用户从零开始，轻松掌握使用该镜像搭建PHP开发环境的完整流程。

🚀 为什么选择docker-php-nginx？

这款Docker镜像具有以下核心优势：

• 超轻量级：镜像大小仅40MB左右，资源占用极低
• 多平台支持：兼容AMD4、ARMv6、ARMv7、ARM64等架构
• 安全设计：所有服务均以非特权用户(nobody)运行
• 性能优化：支持100并发用户，采用PHP-FPM的"按需"进程管理模式
• 日志集成：所有服务日志统一输出到Docker容器，便于监控

🔧 准备工作：安装Docker环境

在开始前，请确保你的系统已安装Docker和Docker Compose。如果尚未安装，可以参考官方文档完成环境配置。

⚡ 快速启动：3步运行PHP应用

1. 拉取官方镜像

使用以下命令获取最新版docker-php-nginx镜像：

docker pull trafex/php-nginx

2. 启动默认容器

运行以下命令启动一个基础容器：

docker run -p 80:8080 trafex/php-nginx

3. 验证安装

打开浏览器访问http://localhost，你将看到PHP信息页面；访问http://localhost/test.html可以查看静态HTML页面。

📂 挂载自定义代码

要运行自己的PHP项目，只需将代码目录挂载到容器中：

docker run -p 80:8080 -v ~/my-php-project:/var/www/html trafex/php-nginx

将~/my-php-project替换为你的实际项目路径。

⚙️ 个性化配置指南

Nginx配置

自定义Nginx设置，可挂载配置文件：

docker run -v "`pwd`/nginx-server.conf:/etc/nginx/conf.d/server.conf" trafex/php-nginx

配置文件模板可参考项目中的config/nginx.conf

PHP配置

添加PHP自定义设置：

docker run -v "`pwd`/php-setting.ini:/etc/php84/conf.d/settings.ini" trafex/php-nginx

PHP-FPM配置

调整PHP-FPM参数：

docker run -v "`pwd`/php-fpm-settings.conf:/etc/php84/php-fpm.d/server.conf" trafex/php-nginx

默认配置文件位于config/fpm-pool.conf

📦 高级应用：集成Composer

如需在项目中使用Composer管理依赖，可通过Dockerfile扩展基础镜像：

FROM trafex/php-nginx:latest

# 安装Composer
COPY --from=composer /usr/bin/composer /usr/bin/composer

# 安装项目依赖
RUN composer install --optimize-autoloader --no-interaction --no-progress

🔒 启用HTTPS支持

为本地开发环境配置HTTPS：

1. 生成自签名证书：

openssl req -x509 -nodes -newkey rsa:2048 -keyout https.key -out https.crt -subj "/CN=localhost" -days 5000

2. 创建包含SSL配置的Nginx配置文件，参考docs/enable-https.md

📚 学习资源

• xdebug支持文档
• 负载均衡器后端真实IP配置
• 发送邮件功能配置

🔄 版本管理

该镜像遵循语义化版本控制：

• latest - 最新稳定版
• <major>.<minor>.<patch> - 特定版本（如3.9.1）
• <major>.<minor> - 最新补丁版本（如3.9）
• <major> - 最新次要版本（如3）

通过本指南，你已经掌握了docker-php-nginx的基本使用方法。这个轻量级且高效的Docker镜像将帮助你快速搭建PHP开发环境，专注于代码编写而非环境配置。开始你的PHP项目开发吧！

【免费下载链接】docker-php-nginx Docker image with PHP-FPM 8.2 & Nginx 1.24 on Alpine Linux 项目地址: https://gitcode.com/gh_mirrors/do/docker-php-nginx