romeoz/docker-nginx-php

romeoz/docker-nginx-php 镜像中文文档

目录

• 安装
• 快速启动
• 持久化
• 链接其他容器
• 添加PHP扩展
• 日志管理
• 开箱即用内容
• 许可证

镜像概述

该镜像整合了Nginx和PHP-FPM，支持多种PHP版本（5.3至7.3），可灵活链接至其他容器（如数据库），适用于Web应用的开发、测试与生产部署场景，提供便捷的扩展安装与日志管理功能。

核心功能

1. 支持多PHP版本（5.3/5.4/5.5/5.6/7.0/7.1/7.2/7.3）
2. 内置Composer包管理器
3. 支持持久化存储Web应用代码
4. 可与其他服务容器（如PostgreSQL）联动
5. 灵活安装PHP扩展
6. 标准化日志输出与轮转

使用场景

• Web应用开发环境搭建
• 轻量级Web服务测试部署
• 生产环境中与数据库等服务配合运行的Web应用容器

配置说明

安装

1. 安装Docker 1.9+（参考Docker官方文档或Ubuntu安装指南）
2. 拉取最新镜像：

bash
docker pull romeoz/docker-nginx-php

或指定PHP版本（如7.1）：

bash
docker pull romeoz/docker-nginx-php:7.1

也可自行构建镜像：

bash
git clone https://github.com/romeoz/docker-nginx-php.git
cd docker-nginx-php
docker build -t="$USER/docker-nginx-php" .

快速启动

运行容器并映射端口：

bash
docker run --name app -d -p 8080:80 romeoz/docker-nginx-php

进入容器终端：

bash
docker exec -it app bash

持久化

开发时可挂载本地目录至容器内的/var/www/app/：

bash
docker run --name app -d -p 8080:80 \
  -v /本地路径/app:/var/www/app/ \
  romeoz/docker-nginx-php

链接其他容器

以链接PostgreSQL为例：

1. 创建网络：

bash
docker network create pg_net

2. 启动PostgreSQL容器：

bash
docker run --name db -d --net pg_net romeoz/docker-postgresql

3. 启动Web应用容器并加入同一网络：

bash
docker run --name app -d -p 8080:80 \
  --net pg_net \
  -v /本地路径/app:/var/www/app/ \
  romeoz/docker-nginx-php

添加PHP扩展

有两种方式：

1. 直接在运行的容器中安装：

bash
docker exec -it app bash -c 'apt-get update && apt-get install php-mongo && rm -rf /var/lib/apt/lists/*'

2. 基于该镜像构建新镜像（以PHP 5.6为例）： 创建Dockerfile：

dockerfile
FROM romeoz/docker-nginx-php:5.6
RUN apt-get update \
    && apt-get install -y php-mongo \
    && rm -rf /var/lib/apt/lists/* 
WORKDIR /var/www/app/
EXPOSE 80 443
CMD ["/usr/bin/supervisord"]

构建并运行：

bash
docker build -t php-5.6 .
docker run --name app -d -p 8080:80 php-5.6

查看已安装扩展：

bash
docker exec -it app php -m

日志管理

所有日志输出至stdout/stderr，可通过docker logs查看：

bash
docker logs app

分割日志

将stdout和stderr分别保存至文件：

bash
docker logs app > stdout.log 2>stderr.log

或输出至主机终端：

bash
docker logs app > -
docker logs app 2> -

日志轮转

创建/etc/logrotate.d/docker-containers文件，内容如下：

/var/lib/docker/containers/*/*.log {
    rotate 31
    daily
    nocompress
    missingok
    notifempty
    copytruncate
}

（可选：将nocompress改为compress，调整rotate数值以修改保留天数）

开箱即用内容

• Ubuntu LTS版本（12.04/14.04/16.04/18.04）
• Nginx 1.14
• PHP版本（5.3/5.4/5.5/5.6/7.0/7.1/7.2/7.3）
• Composer包管理器

环境依赖于所选PHP版本

许可证

该镜像基于MIT许可证开源。