在discord api中，用户对象包含一个名为public_flags的字段，它是一个整数值。这个整数并非随机生成，而是通过特定的“位标志（bit flags）”机制来表示用户所拥有的各种徽章或身份特征。每个特定的徽章都对应一个2的幂次方数值（例如1、2、4、8、64等）。如果用户拥有某个徽章，那么该徽章对应的数值就会被“加”到public_flags中。因此，public_flags实际上是用户所有徽章对应数值的总和。
例如，如果一个用户的public_flags是644，这意味着他拥有以下徽章：
它们的和 4 + 128 + 512 = 644 正好对应了public_flags的值。这种机制被称为位掩码（bitmask），它允许在一个整数中高效地存储和检索多个布尔状态。
以下是Discord API中常见的一些公共标志及其对应的数值：
| 标志名称 | 数值 | 描述 |
|---|---|---|
| Discord_Employee | 1 | Discord员工 |
| Partnered_Server_Owner | 2 | 合作伙伴服务器所有者 |
| HypeSquad_Events | 4 | HypeSquad活动成员 |
| Bug_Hunter_Level_1 | 8 | Bug猎人（等级1） |
| House_Bravery | 64 | HypeSquad勇气之家 |
| House_Brilliance | 128 | HypeSquad智慧之家 |
| House_Balance | 256 | HypeSquad平衡之家 |
| Early_Supporter | 512 | 早期支持者 |
| Bug_Hunter_Level_2 | 16384 | Bug猎人（等级2） |
| Early_Verified_Bot_Developer | 131072 | 早期认证机器人开发者 |
要从一个public_flags整数中提取出所有对应的徽章名称，我们需要使用位运算中的“按位与”（Bitwise AND, &）操作符。按位与操作符会比较两个数的二进制表示，如果两个位都为1，则结果的对应位为1；否则为0。
立即学习“PHP免费学习笔记（深入）”；
其核心原理是：如果一个用户的public_flags值包含某个特定徽章的数值，那么将public_flags与该徽章的数值进行按位与操作，结果会等于该徽章的数值（或大于0）。如果public_flags不包含该徽章，则按位与的结果将为0。
例如，public_flags = 644 (二进制 1010000100)：
我们可以创建一个包含所有徽章及其对应数值的映射数组，然后遍历这个数组，对每个徽章进行位与检查。
<?php
/**
* 定义所有Discord公共标志及其名称的映射
* 键为标志数值，值为标志名称
*/
$allBadges = [
1 => '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文档中查找并添加
];
// 示例1: 假设从Discord API获取到的 public_flags 值为 6
// 6 = 2 (Partnered_Server_Owner) + 4 (HypeSquad_Events)
$publicFlags1 = 6;
echo "解析 public_flags = {$publicFlags1} 的徽章：\n";
$userBadges1 = array_filter($allBadges, function($badgeName, $badgeValue) use($publicFlags1) {
// 使用位与操作检查特定徽章是否包含在 public_flags 中
return ($badgeValue & $publicFlags1) > 0;
}, ARRAY_FILTER_USE_BOTH);
print_r($userBadges1);
/*
预期输出:
Array
(
[2] => Partnered_Server_Owner
[4] => HypeSquad_Events
)
*/
echo "\n----------------------------------------\n\n";
// 示例2: 假设从Discord API获取到的 public_flags 值为 644
// 644 = 4 (HypeSquad_Events) + 128 (House_Brilliance) + 512 (Early_Supporter)
$publicFlags2 = 644;
echo "解析 public_flags = {$publicFlags2} 的徽章：\n";
$userBadges2 = array_filter($allBadges, function($badgeName, $badgeValue) use($publicFlags2) {
return ($badgeValue & $publicFlags2) > 0;
}, ARRAY_FILTER_USE_BOTH);
// 如果需要只获取徽章名称的列表
$badgeNames2 = array_values($userBadges2);
print_r($badgeNames2);
/*
预期输出:
Array
(
[0] => HypeSquad_Events
[1] => House_Brilliance
[2] => Early_Supporter
)
*/
echo "\n----------------------------------------\n\n";
// 示例3: 将徽章名称连接成一个字符串
echo "解析 public_flags = {$publicFlags2} 的徽章（字符串形式）：\n";
$badgeString = implode(' & ', array_values($userBadges2));
echo $badgeString . "\n";
/*
预期输出:
HypeSquad_Events & House_Brilliance & Early_Supporter
*/
?>代码解释：
define('DISCORD_FLAG_EMPLOYEE', 1);
define('DISCORD_FLAG_HYPE_EVENTS', 4);
// ...
$allBadges = [
DISCORD_FLAG_EMPLOYEE => 'Discord_Employee',
DISCORD_FLAG_HYPE_EVENTS => 'HypeSquad_Events',
// ...
];通过理解Discord API中public_flags的位掩码机制，并结合PHP的按位与操作符，我们可以轻松且高效地将一个简单的整数值解析成用户所拥有的详细徽章列表。这种方法不仅适用于Discord API，也广泛应用于其他需要在一个整数中存储多个布尔状态的场景。掌握位运算是处理这类API数据的重要技能。
以上就是Discord API用户徽章解析：PHP位运算实践的详细内容，更多请关注php中文网其它相关文章！
PHP怎么学习？PHP怎么入门？PHP在哪学？PHP怎么学才快？不用担心，这里为大家提供了PHP速学教程(入门到精通)，有需要的小伙伴保存下载就能学习啦！
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
149
收藏
