drupal-7drupal-7入门


备注

本节概述了drupal-7是什么,以及开发人员为什么要使用它。

它还应该提到drupal-7中的任何大型主题,并链接到相关主题。由于drupal-7的文档是新的,您可能需要创建这些相关主题的初始版本。

Drupal是用PHP编写的,带有大量的JavaScript(主要使用JQuery库),用于前端体验,它使用MariaDB / MySQL或PostgreSQL等数据库来存储内容和配置。

履行

要开始构建任何Drupal网站,首先需要安装Drupal。许多不同的操作系统组合(Linux,Windows,Mac OS X),Web服务器(Apache,IIS,Nginx)和数据库(MariaDB / MySQL,PostgreSQL,SQLite)都支持Drupal。

安装Drupal 7步骤

第1步:下载并解压缩Drupal

Drupal有两个支持的版本:最新版本和之前版本。目前是Drupal 8(2015年11月发布)和Drupal 7.推荐版本是两个版本的最新稳定版本。要了解有关版本的更多信息,请参阅Drupal版本信息页面。

要使用英语以外的语言安装Drupal站点,请访问http://localize.drupal.org/translate 。您还可以在安装后添加其他语言。

注意:如果安装Drupal 8,则可以选择安装语言作为安装脚本本身界面中的第一个选项。

您可以通过六种不同的方式下载和提取Drupal:

  • 使用Drush
  • 使用Drupal控制台
  • 从命令行
  • 使用FTP
  • 用Git
  • 使用作曲家

因此,请按照以下方法之一进行下载,然后......

在继续下一页之前......

Drupal安装的基本URL在Web服务器的配置文件中设置。在继续安装的后续步骤之前,您需要知道此URL。如果要在本地计算机上安装Drupal,则基本URL可能是http://localhost. 如果您要将Drupal安装到Web服务器,则您的基本URL可能是特定的域名,例如http://example.com

Drush

Drush是一个维护和管理Drupal站点的命令行工具。它提供了使用单个命令下载Drupal的最便捷方式: pm-download (或其别名dl ):

drush dl drupal
 

此命令将推荐的版本下载到当前文件夹中。检查drush help dl 以查看其他选项,例如如何下载特定版本。

Drupal控制台

Drupal ConsoleDrupal的新命令行界面(CLI)。 Drupal Console是一个生成样板代码,交互和调试Drupal 8的工具。它提供了一种使用单个命令下载Drupal的便捷方法:

site:new

# specifying to download version 8.0.2 into folder "mydrupalsite"
drupal site:new mydrupalsite 8.0.2 

# select version from interactive mode
drupal site:new mydrupalsite
 

此命令将指定的版本下载到当前文件夹中。检查drupal site:new --help 或访问文档

从命令行

下载

使用ssh登录到您的服务器并导航到您将为其服务Drupal站点的目录。在许多* nix计算机上,服务器根目录的路径为/ var / www / html,所以cd /var/www/html 。在共享服务器或承载多个域的服务器上,路径将不同(尝试cd ~/wwwcd ~/public_html )。如果您不确定该目录,请向您的托管服务提供商寻求帮助。

从命令行下载Drupal,例如使用wget或curl。这些命令分别是:

wget http://ftp.drupal.org/files/projects/drupal-x.x.tar.gz
 

要么

curl -O http://ftp.drupal.org/files/projects/drupal-x.x.tar.gz
 

注意: curl命令选项是大写字母“O”,而不是代表零的数字。

http://ftp.drupal.org/files/projects/drupal-xxtar.gz 替换为您要安装的版本的链接。

Drupal Core项目页面上提供了推荐版本的链接,您可以从下载列中复制它们。所有其他版本都可以在Drupal核心页面的Releases上找到。

提取文件

键入以下命令,并将“xx”替换为您下载的版本号:

tar -xvzf drupal-x.x.tar.gz
 

然后使用以下命令删除该文件的压缩版本:

rm drupal-x.x.tar.gz
 

移动到预定位置

现在,您需要将drupal-xx目录的内容“up”移动到Web服务器的文档根目录或公共HTML目录中:

