PHP 解析 Discord 用户 public_flags 获取真实徽章信息

理解 Discord public_flags 的位掩码机制

在 discord api 中，用户的 public_flags 字段是一个整数，它并非简单地累加各个徽章的数值，而是一个位掩码（bitmask）。这意味着每个独特的徽章都对应一个2的幂次方的数值（例如 1, 2, 4, 8, 16 等），这个数值在二进制表示中只有一个位是1。当一个用户拥有多个徽章时，这些徽章对应的数值会被“按位或”操作组合成一个单一的 public_flags 整数。

例如，如果一个用户同时拥有徽章 A（值为 1，二进制 001）和徽章 B（值为 4，二进制 100），那么他的 public_flags 将是 1 | 4 = 5（二进制 101）。要从 5 中解析出用户拥有的徽章，就需要使用位运算。

Discord public_flags 徽章映射表

为了正确解析 public_flags，我们需要一个完整的徽章数值与名称的映射表。以下是 Discord API 中常见的 public_flags 及其对应的徽章名称：

使用 PHP 进行徽章解析

要从 public_flags 中提取出用户拥有的具体徽章，我们可以利用位与（Bitwise AND, &）操作。其原理是，如果 (用户flags & 徽章值) 的结果大于 0（或者等于徽章值本身），则表示用户拥有该徽章。

以下是使用 PHP 实现这一解析逻辑的完整代码示例：

立即学习“PHP免费学习笔记（深入）”；

 'Discord_Employee',
    2      => 'Partnered_Server_Owner',
    4      => 'HypeSquad_Events',
    8      => 'Bug_Hunter_Level_1',
    64     => 'House_Bravery',
    128    => 'House_Brilliance',
    256    => 'House_Balance',
    512    => 'Early_Supporter',
    16384  => 'Bug_Hunter_Level_2',
    131072 => 'Early_Verified_Bot_Developer',
];

// 假设从 Discord API 获取到的 public_flags 值为 644
$userPublicFlags = 644;

/**
 * 使用 array_filter 结合位运算来解析用户拥有的徽章。
 *
 * @param array $badges 徽章映射表。
 * @param int $flags 用户 public_flags 值。
 * @return array 包含用户所拥有徽章名称的数组。
 */
function getOwnedDiscordBadges(array $badges, int $flags): array
{
    // 使用 array_filter 遍历所有可能的徽章
    // 匿名函数会为每个徽章键值对执行
    return array_filter(
        $badges,
        function ($badgeName, $badgeValue) use ($flags) {
            // 进行位与操作：如果 (用户flags & 徽章值) 大于 0，
            // 则表示用户拥有该徽章，返回 true 以保留此徽章。
            return ($badgeValue & $flags) > 0;
        },
        ARRAY_FILTER_USE_BOTH // 指定回调函数接收键和值
    );
}

// 调用函数解析徽章
$ownedBadges = getOwnedDiscordBadges($discordBadges, $userPublicFlags);

// 输出解析结果
echo "用户 public_flags: " . $userPublicFlags . "\n";
echo "用户拥有的徽章:\n";
foreach ($ownedBadges as $badgeValue => $badgeName) {
    echo "- " . $badgeName . " (值: " . $badgeValue . ")\n";
}

echo "\n--- 原始 var_dump 格式输出 ---\n";
var_dump($ownedBadges);

?>

代码解析：

黑点工具

在线工具导航网站，免费使用无需注册，快速使用无门槛。

下载

1. $discordBadges 数组： 这个数组存储了所有已知的 Discord 徽章及其对应的数值。这是解析的基础。
2. $userPublicFlags 变量： 模拟从 Discord API 获取到的 public_flags 值。在示例中，我们使用 644。
3. getOwnedDiscordBadges 函数：
   • 它接收徽章映射表和用户的 public_flags 作为参数。
   • array_filter() 函数用于过滤数组元素。在这里，我们希望保留那些用户实际拥有的徽章。
   • 匿名函数 function ($badgeName, $badgeValue) use ($flags) 是 array_filter 的回调函数。它会遍历 $discordBadges 数组中的每个徽章。
   • use ($flags) 允许匿名函数访问外部的 $flags 变量。
   • ARRAY_FILTER_USE_BOTH 是 array_filter 的一个标志，它告诉回调函数同时接收数组的键（$badgeValue）和值（$badgeName）。
   • 核心逻辑 ($badgeValue & $flags) > 0： 这是位与操作。
     • $badgeValue 是当前迭代到的徽章的数值（例如 4 代表 HypeSquad_Events）。
     • $flags 是用户的总 public_flags 值（例如 644）。
     • 如果 ($badgeValue & $flags) 的结果大于 0，说明 public_flags 中包含 badgeValue 对应的位，即用户拥有该徽章。例如，4 & 644 的结果是 4（因为 644 的二进制是 1010000100，4 的二进制是 0000000100，它们在第三位都有1），所以 4 > 0 为真。
     • 如果结果为 0，则表示用户不拥有该徽章。
   • array_filter 会返回一个新的数组，其中只包含回调函数返回 true 的那些徽章。

示例输出：

运行上述代码，对于 userPublicFlags = 644，你将得到以下输出：

用户 public_flags: 644
用户拥有的徽章:
- HypeSquad_Events (值: 4)
- House_Brilliance (值: 128)
- Early_Supporter (值: 512)

--- 原始 var_dump 格式输出 ---
array(3) {
  [4]=>
  string(16) "HypeSquad_Events"
  [128]=>
  string(14) "House_Brilliance"
  [512]=>
  string(14) "Early_Supporter"
}

这与问题描述中指出的 Hypesquad Event + Brilliance + Early_Supporter 完全吻合。

注意事项与总结

• 徽章列表的及时性： Discord API 的徽章列表可能会随时间更新。因此，建议定期检查 Discord 官方文档或 API 变更日志，以确保你的徽章映射表是最新的。
• 通用性： 位掩码解析是一种非常常见的技术，不仅限于 Discord API。在许多需要用一个整数表示多个布尔状态的场景中，都可以采用这种方法。
• 性能： 位运算是计算机底层操作，通常非常高效。即使处理大量用户数据，这种解析方法也能保持良好的性能。

通过理解 public_flags 的位掩码原理并应用简单的位运算，开发者可以轻松准确地从 Discord API 数据中提取出用户的真实徽章信息，从而在应用中进行展示或基于徽章进行其他逻辑判断。