本教程适用于以下操作系统版本

  • Ubuntu 24.04 (Noble Numbat)
  • Ubuntu 22.04 (Jammy Jellyfish)

本页内容

  • 准备工作
  • 安装 Apache2 Web 服务器
  • 安装 MariaDB 服务器
  • 安装并配置 PHP 8.x
  • 安装 Composer
  • 下载 Drupal 最新版本
  • 为 Drupal 配置 Apache2 虚拟主机
  • 运行 Drupal Web 安装向导
  • 结语

Drupal 是一个基于 PHP 编写、遵循 GNU 通用公共许可证分发的免费开源 Web 内容管理系统。Drupal 提供了一个强大的内容管理工具,并带有用于多通道发布的复杂 API。Drupal 在至少 14% 的互联网排名前一万的网站中使用,它被全球企业行业、政府、教育和机构站点所采用。Drupal 提供了一个高度可扩展的系统,可与数字应用集成,并可用于为不同组织创建支持多语言的多个站点。

在本指南中,我将向您展示如何在 Ubuntu 22.04 系统上安装最新版本的 Drupal。本指南包括安装一些软件包依赖项,例如 Apache2 Web 服务器、MariaDB 数据库、PHP 8.1,以及作为 PHP 包管理工具的 Composer。这里的目标是您将完成 Drupal 在 LAMP 技术栈上的安装,并通过 SSL 证书加以保护。

准备工作

要完成本指南,您需要满足以下要求:

  • 一台 Ubuntu 22.04 服务器。本演示使用主机名为 'server-ubuntu' 且已启用 UFW 防火墙的 Ubuntu 服务器。
  • 一个具有管理员权限的非 root 用户。
  • 一个指向 Ubuntu 服务器 IP 地址的域名。

安装 Apache2 Web 服务器

第一步,您将通过 APT 从 Ubuntu 仓库安装 Apache Web 服务器。在撰写本文时,最新版本的 Drupal 9 至少需要 Apache v2.x。

Drupal 的大部分开发都在 Apache Web 服务器上运行,但也仍支持 Nginx 等其他 Web 服务器。

在安装软件包之前,请以您的非 root sudo 用户身份运行以下 apt 命令来更新并刷新您的软件包索引仓库。您也可以在服务器上直接使用 root 用户。

sudo apt update

现在通过运行以下 apt 命令来安装 Apache Web 服务器。系统会提示您确认安装 Apache,输入 Y 表示同意,然后按 ENTER。

sudo apt install apache2

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

接下来,使用以下 systemctl 命令来检查和验证 'apache2' 服务。

您应该会得到输出,表明 'apache2' 服务已 'enabled'(启用),并将在系统启动时自动运行。同时,您还会收到正在运行的 'apache2' 服务的状态输出。

sudo systemctl is-enabled apache2
sudo systemctl status apache2

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

最后,您需要将规则 "Apache Full" 添加到 UFW 防火墙。规则 "Apache Full" 将自动允许访问 HTTP 和 HTTPS 端口,这是 Apache 软件包默认包含的。

运行以下命令添加 "Apache Full" 规则。然后,检查并验证 UFW 防火墙的状态。您应该会收到输出,表明 "Apache Full" 规则已添加到 UFW 防火墙。

sudo ufw allow "Apache Full"
sudo ufw status

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

安装 MariaDB 服务器

Drupal 支持多种 RDBMS(关系型数据库管理系统),例如 MySQL/MariaDB、PostgreSQL 和 SQLite。在本示例中,您将使用 MariaDB 数据库服务器安装 Drupal。

当前最新版本的 Drupal 9 至少需要 MariaDB 服务器 v10.3.x。而最新版 Ubuntu 仓库提供 MariaDB 服务器 v10.6。

使用以下 apt 命令安装 MariaDB 服务器软件包。当系统提示确认安装时,输入 Y 确认,然后按 ENTER。

sudo apt install mariadb-server mariadb-client

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

