whatwedo/nginx-php

!Docker Pulls !GitHub issues !build status

镜像概述和主要用途

whatwedo/nginx-php 是一个基于 Alpine Linux 的 Docker 镜像，集成了 nginx Web 服务器、PHP 解释器、PHP-FPM、git、Composer 包管理器、init 系统及容器健康检查功能。该镜像专为运行 PHP Web 应用设计，提供轻量级且功能完备的运行环境。

核心功能和特性

基础环境

• 轻量级基础：基于 Alpine Linux，确保镜像体积小、资源占用低
• 版本可控：无 latest 标签，需显式指定稳定版本标签，避免生产环境意外更新

已安装软件

gosu

gosu 是一款轻量级用户切换工具，相比 su 或 sudo，具有更简洁的 TTY 处理和信号转发行为，避免不必要的使用问题。

goss

goss 用于服务器配置验证和健康检查，已预设多项检查并与 Docker 健康检查集成。在 Kubernetes 环境中，可将 goss validate 作为存活/就绪探针。支持自定义检查，可将配置文件放置于 /etc/goss/conf.d 目录。

nginx

nginx 已配置为与 PHP-FPM 协同工作，网站文件需放置于 /var/www 目录以提供服务。

PHP

PHP 通过 codecasts/php-alpine 软件源安装，默认包含以下模块：

• php-apcu、php-calendar、php-common、php-curl、php-ctype、php-dom、php-gd、php-iconv、php-imagick、php-intl、php-json、php-ldap、php-mbstring、php-mysqli、php-mysqlnd、php-opcache、php-openssl、php-pcntl、php-pdo、php-pdo_mysql、php-pdo_sqlite、php-phar、php-posix、php-session、php-soap、php-xml、php-xmlreader、php-zip、php-zlib

PHP 自定义配置：

runit

runit 轻量级 init 系统，负责服务监控与管理，自动加载并监控 /etc/service 目录下的所有服务。

支持的标签

注意：本镜像无 latest 标签。使用 latest 标签可能导致生产环境问题，建议使用当前稳定版标签（如 v2.3）。

使用场景和适用范围

• PHP Web 应用部署：适用于运行基于 PHP 的 Web 应用（如 Laravel、Symfony、WordPress 等）
• 开发与生产环境：轻量级特性适合开发环境快速测试，版本化标签支持生产环境稳定部署
• 容器化 PHP 服务：需同时运行 nginx 和 PHP-FPM 的场景，避免手动配置多服务协同

详细的使用方法和配置说明

基础运行命令

bash
docker run -p 80:80 -v [您的项目根目录]:/var/www whatwedo/nginx-php:v2.2

• -p 80:80：将容器 80 端口映射到主机 80 端口
• -v [您的项目根目录]:/var/www：挂载本地项目目录到容器内的 /var/www（nginx 网站根目录）

启动脚本（Upstart）

镜像默认启动命令为 /sbin/upstart，提供初始化逻辑：

• 可在 /etc/upstart 目录放置自定义脚本（按字母顺序执行）
• 脚本执行完成后自动触发 runit 服务监控

健康检查配置

goss 预设健康检查已集成至 Docker，可通过 docker inspect 查看健康状态。如需扩展检查规则，将自定义 goss 配置文件放置于 /etc/goss/conf.d 目录。

环境变量

本镜像未使用任何环境变量。

暴露端口

• 80（nginx HTTP 服务）

数据卷

本镜像未定义默认数据卷，建议通过 -v 参数挂载项目目录（如示例中的 /var/www）。

开发工作流

对于开发环境，可结合 dde 工具集（whatwedo 开发的辅助工具）优化工作流。dde 针对本镜像特性设计，但非强制依赖，可根据需求选择使用。

问题反馈

如遇镜像使用问题，可通过 GitHub issue 跟踪器 提交报告。

许可证

本镜像基于 MIT 许可证开源，完整许可文本见 GitHub 仓库。

更多信息

whatwedo 提供多个基础镜像，详情可查看 GitHub 仓库。