laravelfans/laravel

Laravel Docker镜像文档

镜像概述

Laravel Docker镜像是一个适用于生产和开发环境的容器化解决方案，基于官方PHP Apache镜像构建，每日自动更新以保持最新Laravel版本，简化Laravel应用的快速部署与开发流程。

核心功能和特性

• 基于官方镜像：构建于https://hub.docker.com/_/php%EF%BC%8C%E7%A1%AE%E4%BF%9D%E5%9F%BA%E7%A1%80%E7%8E%AF%E5%A2%83%E7%9A%84%E7%A8%B3%E5%AE%9A%E6%80%A7%E4%B8%8E%E5%85%BC%E5%AE%B9%E6%80%A7
• 每日自动更新：通过https://github.com/laravel-fans/laravel-docker/actions%E6%AF%8F%E6%97%A5%E6%9E%84%E5%BB%BA%E6%9C%80%E6%96%B0Laravel%E7%89%88%E6%9C%AC
• 透明化构建：提供完整Dockerfile源码：https://github.com/laravel-fans/laravel-docker/blob/main/src/stubs/Dockerfile

使用场景

• Laravel应用的快速部署（生产环境）
• 开发测试环境的快速搭建（本地开发、演示环境）
• 版本兼容性验证（支持Laravel 10、11及最新版本）

使用方法和配置说明

拉取镜像

支持拉取特定版本（10、11）或最新版本：

shell
# 拉取Laravel 10版本
docker pull docker.xuanyuan.run/laravelfans/laravel:10

# 拉取Laravel 11版本
docker pull docker.xuanyuan.run/laravelfans/laravel:11

# 拉取最新版本（默认标签）
docker pull docker.xuanyuan.run/laravelfans/laravel

运行镜像

基本运行

快速启动Laravel应用，映射容器80端口到本地8000端口：

shell
docker run -p 8000:80 docker.xuanyuan.run/laravelfans/laravel

启动后访问：http://127.0.0.1:8000

带环境变量配置运行

可通过环境变量自定义应用配置（如环境类型、数据库连接、应用密钥等）：

shell
docker run -p 8000:80 -e "APP_ENV=local" -e "DB_CONNECTION=sqlite" \
  -e "APP_KEY=base64:L+3avOYCfuq8nnDpHs74+5Et3sx27TssucHQIyqfpDY=" \
  docker.xuanyuan.run/laravelfans/laravel

常用环境变量说明：

• APP_ENV：应用环境类型，可选值包括local（本地开发）、production（生产环境）等
• DB_CONNECTION：数据库连接类型，支持sqlite、mysql、pgsql等Laravel兼容的数据库
• APP_KEY：Laravel应用密钥（必填），可通过php artisan key:generate生成

!Laravel应用界面