本页内容

  • 先决条件
  • 配置软件仓库
  • 安装软件包依赖
  • 配置 Firewalld
  • 配置 MariaDB 服务器
  • 安装 PECL 扩展:uploadprogress
  • 配置 PHP-FPM
  • 下载 Drupal 源代码
  • 配置 SELinux
  • 配置 Nginx Web 服务器
  • 开始 Drupal 安装
  • 完成 Drupal 安装
  • 总结

Drupal 是一个用 PHP 编写、基于 GNU 通用公共许可证分发的免费开源 Web 内容管理系统。Drupal 提供了一个强大的内容管理工具,并带有用于多通道发布的复杂 API。

Drupal 是互联网上使用最广泛的 CMS 之一,至少有 14% 的互联网排名前 10,000 的网站在使用它,并被全球企业、政府、教育和机构站点所采用。Drupal 提供了一个高可扩展的系统,可与数字化应用集成,并支持多语言,可用于为不同组织创建多站点。

在本教程中,你将学习如何在 Rocky Linux 服务器上通过 LEMP 技术栈配置 Drupal CMS(内容管理系统)。你还将学习如何在 Rocky Linux 上以 SELinux 强制模式和启用 Firewalld 的状态下让 Drupal 运行起来。

先决条件

在开始本指南之前,你需要满足以下一些要求:

  • 一台 Rocky Linux 服务器 —— 本示例使用的是主机名为 'drupal-server' 的 Rocky Linux 8.x。
  • 一个具有 sudo/root 管理员权限的非 root 用户。
  • 一个指向 Rocky Linux 服务器 IP 地址的域名 —— 尤其是在生产环境中时。

配置软件仓库

LEMP 技术栈(Nginx、MariaDB/MySQL 和 PHP-FPM)是一组用于托管 Web 应用的开源软件。在 Rocky Linux 上,大部分 LEMP 技术栈软件包都可在第三方仓库中获取。

第一步,你将在系统中添加并启用两个仓库。你将添加 EPEL 仓库(为基于 RHEL 的操作系统提供额外的软件包)和 REMI 仓库(提供多个版本的 PHP 软件包)。

运行以下命令,将 EPEL 仓库添加到你的 Rocky Linux 系统。当提示确认时,输入 y 并按 ENTER。

sudo dnf install epel-release

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

现在运行以下 dnf 命令,为 Rocky Linux 8.4 添加 REMI 仓库。

sudo dnf install dnf-utils http://rpms.remirepo.net/enterprise/remi-release-8.rpm

输入 y 并按 ENTER 以继续并添加 Remi 仓库。

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

最后,运行以下 dnf 命令以验证系统中可用的仓库列表。你应该会看到 EPEL 和 REMI 这两个额外的仓库已被添加到 Rocky Linux 系统。

sudo dnf repolist

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

安装软件包依赖

Drupal 是一个灵活且强大的 CMS,可以安装在任何 Web 服务器上,例如 Apache2/httpd、Nginx 或微软的 IIS。此外,Drupal 支持多种关系型数据库,包括 MariaDB/MySQL、PostgreSQL 和 SQLite。对于 Microsoft SQL Server 和 MongoDB 等其他数据库,你都可以通过社区模块来使用。

现在你将安装 Drupal 所需的 LEMP 技术栈软件包依赖。你将通过 EPEL 仓库安装 Nginx,从 appstream 安装 MariaDB,并从 REMI 仓库安装 PHP 8.1 软件包。

首先,通过以下 dnf 命令重置并启用来自 REMI 仓库的 PHP 模块。在本示例中,你将启用 PHP 8.1 模块,该版本受最新版 Drupal 支持。

sudo dnf module reset php
sudo dnf module enable php:remi-8.1

当提示时,输入 y 以确认并启用 PHP 8.1 REMI 仓库,然后按 ENTER 继续。

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

接下来,使用以下 dnf 命令安装基础的 LEMP 技术栈软件包。

sudo dnf install nginx mariadb-server php php-fpm php-cli php-devel php-mbstring php-gd php-xml php-curl php-mysqlnd php-pdo php-json php-opcache php-pear php-pecl-apcu php-pecl-crypto

当提示确认时,输入 y 并按 ENTER。

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

此外,当提示确认添加某些仓库的 GPG 密钥时,也输入 y。

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

一旦 LEMP 技术栈软件包安装完成,你可以使用以下 systemctl 命令启动 Nginx、MariaDB 和 PHP-FPM 服务。同时,你还将启用所有这些服务,使其在开机时自动运行。

sudo systemctl start nginx mariadb php-fpm
sudo systemctl enable nginx mariadb php-fpm

你现在应该会看到类似以下的输出 —— LEMP 技术栈现在应该已在你的 Rocky Linux 系统上运行,且 LEMP 技术栈的所有服务都已启用。

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

