PHP SplPriorityQueue 怎样同时提取数据和优先级

要让 PHP 的 SplPriorityQueue 同时返回数据和优先级，调用 setExtractFlags(SplPriorityQueue::EXTR_BOTH) 即可。之后使用 extract()、top() 或迭代器读取时，得到的是包含 data 和 priority 两个键的数组，而不是默认的单个数据值。

官方地址：https://www.php.net/manual/en/splpriorityqueue.setextractflags.php

先把提取模式改成 EXTR_BOTH

SplPriorityQueue 是基于最大堆的优先队列。插入时，第一个参数是数据，第二个参数是优先级；读取时返回什么，则由提取模式决定。默认模式是 EXTR_DATA，所以直接调用 extract() 只能看到数据。

setExtractFlags(SplPriorityQueue::EXTR_BOTH); // 同时保留数据和优先级

$queue->insert('支付重试', 20); // 第二个参数是优先级
$queue->insert('普通通知', 5);

$item = $queue->extract(); // 取出最高优先级节点，并从队列移除
echo $item['data'], PHP_EOL; // 读取业务数据
echo $item['priority'], PHP_EOL; // 读取该节点的优先级
?>

这段代码中，$item 的形状是类似 ['data' => '支付重试', 'priority' => 20] 的数组。优先级数值越大，默认比较规则下越先被取出；相同优先级元素的先后顺序不应当被当作稳定排序依据。

为什么默认模式看不到 priority

setExtractFlags() 不改变队列中的节点，也不改变优先级比较逻辑，它只决定 current()、top() 和 extract() 对节点暴露的形状。三种模式可以这样理解：

因此，直接修改返回值的读取方式并不能解决问题；需要先切换提取模式，再读取数组键。模式切换后，遍历队列也会受到同样影响。

extract、top 和 current 的边界不同

如果需要“看一眼最高优先级任务但暂时不消费”，使用 top()；如果要按优先级真正处理任务，使用 extract()。迭代器的 current() 也会按照当前提取模式返回节点，但调用 next() 会移动到下一个节点。

insert('高优先级任务', 100);
$queue->insert('低优先级任务', 10);
$queue->setExtractFlags(SplPriorityQueue::EXTR_BOTH); // 让查看和取出都带上优先级

$peek = $queue->top(); // 只查看队头，不减少队列数量
if ($peek !== null) {
    echo $peek['data'], ':', $peek['priority'], PHP_EOL; // 记录预览信息
}

while (!$queue->isEmpty()) {
    $item = $queue->extract(); // 消费一个节点，循环会持续缩短队列
    echo $item['data'], PHP_EOL;
}

如果把 top() 误写成 extract()，预览操作就会提前消费任务；如果仍使用默认模式，却把返回值当成数组读取，也会出现字段不存在的问题。

迁移到 EXTR_BOTH 时只改一个读取契约

已有代码若依赖默认的字符串或对象数据，不能只在队列初始化处切换模式，还要同步调整读取代码。例如原来是 $queue->extract()，切换后应改为 $item = $queue->extract(); $item['data']，并把 $item['priority'] 交给日志、分流或展示层。

最小检查可以围绕三点展开：确认模式确实为 EXTR_BOTH；确认结果同时有 data 与 priority；确认消费前后 count() 的变化符合预期。若业务要求相同优先级也按插入顺序处理，还需要额外设计稳定的比较值，不能依赖队列默认顺序。

常见问题

调用 extract() 后为什么没有 priority 键？

默认提取模式是 EXTR_DATA。在读取前调用 setExtractFlags(SplPriorityQueue::EXTR_BOTH)，再从返回数组读取两个键。

只查看优先级但不删除任务怎么办？

使用 EXTR_PRIORITY 配合 top()，或者使用 EXTR_BOTH 查看完整节点；不要用 extract() 做预览。

EXTR_BOTH 会改变队列排序吗？

不会。它只改变读取结果的返回形状，队列仍按优先级比较规则取出节点。