Docker PHP Nginx 镜像文档

概述

本Docker容器在单个实例中运行PHP和Nginx，基于Alpine Linux构建，通过Supervisor管理进程。当PHP或Nginx进程终止时，Supervisor会检测到故障并终止整个容器。该镜像主要用于部署Laravel应用，同时支持多种PHP版本，并提供生产环境和开发环境专用版本。

核心功能与特性

• 轻量基础：基于Alpine Linux，镜像体积小，资源占用低
• 进程管理：使用Supervisor监控PHP和Nginx进程，确保服务稳定性
• 版本支持：提供多种PHP版本标签（如7.3、8.0），满足不同应用需求
• 环境分离：生产版本精简无冗余依赖，开发版本包含xdebug等开发工具
• 内置工具：集成Composer，支持容器内直接安装PHP依赖，保障环境一致性

使用场景

• 生产环境部署Laravel及其他PHP Web应用
• 本地开发PHP应用，利用开发版进行代码调试（xdebug支持）
• 需要同时运行PHP和Nginx的Web服务场景

使用方法

镜像版本说明

镜像标签以PHP版本命名，开发版本在版本号后添加-dev后缀：

基本使用

拉取镜像

# 拉取生产版本（以PHP 8.0为例）
docker pull defrostedtuna/php-nginx:8.0

# 拉取开发版本
docker pull defrostedtuna/php-nginx:8.0-dev

运行容器

# 运行生产版本容器，挂载当前目录到容器/app
docker run -it -v $(pwd):/app defrostedtuna/php-nginx:8.0

# 运行开发版本容器
docker run -it -v $(pwd):/app defrostedtuna/php-nginx:8.0-dev

Dockerfile 配置示例

生产环境配置

FROM defrostedtuna/php-nginx:8.0

# 复制项目文件到容器内/app目录
COPY . /app

# 安装生产环境依赖（不含开发依赖）
RUN composer install --no-dev --optimize-autoloader

# 设置应用权限
RUN chown -R www:www /app
RUN chmod -R ug+rwx /app/storage /app/bootstrap/cache
RUN chmod -R 774 /app/storage/logs

# 其他容器配置...

开发环境配置

FROM defrostedtuna/php-nginx:8.0-dev

# 复制项目文件
COPY . /app

# 安装所有依赖（含开发依赖）
RUN composer install

# 设置应用权限
RUN chown -R www:www /app
RUN chmod -R ug+rwx /app/storage /app/bootstrap/cache
RUN chmod -R 774 /app/storage/logs

# 其他容器配置...

docker-compose 配置

version: '3.5'

services:
  app:
    image: defrostedtuna/php-nginx:8.0  # 生产环境使用；开发环境替换为8.0-dev
    container_name: app
    working_dir: /app
    volumes:
      - ./:/app  # 应用代码挂载到容器内/app目录

    # 其他配置（如端口映射、环境变量等）...

已安装软件包

生产版本

通过Alpine包管理器安装的基础软件包包括：

• curl
• nginx
• php
• php-bcmath
• php-ctype
• php-curl
• php-dom
• php-fileinfo
• php-fpm
• php-json
• php-mbstring
• php-opcache
• php-openssl
• php-pdo_mysql
• php-phar
• php-session
• php-simplexml
• php-tokenizer
• php-xml
• php-xmlwriter
• php-zip
• python3
• supervisor
• unzip
• zip

Composer已内置，可直接在容器内执行composer install等命令。Composer版本在Dockerfile中固定，避免因Composer自动更新导致与PHP环境或依赖包冲突。

开发版本

开发版本在生产版本基础上增加了开发必需的依赖，包括：

• php-sqlite
• php-pdo_sqlite
• php-xdebug

开发版本默认启用xdebug扩展，支持代码覆盖率分析工具及IDE调试功能。

构建镜像

官方镜像通过GitHub Actions自动构建并推送到Docker Hub。如需本地构建，需注意仓库的嵌套结构，显式指定构建上下文和Dockerfile路径。

构建生产版本

# 上下文设为项目根目录，指定目标PHP版本的Dockerfile
docker build -t defrostedtuna/php-nginx:8.0 . -f php-8.0/Dockerfile

构建开发版本

# 构建开发版镜像
docker build -t defrostedtuna/php-nginx:8.0-dev . -f php-8.0/dev.Dockerfile