mv drupal-x.x/* drupal-x.x/.htaccess ./
 

对于Drupal 7,还添加:

mv drupal-x.x/.gitignore ./
 

Drupal 8附带了几个额外的隐藏文件,所有这些文件都需要移动。

或者,您可以通过键入以下内容将tar存档直接解压缩到正确的目录中:

tar --strip-components=1 -xvzf drupal-x.x.tar.gz
 

您下载和解压缩的目录中的文件现已向上移动到您的Web目录中,您可以删除(现在为空)drupal-xx目录:

rmdir drupal-x.x
 

使用FTP

您可以使用自己喜欢的FTP工具下载Drupal。

  1. 通过单击要安装的版本的链接,从https://www.drupal.org/project/drupal将Drupal tar.gz或zip文件下载到本地计算机。
  2. 下载文件时,浏览器会询问您如何处理该文件。选择“提取”并将其解压缩到本地计算机。或者,保存文件并使用处理存档文件的计算机软件(例如7-zip)将其解压缩。执行此操作的确切步骤因软件而异,但您最终应在本地计算机上使用名为“drupal-7.32”的文件夹/目录。
  3. 使用FTP将此文件夹的全部内容(包括.htaccess等隐藏文件)传输到主机帐户的HTML文档根目录。有关如何执行此操作的详细信息取决于您的FTP软件。

注意: Drupal 8包含的文件大约是早期版本的10倍(由于其新的框架 ),通过FTP上传到服务器的时间可能比早期版本长得多。更快的方式上传Drupal的8作为一个ZIP文件,适用于某些主机描述这里

使用Git

Drupal项目页面有很棒的版本控制指令 ,首先是通过克隆Drupal来设置存储库。

克隆Drupal 8.1.x或更高版本时,您需要使用composer来安装最新的依赖项。从克隆的Drupal存储库的根目录运行composer install ,这将把所有依赖项下载到Drupal期望的位置。另请参阅此方法以使用composer构建网站

如果您没有安装composer,请按照其文档进行操作

第2步:创建数据库

注意:从8.x开始,在安装Drupal之前无需创建数据库。现在,如果输入能够创建数据库的用户的凭据(例如,MySQL / MariaDB中的'CREATE'特权或postgresql中的'CREATEDB'特权),则在Drupal安装时将创建指定的数据库名称(如果它尚不存在。有关更多信息和屏幕截图,请参阅相关更改通知。如果您确实拥有具有这些权限的用户,则可以转到下一步。

在运行安装脚本之前,必须创建一个空的数据库和数据库用户(分配了使用Drupal数据库的权限的用户名)。

Drupal 7

如果在数据库名称中使用大写字母,则它们将转换为小写。数据库名称中的“ - ”(连字符)将在数据库文件夹名称中编码为“@ 002d”。例如,数据库abc的文件夹名称将是@ 002db @ 002dc。除了a..z,0..9和“_”(下划线)之外的其他字符也被类似地编码。 [ref,ref]

Drupal 8

如果在数据库名称中使用大写字母,则它们将转换为小写。允许的字符是a..z,0..9和“_”(下划线)。

第3步:创建settings.php和files目录

Drupal配置文件“settings.php”和“services.yml”概述

为了使Drupal工作,您必须配置数据库的位置,调用数据库的内容以及访问数据库的数据库凭据。此信息存储在settings.php文件中,该文件位于:

sites/default
 

settings.php文件与Drupal 6,7和8相同

当你第一次提取Drupal时,它没有settings.php文件,而是它带有default.settings.php。当您第一次安装Drupal 7时,它将尝试为您复制并重命名default.settings.php - > settings.php。在某些罕见的情况下,您需要手动执行此操作,详细信息将在本页后面详细介绍。

站点/默认文件夹中Drupal 8的新增功能是名为default.services.yml的文件。就像default.settings.php一样,必须重命名default.services.yml才能工作。但是,此文件旨在覆盖核心services.yml文件,如果您需要覆盖它,99%的站点在那里,将不需要覆盖核心services.yml文件。如果您确实需要覆盖这些设置,则可以使用它。在早期开发中,此文件在安装期间自动复制并重命名,但默认情况下,创建services.yml会取代早期方法。换句话说,除非事情告诉你,否则不要担心default.services.yml / services.yml。

最后,默认。[config-file] .php的目的是让您轻松更新Drupal,而不会覆盖运行您站点的整个配置。是的,曾经有一段时间发生了......

自动settings.php概述

默认情况下,当您使用install.php设置站点时,Drupal 7和8将尝试自动创建和填充settings.php文件。该脚本还会更改文件的权限以在完成后对其进行保护,然后创建sites / default / files目录以容纳所有非核心文件。不幸的是,配置了某些类型的共享/本地主机,因此PHP和Apache作为同一个用户运行。这可能导致安装脚本无法执行settings.php文件的创建和填充,以及设置权限和创建文件目录。如果在安装期间引用设置文件时出错,则必须手动创建settings.php文件并执行一些其他任务,然后才能运行install.php。使用写入权限创建后,安装脚本将自动填充站点配置的正确信息。之后,您将不得不重新保护settings.php文件。

此时,跳转到下一页步骤:步骤4:运行安装脚本 。如果由于设置而遇到安装问题,请返回此处并按照下面列出的手动步骤进行操作。

手动设置.php概述

Drupal 6,7和8带有一个示例settings.php配置文件,位于:

sites/default/default.settings.php
 

在运行安装脚本(install.php)之前,需要将default.settings.php文件复制为名为settings.php 的新文件,并将其权限更改为可写入。安装后,您需要再次限制权限。

手动设置.php详细说明

  • 第1步 - 导航和创作

    导航到根Drupal安装的sites/default
    复制default.settings.php 文件并将新文件作为settings.php 保存在同一目录中(请参阅下面有关重命名的说明)。如果您具有shell访问权限(命令行),请从包含Drupal安装文件的目录运行以下命令:

    cp sites/default/default.settings.php sites/default/settings.php

    注意:不要简单地重命名文件。 Drupal安装程序需要这两个文件。

    如果您只有FTP访问权限,则必须将文件下载到计算机,重命名,然后上传。某些托管服务提供商在仪表板上有一个文件管理器,可以复制和重命名该文件。

  • 第2步 - 检查权限是否可写
    默认情况下, sites / default目录和settings.php文件应该是可写的。您可以通过发出以下命令来检查sites / default和settings.php的权限是否可写:

    ls -l sites/

    网站/默认权限应为755 [drwxr-xr-x]:

    ls -l sites/default/settings.php

    settings.php的权限应为644 [-rw-r - r--]:
    如果它们不是可写的,您可以发出以下命令:

    chmod 644 sites/default/settings.php

    注意:如果您与Web用户位于同一组中,则将权限更改为664 就足够了。
    FilezillaTransmitFetch等几个FTP工具允许您使用“文件属性”或“获取信息”命令更改文件权限。在这种情况下,文件权限应设置为644.如果您的FTP客户端具有用于设置权限的复选框,请同时选中“所有者”,“组”和“其他”的“读取”和“写入”框(但不要选中“执行”框) 。在某些情况下,您可能需要664的权限。某些托管服务提供商允许通过仪表板文件管理器执行类似的操作。

  • 第3步 - 尝试安装

    此时,请安装一下。通过运行http:// [yoursite] /install.php来查看是否可以完成安装。如果您成功,您将要访问的第一页是
    报告 - >状态报告 (管理员/报告/状态)

    在报告页面上,查找一行: 文件系统 。如果它说“可写”以外的任何内容,则需要按照下面的步骤4进行操作。

    接下来,查找一行: 配置文件 。如果它显示除“受保护”以外的任何内容,则您需要重新保护配置文件,如下面的步骤5所述。

  • 第4步 - 创建文件目录

    安装应该已经为您创建了sites / default / files目录,但是如果没有,那么您需要手动创建它并在其上设置正确的权限。

    mkdir sites/default/files

    注意:在大多数Linux系统上,已经使用755权限设置了新创建的目录。如果不是,您可以发出命令:

    chmod 755 sites/default/files

    这将files目录设置为755 [drwx-rw-rw]。

    根据您的apache配置的设置方式,您可能需要运行:

    chmod 777 sites/default/files

    这会将files目录设置为777 [drwxrwxrwx]。它不如755安全,但如果你的服务器设置如何,你无能为力。

  • 第5步 - 安装后权限检查

    安装脚本运行后,Drupal尝试自动将权限设置为:

    555(读 - 执行)[dr-xr-xr-x]用于sites / default文件夹。

    设置.php的444(只读)[ - r - r - r--]

    如果没有,您需要手动设置它们:

    chmod 555 sites/default

    chmod 444 sites/default/settings.php

    这些权限是正确的,不应更改,因为更改这些权限会带来安全风险。

第4步:运行安装脚本

Drupal 7安装脚本

要运行Drupal安装脚本,请将浏览器指向您网站的基本URL。

基本URL表示放置Drupal文件的文档根目录(目录)(在Web服务器配置文件中定义)。如果您已在Web主机上安装了Drupal,则可能是域名,例如http://www.example.com 。如果您在子文件夹中安装了Drupal,则应将浏览器指向子文件夹(例如, http://example.com/subfolder )。如果您在桌面计算机上安装了Drupal,则URL可能是http://localhost/drupal

如果只是通过输入站点的基本URL来显示安装过程,请将文件名install.php添加到站点URL的末尾(例如, http://www.example.com/install.php )。

安装过程

运行install.php ,您将被引导几个页面:

在此处输入图像描述

  1. 选择要用于安装的配置文件(标准或最小或您选择的分发)。大多数人应该选择“标准”选项。标准选项附带已启用的默认内容类型,例如文章和页面,并且已设置适当的发布选项。 (当然,您可以稍后编辑这些默认内容类型及其设置,或添加其他内容。)标准配置文件还为您预先启用了一组有用的模块。

    “最小”选项面向更有经验的Drupal网站创建者,他们希望使用相关的发布选项设置自己的内容类型。最小配置文件仅启用了三个模块: 数据库日志记录更新状态

    有关内置安装配置文件的更多信息。

    如果您在第一步下载了发行版而不是正常的drupal,请选择“发行版的名称”。

    在此处输入图像描述

  2. 如果要使用默认英语以外的语言进行安装,请单击“了解如何以其他语言安装Drupal”链接。

    在此处输入图像描述

  3. 如果您的安装目录尚未正确配置,则会在此页面上通知您。您可以单独更正设置,然后刷新浏览器屏幕或单击“再试一次”以查看是否还有任何错误。

    在此处输入图像描述

    报告的错误可能包括:

    缺少目录和/或不正确的权限
    安装程序将尝试自动设置多个目录,但由于权限设置,这可能会失败。在这种情况下,您将找到列出的缺失目录。
    sites/default/files
    sites/default/private
    sites/default/private/files

    这些目录应设置为以下权限:

    chmod o+w sites/default/files

    要么

    chmod 777 sites/default/files
    缺少settings.php或不正确的权限
    如果settings.php 丢失或无法访问,请按照步骤3:创建settings.php文件中的说明操作
    请注意,您将需要default.settings.phpsettings.php 文件。

  4. 输入在步骤2:创建数据库中创建的数据库的数据库名称,用户名和密码。此用户名和密码信息允许Drupal访问您的数据库,以便安装脚本可以创建表。请注意,这不是管理Drupal的用户名和密码;这些将在下一步中创建。

    在此处输入图像描述

    高级选项允许您更改数据库主机('localhost'通常用于此条目:wamp / bin / apache / Apache2.2.11 / bin / php.ini作为运行WAMP的Windows计算机上的位置示例)。您还可以更改端口和表前缀。如果使用非标准端口号,则只需更改端口。如果要安装共享同一数据库的多个Drupal表实例,则表前缀非常有用。

    单击“保存”并继续在页面底部。

  5. 将出现一个进度条,并显示安装程序中有关安装进度的说明。如果没有遇到错误,下一页将自动加载到您的浏览器中。

  6. 安装程序完成后,输入第一个用户帐户的信息(将自动分配完全管理权限)并提供基本网站设置。

    在“站点名称”字段中,输入要用于站点的名称。您也可以稍后通过管理界面进行编辑。

    在“站点电子邮件地址”字段中,输入Drupal在发送注册信息等通知时将使用的电子邮件地址。

    在“站点维护帐户”字段中,输入主管理帐户的用户名,电子邮件地址和密码。请注意,从Drupal 7开始,您在此页面上设置的主管理帐户与您在访问“角色”和“权限”页面时将看到的“管理员”站点管理员用户角色之间存在区别。管理界面。您在安装期间在“站点维护帐户”部分中设置的帐户是一个超级用户,可以全面控制站点管理和配置的各个方面。 (对于那些熟悉Drupal早期版本帐户的人来说,这将是http://www.example.com/user/1 。)

    在此处输入图像描述在服务器设置字段中,选择默认国家/地区和默认时区。

    在“更新通知”字段中,如果希望Drupal服务器在需要更新时提醒您,请选中两个复选框。更新通常与安全问题有关,并且执行起来很重要。但是,如果您具有受限的Internet连接(例如,如果您位于公司防火墙后面),则可能需要取消选择这些设置,然后再进行测试。 在此处输入图像描述

    点击“保存并继续”。成功后,您将看到Drupal安装完成屏幕。如果有任何错误消息,请立即查看并更正。 在此处输入图像描述

保护您的网站

安装完成后,您将需要更改settings.php 文件的权限以使其受到保护:

chmod u=rw,o=r,a=r sites/default/settings.php
 

要么

chmod 644 sites/default/settings.php
 

如果您稍后手动更改了settings.php 文件,请务必在进行修改后再次对其进行保护。

要点 :如果未能删除settings.php 文件的写入权限,则存在安全风险。

尽管settings.php文件的默认位置位于sites/default/settings.php ,但如果您使用多站点sites/default/settings.php ,它可能位于其他位置。


并做了

安装或设置

有关设置或安装drupal-7的详细说明。