使用WSL2搭建本地Drupal环境详细步骤

使用WSL2搭建本地Drupal环境详细步骤

1.安装适用于 Linux 的 Windows 子系统

以管理员身份打开 PowerShell（“开始”菜单 >“PowerShell” >单击右键 >“以管理员身份运行”），然后输入以下命令：

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

2.检查运行 WSL 2 的要求

若要更新到 WSL 2，需要运行 Windows 10。

• 对于 x64 系统：版本 1903 或更高版本，内部版本为 18362.1049 或更高版本。

• 对于 ARM64 系统：版本 2004 或更高版本，内部版本为 19041 或更高版本。

3.启用虚拟机功能

以管理员身份打开 PowerShell 并运行：

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

这一步完成之后重启计算机

4.下载 Linux 内核更新包

下载最新包：

• 适用于 x64 计算机的 WSL2 Linux 内核更新包

运行上一步中下载的更新包。 （双击以运行 - 系统将提示你提供提升的权限，选择“是”以批准此安装。）

安装完成后，请继续执行下一步 - 在安装新的 Linux 分发时，将 WSL 2 设置为默认版本。 （如果希望将新的 Linux 安装设置为 WSL 1，请跳过此步骤。）

5.将 WSL 2 设置为默认版本

打开 PowerShell（这里不限制是否使用管理员运行），然后在安装新的 Linux 发行版时运行以下命令，将 WSL 2 设置为默认版本：

wsl --set-default-version 2

6.安装所选的 Linux 分发

打开 Microsoft Store，选择你偏好的 Linux 分发版，这里使用的是ubuntu.

7.使用Ubuntu

ubuntu安装完成之后，双击运行会弹命令框，这个过程需要等一会儿。随后会设置用户名和密码。完成之后就进入ubuntu的使用了。

注销命令

wsl --list --verbose

要带上版本
wsl --unregister Ubuntu-22.04

8.在Ubuntu中搭建Drupal运行环境需要安以下组件

1.Apache Web 服务器

2.PHP

3.MySql 或 MariaDB 数据库

4.Drupal

步骤1：更新系统

在开始安装过程之前，确保系统是最新的。

sudo apt update

sudo apt upgrade

步骤2：安装PHP以及Drupal所需的一些扩展

sudo apt install php libapache2-mod-php php-mysql php-gd php-xml php-mbstring php-curl php-zip

步骤3：安装Apache Web服务器

sudo apt install apache2

启动apache
sudo service apache2 start

查看apache运行状态
sudo service apache2 status

关闭apache
sudo service apache2 stop

重启apache
sudo service apache2 restart

步骤4：安装MySql

sudo apt install mysql-server

启动mysql
sudo service mysql start

关闭mysql
sudo service mysql stop

登录mysql
sudo mysql -u root -p

查看数据库
show databases;

CREATE DATABASE drupal_db;   //创建数据库
CREATE USER 'drupal_user'@'localhost' IDENTIFIED BY 'your_password';   //创建drupal_user用户
GRANT ALL PRIVILEGES ON drupal_db.* TO 'drupal_user'@'localhost';      //授予权限
FLUSH PRIVILEGES;           //刷新MySQL权限缓存
EXIT;                       //保存退出

步骤5：安装Composer

下载Composer：
curl -sS https://getcomposer.org/installer | php

将Composer移动到全局可用的位置：使用以下命令将Composer移动到全局可用的位置：
sudo mv composer.phar /usr/local/bin/composer

步骤6：安装drupal

方法一：使用Composer下载Drupal （推荐使用）

composer create-project drupal/recommended-project drupal

将Drupal安装文件移动到/var/www/html目录下：
sudo mv drupal /var/www/html/

修改my_drupal目录文件夹的权限
sudo chown -R www-data:www-data /var/www/html/drupal
sudo chmod -R 777 /var/www/html/drupal



composer create-project drupal/recommended-project:^9.5.10 drupal --no-interaction

在上面的命令中：
- `drupal/recommended-project` 是 Drupal 项目的基础模板，`^9.2.0` 表示要安装的 Drupal 版本为 9.2.0 或更高版本。
- `my-project` 是要安装 Drupal 的目录名称。
- `--no-interaction` 表示在安装过程中不需要进行人机交互。

执行该命令后，Composer 将下载并安装指定版本的 Drupal。安装完成后，你可以在 `my-project` 目录中找到 Drupal 项目文件。

注意：如果指定的 Drupal 版本不存在或不可用，Composer 将无法安装该版本并显示错误信息。

方法二：直接安装drupal

这里以drupal9为例
wget https://ftp.drupal.org/files/projects/drupal-9.2.4.tar.gz

解压缩文件
tar -xvzf drupal-9.2.4.tar.gz

将解压缩后的drupal文件移动到/var/www/html目录下
sudo mv drupal-9.2.4 /var/www/html

修改drupal-9.2.4目录文件夹的权限
sudo chown -R www-data:www-data /var/www/html/drupal-9.2.4
sudo chmod -R 777 /var/www/html/drupal-9.2.4

步骤7：配置Apache（可不用配置，可直接跳到步骤8）

创建一个新的Apache虚拟主机文件
sudo nano /etc/apache2/sites-available/drupal.conf

将以下内容粘贴至文件中，根据需求进行修改

<VirtualHost *:80>
    ServerAdmin 2593721917@qq.com
    DocumentRoot /var/www/html/drupal-9.2.4
    ServerName demo.com
    ServerAlias www.demo.com

    <Directory /var/www/html/drupal-9.2.4/>
        Options FollowSymlinks
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>


将2593721917@qq.com，demo.com，www.demo.com 替换为自己的邮箱和域名

启用新的虚拟主机文件，并禁用默认的虚拟主机文件：

sudo a2ensite drupal.conf

sudo a2dissite 000-default.conf

重启apache的重写模块，以支持Drupal的URL重写功能

sudo a2enmod rewrite

重启Apache服务以使更改生效

sudo service apache2 restart

步骤8：Drupal安装完成

去浏览器访问 localhost/drupal/core/install.php

开始安装Drupal