本教程旨在指导开发者如何在 Drupal 中创建一个简单的自定义页面，显示 “Hello, world”。我们将详细介绍模块的创建、路由配置、控制器编写等步骤，并提供示例代码，帮助读者快速上手 Drupal 的模块开发。通过本教程，你将掌握在 Drupal 中构建自定义页面的基本方法，为更复杂的模块开发奠定基础。
创建自定义模块
在 Drupal 中创建自定义页面，通常需要创建一个自定义模块。模块是 Drupal 功能扩展的基本单元。
创建模块目录：在 modules/custom 目录下创建一个名为 hello 的目录。这是我们自定义模块的根目录。如果 modules/custom 目录不存在，请先创建它。
创建 hello.info.yml 文件：在 hello 目录下创建一个名为 hello.info.yml 的文件，用于描述模块的基本信息。
name: Hello World Moduledescription: Creates a page showing "Hello World".package: Customtype: modulecore_version_requirement: ^8 || ^9 || ^10
name: 模块的名称。description: 模块的描述。package: 模块所属的包，通常设置为 “Custom”。type: 模块类型，设置为 “module”。core_version_requirement: Drupal 核心版本要求，确保模块与 Drupal 版本兼容。
定义路由
路由定义了 URL 路径与控制器之间的映射关系。
创建 hello.routing.yml 文件：在 hello 目录下创建一个名为 hello.routing.yml 的文件，用于定义路由。
hello.my_page: path: '/hello' defaults: _controller: 'DrupalhelloControllerExampleController::myPage' _title: 'My first page in D9' requirements: _permission: 'access content'
hello.my_page: 路由的名称，必须唯一。path: URL 路径，用户访问该路径时将触发该路由。defaults: 定义了控制器和页面标题。_controller: 指定控制器类和方法，格式为 Drupal{模块名}Controller{控制器类名}::{方法名}。_title: 页面的标题。requirements: 定义了访问权限。_permission: 指定用户需要拥有的权限才能访问该页面。access content 是一个常用的权限，允许用户访问内容。
创建控制器
控制器负责处理请求并返回响应。
创建 src/Controller 目录：在 hello 目录下创建一个名为 src 的目录，然后在 src 目录下创建一个名为 Controller 的目录。
创建 ExampleController.php 文件：在 src/Controller 目录下创建一个名为 ExampleController.php 的文件，用于定义控制器类。
'Hello, world', ]; }}
namespace: 命名空间必须与模块目录结构一致。class ExampleController: 控制器类名。extends ControllerBase: 继承 ControllerBase 类，提供了一些常用的方法。public function myPage(): 控制器方法，用于处理请求并返回响应。return [‘#markup’ => ‘Hello, world’];: 返回一个包含 HTML 标记的渲染数组，Drupal 将渲染该数组并显示在页面上。
启用模块并清除缓存
启用模块：登录 Drupal 管理后台，进入 admin/modules 页面，找到 “Hello World Module” 模块，勾选并启用它。
清除缓存：进入 admin/config/development/performance 页面，点击 “清除所有缓存” 按钮。
访问页面
在浏览器中输入 /hello 或 index.php/hello 即可访问自定义页面，看到 “Hello, world” 的内容。
注意事项
命名空间： 确保命名空间与模块目录结构一致，这是最常见的错误。缓存： 在修改模块代码后，必须清除缓存才能使更改生效。权限： 确保用户拥有访问该页面的权限。服务器配置： 如果出现 “Page not found” 错误，可能是服务器配置问题，例如 URL 重写未启用。
总结
通过以上步骤，你已经成功创建了一个简单的 Drupal 自定义页面。这个例子虽然简单，但涵盖了 Drupal 模块开发的基本要素。你可以基于此扩展功能，创建更复杂的模块。建议学习 PHP 的面向对象编程和 Symfony 框架的基础知识，以便更好地利用 Drupal 的强大功能。
以上就是在 Drupal 中创建自定义页面的完整指南的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/35878.html
微信扫一扫 
支付宝扫一扫 
