sindriainc/nginx-php

LEMP Stack (Nginx + PHP-FPM via Socket) 镜像文档

镜像概述

本镜像提供了一套完整的LEMP技术栈解决方案，核心组件包括Nginx和PHP-FPM，特别优化了PHP-FPM通过Unix Socket与Nginx的通信机制，旨在为PHP应用提供高效、低开销的运行环境。

核心功能与特性

高效通信机制

• PHP-FPM通过Unix Socket与Nginx建立通信，相比传统TCP Socket减少网络传输开销，提升请求处理效率
• 内置Socket路径优化，默认配置/run/php-fpm.sock，确保进程间通信稳定可靠

完整技术栈集成

• 包含Nginx稳定版本，支持HTTP/HTTPS协议及常见Web服务器功能
• 集成PHP-FPM运行环境，支持多版本PHP（具体版本以镜像标签为准）
• 内置必要PHP扩展（如mysqli、pdo_mysql、gd等），满足主流PHP应用需求

灵活配置支持

• 支持自定义Nginx站点配置（通过挂载/etc/nginx/conf.d目录）
• 允许调整PHP-FPM参数（如进程数、超时时间等，通过挂载/etc/php-fpm.d目录）
• 可自定义PHP.ini配置（通过挂载/etc/php.ini文件）

使用场景与适用范围

• 个人博客系统（如WordPress、Typecho）
• 企业内容管理系统（如Drupal、Joomla）
• PHP框架应用（如Laravel、Symfony、CodeIgniter）
• 开发/测试环境快速搭建
• 中小型生产环境PHP应用部署

使用方法与配置说明

基础使用（Docker Run）

bash
docker run -d \
  --name lemp-stack \
  -p 80:80 \
  -v /path/to/your/php/app:/var/www/html \
  [镜像名称]:[标签]

参数说明：

• -p 80:80: 映射容器80端口到主机80端口（HTTP服务）
• -v /path/to/your/php/app:/var/www/html: 挂载本地PHP应用代码到容器Web根目录

高级配置（Docker Compose）

创建docker-compose.yml文件：

yaml
version: '3'
services:
  lemp:
    image: [镜像名称]:[标签]
    ports:
      - "80:80"
      - "443:443"  # 如需HTTPS，添加443端口映射
    volumes:
      - ./php-app:/var/www/html  # PHP应用代码目录
      - ./nginx-conf:/etc/nginx/conf.d  # 自定义Nginx配置
      - ./php-fpm-conf:/etc/php-fpm.d  # 自定义PHP-FPM配置
      - ./php-ini:/etc/php.ini  # 自定义PHP.ini配置
      - ./logs:/var/log/nginx  # Nginx日志持久化
    environment:
      - PHP_FPM_MAX_CHILDREN=10  # 设置PHP-FPM最大进程数
      - PHP_MEMORY_LIMIT=256M  # 设置PHP内存限制
    restart: always

启动服务：

bash
docker-compose up -d

环境变量配置

支持以下环境变量调整核心参数：

自定义配置示例

1. 配置WordPress应用

bash
docker run -d \
  --name wordpress-lemp \
  -p 80:80 \
  -v /path/to/wordpress:/var/www/html \
  -e DOCUMENT_ROOT=/var/www/html \
  [镜像名称]:[标签]

2. 启用HTTPS支持

1. 准备SSL证书文件（cert.pem和key.pem）
2. 创建Nginx配置文件ssl.conf：

   nginx
   server {
       listen 443 ssl;
       server_name example.com;
       root /var/www/html;
       
       ssl_certificate /etc/nginx/ssl/cert.pem;
       ssl_certificate_key /etc/nginx/ssl/key.pem;
       
       location ~ \.php$ {
           fastcgi_pass unix:/run/php-fpm.sock;
           fastcgi_index index.php;
           fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
           include fastcgi_params;
       }
   }
   

3. 启动容器：

   bash
   docker run -d \
     --name lemp-ssl \
     -p 443:443 \
     -v /path/to/php/app:/var/www/html \
     -v /path/to/ssl.conf:/etc/nginx/conf.d/ssl.conf \
     -v /path/to/cert:/etc/nginx/ssl \
     [镜像名称]:[标签]
   

注意事项

• 挂载本地目录时需确保文件权限与容器内用户（默认nginx）匹配，避免权限错误
• 生产环境建议配合数据库容器（如MariaDB）使用，通过Docker网络实现服务互联
• 如需调整PHP扩展，可通过自定义Dockerfile基于本镜像添加所需扩展

日志查看

• Nginx访问日志：docker exec -it [容器ID] cat /var/log/nginx/access.log
• Nginx错误日志：docker exec -it [容器ID] cat /var/log/nginx/error.log
• PHP-FPM日志：docker exec -it [容器ID] cat /var/log/php-fpm/error.log