drupal

本文档指南描述了“扩展”Drupal 8站点超出标准Drupal核心安装的功能。

您可以从众多贡献模块中进行选择，以便为您的网站添加功能，并从各种贡献主题中更改您网站的外观。这些附加模块和主题也称为“contrib”，因为它们是由Drupal社区的成员提供的，并且可以在Drupal.org上免费获得。

 在本文档之前或之外，您可能希望阅读Drupal 8用户指南的“  扩展和自定义站点” 一章  。

概观

使用插件'模块'和'主题'安装其他功能和样式，由像您这样的成员提供，并在drupal.org免费提供

寻找贡献的模块

这些是查找和评估在您的站点上使用的contrib模块的说明。

安装Drupal 8模块

描述向您的站点添加模块的过程。

安装模块的Composer依赖项

Composer是PHP包管理器。它提供了与Drupal自己的依赖关系管理类似的功能，以及Drush make，但适用于任何项目

从命令行安装模块

使用drush或drupal控制台安装模块的说明

安装主题

这些是在Drupal 8上安装主题的说明。

更新模块

描述如何将模块更新到其最新版本。

模块配置

某些模块需要安装后配置。这通常描述了如何做到这一点。

模块文档和帮助

描述查找与您可能正在安装的任何模块相关的文档的过程。

卸载模块

描述如何在不再需要Drupal 8站点时从其中删除模块。

安装沙盒模块

在Drupal 8上安装沙箱模块的说明。

破碎的网站问题

描述模块或主题安装中的常见问题以及如何解决它们。

Drupal 8提供了一个Automated Cron模块。

我们可以在以下位置找到此核心模块：core / modules / automated_cron。

与Drupal 7相比

Drupal 7已经有了一个“自动cron系统”，但是Drupal 8将它移动到一个单独的模块中，以允许完全不使用它的站点没有任何开销。

与手动Cron的比较

自动cron模块的缺点在于它是由请求触发的，发送请求的不幸用户可能会遇到相当长的延迟。出于这个原因，自动cron通常由不能手动创建cron作业的较小站点使用，例如使用Linux crontab。如果需要crontab，可以使用Drupal控制台命令来简化配置（而不是卷曲/ admin / config / system / cron中的长URL显示。这是一个示例crontab条目：

30 * * * * web_user /var/www/html/vendor/bin/drupal --root=/var/www/html/docroot cron:execute > /dev/null 2>&1

这将在每小时30分钟后每小时执行一次Drupal cron。

设置cron是安装网站的重要步骤，有助于维护站点的搜索结果资产，检查Drupal核心和模块的更新以及删除临时文件。

正确配置的cron作业管理各种任务：

• 更新搜索模块使用的网站内容索引。
• 队列提要由Aggregator模块更新。
• 检查Update Manager模块的可用更新。
• 对系统模块执行例行维护任务，例如从日志中删除旧行。

什么是cron？

Cron是一个守护程序，它以指定的时间间隔执行命令。这些命令称为“cron作业”。Cron适用于Unix，Linux和Mac服务器。Windows服务器使用计划任务来执行命令。实际的“cron作业”是一个时间触发的动作，通常（并且最有效）由您的网站的托管服务器执行，但也可以由远程服务器甚至您自己的桌面配置。

实际发生的是，cron作业访问您网站中的cron.php文件，例如。您可以在“管理”>“报告”>“状态”报告（admin / reports / status）的“状态”报告中的“Cron维护任务”部分中找到cron.php文件的确切地址。http://www.example.com/cron.php?cron_key=0MgWtfB33FYbbQ5UAC3L0LL3RC0PT3RNUBZILLA0Nf1Re

启用cron

最简单的方法是让Drupal使用其内置的“自动cron”系统为您（默认情况下）执行此操作。您可以通过Manage> Configuration> System> Cron（admin / config / system / cron）管理“自动cron”。默认频率是每三个小时。然后，Cron将由访问您网站的最终用户触发，不会超过每三个小时。请注意，对于低流量站点，也可能需要创建一个cron作业。如果要禁用自动cron，请将“运行cron every”下拉菜单更改为“never”。

