跳转到主要内容
你行网

Main navigation

  • 首页
  • Drupal
  • 编程与开发
  • 数据库
  • 操作系统与应用
  • 服务器与运维
  • 社区
User account menu
  • 登录

面包屑

  1. 首页

drupal

drupal 图书教程

由 hrs, 7 八月, 2019

7. Drupal教程 - 主题和布局

标签
drupal

在本章中,让我们研究一下主题和布局。Drupal将在安装过程中将Bartik主题安装为默认主题。您可以从Drupal官方网站选择付费或免费主题。通常,布局是文本和图形的排列。选择主题是一个很好的想法,记住在您的网站上使用不同的布局。

第1步 - 转到Drupal官方网站,然后单击“开始”。

drupal-themes-and-layouts-step1.jpg

第2步 - 单击所有主题,如以下屏幕所示。

drupal-themes-and-layouts-step2.jpg

第3步 - 您将获得主题列表。选择您选择的主题(让我们选择自适应主题,因为它包括布局和常规设置,将在本章后面介绍)并单击版本,如下面的屏幕所示。

drupal-themes-and-layouts-step3.jpg

步骤4 - 接下来,右键单击“ 下载文件”并复制链接地址,如以下屏幕所示。

drupal-themes-and-layouts-step4.jpg

步骤5 - 您也可以通过单击存档文件直接下载主题,模块将在您的计算机上本地下载,如下面的屏幕所示。

drupal-themes-and-layouts-step5.jpg

步骤6 - 转到“ 外观”,然后单击“ 安装新主题”,如以下屏幕所示。

drupal-themes-and-layouts-step6.jpg

步骤7 - 您可以粘贴在步骤(4)中复制的链接地址,然后单击安装按钮,如以下屏幕所示。

drupal-themes-and-layouts-step7.jpg

步骤8 - 您也可以上传主题存档,而不是复制链接地址(如果已下载),然后单击安装,如下面的屏幕所示。

drupal-themes-and-layouts-step8.jpg

步骤9 - 出现以下屏幕,等待安装完成。

drupal-themes-and-layouts-step9.jpg

步骤10 - 接下来,单击启用新添加的主题,如以下屏幕所示。

drupal-themes-and-layouts-step10.jpg

步骤11 - 默认情况下禁用主题。要启用它们,请单击“ 启用”并设置默认值,如以下屏幕所示。

drupal-themes-and-layouts-step11.jpg

步骤12 - 单击设置,如以下屏幕所示,以设置站点的外观。

drupal-themes-and-layouts-step12.jpg

步骤13 - 屏幕上弹出布局和常规设置选项,此自适应主题包括标准布局,平板电脑布局,小触摸布局和面板和Gpanel。这些选项控制当前正在使用的AT Admin主题的显示设置。当您的网站显示主题时,将使用这些设置。现在,让我们逐一讨论这些布局。

drupal-themes-and-layouts-step13.jpg

步骤14 - 在标准布局中,您可以选择台式机,笔记本电脑和其他大屏幕设备的布局。

drupal-themes-and-layouts-step14.jpg

  • 选择侧栏位置 - 您可以通过单击单选按钮选择侧栏位置。

  • 设置每个侧边栏的宽度 - 您可以设置第一个侧边栏和第二个侧边栏的宽度,单位为%或px或em。

  • 设置页面宽度 - 您可以设置页面宽度。

  • 设置最大宽度 - 您可以选中或取消选中以设置最大宽度。

  • 此布局的媒体查询 - 媒体查询为不同的媒体设备定义不同的样式规则,默认情况下,此布局将为1025px。

步骤15 - 接下来,单击平板电脑布局,如以下屏幕所示。平板电脑设备将有两个方向横向和纵向。您可以为每个方向配置不同的布局。

drupal-themes-and-layouts-step15.jpg

在Landscape tablet和Portrait平板电脑下,您可以选择侧边栏位置,每个侧边栏的宽度和页面宽度。Landscape平板电脑的媒体查询将是最小宽度:769px和最大宽度:1024px。对于纵向平板电脑,它将是最小宽度:581px和最大宽度:768px

步骤16 - 现在,单击Smalltouch Layout,如以下屏幕所示。Smalltouch布局还有两个方向Landscape和Portrait。您可以为每个方向配置不同的布局。

drupal-themes-and-layouts-step16.jpg

在Landscape Smalltouch中,您可以选择侧边栏位置和设置宽度。的肖像Smalltouch总是显示在具有水平低于主内容的侧边栏堆叠一列。Landscape Smalltouch的媒体查询将是最小宽度:321px和最大宽度:580px,而对于Portrait Smalltouch,它将是最大宽度:320px。

步骤17 - 接下来,单击Panels&Gpanels,如以下屏幕所示。自适应主题支持响应式面板和Gpanel布局。要使用此功能,您可以使用Panels模块,Display Suite(带面板)或Adaptive themes原生Gpanels布局。

drupal-themes-and-layouts-step17.jpg

您可以为每个设备范围选择选项并布置其类型。让我们一个接一个地看。

  • 在标准布局下,您可以选择在标准布局中查看网站时要使用的布局。通过单击TWO,THREE,FOUR,FIVE,SIX或INSET,您可以选择列排列,如下面的屏幕所示。

drupal-themes-and-layouts-step17(1).jpg

  • 对于“ 平板电脑风景”,“平板电脑肖像”和“小笔景观”布局,请执行相同的步骤。

步骤18 - 完成所有配置后,单击保存配置,如以下屏幕所示。

drupal-themes-and-layouts-step18.jpg

评论

由 hrs, 5 八月, 2019

6. Drupal教程 - 块和区域

标签
drupal

在本章中,我们将研究Drupal Blocks&Regions。块是用于组织网站内容的容器对象。它可以显示在您页面的区域中。

以下是创建Drupal Blocks的简单步骤。

步骤1 - 单击Drupal中的Structure,如下面的屏幕所示。

drupal-blocks-regions-step1.jpg

第2步 - 然后,单击“ 块”。

drupal-blocks-regions-step2.jpg

第3步 - 显示Blocks页面。单击“ 添加块”。

drupal-blocks-regions-step3.jpg

步骤4 - 将显示一个阻止页面以创建一个新的自定义块,如下面的屏幕所示。

drupal-blocks-regions-step4.jpg

“阻止”页面上显示以下字段。

  • 阻止设置

drupal-blocks-regions-step5.jpg

  • 块标题 - 输入块的标题。

  • 阻止描述 - 输入关于阻止的描述。

  • 块体 - 输入块的内容。

  • 文本格式 - 选择文本格式,即过滤HTML,完整HTML和纯文本。

  • 区域设置

drupal-blocks-regions-step6.jpg

  • Bartik(默认主题) - 选择要在主题中显示块的区域。

  • 七(管理主题) - 在管理主题中选择要显示块的区域。

  • 可见性设置

drupal-blocks-regions-step7.jpg

  • 页面 - 允许在所有或特定页面上显示块。

  • 内容类型 - 允许显示特定内容中的块,即文章或基本页面。

  • 角色 - 允许显示特定类型用户的块,即匿名用户,经过身份验证的用户或管理员用户。

  • 用户 - 允许每个用户在其设置中自定义块的可见性。

现在,在填写所有字段后单击“ 保存”块。

步骤5 - 您可以查看创建的块,如以下屏幕所示。

drupal-blocks-regions-step8.jpg

评论

由 hrs, 5 八月, 2019

5.Drupal教程 - 主菜单

标签
drupal

在本章中,我们将研究如何在Drupal中创建菜单。菜单对于轻松浏览您的网站非常重要。菜单提供一组帮助您导航的链接。Drupal菜单允许您添加,删除和重命名菜单和菜单项。

以下是在Drupal中创建菜单的简单步骤。

步骤1 - 单击结构→菜单,如以下屏幕所示。

01-drupal-main-menu-step1_0.jpg

第2步 - 单击“ 添加”菜单选项以添加菜单。

02-drupal-main-menu-step2.jpg

步骤3 - 填写所需的详细信息,如以下屏幕所示。

03-drupal-installation-setup-wizard-step4_0.jpg

  • 标题 - 它在管理员菜单栏中显示标题。

  • 说明 - 输入有关菜单的简短说明。说明字段仅显示在菜单列表下的管理仪表板中,但不会向网站访问者显示任何信息。

填写有关菜单的所有信息后,单击“ 保存”按钮以保存创建的菜单栏。

步骤4 - 保存菜单栏后,将显示以下屏幕。在这里,您必须定义创建的菜单页面的路径链接。单击添加链接,如以下屏幕所示。

04-drupal-main-menu-step4.jpg

步骤5 - 显示创建的菜单1页面,如以下屏幕所示。

05-drupal-main-menu-step5.jpg

它包含以下字段 -

  • 菜单链接标题 - 指定菜单项的名称。

  • 路径 - 指定要显示的页面的URL路径。

  • 描述 - 关于菜单链接的描述。

  • 已启用 - 它使项目能够显示在菜单上。

  • 显示为展开 - 如果它包含子菜单,则它将显示在父菜单项下。

  • 父链接 - 它设置菜单的主要结构。

  • 重量 - 设置菜单项的顺序。

填写有关菜单链接的所有信息后,单击“ 保存”按钮,这将保存您的“菜单”链接。

第6步 - 现在弹出以下屏幕。

06-drupal-main-menu-step6.jpg

步骤7 - 单击结构→菜单以获取以下屏幕。

07-drupal-main-menu-step7.jpg

在这里,您将在菜单列表中看到创建的菜单1名称。

评论

由 hrs, 5 八月, 2019

4. Drupal教程-Drupal的结构

标签
drupal

Drupal是一个Web内容管理平台,是构建简单和复杂站点的强大工具。在本章中,我们将讨论用于实现用户界面的Drupal的架构风格。下图显示了Drupal的架构 -

drupal-architecture.jpg

Drupal的架构包含以下层和miuns;

  • 用户

  • 管理员

  • Drupal的

  • PHP

  • 网络服务器

  • 数据库

用户 - 这些是Drupal社区的用户。用户使用Drupal CMS向服务器发送请求,Web浏览器,搜索引擎等就像客户端一样。

管理员 - 管理员可以为授权用户提供访问权限,并且可以阻止未经授权的访问。管理帐户将拥有管理内容和管理网站的所有权限。

Drupal - Drupal是一个免费的开源内容管理系统(CMS),允许组织,管理和发布您的内容,并构建在基于PHP的环境之上。Drupal CMS非常灵活且功能强大,可用于构建大型复杂站点。使用Drupal CMS与其他站点和技术进行交互非常容易。此外,您将能够处理复杂的表单和工作流程。

PHP - Drupal使用PHP来处理由用户创建的应用程序。它需要Web服务器的帮助才能从数据库中获取数据。PHP内存要求取决于站点中使用的模块。Drupal 6需要至少16MB,Drupal 7需要32MB而Drupal 8需要64MB。

Web服务器 - Web服务器是一种服务器,用户通过HTTP(超文本传输​​协议)交互和处理请求,并为Web用户提供构成网页的文件。用户和服务器之间的通信使用HTTP进行。您可以使用不同类型的Web服务器,例如Apache,IIS,Nginx,Lighttpd等。

数据库 - 数据库存储用户信息,内容和站点的其他所需数据。它用于存储管理Drupal站点的管理信息。Drupal使用数据库提取数据,并允许存储,修改和更新数据库。

评论

由 hrs, 5 八月, 2019

3. Drupal 教程- Drupal的系统要求和安装步骤

标签
drupal

本章提供Drupal安装的分步过程。在安装Drupal之前,需要满足以下系统要求。

Drupal的系统要求

  • 数据库 - MySQL 5.1 +

  • Web服务器 -

    • WAMP(Windows)

    • LAMP(Linux)

    • XAMP(多平台)

    • MAMP(Macintosh)

    • Nginx的

    • Microsoft IIS

     

  • 操作系统 - 跨平台

  • 浏览器支持 - IE(Internet Explorer 8+),Firefox,谷歌浏览器,Safari,Opera

  • SSL(安全套接字层) - HTTPS需要有效的安全证书

  • PHP兼容性 - PHP 5.2+

下载Drupal

步骤1 - 从此链接下载Drupal并复制到您的Web服务器 - https://www.drupal.org/project/drupal

步骤2 - 选择要下载的最新版zip文件,如以下屏幕所示。该建议的版本是任一版本的最新稳定版本。

01-drupal-installation-download.jpg

安装向导

在您的系统上设置Drupal非常容易。以下步骤描述了如何在系统上本地设置Drupal。

步骤1 - 下载zip文件并将其解压缩到本地计算机。将文件夹从其当前名称重命名为您选择的任何名称以引用您的站点。

第2步 - Drupal需要MySQL数据库。使用用户/密码创建一个新的空数据库供Drupal使用。(例如,用户为“root”,密码为“root”,否则您可以根据自己的选择进行设置)。

步骤3 - 打开浏览器并导航到Drupal文件路径,您将看到第一个Drupal安装程序屏幕,如下图所示。在我们的例子中,路径是localhost / <Your_drupal_folder>。选择标准选项,然后单击保存并继续。

02-drupal-installation-setup-wizard-step3.jpg

第4步 - 选择Drupal网站的默认语言。

03-drupal-installation-setup-wizard-step4.jpg

选择语言后,单击“ 保存”并继续。

步骤5 - 转到数据库配置页面。您需要输入要使用的数据库类型,以及其他详细信息,如下所示。

04-drupal-installation-setup-wizard-step5.jpg

  • 数据库类型 - 选择数据库类型。默认情况下,它将是MySQL。

  • 数据库名称 - 输入Drupal的数据库名称。

  • 数据库用户名 - 输入MySQL数据库的用户名。

  • 数据库密码 - 输入您为MySQL数据库设置的密码。

单击ADVANCED OPTIONS时,您将看到以下屏幕 -

05-drupal-installation-setup-wizard-step5(1).jpg

您可以填写数据库的高级选项 -

  • 数据库主机 - 输入数据库所在的主机名。

  • 数据库端口 - 输入数据库端口。

  • 表前缀 - 用于在数据库表中添加前缀,这有助于在同一数据库上运行多个站点。

填写完所有信息后,单击“ 保存并继续”按钮。

第6步 - 安装过程在您的计算机上启动。

06-drupal-installation-setup-wizard-step6.jpg

步骤7 - 屏幕上显示配置站点页面 -

07-drupal-installation-setup-wizard-step7.jpg

它包含以下字段 -

  • 站点名称 - 您要为站点指定的名称。

  • 站点电子邮件地址 - 将自动发送电子邮件的电子邮件地址。

  • 用户名,电子邮件地址和密码 - 这些都是用于维护帐户的管理详细信息。

您需要输入所有这些字段,然后单击“ 保存”并继续。

步骤8 - 以下页面显示您的Drupal安装成功将显示在屏幕上。

08-drupal-installation-setup-wizard-step8.jpg

步骤9 - 单击“ 访问新站点”链接,如此图所示。

09-drupal-installation-setup-wizard-step9.jpg

步骤10 - 最后,新安装的Drupal主页出现在屏幕上,如上图所示。

评论

由 hrs, 5 八月, 2019

1. Drupal教程-前言

标签
drupal

Drupal是一个免费的开源内容管理系统(CMS),允许组织,管理和发布您的内容。这种可靠而安全的CMS基于PHP环境构建,可为数百万个应用程序和网站提供支持。本教程将教您如何使用Drupal轻松创建博客或网站。

听众

本教程是为任何具有HTML和CSS基础知识并且有开发网站需求的人准备的。完成本教程后,您将发现自己在使用Drupal开发网站方面具有中等水平的专业知识。

先决条件

在开始学习本教程之前,我们假设您已经了解HTML和CSS的基础知识。如果您不了解这些概念,我们建议您阅读我们关于HTML和CSS的简短教程。

评论

由 hrs, 5 八月, 2019

2. Drupal教程 - 概述

标签
drupal

Drupal是一个免费的开源内容管理系统(CMS),允许组织,管理和发布您的内容。它建立在基于PHP的环境之上。这是在GNU即通用公共许可证下进行的,这意味着每个人都可以自由下载并与他人共享。Drupal用于百万网站,如WhiteHouse.gov,世界经济论坛,斯坦福大学,Examiner.com等等。

什么是内容管理系统?

内容管理系统(CMS)是一种存储您内容的所有数据(如文本,照片,音乐,文档等)的软件,可在您的网站上获得。CMS有助于编辑,发布和修改网站内容。

历史

被称为Drupal核心的Drupal的标准版本由Dries Buytaerti于2001年1月开发。它被认为是各种行业的领​​先CMS。

为什么要使用Drupal?

如果您正在开发具有内容管理系统的网站,Drupal CMS比任何其他CMS都非常灵活。Drupal非常强大,可用于构建大型复杂站点。它是基于PHP的模板,允许非技术用户添加和编辑内容,而无需任何HTML或Web设计知识。使用Drupal CMS,可以轻松地与其他站点或技术交互,因为Drupal可以处理复杂的表单和工作流。它提供超过16000个模块,可以使用Drupal核心和附加模块进行寻址。

特征

  • Drupal使您可以轻松创建和管理您的网站。

  • Drupal使用内置用户界面翻译系统中的任何内容。

  • Drupal使用提要,搜索引擎连接功能等将您的网站连接到其他网站和服务。

  • Drupal是一个开源软件,因此不需要许可费用。

  • Drupal设计高度灵活和富有创意的网站,具有有效的显示质量,从而增加了网站访问者。

  • Drupal可以在Twitter,Facebook和其他社交媒体等社交媒体上发布您的内容。

  • Drupal提供了更多可自定义的主题,包括几个基本主题,用于设计自己的主题以开发Web应用程序。

  • Drupal管理信息站点,社交媒体站点,成员站点,Intranet和Web应用程序上的内容。

好处

  • Drupal是一个灵活的CMS,允许处理内容类型,包括视频,文本,博客,菜单处理,实时统计等。

  • Drupal提供了许多用于开发Web应用程序的模板。如果您正在构建简单或复杂的Web应用程序,则无需从头开始。

  • Drupal易于管理或创建博客或网站。它有助于组织,构建,查找和重用内容。

  • Drupal提供了一些有趣的主题和模板,使您的网站具有吸引力。

  • Drupal拥有超过7000个插件来提升您的网站。由于Drupal是一个开源的,你可以创建自己的插件。

缺点

  • Drupal不是一个用户友好的界面。它需要先进的知识和很少的平台安装和修改基础知识。

  • Drupal是一个新的内容管理系统。它与其他软件不兼容。

  • 与其他CMS相比,性能较低。使用Drupal构建的网站将生成大型服务器负载,并且永远不会以慢速Internet连接打开。

评论

由 hrs, 5 八月, 2019

Drupal 基础教程

标签
drupal

评论

由 hrs, 4 八月, 2019

公开REST API以与API Docs交互

标签
drupal

公开REST API以与API Docs交互

以下部分介绍如何设置REST API以创建,读取,更新或删除API Docs实体。通过以下步骤公开的REST端点使用HTTP基本身份验证处理身份验证和权限。

先决条件:

在开始之前,请确保:

  • 在本地环境中安装Composer以下载Drupal模块,依赖项和修补程序。有关说明,请参阅下载Composer。
  • 安装Apigee Developer Portal Kickstart发行版。有关安装详细信息,请参阅Apigee Developer Portal Kickstart项目页面。

公开REST API

在确保安装了Composer和Apigee Developer Portal Kickstart发行版之后,请按照下面描述的步骤设置REST API:

  • 安装Drupal补丁和附加模块
  • 创建新的角色和服务帐户
  • 设置授权标头

安装Drupal补丁和附加模块

为了公开REST API,我们将下载一个Drupal补丁和一个未包含在Apigee Developer Kickstart发行版中的附加模块。要使用Composer下载这些资源:

  1. 在extra密钥下的项目的根Composer文件中声明补丁。有关更多信息和示例,请参阅此Github存储库。
     

    "patches": { "drupal/core": { "Support entities that are neither content nor config entities":"https://www.drupal.org/files/issues/2019-05-29/3042467-31.patch", "JSON:API call to a member function getTypeName() on boolean": "https://www.drupal.org/files/issues/2019-05-29/3034786-36.patch" } }

  2. 将以下模块信息添加到该repositories部分,如下
    所示:

    "repositories": [ { "type": "composer", "url": "https://packages.drupal.org/8" }, { "type": "package", "package": { "name": "drupal/jsonapi_extras_bulk", "version": "dev", "type": "drupal-module", "source": { "url": "https://github.com/minnur/jsonapi_extras_bulk", "type": "git", "reference": "master" } } } ],

  3. 使用Composer下载模块:
     

    composer require drupal/jsonapi_extras drupal/jsonapi_extras_bulk

  4. 启用以下模块以及它们可能提示的任何依赖项:
     

    cd web drush en jsonapi_extras jsonapi_extras_bulk basic_auth

    注意:如果您使用的是kickstart,可以拨打Drush via 。为了能够从任何地方呼叫drush,安装Drush Launcher。有关详细信息,请参阅http://docs.drush.org/en/master/install。vendor/bin/drush

    每个模块的目的:

    • JSON:API, JSON:API Extras 和 JSON:API批量操作:启用实现JSON:API规范的API服务器并公开配置选项。
    • Basic Auth(核心模块):提供HTTP基本身份验证提供程序。
  5. 以管理员身份登录Drupal实例,然后导航到Configuration> Web services> JSON:API。启用接受所有JSON:API创建,读取,更新和删除操作,如下所示。

    JSON-API-config.png

    注意:如果您在生产系统上运行,则需要禁用任何
    不会使用的REST端点:

    1. 作为管理员,请转到配置> Web服务> JSON:API。
    2. 选择JSON:API Extras选项卡。
    3. 选择批量操作选项卡,然后单击禁用所有资源。
    4. 转至Configuration> Web Services> JSON:API> Resource Types,然后选择Resource overrides 选项卡。
    5. 还原以下资源以启用它们:
      • apidoc - apidoc
      • 文件 - 文件

