php 8.6可用生成器按需遍历分页数据:每次需要下一页时才调用页面读取器,检查items和has_more结构,并用页数上限阻止无限遍历。生成器负责迭代契约,真实接口的认证、超时和重试仍由经过核实的页面读取器负责。

PHP手册中的PHP: Generator syntax - Manual
定义并检查分页数据契约
<?php
function records(callable $readPage,int $maxPages=100): Generator {
if ($maxPages<1 || $maxPages>10000) {
throw new InvalidArgumentException('页数上限不符');
}
$total=0;
for ($page=1;$page<=$maxPages;$page++) {
$data=$readPage($page);
if (!is_array($data) || !isset($data['items'])
|| !is_array($data['items'])
|| !array_key_exists('has_more',$data)
|| !is_bool($data['has_more'])) {
throw new UnexpectedValueException('分页结构不符');
}
foreach ($data['items'] as $item) {
yield $item;
$total++;
}
if (!$data['has_more']) return $total;
}
throw new RuntimeException('达到页数上限但仍有下一页');
}
$pages=[
1=>['items'=>[['id'=>1],['id'=>2]],'has_more'=>true],
2=>['items'=>[['id'=>3]],'has_more'=>false],
];
$rows=records(static fn(int $page):array=>$pages[$page]);
foreach ($rows as $row) echo $row['id']."\n";
echo '完整遍历数量:'.$rows->getReturn();
PHP手册中的PHP: Generator::getReturn - Manual
先用本地数据验证,再接真实适配器
示例可直接用本地页数组运行,不虚构第三方分页API。接入已有接口时,只把已验证的请求与解析逻辑放入readPage,并确认该接口实际采用的页号、终止字段和限额,不把示例字段当作厂商协议。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
提前终止不等于完整遍历
消费者break后,后续页面不会继续请求,也不能调用getReturn声称已经拿到总数。生成器完成返回后才能读取返回值;单页数据仍会占用内存,不能仅因使用yield就声称整个处理过程恒定内存。


















