Drupal 8用户编辑页用户角色切换功能实现求助

刚好做过类似的需求，给你一套完整的代码实现，分几步就能搞定：

1. 用hook_form_alter()添加复选框并绑定提交处理程序 #

首先，在你的自定义模块里实现hook_form_alter()，把两个角色复选框加到用户编辑表单，同时把自定义的提交处理函数挂上去：

/**
 * Implements hook_form_alter().
 */
function YOUR_MODULE_form_user_form_alter(&$form, \Drupal\Core\Form\FormStateInterface $form_state, $form_id) {
  // 获取当前编辑的用户实体
  $account = $form_state->getFormObject()->getEntity();
  
  // 添加「司机」角色复选框，默认值根据用户已有角色设置
  $form['driver_role'] = [
    '#type' => 'checkbox',
    '#title' => t('司机角色'),
    '#default_value' => $account->hasRole('driver'),
    '#weight' => 10, // 调整权重控制显示位置
  ];
  
  // 添加「乘客」角色复选框
  $form['passenger_role'] = [
    '#type' => 'checkbox',
    '#title' => t('乘客角色'),
    '#default_value' => $account->hasRole('passenger'),
    '#weight' => 11,
  ];
  
  // 将自定义提交处理程序追加到默认提交逻辑之后
  $form['actions']['submit']['#submit'][] = 'YOUR_MODULE_user_edit_role_submit';
  
  // 可选：添加表单验证，防止用户同时选两个或都不选
  $form['#validate'][] = 'YOUR_MODULE_user_edit_role_validate';
}

注意：替换YOUR_MODULE为你实际的自定义模块名称，driver和passenger要和你在Drupal后台创建的角色机器名完全一致！

2. 编写提交处理函数实现角色切换逻辑 #

接下来实现提交处理函数，负责根据复选框的选择结果添加/移除角色：

/**
 * 自定义用户编辑表单提交处理：管理司机/乘客角色切换
 */
function YOUR_MODULE_user_edit_role_submit($form, \Drupal\Core\Form\FormStateInterface $form_state) {
  // 获取当前用户实体
  $account = $form_state->getFormObject()->getEntity();
  
  // 获取两个复选框的提交值
  $is_driver = $form_state->getValue('driver_role');
  $is_passenger = $form_state->getValue('passenger_role');
  
  // 核心逻辑：选中一个角色时，添加该角色并移除另一个已存在的角色
  if ($is_driver) {
    // 添加司机角色（避免重复添加）
    if (!$account->hasRole('driver')) {
      $account->addRole('driver');
    }
    // 移除乘客角色（如果用户之前有）
    if ($account->hasRole('passenger')) {
      $account->removeRole('passenger');
    }
  } elseif ($is_passenger) {
    // 添加乘客角色
    if (!$account->hasRole('passenger')) {
      $account->addRole('passenger');
    }
    // 移除司机角色
    if ($account->hasRole('driver')) {
      $account->removeRole('driver');
    }
  } else {
    // 如果两个都没选，这里可以自定义逻辑，示例是移除两个角色
    $account->removeRole('driver');
    $account->removeRole('passenger');
  }
  
  // 保存用户实体的变更
  $account->save();
}

可选：添加表单验证（防止非法选择） #

如果不想让用户同时选两个角色，或者两个都不选，可以加上验证逻辑：

/**
 * 自定义用户编辑表单验证：限制角色选择规则
 */
function YOUR_MODULE_user_edit_role_validate($form, \Drupal\Core\Form\FormStateInterface $form_state) {
  $is_driver = $form_state->getValue('driver_role');
  $is_passenger = $form_state->getValue('passenger_role');
  
  // 禁止同时选中两个角色
  if ($is_driver && $is_passenger) {
    $form_state->setErrorByName('driver_role', t('只能选择司机或乘客中的一个角色'));
  }
  
  // 禁止两个都不选（根据你的需求决定是否开启）
  if (!$is_driver && !$is_passenger) {
    $form_state->setErrorByName('driver_role', t('请至少选择司机或乘客中的一个角色'));
  }
}

最后要注意的点 #

• 确保你的自定义模块已经启用，并且依赖user模块（在模块的info.yml里添加dependencies: ['user']）
• 模块需要有修改用户角色的权限，建议给管理员操作普通用户的权限，避免权限问题
• 测试时用普通用户账号编辑自己的信息，或者用管理员账号编辑其他用户，验证角色切换是否正常

内容的提问来源于stack exchange，提问作者Jerzy Stuhr