Drupal作为全球领先的开源CMS，其强大的扩展性离不开模块（Module）系统。Drupal模块开发是实现网站个性化功能的核心技能，无论是构建企业官网、文档管理系统，还是集成DeepFlow等工具，掌握模块开发都能让你从容应对复杂的网站开发需求。本文将以Drupal 10和最新发布的Drupal 11为基础，带你从零开始创建专属模块，解锁Drupal的无限可能。

在Drupal生态中，模块是功能扩展的基本单元，如同乐高积木，通过组合不同模块可搭建出多样化的网站功能。模块分为核心模块（Drupal自带）、贡献模块（社区开发）和自定义模块（开发者根据需求编写）。Drupal 10和Drupal 11在模块架构上保持了一致性，同时引入了更高效的API和性能优化，为模块开发提供了更友好的环境。

一、模块开发环境搭建

开发Drupal模块前，需确保环境满足Drupal 10安装的环境要求和Drupal 11的适配标准。推荐使用PHP 8.1+（Drupal 11需PHP 8.2+）、MySQL 8.0+或PostgreSQL 13+，搭配Composer管理依赖。本地开发可选用DDEV或Lando等工具快速搭建环境，配合PhpStorm或VS Code编辑器提升效率。环境配置完成后，通过composer create-project drupal/recommended-project my_module_site创建Drupal项目，即可开始模块开发。

二、Drupal模块的基础结构

一个标准的Drupal模块需遵循特定的文件结构，核心文件包括：.info.yml（模块元信息）、.module（钩子实现）、.routing.yml（路由定义）等。模块文件夹需以小写字母命名，避免特殊字符，例如“custom_hello”。以下是基础结构示例：

custom_hello/
├── custom_hello.info.yml       # 模块元信息
├── custom_hello.module         # 钩子与业务逻辑
├── custom_hello.routing.yml    # 页面路由配置
└── src/                        # 控制器、表单等类文件
    └── Controller/
        └── HelloController.php

三、核心文件编写详解

.info.yml文件是模块的“身份证”，用于声明模块名称、描述、版本兼容性等。以Drupal 11为例，文件内容如下：

name: 'Custom Hello'
type: module
description: 'A simple custom module for Drupal 10/11.'
core_version_requirement: ^10 || ^11
package: Custom
configure: custom_hello.settings

其中core_version_requirement指定模块支持的Drupal版本，确保兼容性。.module文件则用于实现钩子函数，例如通过hook_help()添加模块帮助信息：

/
  Implements hook_help().
 /
function custom_hello_help($route_name, \Drupal\Core\Routing\RouteMatchInterface $route_match) {
  if ($route_name == 'help.page.custom_hello') {
    return '<p>' . t('This is a custom module example for Drupal development.') . '</p>';
  }
  return NULL;
}

四、钩子（Hook）系统与实践

钩子（Hook）是Drupal模块与核心交互的核心机制，允许模块“插入”自定义逻辑。例如，通过hook_menu_links_discovered_alter()修改菜单项，或通过hook_form_alter()调整表单字段。Drupal 10/11推荐使用事件订阅者（Event Subscriber）替代部分传统钩子，提升代码解耦性。以下是通过路由和控制器实现自定义页面的示例：

在custom_hello.routing.yml中定义路由：

custom_hello.hello_page:
  path: '/hello'
  defaults:
    _controller: '\Drupal\custom_hello\Controller\HelloController::hello'
    _title: 'Hello Drupal'
  requirements:
    _permission: 'access content'

在src/Controller/HelloController.php中编写控制器：

namespace Drupal\custom_hello\Controller;

use Drupal\Core\Controller\ControllerBase;

class HelloController extends ControllerBase {
  public function hello() {
    return [
      '#markup' => $this->t('Hello, this is my first Drupal module!'),
    ];
  }
}

五、模块测试与调试技巧

模块开发需注重测试与调试，确保功能稳定。推荐使用Devel模块提供的kint()函数打印变量，或通过\Drupal::logger('custom_hello')->info('Debug message')记录日志。Drupal 10/11支持PHPUnit单元测试，可在模块中创建tests/src/Unit目录编写测试用例。此外，启用模块后需通过“/admin/modules”页面验证状态，访问“/hello”测试自定义页面是否正常显示。

六、Drupal 10与Drupal 11模块开发对比

以下是Drupal 10和Drupal 11在模块开发环境与API上的主要差异：

七、模块开发关键步骤总结

• 准备符合Drupal 10/11要求的开发环境，配置PHP、数据库和Composer；
• 创建模块文件夹及基础文件（.info.yml、.routing.yml等）；
• 编写控制器或钩子函数实现核心功能；
• 通过Devel和日志工具调试代码，确保功能正常；
• 测试模块在Drupal 10和Drupal 11上的兼容性，修复版本差异问题。

八、模块发布与长期维护

模块开发完成后，可打包为.tar.gz文件发布到Drupal.org，需遵循社区贡献规范（如添加README、LICENSE文件）。长期维护需关注Drupal版本升级（如从Drupal 10升级到Drupal 11），及时适配API变化，例如Symfony 7带来的路由组件调整。同时，定期更新模块以修复安全漏洞，提升Drupal网站性能。

九、专业的Drupal服务商

成都长风云Drupal开发团队从2008年开始专注于Drupal开发，已拥有17年的Drupal开发经验。无论您计划从Drupal7升级到Drupal11（或者Drupal10）还是基于Drupal开发新的系统、企业官网、电商网站，维护基于Drupal开发的系统等，我们都能依靠我们的专业技术为您完成。手机号：13795726015 或 微信号：changfengqj

通过本文的步骤，你已掌握Drupal模块开发的基础流程。在实际开发中，你可能会遇到更复杂的场景，例如集成多语言功能、优化SEO策略或对接GEO定位服务。那么，你认为在Drupal 11中，事件订阅者模式是否会完全取代传统钩子？欢迎在评论区分享你的观点和开发经验！