Appwrite PHP SDK设置Limit无效？如何一次性获取全部集合文档

首先明确：Appwrite的listDocuments接口默认单次最多返回25个文档，单次请求的最大允许limit值默认是100（可在Appwrite控制台的API设置中调整，但不建议设置过大，避免性能问题）。如果你的集合文档数超过100，必须通过分页循环获取全部内容。

1. 单次获取最多100个文档 #

如果你的文档总数≤100，直接设置limit为100即可：

$query = [
    'limit' => 100 // 单次请求的最大允许值
];

$staff_member_permissions = $databases->listDocuments(
    '6421819e68517dc04814', 
    '6422a0ea9c35c00f9e6c', 
    $query
);

2. 分页循环获取所有文档（文档数>100时） #

当文档总数超过100，需要结合offset参数分页循环，直到获取全部文档：

$allDocuments = [];
$offset = 0;
$limit = 100; // 单次最大数量
$databaseId = '6421819e68517dc04814';
$collectionId = '6422a0ea9c35c00f9e6c';

do {
    $query = [
        'limit' => $limit,
        'offset' => $offset
    ];
    
    $response = $databases->listDocuments($databaseId, $collectionId, $query);
    $documents = $response['documents'];
    
    // 合并到总数组
    $allDocuments = array_merge($allDocuments, $documents);
    
    // 更新偏移量，准备下一页
    $offset += $limit;
} while (count($documents) === $limit); // 返回数量等于limit，说明还有剩余文档

// $allDocuments 即为所有文档的集合

排查你的limit设置未生效的原因 #

• 检查limit值是否超过了Appwrite允许的上限（默认100），超过的话会被自动截断为上限值；
• 确认SDK版本是否为最新，旧版本可能存在参数解析问题；
• 检查$query数组的键名是否正确，必须是'limit'而非其他拼写错误。

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