unitecms/docker-nginx-php-alpine

docker-nginx-php-alpine

镜像概述

基于Alpine Linux构建的Docker镜像，集成Nginx Web服务器和PHP运行环境，旨在提供轻量级、高效的Web服务基础。Alpine Linux的精简特性使镜像体积更小、资源占用更低，适合开发环境、轻量级应用部署及低资源场景使用。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，启动速度快，运行时资源消耗低。
• 完整集成：内置Nginx和PHP，无需额外配置即可运行PHP Web应用。
• 灵活扩展：支持自定义Nginx配置、PHP配置及代码目录挂载，适应不同应用需求。
• 安全可靠：Alpine Linux的最小化设计减少潜在***面，提升运行环境安全性。

使用场景与适用范围

• 开发环境：快速搭建本地PHP开发环境，简化环境配置流程。
• 轻量应用部署：部署小型PHP应用（如个人博客、CMS系统、简单API服务等）。
• 低资源场景：适用于云服务器、边缘计算节点等对资源占用敏感的环境。
• 微服务组件：作为Web服务层组件，与数据库、缓存等服务协同构建微服务架构。

使用方法与配置说明

基本使用（docker run）

通过以下命令启动容器，挂载本地PHP代码目录并暴露Web服务端口：

bash
docker run -d -p 80:80 -v /本地代码目录:/var/www/html --name nginx-php-app docker-nginx-php-alpine

参数说明：

• -p 80:80：将容器内Nginx默认端口（80）映射到主机80端口。
• -v /本地代码目录:/var/www/html：挂载本地PHP代码目录至容器内Nginx网站根目录（/var/www/html）。
• --name nginx-php-app：指定容器名称，便于管理。

自定义配置

Nginx配置自定义

通过挂载自定义Nginx配置文件覆盖默认配置（容器内配置路径通常为/etc/nginx/conf.d/）：

bash
docker run -d -p 80:80 \
  -v /本地代码目录:/var/www/html \
  -v /本地nginx配置.conf:/etc/nginx/conf.d/default.conf \
  docker-nginx-php-alpine

PHP配置自定义

挂载自定义php.ini文件调整PHP运行参数（容器内PHP配置路径通常为/etc/php.ini或/etc/php/<版本>/php.ini）：

bash
docker run -d -p 80:80 \
  -v /本地代码目录:/var/www/html \
  -v /本地php.ini:/etc/php.ini \
  docker-nginx-php-alpine

docker-compose配置示例

创建docker-compose.yml文件简化服务管理：

yaml
version: '3'
services:
  web:
    image: docker-nginx-php-alpine
    ports:
      - "80:80"
    volumes:
      - ./php-app:/var/www/html  # 本地PHP代码目录
      - ./nginx/default.conf:/etc/nginx/conf.d/default.conf  # 自定义Nginx配置
      - ./php/php.ini:/etc/php.ini  # 自定义PHP配置
    restart: always  # 容器退出时自动重启

启动服务：

bash
docker-compose up -d

环境变量（可选）

部分配置可通过环境变量调整（具体支持项需参考镜像文档），常见示例：

• PHP_MEMORY_LIMIT：设置PHP内存限制（如512M）
• NGINX_WORKER_PROCESSES：调整Nginx工作进程数（如auto）