lan2play/docker-php-nginx-base

PHP & Nginx 基础镜像

镜像概述

本镜像为预配置PHP和Nginx的基础Docker镜像，旨在简化PHP Web应用的部署流程。通过整合PHP运行环境与Nginx Web服务器，提供开箱即用的应用运行环境，减少手动配置PHP与Nginx通信的复杂度，适用于各类PHP开发框架及应用场景。

核心功能与特性

• PHP与Nginx集成：预配置PHP-FPM与Nginx通信，默认启用FastCGI协议，确保PHP脚本高效解析
• 稳定版本支持：基于官方稳定版本构建（如PHP 8.x系列、Nginx 1.21+），保障运行稳定性
• 默认配置优化：包含针对PHP Web应用的基础配置（如合理的PHP执行超时时间、Nginx缓存策略）
• 可扩展性：支持自定义PHP配置（php.ini）、Nginx站点配置及扩展安装
• 轻量级设计：基于精简基础镜像（如Alpine或Debian Slim），减少镜像体积
• 标准端口暴露：默认暴露80端口，便于直接映射Web服务

使用场景

• 开发环境：快速搭建本地PHP开发环境，无需手动安装配置PHP和Nginx
• 测试环境：提供一致的运行环境，确保测试结果与生产环境的兼容性
• 生产环境：作为PHP应用基础镜像，配合安全配置与资源限制可用于生产部署
• 适用框架：兼容WordPress、Laravel、Symfony、CodeIgniter等主流PHP框架

使用方法

快速启动

通过docker run命令直接启动容器，挂载本地PHP应用代码至容器Web根目录：

bash
docker run -d \
  -p 80:80 \
  --name php-nginx-app \
  -v /path/to/your/php/app:/var/www/html \
  [镜像名称]

说明：/path/to/your/php/app需替换为本地PHP应用代码目录，容器默认Web根目录为/var/www/html

自定义配置

自定义PHP配置

通过挂载本地php.ini文件覆盖容器默认配置：

bash
docker run -d \
  -p 80:80 \
  -v /path/to/your/php/app:/var/www/html \
  -v /path/to/custom/php.ini:/usr/local/etc/php/php.ini \
  [镜像名称]

自定义Nginx配置

通过挂载Nginx站点配置文件（.conf）至容器/etc/nginx/conf.d/目录，替换默认配置：

bash
docker run -d \
  -p 80:80 \
  -v /path/to/your/php/app:/var/www/html \
  -v /path/to/nginx/conf.d:/etc/nginx/conf.d \
  [镜像名称]

环境变量配置

支持通过环境变量调整基础配置（具体变量需参考镜像文档）：

示例：

bash
docker run -d \
  -p 80:80 \
  -e PHP_MEMORY_LIMIT=256M \
  -e NGINX_ROOT=/var/www/html/public \
  -v /path/to/your/php/app:/var/www/html \
  [镜像名称]

Docker Compose 配置示例

创建docker-compose.yml文件实现多容器协调（如搭配数据库）：

yaml
version: '3.8'

services:
  php-nginx:
    image: [镜像名称]
    ports:
      - "80:80"
    volumes:
      - ./your-php-app:/var/www/html  # 挂载本地应用代码
      - ./custom-php.ini:/usr/local/etc/php/php.ini  # 自定义PHP配置
      - ./nginx-conf:/etc/nginx/conf.d  # 自定义Nginx站点配置
    environment:
      - PHP_MEMORY_LIMIT=256M
      - PHP_MAX_EXECUTION_TIME=60
    restart: unless-stopped
    depends_on:
      - db  # 若需数据库，可添加依赖

  db:
    image: mysql:8.0
    volumes:
      - mysql-data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=secret
      - MYSQL_DATABASE=phpapp

volumes:
  mysql-data:

注意事项

• 扩展管理：基础镜像包含常用PHP扩展（如mysqli、pdo_mysql、gd等），如需额外扩展，可通过Dockerfile基于本镜像构建并安装
• 安全加固：生产环境建议限制容器权限、启用HTTPS（可通过挂载SSL证书配置Nginx HTTPS）
• 日志管理：建议挂载日志目录（如/var/log/nginx、/var/log/php-fpm）至宿主机，便于日志持久化与分析
• 版本更新：定期更新镜像以获取PHP/Nginx安全补丁及功能更新，避免使用latest标签，建议指定具体版本号（如[镜像名称]:8.2-nginx1.23）以确保环境一致性