5分钟搭建专业Drupal开发环境：Drupal VM全攻略-优快云博客

5分钟搭建专业Drupal开发环境：Drupal VM全攻略

你是否还在为Drupal开发环境配置浪费数小时？本地环境与生产环境不一致导致的"在我电脑上能运行"问题是否反复出现？本文将带你通过Drupal VM（Virtual Machine，虚拟机）实现一键部署标准化开发环境，彻底解决这些痛点。

读完本文你将获得：

掌握Drupal VM的两种部署方案（Vagrant/VirtualBox与Docker）
学会根据项目需求定制开发环境配置
了解高级功能如XDebug调试、Varnish缓存的集成方法
解决常见环境一致性问题的实用技巧

Drupal VM简介

Drupal VM是一个基于Ansible构建的Drupal开发虚拟机，它能够快速创建标准化的开发环境，让开发者摆脱传统MAMP/WAMP环境的局限。该项目虽已停止维护，但十年间积累的成熟配置仍能为现代Drupal开发提供稳定支持。

核心组件栈

Drupal VM默认在Ubuntu 18.04系统上安装以下组件：

类别	可选组件
Web服务器	Apache、Nginx
编程语言	PHP（多版本可选）
数据库	MySQL、MariaDB、PostgreSQL
Drupal版本	7、8、9
开发工具	Drush、Drupal Console
缓存系统	Varnish、Memcached、Redis
搜索引擎	Apache Solr、Elasticsearch
调试工具	XDebug、Blackfire、Tideways
邮件测试	MailHog

工作原理

mermaid

快速开始：两种部署方案

方案一：Vagrant + VirtualBox（推荐）

前置条件

安装Vagrant（2.2.x版本）
安装VirtualBox（6.1.x版本）
（可选）安装Ansible以加速配置过程

部署步骤

获取项目代码

git clone https://gitcode.com/gh_mirrors/dr/drupal-vm.git
cd drupal-vm

初始化配置

cp default.config.yml config.yml

启动虚拟机

vagrant up

首次执行将下载Ubuntu基础镜像（约500MB）并安装所有组件，根据网络状况需5-10分钟。若中途失败，可执行vagrant provision继续配置。

访问环境

网站地址：http://drupalvm.test
默认管理员账号：admin/admin
数据库管理：http://drupalvm.test:8080（Adminer）
邮件测试：http://drupalvm.test:8025（MailHog）

常用Vagrant命令

命令	作用
`vagrant up`	启动并配置虚拟机
`vagrant halt`	关闭虚拟机
`vagrant ssh`	登录虚拟机
`vagrant provision`	重新应用配置
`vagrant destroy`	删除虚拟机
`vagrant status`	查看虚拟机状态

方案二：Docker部署

对于偏好容器化方案的开发者，Drupal VM提供Docker支持：

准备配置文件

cp example.docker-compose.yml docker-compose.yml

启动容器

docker-compose up -d

初始化Drupal

docker-compose exec drupal bash
composer create-project drupal/recommended-project:^9 /var/www/drupalvm/drupal

深度定制：配置详解

核心配置文件

Drupal VM的所有定制都通过config.yml文件实现，主要配置项包括：

# 项目名称
project_name: drupalvm

# Drupal设置
drupal_major_version: 9
drupal_site_name: "Drupal VM"
drupal_install_site: true
drupal_account_name: admin
drupal_account_pass: admin

# 组件选择
webserver: nginx
php_version: "7.4"
database: mysql
installed_extras:
  - drush
  - drupalconsole
  - xdebug
  - mailhog
  - redis

# 网络设置
vagrant_ip: 192.168.88.88
vagrant_hostname: drupalvm.test

# 同步文件夹
vagrant_synced_folders:
  - local_path: ./drupal
    destination: /var/www/drupalvm/drupal
    type: nfs

环境定制示例

1. 切换PHP版本

# config.yml
php_version: "8.1"
php_packages_extra:
  - php8.1-xml
  - php8.1-gd
  - php8.1-intl

执行vagrant provision使配置生效。

2. 配置Nginx + PHP-FPM

# config.yml
webserver: nginx
php_fpm_pool_user: www-data
php_fpm_pool_group: www-data

Nginx配置将自动应用，可在虚拟机内的/etc/nginx/sites-available/drupalvm.test查看。

