在 Drupal 中创建一个简单的自定义页面

本文将指导你如何在 Drupal 9 中创建一个显示 "Hello, world" 的简单自定义页面。通过创建一个自定义模块，定义路由，并编写控制器，你可以轻松地在 Drupal 网站上添加自定义内容。本文将详细介绍模块的结构、路由配置和控制器代码，并提供注意事项，帮助你避免常见的错误，快速上手 Drupal 开发。

要在 Drupal 中创建自定义页面，通常需要创建一个自定义模块，并在该模块中定义路由和控制器。以下是一个简单的步骤指南：

1. 创建模块目录

首先，在 modules/custom 目录下创建一个新的模块目录，例如 hello。如果 modules/custom 目录不存在，则需要先创建它。

2. 创建 info.yml 文件

在 hello 目录下，创建一个名为 hello.info.yml 的文件，并添加以下内容：

name: Hello World Module
description: Creates a page showing "Hello World".
package: Custom

type: module
core: 8.x
core_version_requirement: ^8 || ^9

这个文件定义了模块的名称、描述、所属包和核心版本要求。

3. 创建 routing.yml 文件

在 hello 目录下，创建一个名为 hello.routing.yml 的文件，并添加以下内容：

hello.my_page:
  path: '/hello'
  defaults:
    _controller: '\Drupal\hello\Controller\ExampleController::myPage'
    _title: 'My first page in D9'
  requirements:
    _permission: 'access content'

这个文件定义了路由 /hello，并将其映射到 \Drupal\hello\Controller\ExampleController::myPage 控制器方法。_title 定义了页面的标题，_permission 定义了访问权限。

vc商城(eshop)

采用目前业界最流行的模版编译系统，所有的页面都可以实现在线/离线修改，只需简单掌握HTML的知识，就可以轻松创建属于自己的个性化的专业用户界面，内建多语言包替换模块，独创的商品参数模版系统，强大的后台管理支持和数据备份功能

下载

4. 创建 Controller 文件

在 hello 目录下创建一个 src 目录，并在 src 目录下创建一个 Controller 目录。在 Controller 目录下，创建一个名为 ExampleController.php 的文件，并添加以下内容：

<?php

namespace Drupal\hello\Controller;

use Drupal\Core\Controller\ControllerBase;

/**
 * Provides route responses for the Example module.
 */
class ExampleController extends ControllerBase {

  /**
   * Returns a simple page.
   *
   * @return array
   *   A simple renderable array.
   */
  public function myPage() {
    return [
      '#markup' => 'Hello, world',
    ];
  }
}

这个文件定义了一个名为 ExampleController 的控制器类，其中包含一个名为 myPage 的方法，该方法返回一个包含 "Hello, world" 的渲染数组。

5. 启用模块并清除缓存

登录 Drupal 管理界面，转到 admin/modules 页面，找到 "Hello World Module" 并启用它。然后，转到 admin/config/development/performance 页面，清除所有缓存。

6. 访问页面

现在，你应该可以通过访问 /hello 或 index.php/hello 来看到 "Hello, world" 页面了。

注意事项：

• 命名空间： 请确保你的命名空间与模块的目录结构一致。例如，如果你的模块名为 hello，则命名空间应为 Drupal\hello。这是最常见的错误来源。
• 缓存： 在修改模块代码后，务必清除 Drupal 缓存，以使更改生效。
• 路由： 检查 routing.yml 文件中的路径和控制器是否正确配置。
• 权限： 确保用户具有访问该页面的权限。在本例中，我们使用了 access content 权限。
• 服务器配置： 某些服务器配置可能会阻止 Drupal 正确处理路由。如果遇到问题，请检查你的服务器配置。

总结：

通过遵循以上步骤，你应该能够成功创建一个简单的 Drupal 自定义页面。记住，仔细检查你的代码，并确保所有配置都正确。如果你遇到问题，请仔细阅读错误消息，并参考 Drupal 文档或在线社区。 掌握这些基础知识，你就可以开始构建更复杂的 Drupal 模块和自定义页面了。