docker-php-nginx 镜像文档

镜像概述和主要用途

docker-php-nginx是一个预配置的Docker镜像，集成了PHP运行环境与Nginx Web服务器，旨在为PHP Web应用提供即用型部署环境。通过整合核心组件并优化默认配置，该镜像减少了手动安装、配置PHP和Nginx的繁琐步骤，帮助开发者快速搭建一致的运行环境，适用于从本地开发到小型生产部署的全流程场景。

核心功能和特性

• 一站式环境：包含PHP（支持多版本，如7.4/8.0/8.1等）和Nginx，无需单独部署组件。
• 预配置优化：默认集成常用PHP扩展（如mysqli、pdo_mysql、gd、curl、json等），Nginx配置适配PHP-FPM，开箱即用。
• 轻量级基础：基于Alpine或Debian等精简Linux发行版，镜像体积小，启动速度快，资源占用低。
• 高度可定制：支持通过环境变量、配置文件挂载或Dockerfile扩展自定义PHP/Nginx参数及扩展。
• 跨平台支持：通常提供AMD64、ARM等多架构镜像，适配不同硬件环境。

使用场景和适用范围

• 本地开发环境：快速搭建与生产一致的PHP开发环境，避免“环境差异”导致的问题。
• 自动化测试：作为CI/CD流程中的运行环境，用于自动化测试PHP应用功能。
• 小型生产部署：适用于流量规模较小的PHP Web应用（如个人博客、企业官网）的生产环境。
• 教学与演示：简化PHP Web技术栈的教学演示，降低环境准备门槛。

详细使用方法和配置说明

基本部署（docker run）

通过以下命令快速启动容器，将本地PHP应用目录挂载到容器中：

bash
docker run -d \
  -p 80:80 \  # 主机80端口映射到容器Nginx端口
  -v /path/to/your/php/app:/var/www/html \  # 挂载本地PHP应用代码
  --name php-nginx-app \  # 容器名称
  myusername/docker-php-nginx  # 镜像名称（替换为实际镜像地址）

访问 http://localhost 即可查看部署的PHP应用。

多容器编排（docker-compose）

创建 docker-compose.yml 文件实现更灵活的配置管理：

yaml
version: '3'
services:
  php-nginx:
    image: myusername/docker-php-nginx
    ports:
      - "8080:80"  # 自定义主机端口（主机8080 -> 容器80）
    volumes:
      - ./app:/var/www/html  # 本地应用目录
      - ./nginx/conf.d:/etc/nginx/conf.d  # 挂载自定义Nginx配置（可选）
      - ./php.ini:/usr/local/etc/php/php.ini  # 挂载自定义PHP配置（可选）
    environment:
      - PHP_INI_DATE_TIMEZONE=Asia/Shanghai  # 设置PHP时区
      - NGINX_PORT=80  # Nginx容器内监听端口（默认80）
    restart: unless-stopped  # 容器退出时自动重启（可选）

启动服务：

bash
docker-compose up -d

配置参数说明

环境变量

通过 -e 参数或 docker-compose.yml 的 environment 字段设置，支持以下常用配置：

• PHP_INI_<KEY>：自定义PHP配置，格式为 PHP_INI_<配置项名>=<值>，例如：
  • PHP_INI_DATE_TIMEZONE=Asia/Shanghai → 对应 php.ini 中的 date.timezone = Asia/Shanghai
  • PHP_INI_MEMORY_LIMIT=256M → 对应 php.ini 中的 memory_limit = 256M
• NGINX_PORT：设置容器内Nginx监听端口（默认80，需配合 -p 参数调整端口映射）。

配置文件挂载

• Nginx配置：将自定义Nginx站点配置文件（如 myapp.conf）挂载到容器 /etc/nginx/conf.d/ 目录，覆盖默认配置。示例配置：

  nginx
  server {
      listen 80;
      server_name localhost;
      root /var/www/html;
      index index.php index.html;
  
      location ~ \.php$ {
          fastcgi_pass 127.0.0.1:9000;  # 连接PHP-FPM
          fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
          include fastcgi_params;
      }
  }
  

• PHP配置：挂载自定义 php.ini 到 /usr/local/etc/php/php.ini，或在 /usr/local/etc/php/conf.d/ 目录添加扩展配置文件（如 custom.ini）。

安装额外PHP扩展

默认未包含的扩展可通过Dockerfile基于该镜像构建：

dockerfile
FROM myusername/docker-php-nginx  # 替换为实际镜像名称
RUN docker-php-ext-install zip exif  # 安装zip和exif扩展
# 如需pecl扩展（如redis）：
RUN pecl install redis && docker-php-ext-enable redis

构建并使用自定义镜像：

bash
docker build -t my-custom-php-nginx .
docker run -d -p 80:80 -v /path/to/app:/var/www/html my-custom-php-nginx