Alpine Nginx PHP 7 镜像文档

镜像概述与主要用途

本镜像为轻量级Web服务器解决方案，基于Alpine Linux构建，集成Nginx Web服务器和PHP 7运行环境，采用s6进程管理机制确保服务稳定运行。主要用于快速部署PHP Web应用，默认将/opt/www目录作为Web内容根目录，支持标准PHP脚本解析与Web内容分发。

核心功能与特性

轻量级基础

• 基于Alpine Linux发行版，具备体积小（镜像尺寸通常小于50MB）、资源占用低、启动速度快的特点，适合资源受限环境或追求高效部署的场景。

集成组件

• Nginx：高性能HTTP和反向代理服务器，负责处理HTTP请求与静态资源分发。
• PHP 7：集成PHP 7运行时环境及PHP-FPM进程管理器，支持动态PHP脚本解析。
• s6启动机制：采用s6进程管理框架，确保Nginx和PHP-FPM进程协同启动、监控及优雅重启，提升服务稳定性。

便捷部署

• 固定Web根目录：默认使用/opt/www作为应用代码挂载点，简化应用部署流程，只需将PHP应用文件放入该目录即可直接提供服务。

使用场景与适用范围

• 开发与测试环境：快速搭建本地PHP应用测试环境，无需手动配置Nginx与PHP依赖。
• 小型生产环境：适用于个人博客、企业官网、小型CMS系统等低至中等流量的PHP应用部署。
• 容器化应用：兼容Docker、Kubernetes等容器编排平台，作为PHP微服务的基础运行时环境。

使用方法与配置说明

基本部署命令

快速启动容器

通过docker run命令直接启动，映射主机端口并挂载应用目录：

docker run -d -p 80:80 -v /本地应用目录:/opt/www --name php-web hackinglab/alpine-nginx-php:php7

• -p 80:80：将容器内Nginx默认80端口映射到主机80端口（可根据需求修改主机端口，如-p 8080:80）。
• -v /本地应用目录:/opt/www：将本地PHP应用代码目录挂载到容器内/opt/www（Web根目录）。
• --name php-web：指定容器名称，便于管理。

Docker Compose配置示例

创建docker-compose.yml文件实现多容器协同或更复杂配置：

version: '3'
services:
  web:
    image: hackinglab/alpine-nginx-php:php7
    ports:
      - "8080:80"  # 主机8080端口映射到容器80端口
    volumes:
      - ./app:/opt/www  # 本地app目录挂载为Web根目录
      - ./nginx.conf:/etc/nginx/nginx.conf  # 自定义Nginx配置（可选）
      - ./php.ini:/etc/php7/php.ini  # 自定义PHP配置（可选）
    restart: always  # 容器退出时自动重启

启动服务：

docker-compose up -d

配置自定义

Nginx配置修改

默认Nginx配置文件路径：/etc/nginx/nginx.conf。如需自定义Nginx配置（如虚拟主机、反向代理规则等），可通过挂载本地配置文件覆盖：

docker run -d -p 80:80 \
  -v /本地应用目录:/opt/www \
  -v /本地nginx.conf:/etc/nginx/nginx.conf \
  hackinglab/alpine-nginx-php:php7

PHP配置调整

PHP配置文件路径：/etc/php7/php.ini。可通过挂载本地php.ini修改PHP运行参数（如内存限制、时区等）：

docker run -d -p 80:80 \
  -v /本地应用目录:/opt/www \
  -v /本地php.ini:/etc/php7/php.ini \
  hackinglab/alpine-nginx-php:php7

注意事项

文件权限

确保挂载的本地应用目录权限允许容器内进程（通常为nginx用户，UID/GID可通过docker exec -it <容器名> id nginx查看）访问，避免因权限不足导致文件读取失败。

PHP扩展

基础镜像包含PHP核心扩展（如mysqli、pdo等），如需额外扩展（如gd、curl），可通过以下方式处理：

1. 基于本镜像构建自定义镜像，在Dockerfile中使用apk add php7-<扩展名>安装；
2. 容器运行时通过docker exec执行apk add php7-<扩展名>临时安装（重启后失效）。

s6进程管理

s6配置文件位于/etc/s6/，用于定义服务启动顺序、日志输出等。如需调整服务行为（如添加自定义启动脚本），可挂载本地s6配置目录覆盖默认设置。