docker-laravel-alpine 镜像文档

镜像概述与主要用途

docker-laravel-alpine是一个专为Laravel框架设计的Docker镜像，基于Alpine Linux构建，旨在提供轻量、高效的Laravel开发与运行环境。该镜像预配置Composer包管理器及hirak/prestissimo插件以加速依赖安装，支持Laravel 5.x、6.x、7.x、8.x等版本。部分标签（-node-browsers）额外集成Node.js和Chromium浏览器，满足E2E测试需求。

DockerHub仓库地址：[***]

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 依赖加速：内置Composer及hirak/prestissimo插件，大幅提升依赖包下载速度
• 多版本兼容：支持Laravel 5.x、6.x、7.x、8.x框架版本
• 测试支持：-node-browsers标签集成Node.js和Chromium，可运行Laravel Dusk、Puppeteer、Cypress等E2E测试工具
• 版本灵活：提供多个PHP版本标签，满足不同项目环境需求

标签说明

镜像通过标签区分不同配置，主要标签及含义如下：

基础标签（不含浏览器环境）

• 7.4.8、latest（默认最新版，PHP 7.4.8）
• 7.4.7、7.4.6、7.4.5、7.4.4、7.4.2、7.4.1（各PHP 7.4.x版本）
• 7.3.11（PHP 7.3.11版本）
• 7.1、7.1-opcache（PHP 7.1版本，含OPcache优化）
• 7.0.10（PHP 7.0.10版本）

-node-browsers标签（含Node.js和Chromium）

包含Node.js运行环境和Chromium浏览器，支持E2E测试：

• 7.4.8-node-browsers、7.4.7-node-browsers、7.4.6-node-browsers、7.4.5-node-browsers、7.4.4-node-browsers、7.4.2-node-browsers、7.4.1-node-browsers、7.3.11-node-browsers（对应PHP版本+浏览器环境）
• 7.4.3-node-browsers、node-browsers（浏览器环境默认标签，PHP 7.4.3）

使用场景与适用范围

• Laravel应用的开发、测试及生产环境部署
• 需要快速初始化Laravel项目的场景（依赖Composer加速安装）
• 集成E2E测试的开发流程（如使用Laravel Dusk进行浏览器自动化测试）
• 对镜像体积和资源占用有要求的轻量化部署需求

使用方法与配置说明

拉取镜像

根据需求选择标签拉取：

# 拉取最新基础版（PHP 7.4.8）
docker pull shufo/laravel-alpine:latest

# 拉取带浏览器环境的版本（默认PHP 7.4.3）
docker pull shufo/laravel-alpine:node-browsers

# 拉取指定PHP版本（如PHP 7.3.11）
docker pull shufo/laravel-alpine:7.3.11

基础使用示例（docker run）

运行容器并验证环境：

# 检查PHP版本
docker run -it --rm shufo/laravel-alpine:latest php -v

# 检查Composer版本（基础版）
docker run -it --rm shufo/laravel-alpine:latest composer -v

# 检查Node.js版本（浏览器环境版）
docker run -it --rm shufo/laravel-alpine:node-browsers node -v

Docker Compose配置示例

创建docker-compose.yml配置文件，集成Laravel项目：

version: '3'
services:
  laravel-app:
    image: shufo/laravel-alpine:node-browsers  # 使用带浏览器环境的版本
    volumes:
      - ./laravel-project:/app  # 挂载本地Laravel项目目录
    working_dir: /app
    ports:
      - "8000:8000"  # 映射端口
    command: php artisan serve --host=0.0.0.0  # 启动Laravel开发服务器

启动服务：

docker-compose up -d

版本选择建议

• 开发环境：优先使用latest标签获取最新功能，或根据项目PHP版本选择对应标签
• E2E测试环境：使用node-browsers或具体版本的-node-browsers标签
• 生产环境：选择固定PHP版本标签（如7.4.8）以确保环境稳定性