6run0/nginx-unit-php

Nginx Unit with PHP modules 镜像文档

镜像概述

本镜像基于Nginx Unit构建，集成PHP模块，提供轻量级、高性能的Web服务环境，专为PHP应用程序部署设计。Nginx Unit作为动态Web和应用服务器，支持动态配置与多语言运行时，结合PHP模块可快速部署各类PHP应用（如WordPress、Laravel、Symfony等）。

核心功能与特性

• 原生PHP支持：集成PHP运行时及常用扩展，满足主流PHP应用依赖需求
• 轻量级设计：基于Alpine Linux构建，镜像体积小，资源占用低
• 动态配置：支持通过API或配置文件动态调整Nginx Unit服务配置，无需重启
• 灵活部署：支持挂载外部PHP应用代码，适应开发与生产环境需求
• 多版本兼容：提供多种PHP版本标签（如php7.4、php8.1、php8.2等），适配不同应用版本需求

使用场景

• 开发环境：快速搭建PHP应用测试环境，支持本地代码实时映射
• 生产环境：部署PHP Web应用，如内容管理系统（CMS）、PHP框架应用等
• 微服务架构：作为PHP微服务的独立运行时容器

使用方法

基本部署

通过docker run命令快速启动容器：

bash
docker run -d \
  -p 8080:80 \
  --name unit-php-app \
  -v /path/to/your/php/app:/app \
  6run0/nginx-unit-php:latest

• -p 8080:80：将容器80端口映射到主机8080端口
• -v /path/to/your/php/app:/app：挂载本地PHP应用代码至容器内/app目录（默认应用根目录）
• 6run0/nginx-unit-php:latest：镜像名称及标签（可指定PHP版本标签，如php8.2）

自定义配置

通过挂载Nginx Unit配置文件自定义服务行为，配置文件路径为/etc/unit/config.json：

bash
docker run -d \
  -p 8080:80 \
  --name unit-php-custom \
  -v /path/to/your/php/app:/app \
  -v /path/to/unit/config.json:/etc/unit/config.json \
  6run0/nginx-unit-php:latest

示例config.json配置（PHP应用）：

json
{
  "listeners": {
    "*:80": {
      "pass": "applications/php_app"
    }
  },
  "applications": {
    "php_app": {
      "type": "php",
      "root": "/app",
      "index": "index.php"
    }
  }
}

环境变量

Docker Compose 示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  unit-php:
    image: 6run0/nginx-unit-php:php8.2
    ports:
      - "8080:80"
    volumes:
      - ./php-app:/app
      - ./unit-config.json:/etc/unit/config.json
    restart: unless-stopped

注意事项

• 挂载应用代码时，确保目录权限正确（容器内默认用户为www-data）
• 生产环境建议使用特定PHP版本标签（如:php8.2）而非:latest，确保版本稳定性
• 复杂配置可通过Nginx Unit Admin API进行动态调整（默认监听127.0.0.1:8000）