MariaDB 服务器安装完成后,运行以下 systemctl 命令检查 'mariadb' 服务的状态。

您将收到输出,表明 'mariadb' 服务器已 'enabled'(启用),并将在系统启动/开机时自动运行。并且 'mariadb' 服务的当前状态为 'running'(正在运行)。

sudo systemctl is-enabled mariadb
sudo systemctl status mariadb

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

现在 'mariadb' 服务已运行,您需要设置并保护 MariaDB 服务器的安装。为此,您可以使用 MariaDB 服务器软件包提供的命令行工具 'mysql_secure_installation'。

运行以下命令开始配置并保护 MariaDB 服务器的安装。

sudo mysql_secure_installation

您现在将被提示回答以下问题:

  • 对于没有 root 密码的默认 MariaDB 服务器安装,当被问及密码时,按 ENTER。
  • MariaDB root 用户的本地身份验证默认是安全的,当被要求将身份验证方法更改为 'unix_socket' 时,输入 'n'。
  • 输入 'Y' 以创建一个新的 MariaDB root 密码。然后,输入您的 MariaDB root 用户的强密码并重复输入。
  • 当被要求禁用 MariaDB root 用户的远程身份验证时,输入 'Y' 表示同意。
  • 默认 MariaDB 服务器安装附带 'test' 数据库,并允许匿名用户访问它。对这两个设置都输入 'Y' 以删除默认数据库 'test' 并移除匿名权限。
  • 最后,输入 'Y' 确认重新加载表权限。

至此,您已经配置了 MariaDB root 密码并保护了 MariaDB 服务器的安装。现在您将为 Drupal 创建一个新数据库和用户。为此,您必须先通过 'mysql' 命令(MySQL/MariaDB 客户端)登录到 MariaDB shell。

使用以下 'mysql' 命令以 root 用户身份登录到 MariaDB shell。当提示输入密码时,输入您的 MariaDB root 密码。此外,如果您以系统 Linux 用户 'root' 身份运行此命令,也可以直接按 ENTER。

sudo mysql -u root -p

接下来,运行以下查询为 Drupal 创建一个新的 MariaDB 数据库和用户。在本示例中,您将创建数据库 'drupaldb',用户为 'drupal',密码为 'password'。您可以将 'password' 替换为您自己的强密码。

CREATE DATABASE drupaldb;
CREATE USER drupal@localhost IDENTIFIED BY 'password';
GRANT ALL ON drupaldb.* TO drupal@localhost WITH GRANT OPTION;
FLUSH PRIVILEGES;

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

现在运行另一条查询来检查 MariaDB 用户 'drupal@localhost' 的权限。然后,您可以通过 'quit' 查询退出 MariaDB shell,或者直接按 'Ctrl+d'。

您应该会收到输出,表明 MariaDB 用户 'drupal@localhost' 可以访问数据库 'drupaldb'。

SHOW GRANTS FOR drupal@localhost;
quit

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

安装并配置 PHP 8.x

在撰写本文时,最新版本的 Drupal 9 建议使用 PHP 8.x 进行安装。此外,您还需要安装一些额外的 PHP 扩展,例如用于缓存的 'php-apcu'、用于图像处理的 'php-gd'、作为 MariaDB 数据库驱动的 'php-mysql' 等。

在本示例中,您将安装 Ubuntu 仓库提供的 PHP 8.1。使用以下 'apt' 命令安装 PHP 8.1 以及所需的额外扩展和软件包。

当被要求确认安装时,输入 'Y' 表示同意并按 ENTER。

sudo apt install php php-apcu php-dev libapache2-mod-php libcurl4-openssl-dev php-cli php-mysql php-zip php-gd php-fpm php-json php-common php-intl php-mbstring php-curl php-xml php-pear php-tidy php-soap php-bcmath php-xmlrpc

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

PHP 安装完成后,您需要从 PECL(PHP 扩展社区库)仓库安装额外的 PHP 扩展 'uploadprogress'。为此,您可以使用 'php-pear' 软件包提供的 'pecl' 命令行。