自动cron系统与所有系统兼容，因为它实际上并不涉及系统的cron守护程序。它的工作原理是检查每个Drupal请求的结尾，以查看cron上次运行的时间，如果已经太长，则将cron任务作为该请求的一部分进行处理。两个下端是（1）cron任务只在Drupal处理请求时运行; （2）运行cron任务的'权重'（处理和内存）将被添加到某个任意未知页面请求中，这可能会减慢这些请求，并且有可能超出复杂站点的内存限制。

第二种方式（适用于任何版本的Drupal）是创建一个cron作业或使用其他一些外部（用于Drupal）方法来触发其cron任务，例如像EasyCron或Cronless这样的外部cron作业服务。这是两种方法中更可靠的（因为它总是按计划运行），并且它使用更少的资源（因为cron处理没有添加到页面请求中）。因此，当您有选择时，这通常是运行cron的首选方法。请注意，如果您创建一个cron作业，您可能希望完全禁用“自动cron”系统。

禁用“自动cron”

出于性能原因，或者如果您想确保cron只能从外部触发器运行，可能需要禁用自动cron系统。

您可以通过将“Run cron every”值设置为“Never”来禁用它（例如，在Administration> Configuration> System> Cron（admin / config / system / cron）。

在Drupal 8中禁用cron的另一种方法是在settings.php中添加以下行：

$config['automated_cron.settings']['interval'] = 0;

请注意，这会将admin / config / system / cron中的设置修复为“从不”，管理用户无法覆盖它。

术语“ Cron ”指的是您的网站每N小时运行一次的自动化任务。例如，它会检查是否可以为Drupal核心以及您提供的模块和主题提供更新。

默认情况下，“ Cron ”每三个小时运行一次，每6小时（或更长时间）可以更改为每小时一次。您可以在“报告”>“状态报告”页面的顶部随时运行cron，并且可以使用提供的模块来获取其他cron功能。

Cron自动化任务概述

Drupal 8中“Cron”自动化任务的详细概述。

自动化Cron

Drupal 8提供了一个Automated Cron模块。

相关内容

设置cron

为Drupal 7设置cron

Drupal 8提供了一个内部页面缓存模块，建议用于中小型网站。此核心模块（默认情况下已启用）会为匿名用户缓存页面。它位于：core / modules / page_cache

此功能可提高性能，因为它可加快网站速度。匿名用户请求的页面在第一次被请求时被存储，然后被重用; 根据您的站点配置，性能改进可能会很显着。

要为经过身份验证的用户加速站点，请参阅动态页面缓存模块。

向匿名用户（动态，每会话，例如购物车）提供个性化内容的网站将要禁用内部页面缓存模块。此模块假定所有匿名用户的页面都相同。这些网站仍然可以利用动态页面缓存模块，或者可以使用JavaScript + AJAX进行个性化。

配置内部页面缓存模块

在Performance（）页面上，您可以配置浏览器和代理可以缓存页面的时间。没有其他配置。标题可以使用为浏览器和代理缓存页面的最大时间设置的值。内部页面缓存本身会忽略此设置，它会永久缓存页面直到失效，除非它们带有标头。admin/config/development/performanceCache-ControlExpires

与Drupal的比较7

1. Drupal 7没有即时更新; 当某些内容发生变化时，Drupal 8中的页面缓存会立即更新。
2. Drupal 7要求在修改任何内容时清除整个页面缓存; Drupal 8使用缓存标记仅清除依赖于修改内容的缓存页面。
3. 在许多情况下，Drupal 7一直在提供过时的页面; 任何模块（甚至是Drupal 7核心的部分）都无法清除页面缓存。
4. 默认情况下，Drupal 7的内部页面缓存未启用。许多用户不知道他们应该启用此功能。Drupal 8默认为匿名用户启用页面缓存。它可以做到这一点，这要归功于前一点中提到的缓存标记。在Drupal 7中，默认情况下启用内部页面缓存会导致行为中断（正是因为我们在Drupal 7中没有缓存标记）。

也可以看看

• Drupal 8现在默认启用了页面缓存
• 缓存标记开发者文档

添加内容

本指南假定您在安装时使用了标准配置文件，它定义了两种内容类型Basic Page和Article。（如果您使用的是最小配置文件，则需要先定义内容类型。）

在我们开始之前：确保您以有权创建内容的用户身份登录 - 如果您不确定，请询问您的系统管理员; 否则，您需要选择的某些字段将不可见。

1. 从首页选择添加内容（在“导航”菜单中或从管理员菜单中）。

