MENU
  1. ホーム
  2. IT
  3. Drupal
  4. Drupalでカスタムモジュールを作ってみよう

Drupalでカスタムモジュールを作ってみよう

Drupal

この記事ではDrupalでカスタムモジュールを作成するやり方をご紹介します。

目次

Drupalを使ってWEBサイトを作る流れ

1. コアモジュールで機能を実現する
Drupalインストール時に用意されているモジュールで実現できないか検討します。

2. コアモジュールでできないことをコントリビュートモジュールで実現する
Drupal.orgで公開されているコントリビュートモジュールで実現できないか検討します。

3. コントリビュートモジュールで実現できない機能をカスタムモジュールで実現する
ここまで検討して実現できていない場合は独自の機能である可能性が高いです。
そのためルーティングやテンプレートを活用してカスタムモジュールで機能を実現します。

まずはコアモジュールやコントリビュートモジュールで実現できないか？という観点で検討します。
なぜならばコアモジュールやコントリビュートモジュールで実現できれば、
インストールと設定で作業が済むため圧倒的にコストを抑えることができるからです。

ですがそのサイト独自の機能であれば出回っている可能性が非常に高いです。
そのような場合はカスタムモジュールを作成して機能を実現します。

今回はサンプルのモジュールを用いてカスタムモジュールの作成方法をご紹介していきます。

今回作成するモジュール

image.png
画面にアクセスすると文字列を表示するページを作ってみます。
文字列はプログラムで指定した値を表示します。

カスタムモジュールを作成する

モジュール用のフォルダを作成する

web/moudles配下にcustomフォルダを作ります。

mkdir custom

さらにその配下にカスタムモジュール用のフォルダを作ります。
このフォルダはカスタムモジュール1つに対して作成し、フォルダ名はカスタムモジュールのマシン名にします。
今回はhello_moduleというマシン名で作成します。

mkdir hello_module

設定ファイルを作成する

設定ファイルはそのモジュールの名前や説明、対応するコアバージョンを定義するファイルです。
先ほど作成したweb/modules/custom/hello_moduleにhello_module.info.ymlを作成します。

touch hello_module.info.yml

ファイル名のhello_moduleの部分は作成するモジュールのマシン名に置き換えてください。

name: HelloWorld
type: module
description: '画面に「Hello, World!」を表示します。'
package: Custom
core_version_requirement: ^9 || ^10

今回設定ファイルに定義した項目はそれぞれ以下の通りです。

name : モジュールの名前です。管理画面に表示されます。
type : モジュールの場合はmoduleで固定です。
description : モジュールの説明です。管理画面に表示されます。
package : Customというパッケージで管理することを表しています。無くても問題ないです。
core version requirement : どのコアバージョンで動作するかを指定します。

これでモジュールとして必要最低限作成できました。
この状態でインストールは可能ですがまだ何も機能がないのでここからカスタマイズしていきます。

image.png

ルーティングを作成する

ルーティングとはURLとそのURLにアクセスしたときに動作するプログラムを紐づけることです。
hello_moduleでは/hello_worldというURLにアクセスしたら文字列を表示することにします。

hello_module.info.ymlと同階層にhello_module.routing.ymlを作成します。
以下の内容を記載します。

hello_module.content:
  path: '/helloworld'
  defaults:
    _controller: '\Drupal\hello_module\Controller\HelloWorldController::display'
    _title: 'Hello, World!'
  requirements:
    _permission: 'access content'

次にルーティングで指定したプログラムを作成します（controllerに指定したプログラム）。
hello_module.info.ymlと同階層にsrcフォルダを、
さらに配下にControllerフォルダを、
そしてその配下にHelloWorldController.phpを作成します。

mkdir src
mkdir Controller
touch HelloWorldController.php

HelloWorldController.phpは以下のソースコードです。

<?php
namespace Drupal\hello_module\Controller;

use Drupal\Core\Controller\ControllerBase;

class HelloWorldController extends ControllerBase {

    public function display() {
        $arr = [
            '#theme' => 'custom_template',
            '#text' => 'Test',
        ];
        return $arr;
    }

}

次にルーティングファイルのテンプレートを作成します。
hello_module.info.ymlと同階層にtemplateフォルダを、
その配下にcustom-template.html.twigを作成します。

mkdir template
touch custom-template.html.twig

custom-template.html.twigは以下のソースコードです。

<p>Hello, World!</p>
<p> Welcome to our {{ text }} site</p>

モジュールフックを作成する

最後にモジュール用のフックを作成するためのファイルを作ります。
hello_module.info.ymlと同階層でhello_module.moduleを作成します。

touch hello_module.module

hello_module.moduleの内容は以下の通りです。

<?php

/**
* Implementation of hook_theme()
*/

function hello_module_theme($existing, $type, $theme, $path) {
    
    $arr = [
        'custom_template' => [
            'variables' => ['text' => ""],
        ],
    ];

    return $arr;
}

ここまででモジュールが作成できました。
最後にモジュールをインストールします。

モジュールをインストールする

管理画面の機能拡張にアクセスします。
フィルターでhello_moduleを検索し、チェックを入れてインストールを実行します。
image.png

以下のようなメッセージが出ればインストール成功です。
image.png

確認のため/helloworldにアクセスしてみます。
image.png
無事文字列を表示することができました！
テンプレート上でtestという変数に入っていた文字列も表示できています。

以上がカスタムモジュールを作成するまでの流れです。

さいごに

今回はDrupalでカスタムモジュールを作成する方法をご紹介しました。

もしコアモジュールでもコントリビュートモジュールでも実現できない機能があれば
今回ご紹介した内容を参考にぜひモジュールを作ってみてください。

この記事ではページとして機能を提供するモジュールを作成しましたが、
実際にはブロックやAPIとして作成することもできます。

Drupal
CMS Drupal Drupal10 PHP
目次