创建新角色和服务帐户

由于REST API遵循实体访问权限,因此建议您创建新的API文档服务 角色,该角色只能访问API Docs实体上的CRUD操作。要创建具有API Docs服务角色的新用户,以便仅访问API Docs REST API:

  1. 导航到人员>角色>添加新角色并添加API文档服务角色。
  2. 导航到People> Permissions并滚动到页面的Apigee API Catalog部分。
  3. 为API Docs服务启用以下权限:
    • 创建新的API文档
    • 删除API文档
    • 编辑API文档
    • 查看已发布的API文档
    • 查看未发布的API文档
    • 导航到人员>创建新用户并创建仅分配了API文档服务角色的新用户。

设置授权标头

核心JSON:API模块尊重API Doc实体的访问处理程序。要进行读取/更新/删除API调用,您必须向拥有所需权限的用户进行身份验证,如创建新角色和服务帐户中所述。

发送对需要身份验证的资源的请求时,必须将服务帐户用户名和密码编码到Authorization请求的标头中。例如,在PHP中,标题将是:

$auth_header = 'Authorization: Basic ' . base64_encode($username . ':' . $password);

有关此主题的更多信息,请参阅HTTP基本身份验证概述。

与REST API交互

一旦暴露了REST API端点并且您已配置了相应的身份验证和权限,您就应该能够执行任何必要的CRUD操作,如下所述。

获取API文档

要列出您网站上的所有API文档:

curl -X GET \ https://kickstart.local/jsonapi/apidoc/apidoc \ -H 'Accept: application/vnd.api+json' \ -H 'Authorization: Basic XXXXXXXXXXXXXXXX'

要获取单个API文档:

curl -X GET \ https://kickstart.local/jsonapi/apidoc/apidoc/{{uuid}} \ -H 'Accept: application/vnd.api+json' \ -H 'Authorization: Basic XXXXXXXXXXXXXXXX'

创建API文档

POST请求用于创建新资源。要创建新的API Doc,有两种选择。POST请求的格式将根据相关的Open API规范文件是作为文件上载还是URL引用提供而有所不同。下面提供了每种方法的示例:

选项A:使用对spec文件的URL引用创建新的API Doc

curl -X POST \ https://kickstart.local/jsonapi/apidoc/apidoc \ -H 'Accept: application/vnd.api+json' \ -H 'Authorization: Basic XXXXXXXXXXXXXXXX' \ -H 'Content-Type: application/vnd.api+json' \ -d '{ "data": { "type": "apidoc--apidoc", "attributes": { "status": true, "name": "New API Doc", "description": { "value": "<p>Lorem ipsum...</p>", "format": "basic_html" }, "spec_file_source": "url", "file_link": { "uri": "http://other.local/spec.yaml" } } } }'

选项B:创建新的API文档并上传规范文件

要使用关联的Open API规范文件创建新的API文档,我们将发出两个请求。第一个请求是上传文件,第二个请求是创建API Doc实体。

要上传文件:

curl -X POST \ https://kickstart.local/jsonapi/apidoc/apidoc/spec \ -H 'Accept: application/vnd.api+json' \ -H 'Authorization: Basic XXXXXXXXXXXXXXXX' \ -H 'Content-Disposition: file; filename="spec.yaml"' \ -H 'Content-Type: application/octet-stream' \ --data "@/path/to/spec.yaml"

为此请求返回的响应将是新创建的文件实体的JSON:API响应。您需要从响应中解析并提取新文件实体的UUID,以便在第二个请求中使用它来创建API文档:

curl -X POST \ https://kickstart.local/jsonapi/apidoc/apidoc \ -H 'Accept: application/vnd.api+json' \ -H 'Authorization: Basic XXXXXXXXXXXXXXXX' \ -H 'Content-Type: application/vnd.api+json' \ -d '{ "data": { "type": "apidoc--apidoc", "attributes": { "status": true, "name": "New API Doc", "description": { "value": "<p>Lorem ipsum...</p>", "format": "basic_html" }, "spec_file_source": "file" }, "relationships": { "spec": { "data": { "type": "file--file", "id": "{{file_uuid}}" } } } } }'

响应将是201(已创建)响应。响应正文包含新API Doc实体的JSON:API响应。

更新API文档

要在不更改规范文件的情况下更新API文档,请发送以下请求:

注意:这id是必需的。您可以添加应更新的任何其他属性。

curl -X PATCH \ https://kickstart.local/jsonapi/apidoc/apidoc/{{uuid}} \ -H 'Accept: application/vnd.api+json' \ -H 'Authorization: Basic XXXXXXXXXXXXXXXX' \ -H 'Content-Type: application/vnd.api+json' \ -d '{ "data": { "type": "apidoc--apidoc", "id": "{{uuid}}", "attributes": { "status": true, "name": "Updated API Doc", "description": { "value": "<p>Lorem ipsum v2...</p>", "format": "basic_html" } } } }'

响应将是HTTP 200,即更新的API Doc实体的JSON:API响应。

要更新API Doc的规范文件:

curl -X POST \ https://kickstart.local/jsonapi/apidoc/apidoc/{{uuid}}/spec \ -H 'Accept: application/vnd.api+json' \ -H 'Content-Type: application/octet-stream' \ -H 'Authorization: Basic XXXXXXXXXXXXXXXX' \ -H 'Content-Disposition: file; filename="new_spec.yaml"' [... binary file data ...]

此请求的响应将是新上载的文件实体的JSON:API响应。

删除API文档

删除API文档:

curl -X DELETE \ https://kickstart.local/jsonapi/apidoc/apidoc/{{uuid}} \ -H 'Authorization: Basic XXXXXXXXXXXXXXXX'

响应将是HTTP 204(无内容)响应; 即一个空的反应体。

相关资源:

  • 邮递员上面的例子:https://documenter.getpostman.com/view/550470/S1a1aoeF
  • 创建新实体:https://www.drupal.org/docs/8/modules/jsonapi/creating-new-resources-post
  • 更新现有实体:https://www.drupal.org/docs/8/modules/jsonapi/updating-existing-resources-patch
  • 更新附加到实体的文件(“Open API规范文件”):https://www.drupal.org/node/3024331
  • 删除实体:https://www.drupal.org/docs/8/modules/jsonapi/removing-existing-resources-delete
  • HTTP基本身份验证概述

评论

由 hrs, 4 八月, 2019

控制对API文档的访问

标签
drupal

控制对API Doc页面的访问

通过控制用户权限访问,您可以允许匿名用户在开发人员门户中查看已发布的API文档页面,或者将文档限制为注册用户。要启用或限制访问权限:

  1. 以具有管理员或内容创建权限的用户身份登录门户。
  2. 导航到人员>权限> Apigee API目录>在Drupal管理菜单中查看已发布的API文档。
  3. 为每个用户角色选择所需的权限。
  4. 单击保存权限。

控制对API目录页面的访问

您还可以实现对API登录页面的基于角色的访问,该页面显示门户中的所有已发布的API文档。要启用或限制访问权限:

  1. 以具有管理员或内容创建权限的用户身份登录门户。
  2. 在Drupal管理菜单中导航到Structure> Views> API Catalog。
  3. 在“ 页面设置”部分中,单击“ 访问:权限”以根据权限或角色配置对页面的访问权限。
  4. 点击应用。
  5. 单击保存。

评论

分页

  • 首页
  • 前一页
  • …
  • Page 3
  • Page 4
  • Page 5
  • Page 6
  • 当前页 7
  • Page 8
  • Page 9
  • Page 10
  • Page 11
  • …
  • 下一页
  • 末页
drupal
RSS源

友情链接 网站地图 版权信息 联系我们 网址导航 社区

Copyright © 2019 - 2021 你行网 版权所有  粤ICP备19072650号