2. 这会打开一个屏幕，询问您要添加的内容类型。默认情况下，Drupal 8带有两种内容类型，即文章和基本页面。

3. 选择文章。Basic Page和Article之间唯一的主要区别是您可以在创建文章时上传图像; 基本页面是一个静态页面。您可以稍后更新内容类型中的字段。
4. 将出现一个表单，允许您输入文章的信息。您还可以配置修订日志，菜单，注释，创作和提升选项设置。扩展Drupal实例并使用提供的模块时，这些设置会有所不同。  

5. 在“标题”文本框中输入页面的标题：例如，“测试文章”。
6. 在“摘要”区域中，输入一些简要描述您的文章的文本。
7. 在“正文”区域中输入一些文本。如果您的网站已经写好了文本块，则可以将其剪切并粘贴到此区域。您可以从文本区域下方的“文本格式”下拉列表中选择格式设置选项。默认的可用选项是Basic HTML，Restricted HTML和Full HTML。
8. 您可以标记自己的内容。要了解标记，请单击此处。
9. 您可以将图像上传到您的内容类型。
10. 单击保存。使用“保存”按钮可以访问发布内容或保留未发布的内容。
11. 你现在应该看到你的帖子。

管理节点

您可以在一个或多个节点上执行各种操作。您可以将节点指定为已发布或未发布，提升为首页或降级，粘贴（留在列表顶部）或不。您还可以删除一个或多个节点。

单击管理员菜单上的内容链接或导航到'/ admin / content'，您将获得Drupal应用程序中所有内容的列表。

• 单击管理>内容
• 如果需要，按以下方式过滤显示的状态，类型，标题或语言的内容：
  • 在任何/所有过滤器中选择所需的值
  • 单击“过滤器”按钮以获取精确的内容列表。
• 可以使用每行左侧的框来选择要管理的内容
• 要选择所有内容，请单击标题左侧的框
• 从更新选项区域中的操作选择框中选择要执行的管理更新选项，例如从首页删除内容
• 单击“ 应用于所选项目”

有关设置节点权限的信息，请参阅“ 管理用户”部分。

管理评论

您可以显示所有注释的列表视图。从列表中，您可以选择取消发布或删除一个或多个注释。

• 单击管理>内容
• 单击“注释”选项卡。

• 选择一个或多个评论
• 从下拉列表中选择取消发布或删除。
• 单击更新。

本节介绍了新Drupal 8用户的站点管理。它涵盖了管理员帐户的使用，并提供了从何处入手的建议。

了解管理员帐户

在安装过程结束时，执行安装的人员将使用管理员帐户自动登录到站点。您可能会看到管理员帐户称为用户1.此管理帐户自动获得管理内容和管理站点的所有权限，因此保护用户1帐户是关键：

• 不要分享此帐户。而是通过创建帐户并将其分配给角色来授予用户权限。
• 不要将第一个帐户命名为“admin”或明显的名称。
• 为了最大限度地提高安全性，站点管理员可能会考虑限制或取消对用户1帐户的访问权限的方法。 

从哪儿开始

管理员通常需要在新站点中处理以下区域。

检查您网站的状态

通过菜单>报告>状态报告（admin / reports / status）打开状态报告，以获得您网站当前状态的概述。您可以检查Drupal版本，数据库版本，PHP版本，PHP内存限制，Web服务器信息和潜在的安全问题。红色背景的项目是需要立即关注的问题。一个示例是Drupal核心或已安装模块的必需安全更新，或未受保护的settings.php文件（有关更多信息，请参阅Drupal需要哪些权限？）。状态报告页面还显示上次运行cron脚本的时间。此脚本需要定期运行，以使您的站点正常运行。

配置您的站点信息

通过菜单>配置>系统>基本站点设置（admin / config / system / site-information）打开站点信息设置，以进行基本设置，例如站点名称，标语，电子邮件地址或默认的首页路径。

管理用户

通过菜单>人员（管理员/人员）打开“ 人员”页面，以添加新用户或管理现有用户。您可以通过单击此页面上的“权限”选项卡来管理用户角色和权限。要更改用户申请帐户的流程，请通过菜单>配置>人员>帐户设置（admin / config / people / accounts）访问“人员和权限”页面。阅读有关用户，角色和权限的更多信息。

添加其他功能