配置 Firewalld

Firewalld 是基于 RHEL 的操作系统(包括 Rocky Linux)的默认防火墙。建议启用防火墙来运行 Drupal 或任何 Web 应用,尤其是在生产级环境中。

现在你将把 HTTP 和 HTTPS 两个端口添加到 firewalld,以允许客户端访问你的 Drupal 安装。

运行以下 firewall-cmd 命令,将 HTTP 和 HTTPS 服务添加到 firewalld。

sudo firewall-cmd --add-service=http --permanent
sudo firewall-cmd --add-service=https --permanent

现在重新加载 firewalld 以应用新的更改。然后,验证 firewalld 上已启用的服务列表。

sudo firewall-cmd --reload
sudo firewall-cmd --list-services

你应该会看到 HTTP 和 HTTPS 服务已添加到 firewalld。

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

配置 MariaDB 服务器

在这一步,你将开始配置供 Drupal 使用的 MariaDB 数据库。你将首先对 MariaDB 部署进行安全加固,然后为 Drupal 安装创建一个新的数据库和用户。

在开始之前,运行以下命令验证 MariaDB 服务,并确保该服务正在运行。

sudo systemctl status mariadb

以下是 MariaDB 服务正在运行时的输出。

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

接下来,运行以下命令来对 MariaDB 服务器部署进行安全加固。命令行 'mysql_secure_installation' 由 MariaDB 软件包提供,可帮助你加固安装。

sudo mysql_secure_installation

现在你应该会被问到一些与 MariaDB 服务器配置相关的问题:

  • 默认的 MariaDB 安装没有设置密码,当提示输入密码时,按 ENTER。
  • 现在输入 Y 以设置 MariaDB root 密码。然后,输入 MariaDB 的新密码并重复输入一次。
  • 输入 Y 以从 MariaDB 安装中删除匿名用户。
  • 当提示禁用 MariaDB root 用户的远程登录时,再次输入 Y。
  • 输入 Y 以从 MariaDB 中删除默认的 test 数据库。
  • 最后,输入 Y 以重新加载表权限并应用新更改。

在对 MariaDB 部署进行安全加固之后,接下来你将创建新的数据库和供 Drupal 使用的用户。

通过以下 mysql 命令以 root 用户登录到 MySQL/MariaDB shell。

sudo mysql -u root -p

运行以下查询,为 Drupal 创建新的数据库和用户。在本示例中,你将创建名为 drupaldb 的数据库,以及用户 drupal@localhost。同时,请务必修改默认的数据库密码。

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

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

接下来,运行以下查询以验证 MariaDB 用户 drupal@localhost 的权限。你将看到 MariaDB 用户 drupal@localhost 对数据库 drupaldb 拥有访问权限和特权。

SHOW GRANTS FOR drupal@localhost;

现在运行查询 'exit' 或 'quit' 以退出 MariaDB shell。

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

安装 PECL 扩展:uploadprogress

uploadprogress 是 Drupal 用于显示进度条的一个扩展。uploadprogress 可以通过 PECL(PHP 扩展社区库)仓库安装。

现在你将通过 PECL 仓库安装 uploadprogress 扩展,并在你的 PHP 安装中启用它。

首先,运行以下命令,确认命令 'pecl' 在你的系统上可用。若 'pecl' 可用,你应该会看到 'pecl' 二进制文件的完整路径。

which pecl

现在运行以下 'pecl' 命令以安装 uploadprogress 扩展。

sudo pecl install uploadprogress

安装开始时,你应该会看到类似以下的输出:

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

接下来,运行以下命令创建新的配置文件 '/etc/php.d/uploadprogress.ini',并启用 uploadprogress 扩展。

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

最后,重启 PHP-FPM 服务以应用新更改。现在 PHP-FPM 已启用附加的 uploadprogress 扩展运行。

sudo systemctl restart php-fpm

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

配置 PHP-FPM

现在你将通过 '/etc/php.ini' 文件设置 PHP-FPM 的基本配置,并为 Drupal 设置一个专用的 PHP-FPM 进程池。

使用以下 nano 编辑器修改 '/etc/php.ini' 文件。

sudo nano /etc/php.ini

按下述方式修改默认配置。同时,请务必根据你的环境修改 date.timezone 选项。

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

完成后保存文件并退出编辑器。

接下来,将默认的 PHP-FPM 进程池配置 '/etc/php-fpm.d/www.conf' 复制为 '/etc/php-fpm.d/drupal.conf'。然后,使用 nano 编辑器修改新的进程池配置 '/etc/php-fpm.d/drupal.conf'。

sudo cp /etc/php-fpm.d/www.conf /etc/php-fpm.d/drupal.conf
sudo nano /etc/php-fpm.d/drupal.conf