'uploadprogress' 扩展被 Drupal 用来显示和跟踪文件上传的详细进度,其中包括预计剩余时间,以及在上传过程中访问文件内容。

使用以下 'pecl' 命令安装 PHP 扩展 'uploadprogress'。'pecl' 命令现在将下载 'uploadprogress' 扩展的源代码,并自动编译并安装该扩展。

sudo pecl install uploadprogress

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

安装完成后,运行以下命令为 'uploadprogress' PHP 扩展创建一个新的配置文件。

cat <<EOF | sudo tee /etc/php/8.1/mods-available/uploadprogress.ini
; configuration for php uploadprogress module
; priority 15
extension=uploadprogress.so
EOF

现在运行以下命令在您的 PHP 安装上启用 'uploadprogress' 扩展。

sudo ln -s /etc/php/8.1/mods-available/uploadprogress.ini /etc/php/8.1/apache2/conf.d/15-uploadprogress.ini

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

您现在已经完成了 Drupal 所有 PHP 软件包的安装。现在您需要通过编辑 'php.ini' 文件来设置您的 PHP 安装。

使用您的文本编辑器打开文件 '/etc/php/8.1/apache2/php.ini'。在本示例中,我们将使用 'nano'。

sudo nano /etc/php/8.1/apache2/php.ini

按如下更改部分选项。'memory_limit' 选项应根据服务器内存而定,'date.timezone' 选项应根据您所在的时区而定。

memory_limit = 512M
upload_max_filesize = 60M
max_execution_time = 300
date.timezone = Europe/Paris

完成后保存并关闭文件。

接下来,使用以下 systemctl 命令重启 'apache2' 服务,使 PHP 配置的新更改生效。

sudo systemctl restart apache2

既然您已经完成了 PHP 8.1 的安装和配置,现在可以通过创建 phpinfo 文件来验证安装。

运行以下命令创建一个新的 phpinfo 文件 '/var/www/html/info.php'。该文件包含 phpinfo 脚本,将在您的 Web 浏览器中显示 PHP 的详细配置。

cat <<EOF | sudo tee /var/www/html/info.php
<?php
phpinfo();
?>
EOF

最后,打开您的 Web 浏览器,访问您的 Ubuntu 服务器 IP 地址并跟随路径 URL '/info.php'(例如:http://192.168.5.100/info.php)。您应该会看到有关 PHP 8.1 安装的详细信息页面。

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

安装 Composer

Composer 是一个用于管理 PHP 包依赖项的命令行工具。您需要安装 Composer,它将用于安装 Drupal 安装所需的 PHP 软件包依赖项。

要安装 Composer,请运行以下命令。

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '55ce33d7678c5a611085589f1f3ddf8b3c52d662cd01d4ba75c0ee0459970c2200a51f492d557530c71c15d8dba01eae') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"

以下是所用每条命令的说明:

  • 第一条命令会将 Composer 安装脚本下载到 'composer-setup.php'。然后,第二条命令将验证安装脚本的哈希值。请确保您收到输出消息 'Installer verified'。
  • 最后两条命令将运行安装脚本并安装 Composer PHP 包依赖管理工具。之后,安装脚本 'composer-setup.php' 将被删除。
  • 最后,您将在当前工作目录中获得 Composer 二进制文件 'composer.phar'。

接下来,运行以下命令将二进制文件 'composer.phar' 移动到 '/usr/local/bin/composer'。此操作将允许所有用户执行 'composer' 命令。

sudo mv composer.phar /usr/local/bin/composer

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

您现在可以运行 'composer' 命令来检查并验证您的安装。以下命令将显示 Composer 命令的详细帮助页面。

composer --help

下载 Drupal 最新版本

由于您已经安装了 Drupal 的所有软件包依赖项,现在您将下载 Drupal 源代码并通过 Composer 安装 PHP 包依赖项。