您可以通过启用模块来扩展Drupal的功能。标准的Drupal安装附带了许多可以启用的模块。此外，您还可以下载社区贡献（“contrib”）模块。通过菜单>扩展（管理员/模块）
打开“ 扩展”页面以管理模块。 可以从Drupal.org 的Modules部分下载其他模块。了解更多有关安装贡献的模块。
 

使用搜索

搜索模块允许用户搜索您网站上的特定内容。您可以同时搜索用户和特定单词。当您在搜索的“内容”选项卡上时，您将能够搜索站点上节点内容的默认呈现中出现的单词，其中包括任何CCK字段的默认呈现，位置字段，分类法等。 ，以及评论。当您在搜索的“用户”选项卡上时，您将能够搜索您网站上注册用户的用户名，如果您有足够的权限，还可以搜索他们的电子邮件地址。
详细了解如何使用搜索

自定义站点外观

通过菜单>外观（管理员/外观）打开外观页面，通过安装新主题或编辑主题设置来更改站点的外观。Drupal默认提供少量主题。您可以在Drupal.org上创建自己的主题或查找贡献的主题。阅读有关使用Drupal主题的更多信息。

管理网站结构

通过菜单>结构（管理/结构）打开结构页面，通过管理站点中的相应更改来更改站点内容类型的结构，块布局，菜单，分类，视图，显示模式和联系表单。Drupal默认提供站点的一些结构化组件。阅读有关使用Drupal结构的更多信息。

管理Drupal 8站点

Drupal 8管理入门

本节介绍了新Drupal 8用户的站点管理。它涵盖了管理员帐户和优惠的使用

管理内容

本节提供了有关如何在Drupal 8中管理内容的基本介绍

内部页面缓存

在Drupal 8中，默认情况下启用内部页面缓存模块，该模块为匿名用户缓存页面。

Cron自动化任务

为Drupal 8站点配置“Cron”自动化任务。

• Cron自动化任务概述
• 自动化Cron

由于推荐的安装（和更新）Drupal 8站点的方法是使用Composer，因此该页面还将主要介绍如何使用Composer更新模块。由于您使用的是命令行，因此我们使用Drush执行某些任务。

谁是用来干什么的模块升级与Drush应该注意到，在Drush 9（当前版本），所有的人up -的命令， 以及 -被弃用。您必须使用相应的Composer命令。pm-updatepm-updatecodepm-updatestatus

列表更新

使用Composer的内置命令列出具有可用更新的包：

composer outdated 'drupal/*'

您可以使用Composer的show命令获得相同的信息。

列出安全更新

Drupal.org的安全状态无法通过Composer获得。幸运的是Drush来救援：

drush pm:security

安装更新

对于给定的Drupal模块/项目使用

composer update drupal/modulename --with-dependencies

最后，运行任何数据库更新并重建缓存：

drush updatedb drush cr

第一步

要了解Composer如何管理Drupal依赖项，请参阅将Composer与Drupal一起使用。要确定Composer是否是一种合理的更新方式，请比较可用选项。

为方便起见，这些说明包括完成更新所需的Drush命令：许多人发现Drush比基于Web的管理区域更快更容易。但是，如果您没有对生产服务器的命令行访问权限，则几乎每个Drush命令都具有Web等效项。对于那些没有的人，例如备份，通常存在contrib模块。

如果这是一个现有的Drupal站点，之前从未使用过Composer，请确保它首先为作曲家做好准备。

＃ 更新Drupal 8核心

首先，验证Drupal核心的更新实际上是否可用：

composer outdated "drupal/*"

在运行composer update时，为了查看哪些更新可用以及哪些模块将更新

composer update --dry-run

如果没有以行开头的行，则Composer不知道任何更新。如果有更新，请继续执行以下命令。drupal/core

一步更新说明

假设您习惯于更新Drupal并了解应该采取的所有预防措施，则更新非常简单：

composer update drupal/core --with-dependencies drush updatedb drush cr

如果你使用drupal-composer / drupal-project启动你的Drupal站点 ，上面的命令可能不起作用。请阅读下面的列表。

• 如果要从8.5升级到8.6，则需要将“~8.5.x”替换为drupal / core的“^ 8.6.0”和composer.json中的webflo / drupal-core-require-dev。
• 必须将composer update命令更改为

  composer update drupal/core webflo/drupal-core-require-dev --with-dependencies

