sforward/laravel 镜像介绍及部署教程 - 轩辕镜像 | 国内开发者首选的Docker镜像加速服务平台

本站支持搜索的镜像仓库：Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

sforward/laravel

用于运行Laravel应用程序的通用Docker镜像，提供标准化部署环境，简化Laravel应用的容器化流程，支持快速构建和运行Laravel项目，确保环境一致性和部署效率。

1 收藏0 次下载activesforward镜像

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

中文简介版本下载

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

镜像概述

该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项目代码）：

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管理：

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

核心环境变量说明

环境变量名	说明	默认值	必要性
`APP_KEY`	Laravel应用加密密钥（必须手动生成）	无	必传
`APP_ENV`	应用环境（dev/test/production）	`production`	可选
`APP_DEBUG`	是否开启调试模式（true/false）	`false`	可选
`DB_CONNECTION`	数据库驱动（mysql/pgsql/sqlite等）	`mysql`	可选
`DB_HOST`	数据库主机地址	`localhost`	依赖数据库时必传
`DB_PORT`	数据库端口	3306（MySQL默认）	可选
`DB_DATABASE`	数据库名称	`laravel`	依赖数据库时必传
`DB_USERNAME`	数据库用户名	`root`	依赖数据库时必传
`DB_PASSWORD`	数据库密码	无	依赖数据库时必传

自定义配置

1. 覆盖PHP配置

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

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

2. 自定义Nginx配置

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

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

3. 扩展安装

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

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

注意事项

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