在 Drupal 中创建一个简单的自定义页面-php教程-PHP中文网

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

DDD

发布： 2025-10-03 18:13:15

原创

132人浏览过

在 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 定义了访问权限。

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. 启用模块并清除缓存

6. 访问页面

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

注意事项：

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