darrencrossley/craftcms

Docker上的CraftCMS

镜像概述和主要用途

该Docker镜像用于在容器中运行CraftCMS内容管理系统。它不包含数据库服务，需依赖外部数据库，适用于开发和生产环境下的CraftCMS部署，简化环境配置和版本管理。

核心功能和特性

• 容器化封装CraftCMS，提供一致的运行环境
• 支持开发环境通过卷挂载实现本地代码实时更新
• 生产环境可通过Dockerfile构建自定义镜像
• 提供环境变量配置数据库连接参数

使用场景和适用范围

• 开发环境：本地开发CraftCMS项目，实时预览代码变更，无需复杂的本地环境配置
• 生产环境：部署CraftCMS应用到服务器，配合外部数据库使用

使用方法和配置说明

Dockerfile配置

在源代码文件夹中创建Dockerfile，用于构建自定义镜像：

dockerfile
FROM darrencrossley/craftcms:latest

COPY ./src/config /var/www/craft/config
COPY ./src/plugins /var/www/craft/plugins
COPY ./src/templates /var/www/craft/templates
COPY ./html /var/www/html

源代码文件夹结构要求：

• html 文件夹：存放Apache服务器的公共数据
• src 文件夹：存放CraftCMS核心数据，包含以下子文件夹：
  • config：配置文件
  • plugins：插件文件
  • templates：模板文件

开发环境

通过挂载卷实现本地代码与容器的实时同步，命令示例：

bash
docker run -d -P --name crafty-site \
  -v src/templates:/var/www/craft/templates \
  -v src/config:/var/www/craft/config \
  -v src/plugins:/var/www/craft/plugins \
  -v html:/var/www/html \
  darrencrossley/craftcms

此方式允许在本地编辑代码，同时在接近生产环境的容器中实时预览效果。

生产环境

使用上述Dockerfile构建生产环境镜像：

bash
# 构建镜像
docker build -t your-craftcms-production .

# 运行容器
docker run -d -P --name craft-production your-craftcms-production

环境变量配置

若使用镜像内置的配置，可通过以下环境变量设置数据库连接：

• DB_HOST：数据库主机地址
• DB_NAME：数据库名称
• DB_PASS：数据库密码
• DB_PORT：数据库端口（默认通常为3306）
• DB_USER：数据库用户名

待办事项

• 实现共享会话处理功能
• 当前版本依赖外部数据库服务
• 可能存在兼容性问题，需根据具体使用环境调整配置