使用以下 wget 命令下载最新版本的 Drupal。您将在当前工作目录中看到文件 'drupal.tar.gz'。

wget https://www.drupal.org/download-latest/tar.gz -O drupal.tar.gz

现在通过以下 tar 命令解压文件 'drupal.tar.gz'。然后,将解压出来的 drupal 目录移动到 '/var/www/drupal'。该目录将用作您 Drupal 安装的 'Document-root'(文档根)目录。

tar -xvf drupal.tar.gz
mv drupal-* /var/www/drupal

接下来,使用以下命令更改 Drupal 安装目录 '/var/www/drupal' 的所有权和权限。所有权必须是用户和组 'www-data',普通用户权限为 '755'。

sudo chown -R www-data:www-data /var/www/drupal/
sudo chmod -R 755 /var/www/drupal/

现在切换到 '/var/www/drupal' 目录,并如下运行 composer 命令,为您的 Drupal 安装安装所有 PHP 依赖项。

cd /var/www/drupal
sudo -u www-data composer install --no-dev

为 Drupal 配置 Apache2 虚拟主机

在您下载 Drupal 并安装了 PHP 包依赖项之后,现在您将为您的 Drupal 安装设置并配置 Apache 虚拟主机。

在开始配置虚拟主机之前,请确保将用于 Drupal 的域名指向您的服务器 IP 地址。同时,请确保您的 SSL 证书已准备就绪。

运行以下 a2enmod 命令为您的 Drupal 启用一些 Apache2 模块。

sudo a2enmod rewrite ssl headers deflate

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

现在使用以下命令为 drupal 创建一个新的虚拟主机文件 '/etc/apache2/sites-available/drupal.conf'。本示例使用 'nano' 编辑器。

sudo nano /etc/apache2/sites-available/drupal.conf

添加以下 Drupal 虚拟主机的完整配置。请务必更改域名和 SSL 证书的路径。在本演示中,我们将对 Drupal 安装使用域名 'example.local'。

<VirtualHost *:80>
    ServerName example.local
    ServerAdmin 
[email protected]
    # Redirect Requests to SSL
    Redirect permanent "/" "https://example.local/"
    ErrorLog ${APACHE_LOG_DIR}/example.local.error.log
    CustomLog ${APACHE_LOG_DIR}/example.local.access.log combined
</VirtualHost>
<IfModule mod_ssl.c>
    <VirtualHost _default_:443>
        ServerName example.local
        ServerAdmin 
[email protected]
        DocumentRoot /var/www/drupal
        # Add security
        php_flag register_globals off
        ErrorLog ${APACHE_LOG_DIR}/example.local.error.log
        CustomLog ${APACHE_LOG_DIR}/example.local.access.log combined
        SSLEngine on
        SSLCertificateFile /etc/letsencrypt/live/example.local/fullchain.pem
        SSLCertificateKeyFile /etc/letsencrypt/live/example.local/privkey.pem
        <FilesMatch "\.(cgi|shtml|phtml|php)$">
                SSLOptions +StdEnvVars
        </FilesMatch>
        <Directory /var/www/drupal>
                Options FollowSymlinks
                #Allow .htaccess
                AllowOverride All
                Require all granted
                <IfModule security2_module>
                        SecRuleEngine Off
                        # or disable only problematic rules
                </IfModule>
        </Directory>
        <Directory /var/www/drupal/>
            RewriteEngine on
            RewriteBase /
            RewriteCond %{REQUEST_FILENAME} !-f
            RewriteCond %{REQUEST_FILENAME} !-d
            RewriteRule ^(.*)$ index.php?q=$1 [L,QSA]
        </Directory>
    </VirtualHost>
</IfModule>

完成后保存您的配置并关闭文件。

接下来,运行以下命令激活 'drupal.conf' 虚拟主机文件。然后,测试并验证您的 Apache 配置。如果您的 Apache 配置正确,您将收到类似 'Syntax OK' 的输出消息。

