Heroku Craft Docker镜像文档

镜像概述

本Docker镜像专为Heroku平台设计，用于构建和运行Craft CMS应用。它集成了开发、测试及部署Craft应用所需的完整环境组件，简化了在Heroku上部署Craft项目的流程，确保环境一致性和部署效率。

核心功能与特性

• 基础环境：基于Heroku 24栈，完全兼容Heroku平台运行标准
• Web服务：内置Nginx，提供高性能HTTP请求处理能力
• PHP环境：PHP 8.3.x版本，包含关键扩展：
  • Redis：支持Redis缓存和会话管理，提升应用性能
  • Imagick：提供高级图像处理功能，满足Craft CMS媒体资源处理需求
• 依赖管理：集成Composer 2.x，用于PHP依赖包的安装与管理
• 前端工具链：包含Node 18.x和Yarn 1.22.x，支持前端资源构建、打包与依赖管理
• 浏览器自动化：内置Chrome浏览器和ChromeDriver，支持Selenium等自动化测试框架

使用场景

• 在Heroku平台开发、测试和部署Craft CMS应用
• 需要完整LAMP-like环境（Nginx+PHP）的Craft项目容器化部署
• 包含前端构建流程（如JavaScript/CSS打包）的Craft应用
• 需要浏览器自动化测试能力的Craft应用开发与测试

使用方法

基础使用

在项目Dockerfile中直接引用本镜像作为基础镜像：

FROM nerdsandcompany/docker-heroku-craft

# 可选：复制应用代码到镜像
COPY . /app

# 可选：安装PHP依赖
RUN composer install --no-dev

# 可选：构建前端资源
RUN yarn install && yarn build

构建与部署到Heroku

1. 准备环境：确保本地安装Docker和Heroku CLI
2. 构建镜像：

   docker build -t craft-heroku-app .
   

3. 登录Heroku容器注册表：

   heroku container:login
   

4. 推送镜像到Heroku：

   heroku container:push web -a your-heroku-app-name
   

5. 部署镜像：

   heroku container:release web -a your-heroku-app-name
   

自定义配置

Nginx配置

如需修改Nginx配置，可通过Dockerfile覆盖默认配置：

# 复制自定义Nginx配置
COPY custom-nginx.conf /etc/nginx/conf.d/default.conf

环境变量配置

通过Heroku应用配置或Dockerfile设置环境变量（如数据库连接、Craft环境等）：

# Dockerfile中设置环境变量
ENV CRAFT_ENVIRONMENT=production
ENV DB_USER=your_db_user
ENV DB_PASSWORD=your_db_password

或通过Heroku CLI设置：

heroku config:set CRAFT_ENVIRONMENT=production -a your-heroku-app-name