参考:
https://www.drupal.org/developing/modules/8
https://www.drupal.org/node/1915030
https://www.drupal.org/node/318
Drupal 8 RC 发布了。由于D8使用了Symfony2的内核。与之前版本对比,模块的写法有很大的不同。
新建模块
下面的例子中写一个单独显示“hello world”页面的模块。
首先要给模块起一个唯一的机器名(machine name)
机器名必须满足:
1. 字母开头
2. 只能包含小写字母和下划线
3. 必须唯一,不能与其他模块,主题和配置文件(profile)重名
4. 不能是src, lib, vendor, assets, css, files, images, js, misc, templates, includes, fixtures, Drupal. 这些是保留关键字。
info.yml
在根目录的modules目录中先新建custom和contrib目录。
custom存放我们自己的写的模块,contrib里放从官网下的模块。当然不建这俩目录系统也能识别不过这是规范。然后我们在custom目录下新建"hello_world"目录。
然后新建hello_world.info.yml,在D7是.info文件。此文件记录模块的元信息。就是最基本的信息。
name 模块的名字,description 模块的描述干什么用的。package 属于哪个分组。如Core
属于D8内核模块。
type可以为module,theme或profile。
name: Hello World Module
description: Creates a page showing "Hello World".
package: Custom
type: module
version: 1.0
core: 8.x
composer.json 非必须
新建composer.json
{
"name": "drupal/example",
"description": "This is an example composer.json for example module.",
"type": "drupal-module",
"license": "GPL-2.0+"
}
添加控制器
在hello_world目录中新建/src/Controller/HelloController.php
<?php
/**
* @file
* Contains \Drupal\hello_world\Controller\HelloController.
*/
namespace Drupal\hello_world\Controller;
use Drupal\Core\Controller\ControllerBase;
class HelloController extends ControllerBase {
public function content() {
return array(
'#type' => 'markup',
'#markup' => t('Hello, World!'),
);
}
}
?>
返回这个模块目录下新建hello_world.routing.yml
hello_world.content:
path: '/hello'
defaults:
_controller: '\Drupal\hello_world\Controller\HelloController::content'
_title: 'Hello World'
requirements:
_permission: 'access content'
到此,这个模块算完整的写完,这时候打开地址/hello就会出现hello world的单独页面。