logo

额外区块类型 (EBT) - 全新的布局构建器体验❗

额外区块类型 (EBT) - 样式化、可定制的区块类型:幻灯片、标签页、卡片、手风琴等更多类型。内置背景、DOM Box、JavaScript 插件的设置。立即体验布局构建的未来。

演示 EBT 模块 下载 EBT 模块

❗额外段落类型 (EPT) - 全新的 Paragraphs 体验

额外段落类型 (EPT) - 类似的基于 Paragraph 的模块集合。

演示 EPT 模块 滚动

滚动
07/10/2025, by Ivan

某些单独的模块可能对 PHP 扩展和配置有特殊要求,除了以下列出的内容外,因此请务必查阅该模块的文档。

07/10/2025, by Ivan

如果您在一个 PHP 被编译或限制为使用 32 位整数的系统上运行 Drupal,那么您只能输入 1901 年至 2038 年之间的日期(具体而言,从 1901 年 12 月 13 日 UTC 时间 20:45:52 到 2038 年 1 月 19 日 UTC 时间 03:14:07)。这被广泛称为 2038 年问题

常见的症状是日期显示或记录为 1970-01-01,而不是超出上述范围的预期值。这会影响所有 PHP 应用程序。特别是在 Drupal 中,它会影响基于日期的字段类型,例如“仅日期”和“日期与时间”,包括“列表选择器”小部件。您可以选择 1900 至 2038 年之外的年份,但由于 PHP 本身无法处理这些日期,它们将在没有任何警告的情况下被保存或显示为 1970-01-01。

07/10/2025, by Ivan

第 3 章 用户指南 Drupal 8 涵盖了服务器要求、附加工具、安装前的准备以及安装脚本的运行。第 4 章 描述了在安装脚本完成后应执行的后续步骤。

本指南涵盖了大部分相同的内容。这些页面提供的选项比用户指南更多,但说明略少详细。当其他开发者文档中已有相关信息时,我们会引用它们,而不是在此重复。

06/10/2025, by Ivan

安装 Drupal 之前,您必须先拥有一个 Web 服务器和一个数据库服务器。

对于使用 ApacheMySQL 的 Linux 系统(无论是本地还是在线服务器),运行 Drupal 所需的软件被称为 “AMP 堆栈(Apache、MySQL、PHP)”。而在 Microsoft 系统上,这类组件集合也存在类似的集成堆栈。

AMP 堆栈包括:

  • Apache(或其他 Web 服务器)
  • MySQL(或其他数据库服务器)
  • PHP

Web 托管服务通常默认提供这些组件;或者,您也可以在自己的 Linux、Mac 或 Windows 电脑上免费安装它们。

前言

在 drupal.org 上,Drupal 8 的文档分为两个主要部分:

06/10/2025, by Ivan

只有在您通过 git 安装(或更新)代码库时,才需要执行此步骤。

如果尚未安装 Composer,请参阅 Composer 官方安装说明

要获得可正常运行的代码库,您需要在项目的顶级目录中运行 composer install --no-dev。这将会在 vendor 目录中安装 Drupal 所需的 Symfony 及其他依赖包。

如果跳过此步骤,当您尝试运行安装程序时,可能会看到如下错误:

06/10/2025, by Ivan

如果您在测试站点上安装 Drupal,可以跳过此步骤。在运行安装脚本(下一步)时,只需提供具有创建数据库权限的数据库用户的用户名和密码即可。

如果您在公共 Web 服务器上安装 Drupal,建议先创建数据库,并为其分配一个权限较少的数据库用户。您在安装过程中输入的数据库用户将用于每次加载页面时连接数据库。

本页提供多种创建 Drupal 数据库的方法:

06/10/2025, by Ivan

在本地拥有一个 Web 服务器,用于运行一个完全集成的虚拟化 AMP 堆栈(Apache、MySQL、PHP),可以模拟 Drupal 部署所需的开发、预备和生产服务器环境。

本地计算机上的 AMP 堆栈

开发人员的工作流程通常从在 Windows、Mac 或 Linux 系统上安装和配置 AMP 堆栈(Apache、MySQL、PHP)开始。根据操作系统的不同,有多种方法可以构建理想的开发环境。然而,常见的选择主要有三种:

1. 原生 AMP 堆栈:此选项适用于已预装 Apache、MySQL 和 PHP 的系统,或可以通过简单步骤安装和配置这三项的系统。网上有很多出色的教程介绍如何建立这样的工作流程,但这需要对操作系统有一定熟悉程度。

2. 打包的 AMP 堆栈:此选项指的是第三方提供的解决方案,例如:

06/10/2025, by Ivan

安装完成后,请在“管理 > 报告 > 状态报告”(/admin/reports/status)部分检查您网站的状态。如果此页面显示任何问题,请及时修复。

受信任主机

如果您没有手动创建 settings.php 文件(位于 sites/default/ 目录中,除非您使用多站点安装),安装脚本会为您自动生成该文件。然而,自动生成的 settings.php 文件中不包含“受信任主机(trusted host)”配置。

有一个相关问题的讨论:允许通过安装程序设置受信任主机。

有关为什么此设置很重要的解释,请参阅 受信任主机设置

确保 settings.php 可写

安装脚本会尝试将 settings.php 设置为只读。在类 UNIX 系统中,您可以通过以下命令修改权限: