Drupal开发中文教程，新手入门指引

我是云客，《云客Drupal源码分析》系列的作者，伴随着Drupal 8第一个版本发布开始，每周一期，该系列已经发布逾150余期，超过110余万字，伴随云客对Drupal系统的全面了解，和对该系列的全面修订更新，该系列已更名为《中文drupal教程》，由于历史渊源，读者请知悉这二者的区别，《中文drupal教程》也伴随Drupal新版本的发布持续进行更新，以求对未来版本的知识、变更覆盖，如需查看过往版本请到云客个人网站“水滴间”使用历史版本查看功能。
作为过来人、同时也是时间最早的第一批用户之一，云客觉得有义务帮助初学者准备好行囊，叮嘱好一路上的注意事项，之前也零星写过一些入门方面的资料，会在本文末给出链接（这些资料也很值得参考），本篇将为您全面整理需要的一切和规划学习步骤，这里假定您是一个刚刚学会php正在寻找下一步方向的开发者。

注意：Drupal 7以及以前版本是面向过程开发，Drupal8开始采用OOP开发，代码几乎全部重写，在Drupal发展史上这是一个里程碑事件，从Drupal 8开始，后续的升级都很平滑，核心架构以及许多方面均相同，因此有关Drupal 8的文档通常也适用于Drupal9、Drupal 10.......，D8打下OOP的基础，已成熟部分不会做调整，如有更改的功能会在本系列中列出。

首先是语言问题，Drupal是国际协作的开源软件，以英语作为主要沟通语言，因此很多第一手资料是英语的，但不用担心，一是现在中文资料已经有很多了，二是在官网文档和源代码注释里面使用的英语都非常简单，建议您安装有道词典，该软件可以划词翻译，很方便，在翻译软件的帮助下，八零后初中英语水平（学时三年），在学习上应不成问题，如果换成现代教育，小学英语水平即可，不要被英语阻碍了您的步伐，事后会发现其实这没什么。

然后是搭建本地开发环境，假定您使用win操作系统，这里推荐您使用phpwamp或者phpStudy集成套件，这两个软件都很优秀，它们集成了多个php版本、主流的三种服务器软件、多个mysql版本等等，可以随意切换， 经过简单的配置和本地hosts文件修改就可以在本地安装多个任意域名的站点，对于开发而言非常方便

再选择一款优秀的集成开发工具（IDE），这里推荐您使用phpstorm，这是一款非常优秀聪明的开发工具，智能化水平非常高，在新建项目时内置了以drupal模块方式新建，开启Drupal集成支持后，在开发上带来极大的辅助，这里列出一些最常用的操作和快捷键：
打开drupal类文件：“Ctrl+N”，粘贴类的完全限定名称，回车即可，因为Drupal系统使用PSR-0和PSR-4标准的类自动加载器，phpstorm会依据这自动打开，因此您不需要到文件系统里去手动查找，非常方便，此外对着类名点击鼠标中键可以起到同样的作用，也正因为drupal使用自动加载机制，所以在很多资料里面在谈及某个类文件时，只给出全限定类名，而不会提到类文件的路径，有经验的开发人员或IDE能够通过类名判断出文件所在位置
格式化代码：“Ctrl+Shift+Alt+L”打开格式化代码对话框
添加删除注释：行注释“Ctrl+/”，块注释“Ctrl+Shift+/”，删除时再按一次即可
在某路径下所有文件中查找某字符：“Ctrl+Shift+F”，这非常有用，可以用来查找钩子或函数在哪些地方被使用，关于该功能另外一款软件Sublime也很不错
查看一个类或接口在哪些地方被使用了：光标定位到类名，再点击“Ctrl+B”或“Ctrl+ Alt+B”
云客通常使用4种开发工具，phpstorm是最喜欢的，她还有很多非常棒的功能，这里不一一例举了

在Drupal里面有些变量非常巨大，且存在循环引用问题，如果您采用print_r($var);或var_dump($var);的方式查看，即便有16GB的内存，系统也会被耗尽卡死，因此您需要使用断点调试工具，关于这请查看云客的专门介绍：《php调试工具Xdebug使用教程》，地址：
http://www.indrupal.com/node/158
如果你觉得断点调式不方便也可以安装“yunke_help”模块来打印大变量，这是《云客Drupal源码分析》的配套模块，见下文

开发所需的环境和工具准备好了，我们来谈一谈学习步骤：
首先您需要知道一些基本的Drupal概念，比如：实体、插件、释文、钩子、主题、区块等等，因此建议您花一周的时间去官网浏览一些基本文档，同时也熟悉官网的结构，浏览完后您依然会对一些概念不甚理解，但没有关系，有一个初步的印象足够了，接下来去查看中文资料，对一些疑惑的地方做进一步的了解，以下这些网站都很不错：
爱码文档汇：http://www.nowicode.com/
drupal中国：http://drupalchina.cn/
drupal大学：http://www.drupal001.net/
还有很多，不一一列举了，在浏览这些网站的时候不要对一些高深的内容惦念不放，这一阶段的主要目的是熟悉基本概念、社区、资料来源等等，这会为以后的学习打下基础
接下来您需要一本简单的较系统的介绍Drupal如何使用的中文书籍，推荐《Beginning Drupal 8》，地址：
http://drupalchina.cn/node/6096
该书着重讲解如何使用Drupal，不涉及开发内容，篇幅不多，但较为系统的让您融会贯通了一次，有了一次完整的使用体验，此时您应该可以在使用层面获得一些成就感，对Drupal的强大有更加深入的了解了，此时请您在心里感谢一下那些参与该书翻译的社区成员，龙马组织大家花费了很多的时间，云客有幸也参与了其中一章的翻译，感受到社区的力量和良好氛围，各类翻译工作还在继续，有朝一日您成为过来人也请不要忘记辅助正在入门的新人。

注：为了帮助新人更为快速入门，云客有计划开发一系列的视频教程，读到这里时，你可以求证当前是否已经发开完成20221122

现在您的基础已经足够了，可以开始学习开发，首先您需要对整个系统的主要结构有所了解，drupal是典型的结构简单，但细节繁多，这里需要告诉您一句话：任何web系统都是将请求转化为响应的系统。这是一个非常朴实但博大的理念，这是由symfony框架提出的，symfony在这个理念基础上设计了系统基本流程，如图：

该图非常重要，详细请参考：
https://symfony.com/doc/master/components/http_kernel.html
这也是Drupal的核心执行流程，是系统的核心骨架，同时Drupal也采用了symfony框架的部分组件，因此该链接应是您学习开发时详细阅读的第一篇资料。

关于Drupal和symfony的关系，需要在这里进行一下说明，有一些资料说Drupal是基于symfony的，这里要告诉您这不能说错，但并不恰当，准确的说法是drupal采用了symfony的一些组件，在代码量上symfony占比是非常小的，而且采用的组件中非常多的地方经过了继承修改，如果说是“基于”，那么容易误导学习者，让人误以为必须要先学习symfony才能开始学习Drupal，而事实上完全没有必要，当然如果您已经学习过symfony那么对Drupal的学习会很有帮助，没有学过也没关系，您可以直接开始学习Drupal。说是 “基于”还带来一个误解，一些评论人员会说symfony的bug会影响到Drupal，使得Drupal不安全，更有甚者说Drupal会受制于symfony，其实都是庸人自扰，他们太过高估了symfony的代码占比，又低估了Drupal对symfony的继承修改，云客在此想告诉您：事物的发展是递进的，依次建立在前者的基础上，对前者的担心没有必要，就像我们做web开发不会去担心操作系统或者硬件是不是足够好一样，Drupal作为一款优秀的开源系统势必会接纳和采用已有的优秀第三方组件。

在了解了核心流程骨架后您可以从系统的入口index.php文件开始看一看，接下来马上就是对composer运用的学习，她负责加载系统运行中的所有类文件，此时您可以开始阅读本系列了，从第一篇开始阅读，此系列是依据系统执行流程发布的，跟您的探索步骤相吻合，虽然最初取名为源码分析，实则也是开发者教程，是云客从不知道变为知道的过程中留下的资料，非常注重学习者的心理状态，在您的学习路上答疑解惑，且持续更新，Drupal很庞大，这个过程会很漫长，云客将在此系列的字里行间常伴您左右，直到您可以成为一名Drupal核心贡献人员，这个过程中您仅需要的是：坚持，祝您心有所成，坚持并快乐着。

云客为您准备了一个学习模块：yunke_help模块，下载链接：
http://www.indrupal.com/yunkehelp
该模块专门为drupal学习者打造，适用于D8及以上版本，通过她您可以查看到系统的许多数据，也提供了一些常用操作，不管是学习还是正式的开发，都带来极大的方便，如果您需要一些开发方面的示例代码，可以下载官网的示例模块，下载地址：
https://www.drupal.org/project/examples
更多的资源链接已经集成到了yunke_help模块，请下载查看

最后讲一讲drupal大版本的区别和联系：
在drupal7时，系统是用过程式代码开发的，伴随php语言本身的发展，drupal8实现了一次大飞跃，采用面向对象方式开发（oop），重写了几乎所有代码，因此对于学习而言，版本8是一个新的切入点，您不需要去专门学习D7版本；发展是递进的，D8虽然代码重写了，但很多思想和概念是历史版本的沉淀和延续，如您有兴趣可以多去了解D7版本，如果您学习过D7那么学习D8会容易许多；Drupal9在2020年6月推出，Drupal 10在2022年12月推出，Drupal的发展更新还在继续，但您不必担心学习资料过时，尽管很多资料是直接提到“Drupal8”，因为D9及后续版本是在D8基础上平滑升级，变化远远没有D7到D8那么大，已成熟部分不会改动，更多的是新功能加入，和累积弃用代码删除，在云客看来对于开发者的影响会非常小，因为已经跨入了OOP方式，极大部分代码是不需要变化的，所学内容会被自然延用。

相关链接：
《drupal心得：难的价值、未来趋势、拥抱王者》（写于2018年）：
http://www.indrupal.com/node/165

《为什么选择drupal？为什么做贡献？怎么学？怎么贡献？》（写于2017年）：
https://blog.csdn.net/u011474028/article/details/74295701

《drupal 8 入门》 （写于2016年，强烈推荐看一看，对理解系统整体架构很有帮助）：
https://blog.csdn.net/u011474028/article/details/52514472

“水滴间”网站建立前《云客drupal源码分析系列》发布于以下博客（现该博客已不再更新，仅存留历史内容）：
https://blog.csdn.net/u011474028

专业drupal文档网站：
http://www.nowicode.com/

外记：
《云客drupal源码分析系列》已于2020年8月前成功完成，耗时6年，总字数110余万字，您可以提前看一看完结总结，请见：
《完结篇，云客drupal源码分析系列终于完成了》
http://www.indrupal.com/drupal/success

作者声明：
伴随Drupal不断发布的新版本，本系列教程持续更新，适用于Drupal V8、V9、V10以及后续版本，如未及时更新请反馈。
本Drupal教程为中文原创，并非翻译，来自作者耗时八年对源代码的理解，最初取名为“云客Drupal源码分析”并在社区发布。
作者：云客，微信号及个人网站域名均为“indrupal”；首发于云客个人网站“水滴间”，已发布一百余万字，持续更新中。
鸣谢“未来很美科技”提供的赞助支持，“未来很美（深圳）科技有限公司”是国内专业的Drupal开发公司，总部位于深圳。
如对您有帮助可到“水滴间”进行赞助支持，同时Drupal中国社区需要大家共建共享，云客持开放态度与大家合作推进。
允许任何机构以及个人转载、翻译、引用传播等，但须同步附带本声明。

我是云客,【云游天下，做客四方】,微信号：indrupal，欢迎转载，但须注明出处，讨论请加qq群203286137

​