sforward/laravel

镜像概述

该Docker镜像是为Laravel应用程序设计的通用容器化解决方案，旨在解决Laravel应用部署过程中的环境一致性问题，简化容器化流程。镜像集成了Laravel运行所需的核心依赖组件（如PHP、Web服务器、数据库客户端等），提供开箱即用的运行环境，支持从开发到生产环境的全流程应用部署。

核心功能与特性

1. 标准化运行环境

• 内置与Laravel版本兼容的PHP运行时（支持PHP 7.4+，具体版本可通过镜像标签指定）
• 集成Nginx作为Web服务器，配置优化以适配Laravel路由规则
• 包含Composer工具，支持依赖安装与更新
• 预装Laravel核心扩展（如PDO、mbstring、openssl等）

2. 灵活配置能力

• 支持通过环境变量自定义应用配置（如数据库连接、缓存驱动、APP_KEY等）
• 允许挂载外部配置文件（如.env、Nginx配置、PHP.ini）覆盖默认设置
• 支持多阶段构建，可按需裁剪镜像体积

3. 兼容性与扩展性

• 兼容Laravel 6.x及以上版本（需根据Laravel版本选择对应PHP版本的镜像）
• 支持主流数据库驱动（MySQL、PostgreSQL、SQLite等）
• 可集成Redis、Memcached等缓存服务，满足Laravel性能优化需求

使用场景

1. 开发环境快速搭建

• 本地开发时，通过容器化环境避免"开发机环境差异"问题，确保团队成员使用一致的运行环境
• 支持代码热更新（通过挂载项目目录实现），加速开发调试流程

2. 测试与CI/CD流程

• 在自动化测试或CI/CD pipeline中，作为标准运行环境部署Laravel应用，确保测试结果与生产环境一致
• 支持快速启停，适合临时测试环境搭建

3. 生产环境部署

• 简化生产环境配置，通过环境变量注入敏感信息（如数据库密码、API密钥），避免配置文件硬编码
• 支持配合Docker Compose或容器编排工具（K8s）实现规模化部署

使用方法与配置说明

快速启动（docker run）

通过以下命令快速运行Laravel应用（需提前准备Laravel项目代码）：

bash
docker run -d \
  --name laravel-app \
  -p 80:80 \
  -e APP_KEY=base64:your_laravel_app_key \
  -e APP_ENV=production \
  -e DB_CONNECTION=mysql \
  -e DB_HOST=mysql-service \
  -e DB_DATABASE=laravel_db \
  -e DB_USERNAME=laravel_user \
  -e DB_PASSWORD=your_db_password \
  -v /path/to/your/laravel/project:/app \
  laravel-generic-image:latest

参数说明：

• -p 80:80：将容器内80端口映射到主机80端口（Web服务端口）
• -v /path/to/your/laravel/project:/app：挂载本地Laravel项目目录到容器内/app（核心代码目录）
• 环境变量（-e）：注入Laravel运行所需的配置参数

Docker Compose配置示例

对于多服务依赖场景（如需搭配MySQL、Redis），推荐使用docker-compose.yml管理：

yaml
version: '3.8'

services:
  laravel:
    image: laravel-generic-image:latest
    ports:
      - "80:80"
    environment:
      - APP_KEY=base64:your_laravel_app_key
      - APP_ENV=production
      - DB_CONNECTION=mysql
      - DB_HOST=mysql
      - DB_DATABASE=laravel
      - DB_USERNAME=root
      - DB_PASSWORD=root_password
      - CACHE_DRIVER=redis
      - REDIS_HOST=redis
    volumes:
      - ./laravel-project:/app  # 本地Laravel项目目录
      - ./custom-nginx.conf:/etc/nginx/conf.d/default.conf  # 自定义Nginx配置（可选）
    depends_on:
      - mysql
      - redis

  mysql:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=root_password
      - MYSQL_DATABASE=laravel
    volumes:
      - mysql-data:/var/lib/mysql

  redis:
    image: redis:alpine
    volumes:
      - redis-data:/data

volumes:
  mysql-data:
  redis-data:

启动命令：docker-compose up -d

核心环境变量说明

自定义配置

1. 覆盖PHP配置

通过挂载自定义php.ini文件修改PHP配置：

bash
-v /path/to/your/php.ini:/usr/local/etc/php/php.ini

2. 自定义Nginx配置

Laravel的URL重写依赖Nginx配置，如需修改可挂载自定义Nginx配置文件：

bash
-v /path/to/your/nginx.conf:/etc/nginx/conf.d/default.conf

3. 扩展安装

如需安装额外PHP扩展，可基于该镜像构建自定义镜像（示例Dockerfile）：

dockerfile
FROM laravel-generic-image:latest
RUN docker-php-ext-install gd exif  # 安装GD库和Exif扩展

注意事项

1. APP_KEY生成：首次使用需通过php artisan key:generate生成APP_KEY，并通过环境变量传入容器
2. 目录权限：确保挂载的Laravel项目目录权限正确（容器内运行用户通常为www-data，需保证目录可读写）
3. 版本匹配：选择镜像标签时，需确保PHP版本与Laravel版本兼容（如Laravel 9需PHP 8.0+，对应镜像标签可使用laravel-generic-image:php8.0）
4. 生产环境优化：生产环境建议关闭APP_DEBUG，配置日志轮转，并通过反向代理（如Nginx、Traefik）处理SSL终结