Drupal开发容器

!GitHub last commit !Docker Pulls

!Docker (tag) !PHP (tag) !NodeJS (tag) !Drupal (tag) !Ubuntu (tag) !Apple silicon (tag) !VS Code (tag)

!Docker Stars !Docker Image Size (tag) !Docker Image Size (tag) !Docker Image Size (tag)

![Build & Publish Images]([] ![Update Container Description]([]

基于Microsoft PHP devcontainer镜像构建的Drupal开发容器。

使用说明

Devcontainer镜像是用于在容器内进行开发的镜像，预装了开发Drupal和Node.js项目所需的工具。

该镜像可独立使用，推荐配合alchatti/drupal-devcontainer与VS Code使用，以获得交互式开发体验，并自动安装必要的扩展。

基础Drupal项目示例可参考alchatti/drupal-devcontainer-sample-project。

容器的开发功能针对vscode用户配置，这是Microsoft基础镜像提供的非root用户。

Apache服务器将通过启动脚本中的apache2ctl start命令启动

Xdebug端口为9003，这是xdebug默认客户端端口。

快速开始：独立Drupal站点（用于测试和演示）

Drupal 10可使用SQLite安装，无需额外数据库容器。

为获得最佳开发体验，请以vscode用户启动容器。主机名drupal-dev可替换为其他名称。

1. 以交互模式启动容器（退出后自动删除），Docker将自动创建卷drupal-dev-html以持久化站点安装：

bash
docker run --rm -it \
-h "drupal-dev" \
-u "vscode" \
-p 80:80 \
-v "drupal-dev-html:/var/www/html" \
alchatti/drupal-devcontainer:8.1 fish

2. 容器初始化完成后，访问http://localhost可查看PHP信息页面。

3. 可使用init.sh命令创建新的Drupal 10站点。选择SQLite作为数据库选项可实现独立镜像运行。此脚本基于Acquia配置，也可手动设置Drupal。

bash
init.sh

4. Drupal安装完成后，访问http://localhost开始配置Drupal。

5. 演示场景下，选择“Demo: Umami Food Magazine (Experimental)”作为安装配置文件。

6. 数据库选择SQLite，数据库文件使用默认路径sites/default/files/.ht.sqlite。

7. 配置站点，设置admin用户名和密码。

8. 访问http://localhost即可查看Drupal站点。

9. 退出容器并停止服务：

bash
exit

• 删除创建的卷以重新开始：

bash
docker volume rm drupal-dev-html

其他使用选项和参数

• 通过环境变量POSH_THEME_ENVIRONMENT更改shell为zsh并设置主题为'blue-owl'，更多主题选项参见Oh My Posh主题：

bash
docker run --rm -it \
-e POSH_THEME_ENVIRONMENT='blue-owl' \
-h "drupal-dev" \
-u "vscode" \
-p 80:80 \
-v "drupal-dev-html:/var/www/html" \
alchatti/drupal-devcontainer:8.1 zsh

标签

特定版本构建的标签格式为$php-$datetime。

可用标签：

• 8.2：包含PHP 8.2、最新Node.js和构建时的最新Composer。
• 8.1：包含PHP 8.1、最新Node.js和构建时的最新Composer。

旧版/已弃用标签：

• 7.4：包含PHP 7.4、最新Node.js和构建时的最新Composer。（最后构建时间：2023年12月1日）

也可使用时间戳标签定位特定构建版本，详见[***]

镜像信息

该镜像针对PHP 8.1和8.2的最新版本构建，包含最新Node.js。

脚本

bash
# 以JSON格式打印镜像包版本/标签信息
about | jq
# 使用drush创建带时间戳的数据库转储，并存储到/var/www/html/dump目录
dump.sh
# 使用acli下载最新的Acquia云数据库备份
acli-dump.sh

预装软件包

基础镜像已包含Zsh、Apache、Xdebug、Composer，额外预装以下软件包：

• Drupal开发工具

  • Drush launcher
  • Drush 8（全局备用，适用于Drupal 7）
  • Drupal Coder

• Acquia工具

  • Acquia CLI（需PHP 8）
  • Acquia BLT launcher

• 前端开发工具

  • Node.js

• 终端增强工具：

  • zsh-autosuggestions
  • zsh-syntax-highlighting
  • fish
  • Oh My Posh（适用于Zsh和Fish）

• Git增强工具：

  • git-quick-stats：一种简单高效的Git仓库统计信息查看工具

环境变量

以下环境变量用于自定义配置：

bash
# Apache环境变量默认值
ENV APACHE_SERVER_NAME "localhost"
ENV APACHE_DOCUMENT_ROOT "docroot"
ENV WORKSPACE_ROOT "/var/www/html"
# Oh My Posh默认主题环境变量
ENV POSH_THEME_ENVIRONMENT "ys"

CI构建与标签

构建流程通过GitHub Actions工作流自动化，包含两个脚本：

• build.sh：根据PHP、Node、Sass版本构建镜像，参数如下：

  • -p：PHP版本（如7或8）
  • -n：Node.js版本，node表示最新版，--lts表示LTS版本

• test.sh：加载最新本地构建镜像

工作流按计划执行，也可在推送到main分支时触发，或通过GitHub手动触发。

参考链接

• Docker仓库：[***]
• 镜像问题、详情和源码：[***]

更新日志

2024年1月

• 功能：基础镜像更新至Debian 12（Bookworm）
• 功能：fish通过仓库安装
• 功能：GitHub Actions更新如下：
  • actions/checkout@v2→4
  • docker/setup-qemu-action@v2→3
  • docker/setup-buildx-action@v2.0.0→3
  • docker/build-push-action@v3→5
• CI：切换到peter-evans/dockerhub-description@v3（持续维护版本）
• 修复：在apache2.conf中通过PassEnv传递APACHE_DOCUMENT_ROOT和WORKSPACE_ROOT，以在/etc/apache2/sites-available/*.conf中生效

2023年12月

• 功能：添加git-quick-stats
• 功能：fish更新至3.6.4-1
• 功能：about脚本可打印基础镜像OS版本
• 功能：停止支持PHP 7.4版本

2023年1月

• 功能：支持PHP 8.1，弃用PHP 8.0
• 功能：支持Apple Silicon arm64架构（PHP 8.1和7.4）
• 功能：支持Drupal 10，更新安装脚本
• 功能：移除已弃用的Drupal Console
• 功能：更新GitHub Action工作流以支持多架构、标签和镜像推送
• 修复：fish与nvm的兼容性问题