云客的技术博客【云游天下 做客四方】

由于本博客发布的长篇原创系列：《云客Drupal8源码分析》是一个综合性全面介绍Drupal系统的系列（已超过70万字，尚在继续），有许多示例和操作需要运行，需要一个配套模块，因此云客开发了“yunke_help”模块，该模块是纯粹免费且开源的，没有任何商业性质，仅用于帮助本系列的读者学习drupal，为了方便读者，一直在本博客置顶下载，但在V2.0.0发布后，被CSDN强行下架，理由是涉嫌广告，...

以下内容仅是一个预览，完整内容请见文尾：该篇内容在drupal8学习过程中具有极其重要的地位，除讲述AJAX API后端系统原理外，着重讲述请求格式、系统核心流程控制等，阅读后将对系统主干流程了然于心，鉴于其重要价值，因此收费阅读，款项全部捐赠用于社区建设全文九千字，目录如下：--格式协商--主内容渲染器--主内容渲染流程--AJAX表单提交流程--表单AJAX响应构建器--A...

前端概述：drupal AJAX API前端系统主要是指核心库：core/drupal.ajax，下文简称AJAX库，前端AJAX行为均由该库完成，她主要依赖以下几个重要的库：jquery库core/jquery：整个前端系统是建立在jquery基础之上的jquery表单库core/jquery.form：为表单提交提供支持功能，请见本系列番外篇对此的介绍core/drupal：为...

这是很多读者期待的一个激动人心的时刻，从本篇起，本系列将分多集连续全面介绍Drupal系统的AJAX实现，在阅读前需要掌握一些必须的前置知识，请先阅读本系列以下主题：《全局设置与前端API》《jQuery表单库jquery.form.js详解》此外需要读者熟悉jQuery，如果JS编程不熟悉，云客为你准备了以下教程：《PHP开发者的JavaScript快速教程（phper简明...

本主题是《云客drupal源码分析》的番外篇，在drupal系统中用于支持AJAX API，由于这是一个独立实用的库，因此专门用一个主题介绍简介：jQuery表单库（jquery.form.js库）以jQuery为基础，用于处理表单AJAX提交，使得表单AJAX提交简单、容易，且能完整控制提交过程和处理结果，不需要任何特殊标签辅助，不影响原表单结构，只要使用该库就能使普通表单平滑升级...

本主题接着《前端JavaScript（四）》讲述，推荐按序号阅读核心库core/drupal.form：文件： core/misc/form.es6.js该库做以下事情：一、为jquery对象添加两个扩展方法：drupalSetSummary(callback)设置一个生成摘要的回调函数，调用时接收jquery集中第一个元素作为参数，回调应该返回一个字符串作为摘要；call...

本主题接着《前端JavaScript（三）》讲述，推荐按序号阅读核心库core/ drupal.debounce：文件： /core/misc/debounce.es6.js为全局对象Drupal添加了一个方法： Drupal.debounce(func, wait, immediate)该方法称为防抖函数，用于在给定毫秒时间段内最多执行一次给定的函数，参数如下：func...

以下内容仅是一个预览，完整内容请见文尾：表单的状态是指是否启用、可见、选中、展开等等，状态会依据用户的交互动作而实时变化，该篇讲解实现原理，并在原系统之上提供了一个扩展，可以实现任意复杂的条件比较，如正则比较、范围比较等等，该篇提供实现复杂表单不可或缺的知识点，详细程度和深度远超官网文档，讲述的许多要点知识目前官网文档还处于空白状态，帮助读者彻底理解状态处理全文九千字，目录如下：--核心...

本主题接着《前端JavaScript（一）》讲述，推荐按序号阅读核心库core/jquery：该库用于加载大名鼎鼎的jquery，在Drupal8.7中使用的是v3.2.1版本，此时最新的jquery版本是v3.4.1，网络上有v3.2.1版本的chm格式中文参考手册下载，drupal中大多重要库依赖jquery，本主题不做介绍，但务必学会使用，这是Drupal前端基础也是很多web项目的...

由于drupal前端js内容庞大，本系列将分多个主题逐个讲述较常用和较重要的前端资源库，并以序号进行标识，推荐按序号阅读前言：在开始前端js探索前有一些注意事项：ES6升级：从Drupal8.4开始核心使用ES6开发js程序，但为每个ES6版本的js文件都添加了自动转码的ES5版本文件，因此我们在查看源代码时应该查看ES6版本（也就是.es6.js后缀的文件），里面有开发者清晰的注...

从本主题开始《云客Drupal8源码分析》系列将连续发布和前端js相关的内容，如果您对JavaScript还不熟悉或者需要来一次系统性的整理回顾，在此云客为您准备了以下资料： 《PHP开发者的JavaScript快速文档》首发于爱码文档汇（nowicode.com），您也可以到云客的博客阅读，该篇资料全文6万字，A4页面45页，简明系统的介绍了js相关知识，由于从Drupal8.4开始核...

本文提供word格式文档，下载链接: https://pan.baidu.com/s/1CcM2Dl4_rG0qe0omxPG8zQ 提取码: 9isx前言：每一位PHP开发者或多或少的都掌握一些JavaScript知识，本文写在《云客Drupal8源码分析》前端相关章节发布前，意在帮助沉浸在后端世界的phper快速进入前端js世界（推荐phper关注学习Drupal，那是php世界的珠峰...

drupal可以为页面中的局部区域提供额外的链接，通常用这些链接指向和这个区域相关的页面，这些链接就是本篇所说的菜单上下文链接，在drupal中被大量运用，她们位于哪里呢？以默认安装为例：以管理员身份登录系统后，打开首页，当鼠标悬停在某个块上时，该块右上方将出现一个图标，默认样式为一个圆圈，里面有一只铅笔，该图标就是菜单上下文链接按钮图标，后简称上下文图标或上下文链接按钮，点击上下文图标后将出现一...

菜单本地动作Menu local actions用来为目标路由提供操作动作，在路由对应页面中以操作按钮呈现，比如在呈现某内容列表的路由页面提供一个添加新内容的按钮，可参考内容管理页（/admin/content）的“添加内容”按钮本地动作块：路由页面是以本地动作块来呈现本地动作按钮的，因此需显示本地动作的页面须添加该块，块定义如下：块管理标签admin_label：Primary ad...

菜单本地任务（Menu local tasks）这个名字读者可能会感觉有点生涩，其实通常她就是页面主要内容上方的选项卡栏，可以联想下windows操作系统的任务栏，其中就是一些选项卡，但通常叫任务栏，drupal采用该称呼也体现了其重视计算机术语的统一性；不管是管理主题还是前端主题都用到了她，比如默认的seven管理主题“内容”菜单页面上方的“内容、评论、文件”，再比如默认的Bartik前端主题在...

菜单系统概述：drupal8的菜单系统主要包含四大部分：导航菜单Navigation menus、本地任务Local tasks、本地动作Local actions、上下文链接Contextual links，都非常有用，本篇讲解第一部分：导航菜单，后简称菜单菜单概述：在讲述菜单前，需要先明确一些概念，菜单menu用于在网站中导航，是由菜单链接menu link组成的层次结构，也就是说一个...

以下内容仅是一个预览，完整内容请见文尾：本篇讲解节点实体的访问控制，总结了访问检查链，对“域”、“授权id”进行了清晰论述（该知识点可能是中文资料第一次提及，在英文资料中也非常罕见），带权限控制的实体查询极可能出现错误使用，内部原理和直觉感受不一致，本篇说明了这种权限的范围，以及完整的权限控制方法。全文1.22万字，目录如下：--节点访问检查链--节点实体访问控制处理器--节点访问表...

实体访问控制处理器用于判断账户是否有某种实体操作权限，是整个权限系统的一部分，专门针对实体，本系列已经发布了权限系统上下集，请务必先查看再阅读本篇内容。 是否允许对实体执行某种操作，由该实体类型定义的访问控制处理器来判断，她是相对于实体类型而存在的，换句话说一个实体访问控制器只处理该类型的实体，其属于实体处理器，被设置在实体释文处理器根键的access键下，采用实体处理器的实例化方法，所有实...

以下内容仅是一个预览，完整内容请见文尾：分页器pager是指页面中的分页链接条，用于数据量很大时需要分多页展示的情况，本篇讲解了数据选择、额外链接参数、个性化分页器、实现同页面多个分页器等知识点，涵盖分页器所有方面的内容，提供大量代码示例，并实现了一个带总数显示和跳转功能的增强型分页器，见下图：增强的drupal分页链接条示例分页器pager是指页面中的分页链接条，用于数据量很大时需要分多...

实体列表构建和实体视图构建有相似之处，但并不是一样的概念，从字面意思看列表构建似乎是用于产生实体的索引页面（比如摘要列表页），但产生索引页面是视图构建器的工作，而列表构建则是用于管理工作：用来列出实体以便操作它们列表路由：比如“管理-结构-内容类型”（地址：/admin/structure/types），这个页面就是实体列表构建器产生的列表页面，用于对内容类型进行管理，其路由定义如下：...

在实体视图构建器中构建完实体的基本渲染数组后，会调用实体视图显示对象继续构建实体字段对象的渲染数组，然后合并到基本数组中（合并过程基本数组的优先级更高）以形成完整实体渲染数组，实体视图显示对象内部又依据配置调用字段格式化器来构建每一个字段对象的渲染数组。实体显示对象在视图构建器中的调用入口如下：构建多个实体的字段渲染数组： $display->buildMultiple($entiti...

实体视图显示和表单显示在实现上有许多相似之处，许多类都共用了相同基类，有许多概念和知识已经在本系列的实体表单显示主题中介绍过，如显示模式及其定义等，本篇不再重复介绍，将假设读者已阅读过实体表单显示主题；视图这个词可能会让人感觉生涩，可以将其理解为查看、显示，实体视图构建就是产生实体的查看页面或数据。从节点视图说起：在drupal中最常见的是节点查看，网址如：/node/1，查看节点的路由名为...

音译转化Transliteration服务用于依据发音将Unicode字符串转化为US-ASCII字符串，这和翻译是不同的概念，对于中国人来说最直观的理解就是将中文文字转变为拼音，Unicode涵盖世界所有语言的字符，因此该服务可转换所有的语言，而不仅仅用于中文；在drupal中通常用于依据用户输入产生识别id，如在后台定义字段操作中，输入中文的标签时，系统用该服务自动产生机器名。服务定义及使...

找到让人偷懒的方法，你就可以赚钱。听到有人抱怨每天写博客太累，太复杂，不够简单，机会来了。Twitter，微博客，最简单的方式写博客。听到有人抱怨说网页太多了，信息泛滥，yahoo搜索结果不准确，机会来了，google，最简单最快的网页搜索。 当早年的计算机USB接口在机箱的背后，我们发现要插拔U盘是件多么不方便的事情，于是，机箱的前面也设计了两个USB接口，但是我们又发现，当机箱总是...

我是云客，《云客drupal8源码分析》系列的作者，伴随着drupal8第一个正式版本发布到现在，该系列已经发布100期，超过60万字，作为中国投入精力最大、同时也是时间最早的第一批用户之一，云客觉得有义务帮助初学者准备好行囊，叮嘱好一路上的注意事项，之前也零星写过一些入门方面的资料，会在本文末给出链接（这些资料也很值得参考），本篇将为您全面整理需要的一切和规划学习步骤，这里假定您是一个刚刚学会p...

今天是云客drupal8源码分析第100篇发布的日子，该篇将作为2018-2019春节前的最后一篇发布，回望研究历时已超过三年，该系列总字数已超过60万字，虽取名为源码分析，实则也是开发者教程，可视为与官网文档平行的中文文档项目，完全原创并非翻译，许多时候和官方英文文档也形成互补，官网没有或模糊的知识点可以在这里找到详细解释，内容均来自源代码解读，目前已覆盖了drupal8系统核心大部分知识...

节点表单是系统中使用最频繁最重要的表单，她是建立在许多组件和概念之上的，内容广泛，本篇意在起到一个指示和总结作用，帮助想直接操控节点表单的读者明白需要知道些什么，同时就节点表单本身进行介绍，这好似在爬山到了顶上，顶上并没有多少东西，节点表单就是最终的应用，就其本身并没有多少内容，因此本篇会很短，仅是一个综合运用的总结，更多重要内容是在爬山的路上，没有路上的内容将无法到达山顶，因此在阅读本篇前需...

在某些语境下控件等同于表单中的输入标签，如input、select、textarea等，如在谈论前端设计时，而本篇所指字段控件是程序上的控件对象，用于为字段类型产生输入表单的渲染数组，并负责在表单处理流程中提取输入值、标记验证错误等，解决字段类型的用户输入问题，本篇讲解drupal控件的实现。 字段控件是以插件方式提供，在其释文定义中用field_types指定她可以被哪些字段类型使用...

如果你对以下问题不知道或感兴趣，本篇即是你需要的：1、如何让某个内容类型的标题或其他表单项只允许录入指定的格式？如：只允许产品型号，其他特征不被允许2、如何限制用户的发布频率？如：在指定时间内最多只能发布多少篇文章以下内容仅是一个预览，完整内容请见文尾：在上篇中介绍了执行验证的各组件的作用、原理和验证流程，下篇侧重于实践，并提供了示例代码实体对象转化为类型化数据对象：实体（不管是内容...

以下内容仅是一个预览，完整内容请见文尾：关于实体表单验证主要有三种方式：1、在表单渲染数组上直接通过属性设置的验证，如：#pattern（正则验证）、#required（必填性验证），这在前后端均会自动验证，但这种验证仅支持单个控件2、在表单或其子元素上设置的自定义验证器，这将在表单流程中自动执行，可以进行任意验证3、对于内容实体表单而言，会依据字段定义中设置的约束，通过类型化组件进行验...

以下内容仅是一个预览，完整内容请见文尾：实体的显示分为表单显示和视图显示，前者用于不同情况下的信息输入，后者用于不同情况下的信息展示，本篇很多内容不止用于本篇所讲的表单主题，也是学习drupal视图构建的前置知识。显示模式：一个内容实体类型的编辑表单在不同的情况下可能需要不一样，以用户实体做列子，为了吸引用户快速注册，可以提供一个很精简的表单，比如只有用户名和密码，但用户注册后，在个人资料...

以下内容仅是一个预览，完整内容请见文尾：实体的显示分为表单显示和视图显示，前者用于不同情况下的信息输入，后者用于不同情况下的信息展示，本篇很多内容不止用于本篇所讲的表单主题，也是学习drupal视图构建的前置知识。显示模式：一个内容实体类型的编辑表单在不同的情况下可能需要不一样，以用户实体做列子，为了吸引用户快速注册，可以提供一个很精简的表单，比如只有用户名和密码，但用户注册后，在个人资料...

以下内容仅是一个预览，完整内容请见文尾：实体表单用于提供实体的用户交互，如：创建、编辑、删除等，她建立在表单组件基础之上，提供了对实体的特定支持，在阅读本篇前，请务必先阅读本系列表单相关主题。实体表单操作的是实体，一切围绕实体对象，当删除、编辑实体时，会使用实体储存处理器加载实体，在新建操作时会新建一个实体，实体本身具备CURD方法，在表单中重点处理内容是各阶段如何得到实体对象，派发钩子、...

系统管理工具栏toolbar是指用户登录后页面顶部的黑色条区域，后简称工具栏，里面列出了系统最重要的一些链接，默认有：管理、快捷方式、用户等，点击这些链接后会展开显示对应的子链接。注意这里并没有将工具栏里面的链接称为菜单，在drupal中菜单有明确的定义（请见本系列后续的菜单系统介绍），默认情况下工具栏用到了菜单，但她本身不是菜单，先明确这一点以便于理解一些概念。工具栏由两部分构成：tab：...

一个系统要是没有帮助信息那么会给使用者带来困惑， drupal除了官方网站上面有各种详尽的文档介绍外，还在系统内部内置了帮助系统来提供引导信息，为使用者考虑的很全面，内置帮助系统是由帮助模块来完成的，她通过三种方式向用户提供在线帮助：帮助块、系统帮助主页、模块帮助主页。帮助块：帮助模块提供了一个块：\Drupal\help\Plugin\Block\HelpBlock这是一个很简单的块B...

条件插件在块实体配置中被用到（在默认安装下，系统也只有该处用到），用来指定块在什么条件下才显示，见管理后台：管理》结构》区块布局》点击某个块的配置，每一种类型的条件由一个插件负责，这些插件由条件插件管理器来管理：服务id：plugin.manager.condition类：Drupal\Core\Condition\ConditionManager获取方式：\Drupal::service(...

在drupal中系统流程指向一个控制器，通常控制器返回一个代表特定内容的渲染数组，那么还需要其他内容怎么办？这就是块系统要解决的，她让页面精彩纷呈，可展示多种信息或工具，如果没有她页面会非常单调，某种程度上说她是系统必须的，给各模块展示信息提供页面窗口。从控制器返回的渲染数组说起：一个渲染数组可以代表页面中的一部分，也可以是整个页面，在drupal中大多数时候控制器返回的渲染数组代表页面的一...

drupal可以让你使用任意URL路径来访问某个页面，从而提供良好的SEO支持和语义性，如此强大的功能是由路径处理子系统完成的，在讲解她之前需要明白一个概念：“内部路径”，也就是路由中指定的路径，任意进来的路径都会被路径处理系统转化为内部路径（非可路由内部url除外），从而让系统内部有一个统一的环境，面向内部路径即可，而不用考虑用户到底使用的什么路径，路径处理系统实现了访问路径和系统实现的解耦，路...

以下内容仅是一个预览，完整内容请见文尾：在本系列前面已经发布过一篇语言主题，介绍了一些语言相关的知识以及核心提供的语言相关内容，本篇所讲的语言模块是建立在核心语言组件基础之上的，所以请先阅读那一篇主题；在系统中和语言相关的核心模块有四个：language：本篇主题，站点的多语言基础，支持其他三个模块locale：支持界面翻译content_translation：支持内容翻译confi...

前言：临时储存与消息服务之间并没有什么直接关联，由于她们都是系统基础组件，内容也比较简单，为后续主题做准备，所以放在一起讲解。临时储存概述：临时储存用来储存一些临时性的数据，超期后会被删除，比如节点在保存前的预览数据，她和缓存不一样，她是临时性的、不能被重建的数据，依据被储存的数据在用户间能否互相访问又分为私有和共享。私有临时储存：用户之间不共享数据，只能访问或操作自己的数据，已登录用...

本系列已经发布过内容实体的实体查询，配置实体也是有实体查询的，比如：块知识库服务（\Drupal\block\BlockRepository）中就用到配置实体查询，以查出相同主题下的块配置实体。配置实体的数据通过配置系统保存，先回顾一下我们获取一个配置值的方式： $config = \Drupal::configFactory()->get('system.perform...

该服务为实体类型操作提供辅助方法，这些方法不适合划归到其他组件中，服务定义如下：服务id：entity_type.repository类：\Drupal\Core\Entity\EntityTypeRepository接口：\Drupal\Core\Entity\EntityTypeRepositoryInterface获取方法：$entity_type_repository = \Dru...

drupal表单系统涉及知识很多，本系列已经发布过两篇表单基础知识，为了接下来“块系统”相关的学习需要提前讲解一些进阶的知识，在阅读本篇时建议你也看一看表单相关的渲染元素类型，熟练掌握渲染器的渲染流程，这将大有帮助，关于表单后续还会出多个章节以介绍ajax、实体表单等。子表单：如果一个表单需要由多个组件共同参与构建，那么在构建表单时，需要调用其他组件来产生属于她们那一部分表单的渲染数组，这部...

以下内容仅是一个预览，完整内容请见文尾：至此本系列对插件的介绍全部完成，涵盖了系统插件的所有知识全文目录（全文10476字）：实例化插件插件映射Plugin mapping插件上下文 具备上下文感知的插件 上下文对象 上下文定义对象 上下文定义释文对象 上下文感知插件管理器 上下文处理器 上下文知识库插件表单插件分类插件回退清理被缓存的插件定义插...

为了提高页面加载性能，drupal可以开启资源优化处理，这将在不影响加载顺序及加载条件的情况下，将可聚合的资源文件合并在一起，多个文件变成一个文件，这样就减少了浏览器下载次数，同时还对资源进行缩小化处理，去掉注释、空行、空格、BOM，以及纠正资源编码等，优化器的调用入口是在资源解析器（服务名：asset.resolver）中进行的，本主题讲解资源如何优化。Css集优化器：对页面css文件集...

在阅读本主题前，请先阅读本系的《资源库assets library详解》以详细了解资源库相关知识用于解析页面附加的资源库和渲染数组中的js设置（drupalSettings），执行入口：\Drupal\Core\Render\HtmlResponseAttachmentsProcessor::processAssetLibraries附加资源集：在系统中用附加资源集对象代表一个页面的资...

在阅读本主题前，你需要先阅读本系列的渲染数组、渲染器、渲染占位符等主题附属物attachments就是渲染数组的#attached部分，这里称为“附属物”而不叫做“附件”，以便和图片、文件等概念相区别，附属物有如下8个类型（以在#attached中的键名列出，如果添加了其他键名将引起错误）：library：资源库，保存css、js、库js设置等，详见本系列资源库详解drupalSettings...

在系统派发响应事件时，渲染数组中的占位符内容（$element['#attached']['placeholders']）以及其他附属物还没有被渲染和替换，此操作发生在同样是订阅响应事件的html响应订阅器中（服务id：html_response.subscriber）具体在附属物处理器中替换（服务名：html_response.attachments_processor），在派发响应事件时，系统...

以下内容仅是一个预览，完整内容请见文尾：全文目录（全文11509字）：服务定义及调用入口对原生twig所做变动为twig提供的drupal_core扩展添加的模板函数添加的过滤器复数翻译添加的标签节点访问器调试扩展自定义twig扩展的方法twig扩展哈希加载器自定义加载器twig配置bug：官网文档介绍说：{% set string = '…' %}{% ...

在做项目时，有时需要储存php代码，由于她是可执行的，我们并不希望被随意执行或者修改，drupal提供了一个php代码储存组件来保障这一点，她使用文件系统储存，本篇讲解她的使用和原理。前备知识点：首先我们需要明确知道文件系统操作的以下几点：一个文件有三个时间：创建时间、修改时间、最后访问时间，她们分别对应php函数：filectime()、filemtime()、fileatime...

上集重点介绍了twig模板的使用，供模板设计者阅读，下集供php开发者阅读，讲解如何调用和扩展twig，这一篇安装和采用版本将衔接上集内容。Twig_Environment：该类的实例是twig模板系统的中心枢纽，也叫环境对象，用于保存配置、twig扩展、加载模板等，在她内部调度twig系统的各个类，可以说她是系统的对外使用接口，代表整个twig系统，因此通常用$twig变量名来表示她（在本...

前文：本文是《云客drupal源码分析》系列的番外篇，由于drupal采用了twig模板引擎，因此该篇将详细介绍twig，但不会涉及drupal任何内容，是原生twig的使用详解，分上下两集，上集供设计师阅读，讲解在模板中的使用，下集供php程序开发人员阅读，讲解程序调用、扩展开发。本篇为上集，额外介绍了安装等必要内容，以便首次接触人员查阅，纯模板设计师可以跳过。官网地址：https://t...

主题管理器主要作用是调用模板或主题函数（主题函数不是主题钩子函数，将在D9中移除）将渲染数组转化为页面字符串输出、执行主题修改钩子等，在阅读本篇前，你应该先阅读本系列的以下章节：主题处理器：服务id：theme_handler类：Drupal\Core\Extension\ThemeHandler和主题管理器只一字之差，但功能完全不同，她是更底层的，用于提供主题扩展的扫描、安装等主题协商者：服务i...

以下内容仅是一个预览，完整内容请见文尾：全文目录（全文11509字）：主题钩子定义：主题注册服务：主题实现：主题钩子注册：主题钩子类型：函数注册：扫描注册：注册顺序及覆写：主题钩子、主题函数、模板命名：预处理函数：注册后处理及修改：运行时主题注册表：补充说明：BUG报告:一、在drupal8.5中主题钩子注册逻辑有多个bug，简要说明如下，请避免，这些云客已经向官方提交了报告：1在drupal8系...

在主题处理器一节提到了主题扩展对象（\Drupal\Core\Extension\Extension），该对象包含了一个主题的全部信息，但仅仅是该主题的信息，在系统中许多地方实际使用的是更高层次的活动主题对象（见下），她包含前者所有信息，还处理库覆写、库继承等主题与主题间相互影响的内容，该对象就是在主题初始化器中产生的，同时主题初始化器还负责加载主题主扩展文件等工作。主题初始化器：服务id：the...

drupal主题系统十分灵活，你可以全站使用一套主题，用响应式设计去兼容移动端和pc端，如果响应式无法满足要求，你可以在各端分别使用不同的主题，但其灵活性远不止如此，实际上在同一个站点中你可以根据任意条件使用不同的主题，系统后台设定的只是默认值而已，比如在pc端或移动端你可以为不同语言采用不同主题，甚至不同用户采用不同模板，条件是任意的，只需要简单实现一个主题协商即可，这就是本篇所讲的内容。在dr...

主题处理器theme_handler与主题管理器theme.manager都是系统提供的服务，虽然一字之差但她们功能完全不同，主题管理器用于主题渲染和派发主题修改钩子，而主题处理器完成更为底层的工作，向上为主题管理器、初始化器等各主题相关组件提供基础功能支持，定义如下：服务id：theme_handler类：Drupal\Core\Extension\ThemeHandler获取方法：\Drupa...

以下内容仅是一个预览，完整内容请见文尾：全文目录（全文10512字）：SMACSS资源库静态定义各设置项及属性数组详解资源库动态定义库定义注意事项资源库覆写资源库覆写顺序样式表移除设置资源库继承资源库运用补充说明各位《云客drupal8源码分析》系列的读者：本系列分享希望帮助大家理解drupal8底层原理，并缩短学习时间，但部分重点内容在博客仅发布前言和目录，这是因为：drupal在国外如此流行但...

从本主题开始，云客源码分析系列将连续讲解drupal主题相关内容，主要读者定位为drupal开发人员，以及想深入理解主题系统的前端人员，讲述系统是如何处理主题的，尽量兼顾到不会php的主题开发人员，提供许多要点知识，使他们读后更加深入的理解主题，对一些概念和用法有精确的掌握，由于这样的定位，将少讲解主题开发的入门知识，这方面的中文文章资料有很多，官方也较系统的进行了介绍，你应该先行查阅，如果有疑点...

以下内容仅是一个预览，完整内容请见文尾：在阅读本篇前请先阅读本系列的《云客Drupal8源码分析之页面缓存PageCache的请求策略RequestPolicy及响应策略ResponsePolicy》内部页面缓存和内部动态页面缓存的区别：内部页面缓存Internal Page Cache，服务id：http_middleware.page_cache，可以视为匿名用户缓存（对登录用户不起作用），相...

系统日志让你了解系统内部发生了什么，当出现故障时首先想到的就是日志，drupal日志系统可以按信息类别分别记录日志，并且按照RFC 5424和PSR-3将各类信息按紧迫程度划分为8个级别，这样方便筛选查看；除此外你只需进行简单实现就可在系统发生严重问题时得到及时通知，比如数据库连接不上或系统不可用时发送手机短信给你，本篇将介绍这些。日志等级：依据日志重要性（或严重程度）将信息分为如下8个级别：em...

<?php/** * Class AES * 用于AES加解密数据 * by:云客 【云游天下，做客四方】,微信号：php-world，欢迎转载，但须注明出处，讨论请加qq群203286137 * time:2018-04-27 */class AES{ protected $cipher = MCRYPT_RIJNDAEL_256; //AES加密算法 p...

我们知道web服务器是并发访问的，php脚本被不同的线程或进程执行，他们可能真正的同时执行，现在假设有个操作（比如计划任务）在系统中只能被执行一次，由于这种并发性就可能出现问题，两个同时执行的请求可能带来两次执行，为了解决这个问题我们就需要“锁LOCK”了。锁LOCK服务定义：锁是系统定义的一个服务，定义如下： lock: class: Drupal\Core\Lock\Database...

xdebug是一个php扩展，官方地址：https://xdebug.org/index.php，用于帮助开发者调试代码，本文以目前（2018年3月12日）最新的2.6版本为列来讲解，她具备这些功能：代替php的错误提示：在提示中加入配色以强调不同信息大变量打印：增强var_dump()、print_r()等打印函数的功能，在大变量打印时很有用，避免死机最大递归保护：可以设定最大递归次数限制，防止...

各位《云客drupal8源码分析》系列的读者：本系列分享希望帮助大家理解drupal8底层原理，并缩短学习时间，但部分重点内容在博客仅发布前言和目录，这是因为：drupal在国外如此流行但在国内却很小众，一个重要原因应该是中文资料的缺乏，我们是否能够找到一种方式来激发高质量的中文资料出产？此时同是积极推动者的晴空提出能否用付费阅读的方式来鼓励更多教程作者？并建立了一个付费阅读drupal资料的网站...

HTML类class和ID的命名：HTML标准是由W3C维护的，在它的推荐标准中只对class和id命名有如下要求：类名：一些由空格分隔的字符串ID名：全局唯一，不能含任意空白字符，至少一个字符，可以仅含数字或标点符号，可以以数字、字母、下划线开始等等，见以下资料：https://www.w3.org/TR/html52/dom.html#element-definitions-attribute...

在阅读本主题前建议你先阅读本系列前面的《表单定义示例》主题，看一看在drupal8中是如何运用表单的。表单处理流程：一般情况下表单流程是先显示一个表单，用户填写，然后提交，系统处理，如果有错则重新显示并给出错误提示，反之没有错误那么完成后给出一个响应或者一个重定向响应，这是任何系统的基本流程，drupal也不例外，在drupal中可以这么认为：显示表单和处理提交在系统流程上其实是一样的，只不过后者...

表单form是系统非常重要的一块功能，用于用户向系统提交信息，本主题为你展示如何在drupal8中定义和使用表单，至于表单API如何运作将在接下来的几个主题中详解。表单四要素：要定义一个表单，系统仅需要你提供四个信息，其他事情比如CSRF token攻击验证、渲染等将为你自动完成，非常贴心，需要的四个信息如下：表单识别id：用于唯一标识表单、其他模块通过该id产生的钩子参与表单流程、缓存等表单的构...

本系列即将讲解表单API，那是重要的用户交互组件，在此前有必要讲解一些系统安全相关的问题，为后续的表单API主题打下基础。同源策略：同源策略是浏览器的一个基本安全规则，限制了不同源的页面间脚本的相互操作，当协议、域名、端口三者都相同时被认为是相同的源，否则是跨源，简单点说就是一个页面中的脚本想去操作或访问另外一个源中的页面，是不允许的，关于同源策略网络上有很多资料，这里仅列出一些重要内

以下内容仅是一个预览，完整内容请见文尾：在本系列初期已经发布过了两篇会话主题，属于初级内容，建议你先了解一下，相比之下本篇更加注重实践，全面讲解了drupal的会话系统运行原理及使用方法，补充了许多重要的知识。会话session概念：会话session是客户端和服务器间利用cookie或url以“session_name=session_id”的形式来传递的一个用户凭据，因为HTTP协议的无状态性

你一定好奇为什么控制器只返回了很简单的渲染数组，简单到甚至里面只包含了一个字符串标签而已，可最后的页面为何包含了那么多信息（页头、页尾、侧边栏、搜索框、导航菜单、面包屑路径等等）？是多次执行请求流程再合并结果吗？本主题讲解关键的渲染过程，将回答这些问题。通过本系列前面的学习你现在已经知道了drupal程序部分的主体结构，从本篇开始将越来越多的涉及到看的见的部分：页面外观。完全掌控drupal指日可

通过本系列前面内容的学习你已经知道实体在数据库中是如何存储的，简单来说储存实体的数据库表分为两大类，专用表和共享表，共享表必有基本表，可能有版本表、数据表、版本数据表，总之大多数情况下一个完整的实体被储存在多张表中，比如我们在后台建立一个内容类型，她的数据至少存储在六张表中，这带来一个问题：当开发者需要找出满足特点条件的实体时，如产品名包含特定关键词且价格在某一区间的产品，如果直接采用数据库组件进

一个实体类型创建后，在她的生命周期中，她和她的字段定义可能出现更新、删除操作以满足业务需求，而不是一旦创建就不能被改变，所以要求她的储存Schema是动态的，在发生这样的事情时需要作出反应，典型的就是数据库schema（可简单理解为数据库表结构）的改变和数据的迁移或删除，系统为此定义了以下接口：

内容实体储存处理器类，顾名思义就是解决内容实体的储存问题，这主要有两大块内容：1、 实体数据从储存后端的读写，这个过程需要派发钩子让模块参与进来；2、 实体储存后端的管理，也就是schema的增删改，先有这才能进行数据存取；储存处理器类是drupal核心之一，比较大，但学习完后您将全面彻底理解实体，建议您先阅读本主题文尾的补充内容，那将让你更好更容易理解本主题，然后再回到这里继续阅读。

“字段”概念在drupal中提到“字段”这个概念时，请不要理解为数据库中表的一个列，这不是一个概念，它是指一个字段对象，充当着实体对象的属性，也是一个列表类型的类型化数据对象，当本系列提到“字段field”一般均是指字段对象或字段定义对象，而数据库表中的字段列，则将其称为“列column”；一个字段对象可以包含数据库表中的多个列（取决于字段类型定义中的schema），这些列称为字段对象的属性，

实体字段管理器用于获取和实体类型有关的字段信息，她让各模块参与建设实体类型的字段定义，是所有内容实体类型的字段定义中枢，在涉及实体字段信息时大多会用到她，比如节点实体储存处理器用它来确定数据库表信息，因此很重要，以下讲述她的各种方法

基本Base字段和bundle字段：一个可字段化的实体类型自身定义的字段称为基本字段（非bundle定义，模块可以通过钩子entity_base_field_info添加定义），她们存在于所有的bundle中，也就是说所有bundle可用，基本字段定义可以通过模块的hook_entity_base_field_info_alter()钩子修改，这种修改作用于全部bundle，如果要作用于某个b

实体类型bundle信息服务在容器中的服务id是entity_type.bundle.info，从代码上说这是一个很简单的服务，用以获取系统中实体类型的bundle信息，由于她充分的展示了什么是bundle，进一步帮助理解bundle这个概念，因此本系列将她作为一个独立主题来讲述。服务id：entity_type.bundle.info类：Drupal\Core\Entity\Enti

内容实体基类完成了内容实体的主要功能，具体的内容实体继承她后只需要写少量代码即可使用，不论内容实体类型是否为可版本化的，内容实体类只接受某个版本或默认版本的全部翻译数据，包括源语言，关键词是“一个版本”“全部翻译”，该基类可以为不同语言克隆自己，这些克隆出的实体又关联在一起，这用到了以下设计模式。

字段api的核心为字段对象、字段控件、字段格式化器，在上节中已经强调了字段对象中的字段含义不等于数据库层面的字段（数据表中的列），她是更高一级的抽象，字段对象是一个列表型的类型化数据对象，附属到实体对象作为属性，列表中的每一个条目是一个复合类型的类型化数据对象，可以叫做字段条目对象，字段对象是列表对象决定着字段可以是多值的，这也就是为什么我们在管理后台字段管理中可以设定数量限制的原因，字段条目对象

字段API提供字段储存、类型化、验证等功能，它是内容实体的基石，是学习实体之前不可忽略的内容，而她又是建立在类型化组件之上的。“字段”含义的区别：字段API组件中的“字段”和数据库中表的“字段”含义是不一样的，后者是数据库表中的一个列，前者是一个包含多个信息的数据对象，除包含了后者的值外，还有许多与后者相关的属性和配置，前者直接充当实体对象的属性；在数据库表字段这个层面上，许多cms将

简介：phpMyAdmin是用php开发的mysql数据库管理工具，属于开源自由软件，支持用户通过网页界面对数据库进行广泛的操作，除界面外还支持执行任意sql语句，为了便于使用，提供72种语言，包括从右到左的语言。官方地址为：https://www.phpmyadmin.net/功能概述：1、 通过网页界面管理2、 支持绝大多数MySQL功能。3、 可通过CSV

从本质上讲，插件和钩子机制是系统各个部分传递信息和进行组织的一种机制，他们可以让各部分参与到某件事情中来，他们和事件派发器、服务定义一起形成了系统的神经系统，或称为系统总线或信息高速公路，因为插件、钩子、事件派发器、服务定义有一个共同特点：连接系统的各个部分，从而让核心和模块没有明确的边界，他们是一个整体，模块可以像核心一样参与系统建设，从而实现了drupal的高度模块化。在上篇中介绍了插件的基...

用于观察drupal的模块多少对性能的影响，模块多少直接影响钩子函数的查找次数，函数查找速度影响性能注意模块多少对整体性能的影响中，钩子只是其中一项：<?php$php = "<?php\r
";for ($i = 0; $i < 10000; $i++) { $function_name = "f" . bin2hex(random_bytes(16));

内容实体用于处理系统四大信息类别（内容、会话、状态、配置）中最主要的内容信息，如栏目内容、评论内容、会员数据、文件信息等等，是一个比较庞大的子系统，涉及内容很多，本主题介绍一个概况，帮助后续学习，在后续主题中对各细节会有非常详细的介绍。数据建模：如果你是第一次听到这个词，可能会觉得抽象，但它的含义却是很简单的，就是为一个对象确定数据模型的过程，这里举一个列子来说明：假设你要做一个卖杯子

据联合国教科文组织曾发布的《濒危语言图谱》的数据，在这颗星球上我们的文明有7000种语言，另据德国出版的《语言学及语言交际工具问题手册》有5651种语言，具体有多少谁也说不清，但我们知道人类文明大体有数千种语言之多，中国就有129种语言，世界80%的人讲83种主要语言，drupal系统默认提供的语言列表有95种，但非常可惜的是许多语言正在衰亡，人类是个大家庭，文明需要多样性，计算机系统要将人类文明

在本系列的前面介绍了实体基础和配置系统的部分内容，现在已有足够的预备知识，我们结合一个具体的实体列子来看一看实体是怎么实现的，本篇讲解用户角色实体。权限判断：判断用户是否具备某权限是从用户账户对象中得知的，默认账户对象为：Drupal\Core\Session\UserSession实例化账户对象是在以下方法中：Drupal\user\Authentication\Prov

在drupal中有些对象会存在依赖关系，被依赖的对象存在后，依赖它的对象才能被安装，这往往是后者需要前者提供的功能或者信息，否则无法运行；例如：节点类型创建后才能创建他们的字段，这两者都创建后才能创建视图显示配置；依赖可以有很多级，一级一级的形成依赖链条，在安装和卸载某对象时需要考虑依赖问题，这需要依赖运算处理、依赖如何表示等等，在系统中可以具备依赖属性的对象分为四大类：模块、主题、内容实体、配置实体；本主题讲解以上内容。

精炼一点看实体由两大部分构成：数据和动作，实现各种动作的类我们称之为实体处理器，有很多，如储存处理器、表单构建处理器、访问控制处理器、翻译处理器等等等等，这些类在实体释文的handlers属性中指定，系统为实体处理器提供了一个通用接口：Drupal\Core\Entity\EntityHandlerInterface但并不要求所有的处理器一定要实现它，如果处理器实现了它，实例化时会将服务容

以下是云客在一次drupal聚会上的分享，截取出来分享给所有人我来自哪里？我是谁？我将去向何处？这号称哲学三大终极问题，相信许多小伙伴都思考过，什么样的人生才是自己想要的呢？要怎么过好她呢？首先，目前的科技已很发达，应该有听过人工心脏、电子义眼、人工耳蜗、机械手臂等等吧，这些东西已可以安装到人体，这就出现了一个问题：如果不停替换身体部件，那么这个人到什么程度不再是这个人了呢

以下是2017年7月2日深圳drupal聚会上的分享整理，录音请查看以下网址，音频资料内容略有差异，大体相同：http://pan.baidu.com/s/1mhASSMO?qq-pf-to=pcqq.c2c#list/path=%2F关于Drupal的为什么和怎么做大家好：我是《云客drupal8源码分析》系列分享的作者云客，在去年（2016年）9月11日drupal深圳社区聚会

配置实体基类是系统定义的一个用于配置实体的抽象基类，继承自实体基类，完成了配置实体的大部分通用功能，具体的配置实体往往会继承它，比如用户角色实体，这样写少量代码即可，类定义如下：Drupal\Core\Config\Entity\ConfigEntityBase实现了配置实体接口：Drupal\Core\Config\Entity\ConfigEntityInterface该接口继

注：本系列先前已发布过两篇关于实体基础性介绍的主题：《实体概述》和《实体类型管理器、实体类型、实体》，请先查阅，从本主题开始将深入到具体的代码细节，并以序列编号有关实体的主题，该序列将指导学习的顺序。纵观实体概念有一些要点：实体对象本身：保存着数据和一些常用方法实体类型对象：保存实体的元数据，来自于实体类定义中的释文头部实体处理器：一系列针对实体处理的一些操作，如储存、访问控制

在上篇中讲了配置schema和配置对象类型化，那么如何得到配置对象的类型化数据对象呢？该对象是类型化配置管理器通过schema定义实例化完成的，在配置对象Drupal\Core\Config\Config中已经展示了得到它的方法， 如下：Drupal\Core\Config\Config::getSchemaWrapper()配置对象中的schemaWrapper属性就是该配置对象的类型化

大千世界那么丰富，事物的种类不计其数，却源自于一百多种元素，而这些元素又源自几种基本粒子，随着人类科技进步，进入更加微观的世界，也许会发现我们这个世界所有的事物万物归宗源于同一种东西，这种奇妙的现象也发生在数字世界里，那就是数据的类型，基础层面仅有为数不多的几种基本数据类型，然后由它们形成许许多多各样的类型

系统可以有多种语言，其中一种被设定为系统默认语言，配置信息根据不同语言可能是不同的，跟语言相关的部分有对应变体（或者说是翻译），由此根据语言将配置归类到多个集合里，换句话讲即每种语言都是一个配置集Collection（在数据库活动配置储存表config中以collection字段标识，如果是前文提到的针对角色、上下文等进行的覆写，该字段则标识不同的角

在cms中配置信息非常重要，储存管理员及模块的各种设定，以它指导系统行为等等，在系统中是四大类信息（内容、会话、状态、配置）之一，drupal中配置系统是一个比较大且重要的系统，本系列将分多节进行讲解。配置信息是可以在两个安装实例之间转移的，比如在开发站点导出配置，然后在生产站点导入，而状态信息是不能转移的，可以重置，重置后状态信息消失，配置信息继续有效，针对配置信息可以导入导出，有此功能就可以支持用版本控