
如果您在一个 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。




安装 Drupal 之前,您必须先拥有一个 Web 服务器和一个数据库服务器。
对于使用 Apache 和 MySQL 的 Linux 系统(无论是本地还是在线服务器),运行 Drupal 所需的软件被称为 “AMP 堆栈(Apache、MySQL、PHP)”。而在 Microsoft 系统上,这类组件集合也存在类似的集成堆栈。
AMP 堆栈包括:
- Apache(或其他 Web 服务器)
- MySQL(或其他数据库服务器)
- PHP
Web 托管服务通常默认提供这些组件;或者,您也可以在自己的 Linux、Mac 或 Windows 电脑上免费安装它们。
前言
在 drupal.org 上,Drupal 8 的文档分为两个主要部分:


当前或最新版本始终可在 下载页面 获取。然而,获取 Drupal 源代码的推荐方式是使用 Composer —— PHP 的依赖管理工具。请阅读 使用 Composer 下载 Drupal 核心,该内容位于 《Composer 使用开发者指南》中以了解更多信息。使用 Composer 需要您具备访问网站所在计算机命令行的权限。


只有在您通过 git 安装(或更新)代码库时,才需要执行此步骤。
如果尚未安装 Composer,请参阅 Composer 官方安装说明。
要获得可正常运行的代码库,您需要在项目的顶级目录中运行 composer install --no-dev。这将会在 vendor 目录中安装 Drupal 所需的 Symfony 及其他依赖包。
如果跳过此步骤,当您尝试运行安装程序时,可能会看到如下错误:


如果您在测试站点上安装 Drupal,可以跳过此步骤。在运行安装脚本(下一步)时,只需提供具有创建数据库权限的数据库用户的用户名和密码即可。
如果您在公共 Web 服务器上安装 Drupal,建议先创建数据库,并为其分配一个权限较少的数据库用户。您在安装过程中输入的数据库用户将用于每次加载页面时连接数据库。
本页提供多种创建 Drupal 数据库的方法:


在本地拥有一个 Web 服务器,用于运行一个完全集成的虚拟化 AMP 堆栈(Apache、MySQL、PHP),可以模拟 Drupal 部署所需的开发、预备和生产服务器环境。
本地计算机上的 AMP 堆栈
开发人员的工作流程通常从在 Windows、Mac 或 Linux 系统上安装和配置 AMP 堆栈(Apache、MySQL、PHP)开始。根据操作系统的不同,有多种方法可以构建理想的开发环境。然而,常见的选择主要有三种:
1. 原生 AMP 堆栈:此选项适用于已预装 Apache、MySQL 和 PHP 的系统,或可以通过简单步骤安装和配置这三项的系统。网上有很多出色的教程介绍如何建立这样的工作流程,但这需要对操作系统有一定熟悉程度。
2. 打包的 AMP 堆栈:此选项指的是第三方提供的解决方案,例如:


安装完成后,请在“管理 > 报告 > 状态报告”(/admin/reports/status)部分检查您网站的状态。如果此页面显示任何问题,请及时修复。
受信任主机
如果您没有手动创建 settings.php 文件(位于 sites/default/ 目录中,除非您使用多站点安装),安装脚本会为您自动生成该文件。然而,自动生成的 settings.php 文件中不包含“受信任主机(trusted host)”配置。
有一个相关问题的讨论:允许通过安装程序设置受信任主机。
有关为什么此设置很重要的解释,请参阅 受信任主机设置。
确保 settings.php 可写
安装脚本会尝试将 settings.php 设置为只读。在类 UNIX 系统中,您可以通过以下命令修改权限:
