Drupal8模块开发-命名和放置Drupal8模块

翻译者:长风Drupal开发

原文地址:https://www.drupal.org/docs/8/creating-custom-modules/naming-and-placing-your-drupal-8-module

开始之前

如果你想要在你的测试站点得到所有PHP错误信息,通过下面的方式进行设置:https://www.drupal.org/node/1056468

tail -f /var/log/apache2/error.log

error_reporting(E_ALL);

ini_set('display_errors', TRUE);

ini_set('display_startup_errors', TRUE);

修改php.ini文件,把错误报告修改为 E_ALL | E_STRICT

命名Drupal8模块

创建Drupal模块的第一步是选择一个Drupal8模块的名字,或者叫机读名。

注意:在你的模块机读名中,不能使用大写开始。

为你的Drupal8模块创建一个文件夹

假如我们的Drupal8模块名字为hello_world ,在你的Drupal8的安装文件下创建文件夹/modules/hello_world或者/sites/all/modules/hello_world,开始Drupal8模块开发。没有必要写“custom”因为核心模块位于/core/目录下。

注意你没有必要使用模块的机读名作为文件夹的名字,(翻译者备注:即这里的hello_world)。当然你可以使用hellWorld。尽管如此,你必须记住,在程序里面和文件名字必须使用模块的机读名字。

在之前的Drupal版本中,要求自定义的模块位于/sites/all/modules/文件夹下面,因为核心模块位于/modules文件夹。在Drupal8中,/modules文件夹被释放给自定义模块和第三方模块使用。所有的核心模块和库文件都放置在/core目录下。在drupal8中,你仍然可以和在Drupal6/7中一样,把你的自定义模块和第三方模块放在/sites/all/modules目录下。当然你也可以放在/modules目录下,二者的效果是一样的。

代码规范

我们强烈建议你遵循Drupal代码规范http://drupal.org/node/318,当你写你自定义的模块的时候。