sudo a2ensite drupal.conf
sudo apachectl configtest

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

最后,重启 'apache2' 服务以使新更改和新虚拟主机文件生效。您现在可以通过域名和 Web 浏览器访问 Drupal 安装程序。

sudo systemctl restart apache2

运行 Drupal Web 安装向导

要访问 Drupal 安装程序,请打开您的 Web 浏览器并访问您的 Drupal 安装的域名(例如:https://example.local/)。

在语言设置中,选择您偏好的语言并点击 'Save and continue'(保存并继续)。默认语言设置为 'English'(英语)。

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

选择您的 Drupal 安装的安裝配置文件。然后,点击 'Save and continue'(保存并继续)。

您可以使用推荐给新 Drupal 用户的 'standard'(标准)配置文件,如果您熟悉 Drupal 可以使用 'Minimal'(最小),或者使用包含 Drupal 站点和配置示例的 'Demo'(演示)配置文件。

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

现在输入您的 Drupal 安装的 MariaDB 数据库详细信息,并点击 'Save and continue'(保存并继续)。如果您在不同的主机上使用 MariaDB,请使用 'ADVANCED OPTIONS'(高级选项)输入 MariaDB 服务器主机 IP 地址。

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

随后 Drupal 安装将开始。

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

接下来,输入您的 Drupal 站点配置的详细信息,包括站点名称和您的 Drupal 管理员用户。完成后,点击 'Save and continue'(保存并继续)。

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

现在您应该会看到通知您 Drupal 安装已完成的页面。您可以看到类似 "Congratulations, you installed Drupal!"(恭喜,您已安装 Drupal!)的消息。

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

您现在已经完成了 Drupal 的安装,但您仍然需要进行一些额外的配置。在本示例中,您将设置 Drupal 的 'trusted_host'(可信主机)配置,它将保护您的 Drupal 安装免受 HTTP HOST 头攻击。

要启用 'trusted_host' 配置,您需要编辑 Drupal 配置文件 '/var/www/drupal/sites/default/settings.php'。

运行以下命令使文件 '/var/www/drupal/sites/default/settings.php' 可写。然后,使用您的文本编辑器打开该文件。在本演示中,我们将使用 'nano'。

sudo chmod 644 /var/www/drupal/sites/default/settings.php
sudo nano /var/www/drupal/sites/default/settings.php

按 'Ctrl+w' 搜索 'trusted_host' 的模式。然后,将以下配置添加到文件中,并务必将域名更改为您的 Drupal 安装所用的域名。域名应以 Regex(正则表达式)格式编写。

$settings['trusted_host_patterns'] = [
  '^hwdomain\.io$',
];

完成后保存配置并退出。然后,再次使用以下命令更改文件的权限使其变为不可写。

sudo chmod 444 /var/www/drupal/sites/default/settings.php

最后,回到您的 Web 浏览器并访问您的 Drupal 安装的状态报告(例如:https://example.local/admin/reports/status)。

您将看到您的 Drupal 安装的详细服务器配置。此外,您可以看到全部 25 项 Drupal 配置均已成功通过检查。

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

将页面滚动到底部,您将看到您的 Drupal 安装的详细系统配置。在以下内容中,您可以看到 'trusted_host' 和 'Upload Progress'(上传进度)设置已启用。

在 Ubuntu 22.04 系统上完整安装 Drupal 内容管理系统与 Apache2 教程

结语

在本指南中,您在 Ubuntu 22.04 服务器上安装并配置了最新版本的 Drupal v9。您还学习了在 Ubuntu 系统上安装 LAMP 技术栈(Linux、Apache、MariaDB 和 PHP)的基础,以及从 PECL(PHP 扩展社区库)仓库安装 PHP 扩展的基础。

既然您已经安装了 Drupal 并通过 SSL 证书加以保护,且启用了 'trusted_host' 设置。您可以通过为站点安装主题以及安装一些额外的 Drupal 插件来扩展您当前的 Drupal 安装。