主站注册时自动创建PHPBB论坛用户并配置权限方案

放弃依赖ACP临时令牌的插件方案，以下两种可靠方案可实现需求：

方案1：直接调用PHPBB核心函数（推荐，同服务器/可访问文件场景） #

利用PHPBB内置的用户管理函数，在主站注册成功后直接执行注册和权限配置逻辑，无需令牌，稳定可靠。

实现步骤： #

1. 在主站注册成功的回调代码中，引入PHPBB的初始化文件，初始化其运行环境。
2. 调用PHPBB的user_add()函数创建用户。
3. 通过组添加或直接设置ACL，分配对应论坛的访问权限。

代码示例： #

// 主站注册完成后，获取用户提交的信息
$username = 'new_user'; // 替换为实际用户名
$email = 'user@example.com'; // 替换为实际邮箱
$password = 'user_input_password'; // 替换为用户设置的密码
$target_group_id = 10; // 提前创建好的对应论坛权限组ID

// 初始化PHPBB环境（路径需根据你的实际部署调整）
define('IN_PHPBB', true);
$phpbb_root_path = './bbs/'; // 论坛根目录相对主站的路径
$phpEx = substr(strrchr(__FILE__, '.'), 1);
include($phpbb_root_path . 'common.' . $phpEx);
include($phpbb_root_path . 'includes/functions_user.' . $phpEx);
include($phpbb_root_path . 'includes/functions_groups.' . $phpEx);

// 启动PHPBB会话
$user->session_begin();
$auth->acl($user->data);
$user->setup();

// 检查是否已存在同名/同邮箱用户，避免重复注册
$existing_user = user_get_id_name($username);
if (!empty($existing_user)) {
    // 处理重复用户逻辑，比如提示主站用户邮箱已注册
    exit('该邮箱已在论坛注册');
}

// 准备PHPBB用户数据
$user_row = [
    'username'              => $username,
    'user_password'         => phpbb_hash($password), // 使用PHPBB官方哈希函数加密密码
    'user_email'            => $email,
    'user_lang'             => 'zh_cn', // 替换为你的论坛默认语言
    'user_timezone'         => '+8:00',
    'user_type'             => USER_NORMAL,
    'user_regdate'          => time(),
];

// 注册用户到PHPBB
$user_id = user_add($user_row);

if ($user_id) {
    // 将用户加入对应权限组（推荐用组管理权限，更易维护）
    group_user_add($target_group_id, [$user_id]);

    // 若需直接设置单论坛权限（无需组），可调用以下函数：
    // auth_acl_add($user_id, $target_forum_id, 'f_read', 1); // 允许读权限
    // auth_acl_add($user_id, $target_forum_id, 'f_post', 1); // 允许发帖权限
} else {
    // 处理注册失败逻辑
    exit('论坛注册失败');
}

注意事项： #

• 确保主站PHP进程有读取PHPBB文件的权限。
• 路径配置必须准确，否则无法初始化PHPBB环境。
• 提前在PHPBB后台创建好对应论坛的权限组，组权限需设置为允许访问目标论坛。

方案2：使用PHPBB REST API（适合跨服务器场景） #

启用PHPBB的官方REST API，创建信任客户端获取长期有效令牌，通过API完成注册和权限配置，无需依赖临时ACP令牌。

实现步骤： #

1. 在PHPBB后台（ACP）进入「客户端注册」，创建一个信任的客户端，记录客户端ID和密钥。
2. 调用API获取长期有效令牌（只需调用一次，保存到主站配置或数据库）。
3. 主站注册完成后，调用API创建用户并分配权限。

代码示例： #

// 1. 获取长期令牌（只需执行一次，保存令牌后无需重复调用）
$token_url = 'https://bbs.example.com/api/token';
$client_id = '你的信任客户端ID';
$client_secret = '你的信任客户端密钥';

$token_data = [
    'grant_type' => 'client_credentials',
    'client_id' => $client_id,
    'client_secret' => $client_secret,
];

$ch = curl_init($token_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($token_data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$token_response = curl_exec($ch);
curl_close($ch);

$token_result = json_decode($token_response, true);
$access_token = $token_result['access_token']; // 保存此令牌，长期有效（除非手动吊销）

// 2. 注册用户到PHPBB
$register_url = 'https://bbs.example.com/api/users';
$user_data = [
    'username' => 'new_user',
    'email' => 'user@example.com',
    'password' => 'user_input_password',
    'language' => 'zh_cn',
];

$ch = curl_init($register_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($user_data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $access_token,
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$register_response = curl_exec($ch);
curl_close($ch);

$register_result = json_decode($register_response, true);
$user_id = $register_result['user_id'] ?? 0;

// 3. 分配权限：将用户加入对应权限组
if ($user_id) {
    $group_url = "https://bbs.example.com/api/groups/10/members"; // 10为目标权限组ID
    $group_data = ['user_id' => $user_id];

    $ch = curl_init($group_url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($group_data));
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Authorization: Bearer ' . $access_token,
        'Content-Type: application/json',
    ]);
    curl_exec($ch);
    curl_close($ch);
}

注意事项： #

• 确保PHPBB已启用REST API（ACP -> 通用 -> 功能 -> 启用REST API）。
• 信任客户端拥有足够权限（需勾选「用户管理」「组管理」相关权限）。
• 令牌需妥善保存，避免泄露。

为什么之前的ACP插件方案不可行？ #

ACP插件使用的是会话临时令牌，该令牌与管理员会话绑定，会话过期或关闭浏览器后令牌失效，无法用于自动化的批量/实时注册场景，因此必须使用上述两种不依赖临时会话令牌的方案。

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