shinsenter/laravel

shinsenter/laravel 镜像文档

概述

生产就绪的PHP/Laravel Docker镜像，具备自动Laravel安装功能。支持通过环境变量轻松配置PHP和PHP-FPM设置，无需重建镜像即可调整配置。包含最新版本的Composer，方便快速启动项目。提供Debian和Alpine两种版本。

• Docker Hub: https://hub.docker.com/r/shinsenter/laravel
• GitHub Packages: https://code.shin.company/php/pkgs/container/laravel
• 还可查看 https://hub.docker.com/u/shinsenter%E3%80%82

核心功能与特性

• 自动Laravel安装：挂载空目录到容器时，自动下载框架源代码，快速初始化新项目
• 环境变量配置：通过环境变量配置PHP和PHP-FPM，无需修改Dockerfile或重建镜像
• 内置Composer：包含最新Composer，方便项目依赖管理和安装
• 多版本支持：提供Debian和Alpine两种基础镜像版本，满足不同需求
• HTTPS支持：内置SSL测试证书，支持替换为自定义证书以实现生产环境HTTPS
• 服务控制：通过环境变量启用Laravel队列worker、调度器、Horizon等服务

使用场景

• 快速创建新的Laravel项目，自动完成框架代码初始化
• 部署现有Laravel项目到生产环境，简化配置流程
• 需要灵活调整PHP配置的场景，避免频繁重建镜像
• 生产环境中需要HTTPS加密的部署场景
• 需要控制Laravel服务（如队列处理、定时任务）的应用场景

使用方法

创建新项目

当将空目录挂载到容器时，容器会自动下载Laravel框架源代码，快速引导新项目。

操作步骤

1. 在主机创建空目录用于存放项目代码：

shell
mkdir laravel

2. 运行容器并将空目录挂载为卷：

shell
docker run -p 80:80 -p 443:443 -p 443:443/udp \
    -v ./laravel:/var/www/html \
    docker.xuanyuan.run/shinsenter/laravel:latest

容器会检测到挂载到/var/www/html的空目录，并自动克隆Laravel框架源代码到该目录。

使用现有项目

将主机上的现有Laravel项目目录挂载到容器的/var/www/html目录即可。由于源代码以卷的形式挂载，主机上的修改会实时反映到容器中，方便在容器内运行构建、测试等任务。

HTTPS配置

镜像包含预生成的SSL证书用于本地测试。生产环境中需替换为有效的SSL证书，可通过以下方式实现：

使用Dockerfile

Dockerfile
FROM docker.xuanyuan.run/shinsenter/laravel:latest

# 复制自定义证书到容器
COPY my_domain.crt /etc/ssl/site/server.crt
COPY my_domain.key /etc/ssl/site/server.key

# 添加自定义指令，例如：
# ADD --chown=$APP_USER:$APP_GROUP ./laravel/ /var/www/html/

使用docker run

shell
docker run -p 80:80 -p 443:443 -p 443:443/udp \
    -v ./laravel:/var/www/html \
    -v ./my_domain.crt:/etc/ssl/site/server.crt \
    -v ./my_domain.key:/etc/ssl/site/server.key \
    docker.xuanyuan.run/shinsenter/laravel:latest

使用docker-compose

yaml
services:
  web:
    image: docker.xuanyuan.run/shinsenter/laravel:latest
    volumes:
      - ./laravel:/var/www/html
      - ./my_domain.crt:/etc/ssl/site/server.crt
      - ./my_domain.key:/etc/ssl/site/server.key

环境变量

可通过设置以下环境变量来启用容器中与Web服务器一起运行的特定服务。

📝 注意：对于Laravel Pulse、Laravel Horizon或Laravel Reverb等功能，需要自行安装所需包并创建必要的配置。

稳定镜像标签

https://code.shin.company/php%E7%9A%84%E5%8F%91%E5%B8%83%E7%89%88%E6%9C%AC%E4%B8%8D%E4%BF%9D%E8%AF%81%E4%BB%8E%E7%9B%B8%E5%90%8C%E6%BA%90%E4%BB%A3%E7%A0%81%E6%9E%84%E5%BB%BA%E7%9A%84Docker%E9%95%9C%E5%83%8F%E5%A7%8B%E7%BB%88%E5%AE%8C%E5%85%A8%E4%B8%80%E8%87%B4%E3%80%82%E6%88%91%E4%BB%AC%E6%AF%8F%E5%A4%A9%E6%9E%84%E5%BB%BA%E6%96%B0%E7%9A%84Docker%E9%95%9C%E5%83%8F%EF%BC%8C%E4%BB%A5%E7%A1%AE%E4%BF%9D%E5%85%B6%E5%8C%85%E5%90%ABPHP%E3%80%81%E5%9F%BA%E7%A1%80%E6%93%8D%E4%BD%9C%E7%B3%BB%E7%BB%9F%E3%80%81Composer%E7%AD%89%E7%9A%84%E6%9C%80%E6%96%B0%E4%B8%8A%E6%B8%B8%E6%9B%B4%E6%96%B0%EF%BC%8C%E7%9B%B8%E5%90%8C%E6%A0%87%E7%AD%BE%E7%9A%84%E9%95%9C%E5%83%8F%E4%BC%9A%E5%AE%9A%E6%9C%9F%E6%9B%B4%E6%96%B0%E3%80%82

若需使用稳定版本，可拉取shinsenter/laravel:latest镜像并标记为稳定版本（如your-repo/laravel:stable），命令如下：

shell
docker pull docker.xuanyuan.run/shinsenter/laravel:latest
docker tag  shinsenter/laravel:latest your-repo/laravel:stable
docker push your-repo/laravel:stable

然后使用your-repo/laravel:stable作为基础镜像构建生产环境容器。

贡献

如果您觉得这些镜像有用，可通过***，或在https://code.shin.company/php/issues/new%E6%8F%90%E4%BA%A4issue%E3%80%82%E6%82%A8%E7%9A%84%E6%94%AF%E6%8C%81%E6%9C%89%E5%8A%A9%E4%BA%8E%E7%BB%B4%E6%8A%A4%E5%92%8C%E6%94%B9%E8%BF%9B%E8%BF%99%E4%BA%9B%E7%A4%BE%E5%8C%BA%E9%95%9C%E5%83%8F%E3%80%82

许可协议

本项目基于https://code.shin.company/php/blob/main/LICENSE%E8%AE%B8%E5%8F%AF%E3%80%82%E6%84%9F%E8%B0%A2%E6%82%A8%E8%AE%A4%E5%8F%AF%E6%9C%AC%E9%A1%B9%E7%9B%AE%E8%83%8C%E5%90%8E%E7%9A%84%E6%99%BA%E5%8A%9B%E6%88%90%E6%9E%9C%EF%BC%8C%E5%A6%82%E4%BD%BF%E7%94%A8%E6%88%96%E5%80%9F%E9%89%B4%E6%9C%AC%E9%A1%B9%E7%9B%AE%E7%9A%84%E4%BB%BB%E4%BD%95%E6%83%B3%E6%B3%95%EF%BC%8C%E6%95%AC%E8%AF%B7%E7%BB%99%E4%BA%88%E9%80%82%E5%BD%93%E7%9A%84%E7%BD%B2%E5%90%8D%E3%80%82

---

来自越南 🇻🇳 的爱。