如果您尚未使用composer安装Drupal 8，则必须将站点转换为作曲家管理的项目才能使用上述命令更新Drupal。请参阅“ 将编译器添加到现有站点 ”，以获取有关将编写器手动添加到以前未安装Composer的现有Drupal 8站点的  分步指南。

逐步更新说明

使用composer更新Drupal 8核心的所有步骤：

1. 在更新之前，请始终备份文件和数据库。
   • drush sql-dump 将转储数据库。
   • drush archive-dump 遗憾的是，从Drush 9中删除了，因此您必须使用标准的CLI工具来备份所需的目录 - 通常不包括供应商目录。
2. 阅读核心发行说明。一些贡献的模块或主题可能需要更新以使用核心的新“ 次要”版本（例如8.3到8.4）。补丁发布（例如8.4.4到8.4.5）不应要求这样做。要检测所需的模块或主题更新，您需要阅读项目页面或发行说明。
3. 使用然后激活维护模式。drush sset system.maintenance_mode 1drush cr
4. 如果您确定某些模块或主题需要更新，请按照模块更新说明进行操作。
5. 更新Drupal核心及其所有依赖项：
   • 运行以下Composer命令：

     composer update drupal/core --with-dependencies

   • 如果您使用drupal-composer / drupal-project启动Drupal站点，请改为运行此命令：

     composer update drupal/core webflo/drupal-core-require-dev --with-dependencies

6. 接下来，使用drush updatedb并清除缓存来应用任何所需的数据库更新drush cr
7. 检查您的Drupal站点是否正常：
   • 查看状态报告页面以查找错误。
   • 如果启用了数据库日志记录模块，请执行一些基本操作并检查最近的日志以查找错误，警告等。
8. 使用 然后取消激活维护模式。drush sset system.maintenance_mode 0drush cr
9. 停用维护模式后，也以匿名用户身份测试该站点。

在您的生产环境中

• 您不需要重复上述过程的其余部分，因为composer install它将读取composer.lock中所有包的确切提交指针，因此您将在两个环境中拥有相同版本的所有内容。
• 如果您有单独的开发/暂存和生产服务器，请确保将composer.json 和composer.lock文件复制/提交到生产并始终 在生产中运行  ，而不是更新。（--no-dev开关将停止安装'require-dev'中列出的任何软件包，通常是用于调试的模块和用于单元/行为测试的库。）composer install --no-dev

＃ 已知问题和解决方法

如果您运行composer update上面的命令但未更新，则可能存在阻止Drupal升级的另一个依赖项。您可以使用该命令检查阻止依赖项。例如，如果您尝试从8.4.5升级到8.5.0，则可以运行，并且应该提供阻止升级的依赖项列表。更新这些依赖项，它应该工作（例如）。drupal/corecomposer prohibitscomposer prohibits drupal/core:8.5.0drupal/corecomposer update drupal/core "symfony/*" --with-dependencies

Composer更新问题通常与废弃的composer模板或composer.json中的错误设置有关。确保使用的是第3.5章中建议的作曲家模板。Drupal 8用户指南“ 使用Composer下载和更新文件 ”。请参阅“ 将编译器添加到现有站点 ”，以获取有关将编写器手动添加到  以前未安装Composer的现有Drupal 8站点的  分步指南。

其他一些相关问题和博客文章提供了进一步的帮助：

1. 使用Composer升级到Drupal 8.4.0和Drush 9 - 由Isojira的Benji Fisher（@benjifisher）撰写的博客文章介绍了有问题的8.3到8.4升级。
2. 更新到Drupal核心8.4，一步一步指南  - PreviousNext的博客文章，涵盖有问题的8.3到8.4升级。
3. 使用作曲家更新到Drupal 8.5  - Eirik Morland（eiriksm）的博客文章报道了从8.4到8.5的一些问题。
4. Composer无法从8.4.4升级到8.5.0-alpha1  - 很多想法如何解决作曲家更新问题。
5. 无法更新您的Drupal 8网站？然后，这篇博客文章适合您   - 新的GoComposer插件的博客文章，可自动执行更新过程并将您的网站转换为推荐的模板。

如果在更新过程中发生错误和警告，建议您仔细阅读并在问题队列中搜索可能的解决方案，然后再继续。如果出现致命错误，建议始终使用之前建议的备份停止进一步更新并从头开始重新启动整个过程。