dockerwest/nginx-laravel

Dockerwest Nginx Laravel 5 镜像

镜像概述与主要用途

Dockerwest Nginx Laravel 5 镜像是专为 Laravel 5 应用设计的 Nginx 容器镜像，提供 Web 服务器运行环境。该镜像不包含 Laravel 框架本身，需配合外部 Laravel 5 应用代码（通过挂载或集成）使用，主要作为 Laravel 5 应用的生产环境 Web 服务器，处理 HTTP 请求、静态资源服务及 PHP-FPM 代理。

核心功能与特性

预设文档根目录

• 符合 Laravel 生产环境推荐配置，文档根目录固定为 <your laravel project>/public，确保 Laravel 应用的静态资源（如 CSS、JS、图片）和入口文件（index.php）可被 Nginx 正确访问。

灵活的配置扩展

• 支持通过外部文件覆盖或添加 Nginx 配置：默认服务器配置中包含 /etc/nginx/include/overrides.conf 文件，可挂载自定义配置文件至该路径，实现如维护页面、客户端请求体大小限制（client_max_body_size）等个性化配置。

自适应 DNS 解析

• 通过 DNS_RESOLVER 环境变量配置 Nginx 的 DNS 解析策略，确保在 PHP-FPM 容器可用前，Nginx 能正确解析应用容器名称，避免启动依赖问题。

使用场景与适用范围

• Laravel 5 应用部署：作为生产或开发环境的 Web 服务器，配合 PHP-FPM 容器（运行 Laravel 应用）构建完整服务架构。
• 需要自定义 Nginx 配置的场景：如设置维护页面、调整请求大小限制、添加自定义 HTTP 头或重写规则等。
• Docker 容器化部署：适用于 Docker 单机部署或容器编排（如 Docker Compose、Kubernetes）环境，需与 Laravel 应用代码及 PHP-FPM 服务协同工作。

配置参数与环境变量

DNS_RESOLVER

• 作用：配置 Nginx 的 DNS 解析器，确保 Nginx 能解析 Laravel 应用容器（如 PHP-FPM 容器）的主机名。
• 取值：
  • auto（默认）：使用容器内 /etc/resolv.conf 中的 DNS 解析器（通常为 Docker 内部 DNS 服务）。
  • 具体 IPv4 地址：指定外部 DNS 服务器（如 8.8.8.8、114.114.114.114）。

使用方法与配置说明

基础使用（Docker Run）

启动容器并挂载 Laravel 项目的 public 目录（需提前确保 Laravel 项目目录存在）：

sh
docker run -d \
  -p 80:80 \
  -v /path/to/laravel-project/public:/var/www/html/public \  # 挂载 Laravel 项目 public 目录
  dockerwest/nginx-laravel:<version>

自定义 Nginx 配置

通过挂载 overrides.conf 文件添加或覆盖配置（如设置维护页面或请求体大小）：

1. 创建自定义配置文件 overrides.conf（示例内容）：

   nginx
   # 维护页面配置
   location /maintenance {
     root /var/www/html/public;
     try_files $uri $uri/ /maintenance.html;
   }
   
   # 调整客户端请求体大小限制
   client_max_body_size 100M;
   

2. 启动容器时挂载该文件：

   sh
   docker run -d \
     -p 80:80 \
     -v /path/to/laravel-project/public:/var/www/html/public \
     -v /path/to/overrides.conf:/etc/nginx/include/overrides.conf \  # 挂载自定义配置
     -e DNS_RESOLVER=auto \  # 可选：配置 DNS 解析器
     dockerwest/nginx-laravel:<version>
   

Docker Compose 部署示例

配合 PHP-FPM 容器（运行 Laravel 应用）构建完整服务：

yaml
version: '3.8'

services:
  nginx:
    image: dockerwest/nginx-laravel:stable  # 使用稳定版 Nginx
    ports:
      - "80:80"
    volumes:
      - ./laravel-project/public:/var/www/html/public  # 挂载本地 Laravel 项目 public 目录
      - ./nginx-overrides.conf:/etc/nginx/include/overrides.conf  # 挂载自定义 Nginx 配置
    environment:
      - DNS_RESOLVER=127.0.0.11  # 使用 Docker 内部 DNS（默认 /etc/resolv.conf 通常指向此地址）
    depends_on:
      - php  # 依赖 PHP-FPM 容器启动

  php:
    image: dockerwest/php-laravel:7.4  # 示例：运行 Laravel 的 PHP-FPM 镜像（需根据实际选择）
    volumes:
      - ./laravel-project:/var/www/html  # 挂载 Laravel 项目代码
    environment:
      - APP_ENV=production  # Laravel 环境变量

版本信息

镜像提供以下版本标签，对应不同 Nginx 版本：

• stable：Nginx 最新稳定版
• mainline：Nginx 最新主线版

许可证

本镜像基于 MIT 许可证开源。详见 许可证文件。