将默认名称改为 '[drupal]',并将默认的用户和组改为 'nginx'。同时,请务必将 'drupal' PHP-FPM 进程池的监听 sock 文件改为 '/run/php-fpm/drupal.sock'。

[drupal]
user = nginx
group = nginx
listen.owner = nginx
listen.group = nginx
listen = /run/php-fpm/drupal.sock

完成后保存文件并退出编辑器。

现在通过以下 systemctl 命令重启 PHP-FPM 服务。然后,验证 PHP-FPM 服务状态。

sudo systemctl restart php-fpm
sudo systemctl status php-fpm

你应该会收到类似以下的输出 —— PHP-FPM 服务正在运行。

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

接下来,运行以下命令创建新的 PHPINFO 文件 '/usr/share/nginx/html/info.php'。

cat <<EOF | sudo tee /usr/share/nginx/html/info.php
<?php
phpinfo();
?>
EOF

最后,打开 Web 浏览器,访问服务器 IP 地址加上路径 '/info.php'(例如:http://192.168.5.100/info.php)。你应该会看到关于 PHP 的详细信息。

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

下载 Drupal 源代码

至此,你已完成 Drupal 安装所需的 MariaDB 数据库服务器和 PHP-FPM 的配置。接下来,你将把最新版本的 Drupal 下载到服务器上。

首先,将当前工作目录切换到 '/tmp',并通过以下 wget 命令下载最新版本的 Drupal。下载完成后,你应该会看到 'drupal.tar.gz' 文件。

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

接下来,使用 tar 命令解压 'drupal.tar.gz' 文件,并将解压出来的目录移动到 '/var/www/drupal',该目录将用作 Drupal 的安装目录。

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

最后,运行以下命令更改 Drupal 安装目录 '/var/www/drupal' 的所有权和权限。所有权应设置为用户和组 'nginx',以便 Nginx Web 服务器能够读取并访问 Drupal 源代码。权限应设置为 '755'。

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

配置 SELinux

下载完 Drupal 源代码后,接下来你将配置 Drupal 的 SELinux。你将把 SELinux 管理工具下载到服务器上,并为 Drupal 源代码设置标签,以及为 Nginx 设置额外的规则。

运行以下 dnf 命令安装用于管理系统 SELinux 的软件包 'policycoreutils-python-utils'。

sudo dnf install policycoreutils-python-utils

当提示时,输入 y 以确认安装并按 ENTER 继续。

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

接下来,运行以下命令为 Drupal 源代码设置标签。

sudo semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/drupal(/.*)?"
sudo semanage fcontext -a -t httpd_sys_rw_content_t '/var/www/drupal/sites/default/settings.php'
sudo semanage fcontext -a -t httpd_sys_rw_content_t '/var/www/drupal/sites/default/files'
sudo restorecon -Rv /var/www/drupal

运行以下命令,允许 Nginx Web 服务器访问某些服务。对于 Drupal 安装,你应该允许 Nginx 访问网络和邮件服务。

sudo setsebool -P httpd_can_sendmail on
sudo setsebool -P httpd_can_network_connect on

现在你已下载 Drupal 源代码,配置了用户和组 'nginx' 的正确所有权,配置了 755 的正确权限,并配置了 Drupal 的 SELinux。

配置 Nginx Web 服务器

现在你已完成 MariaDB 数据库服务器和 PHP-FPM 的部分配置。此外,你已下载 Drupal 源代码并配置了 SELinux。在下一步,你将为自己的域名配置 Nginx 服务器块。

在开始之前,请确保你的域名已指向服务器 IP 地址。同时,请确保已生成 SSL Letsencrypt 证书。

使用以下 nano 编辑器创建新的 Nginx 服务器块配置 '/etc/nginx/conf.d/drupal.conf'。

sudo nano /etc/nginx/conf.d/drupal.conf

将以下配置添加到文件中。并务必修改域名和 SSL 证书的路径。本示例使用域名 http://drupal.example.local 作为 Drupal 安装的主域名。

server {
    listen 80;
    server_name drupal.example.local;
    return 301 https://$host$request_uri;
}
server {
    listen 443 http2 ssl;
    server_name drupal.example.local;
    root /var/www/drupal;
    ssl_certificate      /etc/letsencrypt/live/drupal.example.local/fullchain.pem;
    ssl_certificate_key  /etc/letsencrypt/live/drupal.example.local/privkey.pem;
    access_log /var/log/nginx/drupal.example.local.access.log;
    error_log /var/log/nginx/drupal.example.local.error.log;
    location = /favicon.ico {
        log_not_found off;
        access_log off;
    }
    location = /robots.txt {
        allow all;
        log_not_found off;
        access_log off;
    }
    location ~ \..*/.*\.php$ {
        return 403;
    }
    location ~ ^/sites/.*/private/ {
        return 403;
    }
    # Block access to scripts in the site files directory
    location ~ ^/sites/[^/]+/files/.*\.php$ {
        deny all;
    }
    location ~ (^|/)\. {
        return 403;
    }
    location / {
        try_files $uri /index.php?$query_string;
    }
    location @rewrite {
        rewrite ^/(.*)$ /index.php?q=$1;
    }
    location ~ /vendor/.*\.php$ {
        deny all;
        return 404;
    }
    location ~ '\.php$|^/update.php' {
        fastcgi_split_path_info ^(.+?\.php)(|/.*)$;
        include fastcgi_params;
        # Block httpoxy attacks. See https://httpoxy.org/.
        fastcgi_param HTTP_PROXY "";
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param PATH_INFO $fastcgi_path_info;
        fastcgi_param QUERY_STRING $query_string;
        fastcgi_intercept_errors on;
        fastcgi_pass unix:/run/php-fpm/drupal.sock;
    }
    location ~ ^/sites/.*/files/styles/ { # For Drupal >= 7
        try_files $uri @rewrite;
    }
    # Handle private files through Drupal. Private file's path can come
    # with a language prefix.
    location ~ ^(/[a-z\-]+)?/system/files/ { # For Drupal >= 7
        try_files $uri /index.php?$query_string;
    }
    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
        try_files $uri @rewrite;
        expires max;
        log_not_found off;
    }
}