3. 启用Redis缓存

# config.yml
installed_extras:
  - redis

# Drupal设置（settings.php）
$settings['cache']['default'] = 'cache.backend.redis';
$settings['redis.connection']['interface'] = 'PhpRedis';
$settings['redis.connection']['host'] = '127.0.0.1';

目录结构解析

drupal-vm/
├── config.yml           # 主配置文件
├── Vagrantfile          # Vagrant配置
├── provisioning/        # Ansible配置
│   ├── playbook.yml     # 主剧本
│   ├── roles/           # Ansible角色
│   └── tasks/           # 任务定义
├── drupal/              # Drupal代码目录（自动创建）
└── docs/                # 文档

高级功能应用

XDebug调试配置

启用XDebug：

# config.yml
installed_extras:
  - xdebug
xdebug_install: true
xdebug_remote_enable: 1
xdebug_remote_connect_back: 1

PHPStorm配置：
- 服务器配置：添加新服务器，地址为drupalvm.test，端口80
- 路径映射：本地drupal目录映射到/var/www/drupalvm/drupal
- 调试端口：9003

Varnish缓存集成

启用Varnish：

# config.yml
installed_extras:
  - varnish
varnish_listen_port: 80
nginx_listen_port: 8080

验证配置：

vagrant ssh
curl -I http://localhost
# 应显示 X-Varnish 响应头

多站点配置

# config.yml
drupal_major_version: 9
drupal_install_site: false
drupal_multisite:
  - site_name: site1
    site_url: site1.drupalvm.test
  - site_name: site2
    site_url: site2.drupalvm.test

然后手动安装每个站点：

vagrant ssh
cd /var/www/drupalvm/drupal
drush site-install standard --db-url=mysql://drupal:drupal@localhost/site1 -y
drush site-install standard --db-url=mysql://drupal:drupal@localhost/site2 -y

常见问题解决方案

性能优化

使用NFS同步文件夹（默认已配置）：

vagrant_synced_folders:
  - local_path: ./drupal
    destination: /var/www/drupalvm/drupal
    type: nfs

增加虚拟机资源：

vagrant_memory: 2048  # MB
vagrant_cpus: 2       # CPU核心数

网络问题

端口冲突：修改默认IP

vagrant_ip: 192.168.56.56  # 更换为其他未占用IP

DNS解析问题：手动添加hosts记录

192.168.88.88 drupalvm.test site1.drupalvm.test

环境一致性

版本锁定：

# 指定基础镜像版本
vagrant_box: geerlingguy/ubuntu1804
vagrant_box_version: 1.2.0

配置文件版本控制：将config.yml纳入项目Git管理

最佳实践

项目结构推荐

project-root/
├── .gitignore        # 忽略drupal目录
├── config.yml        # 项目特定配置
├── Vagrantfile       # 自定义Vagrant配置
├── provisioning/     # 项目特定Ansible任务
└── docs/             # 环境说明文档

备份策略

# 数据库备份脚本
vagrant ssh -c "drush sql-dump --result-file=/tmp/backup.sql"
scp -P 2222 vagrant@127.0.0.1:/tmp/backup.sql ./backups/

与CI/CD集成

可将Drupal VM配置作为项目基础环境，确保开发、测试与生产环境一致性：

# .gitlab-ci.yml示例
test:
  script:
    - composer install
    - cp config.ci.yml config.yml
    - vagrant up
    - vagrant ssh -c "cd /var/www/drupalvm/drupal && drush updb -y && drush cr"
    - ./run-tests.sh

总结与替代方案

Drupal VM通过Ansible实现了开发环境的代码化管理，解决了"在我电脑上能运行"的经典问题。尽管项目已停止维护，但其架构思想值得借鉴。对于需要更现代解决方案的团队，可考虑：

Lando：基于Docker的多平台开发环境
DDEV：专为Drupal优化的Docker环境
Docksal：用于PHP项目的Docker开发环境

无论选择哪种方案，核心目标都是实现环境配置的标准化、可复制化和版本化，从而提高开发效率并减少环境相关问题。

通过本文介绍的Drupal VM，你可以在5分钟内搭建起专业的Drupal开发环境，将更多时间专注于功能开发而非环境配置。立即尝试，体验标准化开发环境带来的效率提升！

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考