在Windows上搭建Drupal开发环境基于WSL的Ubuntu+Apache+PHP+MariaDB+Drush详细教程

欢迎来到Drupal开发环境搭建教程！本文专为Windows用户设计，通过WSL安装Drupal，逐步引导你配置一个完整的Windows搭建Drupal开发环境，并掌握Drush使用教程。无论你是Drupal新手还是经验丰富的开发者，这篇保姆级指南都能帮助你快速上手。

1. 准备工作：启用WSL并安装Ubuntu

首先，确保Windows系统版本支持WSL2（Windows 10 2004及以上或Windows 11）。以管理员身份打开PowerShell或CMD，执行以下命令启用WSL功能：

    dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestartdism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart  

重启电脑后，在Microsoft官网下载并安装WSL2内核更新包。然后将WSL2设置为默认版本：

    wsl --set-default-version 2  

接下来，在Microsoft Store中搜索“Ubuntu”并安装最新LTS版本（如Ubuntu 22.04）。安装后启动Ubuntu，设置用户名和密码，完成初始化。

2. 更新系统并安装基础工具

进入Ubuntu终端，首先更新软件包列表并升级现有软件：

    sudo apt update && sudo apt upgrade -y  

安装必要工具，如curl、wget、git等：

    sudo apt install -y curl wget git unzip  

3. 安装Apache Web服务器

执行以下命令安装Apache：

    sudo apt install -y apache2  

启动Apache并设置开机自启：

    sudo systemctl start apache2sudo systemctl enable apache2  

在Windows浏览器中访问 http://localhost，如果看到Apache默认页面，说明安装成功。

4. 安装PHP及所需扩展

Drupal推荐使用PHP 8.1或更高版本。添加第三方仓库以获取最新PHP：

    sudo add-apt-repository -y ppa:ondrej/phpsudo apt update  

安装PHP 8.1及常用扩展：

    sudo apt install -y php8.1 php8.1-cli php8.1-common php8.1-mysql php8.1-zip php8.1-gd php8.1-mbstring php8.1-curl php8.1-xml php8.1-bcmath php8.1-json php8.1-tokenizer php8.1-bz2 php8.1-intl php8.1-ldap php8.1-sqlite3 php8.1-soap  

安装完成后，重启Apache使PHP生效：

    sudo systemctl restart apache2  

创建PHP测试文件验证安装：

    echo "" | sudo tee /var/www/html/info.php  

访问 http://localhost/info.php，应显示PHP信息页面。

5. 安装MariaDB数据库

MariaDB是MySQL的替代品，Drupal支持良好。安装MariaDB服务器和客户端：

    sudo apt install -y mariadb-server mariadb-client  

启动MariaDB并设置开机自启：

    sudo systemctl start mariadbsudo systemctl enable mariadb  

运行安全安装脚本，设置root密码并移除匿名用户等：

    sudo mysql_secure_installation  

按照提示操作，建议设置root密码（例如：root），其他选项根据需求选择。

6. 为Drupal创建数据库

登录MariaDB：

    sudo mysql -u root -p  

输入root密码后，执行以下SQL创建Drupal专用数据库和用户：

    CREATE DATABASE drupal CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;CREATE USER "drupaluser"@"localhost" IDENTIFIED BY "your_password";GRANT ALL PRIVILEGES ON drupal.* TO "drupaluser"@"localhost";FLUSH PRIVILEGES;EXIT;  

请将 your_password 替换为安全密码。

7. 下载并安装Drupal

进入Apache网站根目录：

    cd /var/www/html  

删除默认的index.html（可选）：

    sudo rm index.html  

使用wget下载Drupal最新版本（以10.2.x为例）：

    sudo wget https://www.drupal.org/download-latest/tar.gz -O drupal.tar.gzsudo tar -xzf drupal.tar.gz --strip-components=1sudo rm drupal.tar.gz  

设置正确的文件权限：

    sudo chown -R www-data:www-data /var/www/htmlsudo chmod -R 755 /var/www/html  

8. 通过Web界面安装Drupal

在Windows浏览器中访问 http://localhost，进入Drupal安装向导。选择语言后，安装配置文件选择“标准”。数据库配置页面，填写之前创建的数据库信息：

• 数据库类型： MySQL、MariaDB或等价
• 数据库名称： drupal
• 数据库用户名： drupaluser
• 数据库密码： 你设置的密码

继续后续步骤，设置站点名称、管理员账户等，完成安装。

9. 安装Drush（Drupal Shell）

Drush是Drupal的命令行工具，能极大提高开发效率。我们通过Composer安装Drush。首先安装Composer：

    cd ~php -r "copy("https://getcomposer.org/installer", "composer-setup.php");"php composer-setup.phpphp -r "unlink("composer-setup.php");"sudo mv composer.phar /usr/local/bin/composer  

验证Composer安装：

    composer --version  

然后在Drupal根目录中全局安装Drush（也可以作为项目依赖）：

    cd /var/www/htmlcomposer require drush/drush  

或者全局安装以便在任意目录使用：

    composer global require drush/drushexport PATH="$HOME/.config/composer/vendor/bin:$PATH"  

将上述export命令添加到 ~/.bashrc 中以永久生效。

测试Drush：

    drush status  

如果显示Drupal版本和数据库连接信息，说明Drush安装成功。

10. 后续优化与常用命令

现在你已拥有一个完整的Drupal开发环境搭建。通过WSL安装Drupal后，可以无缝在Windows和Linux文件系统间操作。记住常用Drush命令：

• drush cr – 清除缓存
• drush updb – 更新数据库
• drush en module_name – 启用模块
• drush pmu module_name – 卸载模块

至此，你已成功在Windows上通过WSL配置了Ubuntu+Apache+PHP+MariaDB+Drupal+Drush开发环境，开始你的Drupal开发之旅吧！

关键词：Drupal开发环境搭建、WSL安装Drupal、Windows搭建Drupal、Drush使用教程