完成后保存文件并退出编辑器。

现在,运行以下命令验证 Nginx 配置。你应该会收到类似 'test successful - syntax ok' 的输出消息,这意味着你的 Nginx 配置正确且无错误。

sudo nginx -t

接下来,运行以下 systemctl 命令重启 Nginx 服务,以应用新的服务器块配置。

sudo systemctl restart nginx

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

现在 Nginx 服务应已使用新的服务器块配置 '/etc/nginx/conf.d/drupal.conf' 运行。运行以下命令验证 Nginx 服务,并确保其正在运行。

sudo systemctl status nginx

你应该会看到类似以下的输出 —— Nginx 服务正在运行。

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

现在你应该能够通过你的域名访问 Drupal 安装。

开始 Drupal 安装

至此,你已完成 Drupal 软件包依赖的配置。现在你可以通过你的域名访问 Drupal。

在这一步,你将开始安装 Drupal,同时你将设置 Drupal 的相关详细信息,并创建 Drupal 的管理员用户。

打开你的 Web 浏览器,访问你的 Drupal 安装域名(例如:https://drupal.example.local/)。你应该会看到 Drupal 的安装页面。

为你的 Drupal 安装选择语言,或者直接使用默认的 'English',然后点击 'Save and continue' 按钮。

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

为你的安装选择安装配置文件,然后点击 'Save and continue'。本示例使用 'Standard' 配置文件。

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

现在为你的 Drupal 安装设置数据库。输入你先前已创建并拥有的 MariaDB 数据库和用户的详细信息。

再次点击 Save and continue.

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

现在 Drupal 安装将开始。

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

输入你的 Drupal 安装的详细信息。同时,请务必使用你的用户名作为 Drupal 管理员,并使用一个强密码。

点击 Save and continue.

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

当 Drupal 安装完成时,你将看到以下页面。你可以看到诸如 'Congratulations, you installed Drupal!' 这样的消息。

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

完成 Drupal 安装

运行以下命令为 Drupal 配置文件和目录设置标签。

sudo restorecon -v /var/www/drupal/sites/default/settings.php
sudo restorecon -Rv /var/www/drupal/sites/default/files

接下来,运行以下命令更改文件 '/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

取消注释脚本行 'trusted_host_patterns' 并添加你的域名。这将启用 Drupal 安装上的 trusted_host 功能。

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

完成后保存文件并退出编辑器。

最后,回到你 Drupal 站点的 Web 浏览器,访问以下 URL 中的报告状态。将主域名替换为你的域名 —— 或者你也可以通过菜单 Administration > Reports 来访问。

https://drupal.example.local/admin/reports/status

在以下报告中 —— 你可以看到 Drupal 安装的 25 项系统要求都已通过检查。这意味着你的 Drupal 安装是正确的且没有错误。

如何在 Rocky Linux 8 上通过 Nginx 安装 Drupal 内容管理系统

总结

在本指南中,你学习了如何在 Rocky Linux 服务器上安装最新版本的 Drupal v9。你还学习了 LAMP 技术栈(Linux、Apache2/httpd、MySQL/MariaDB 和 PHP)的安装,以及托管 Drupal 的基本配置。此外,你还学习了如何从 PECL(PHP 扩展社区库)仓库安装 PHP 扩展。

在 Drupal 运行并通过 SSL 证书加固、且启用了 'trusted_hosts' 配置的情况下,你现在可以通过安装新主题或为你的 Drupal 安装添加一些插件来扩展 Drupal 部署。