cr-laravel-php-83

Laravel PHP 8.3 的 Cursor 规则 在 Laravel 中使用 Cursor 时，需遵循以下规则以确保高效、安全地处理大数据集： 1. **仅适用于 Eloquent 查询** Cursor 方法仅支持通过 Eloquent 构建器生成的查询，不支持原始查询或数据库查询构建器（DB facade）。 2. **必须使用 `cursor()` 方法** 使用 `Model::query()->cursor()` 或类似方式调用，返回一个 `LazyCollection` 实例，逐条惰性加载记录。 3. **避免在循环中执行额外查询** 在遍历 Cursor 结果时，尽量避免在循环体内执行新的数据库查询，以防 N+1 问题。必要时使用预加载（`with()`）。 4. **不支持分页与偏移** Cursor 基于游标逐条读取，不能使用 `offset()` 或 `limit()` 进行传统分页。如需分页，考虑使用 `chunkById()`。 5. **内存效率高，但连接保持时间长** Cursor 保持数据库连接直到遍历完成，确保处理过程中连接不超时。适用于导出、批量处理等场景。 6. **仅向前遍历** Cursor 是单向迭代器，不支持回退或随机访问。一旦迭代完成，需重新执行查询获取新游标。 7. **PHP 8.3 兼容性** 确保 Laravel 版本支持 PHP 8.3，并使用兼容的数据库驱动（如 MySQL 8.0+、PostgreSQL 12+ 等）。 8. **异常处理** 在遍历过程中捕获可能的数据库异常（如连接中断），并实现重试或日志记录机制。 9. **关闭游标** 遍历完成后，游标会自动关闭。若提前终止循环，建议手动释放资源或使用 `finally` 块确保清理。 10. **性能监控** 对大数据集使用 Cursor 时，监控内存使用与执行时间，避免长时间占用数据库连接影响其他请求。 遵循以上规则可充分发挥 Cursor 在处理大规模数据时的优势，同时保障应用稳定性与性能。

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本