cursor-laravel

Laravel 的 Cursor IDE 规则 1. **遵循 Laravel 编码规范** 使用 PSR-12 编码标准，确保代码风格统一。推荐使用 Laravel Pint 进行自动格式化。 2. **优先使用 Laravel 内置功能** 尽量使用 Laravel 提供的原生方法（如 Eloquent、Blade、Artisan 命令等），避免重复造轮子。 3. **目录结构规范** 严格遵循 Laravel 默认目录结构，自定义文件应放置在合适的目录（如 `app/Services`、`app/Http/Requests`）。 4. **路由定义清晰** 路由文件（`routes/web.php`、`routes/api.php`）需分组明确，命名规范（如 `user.profile.update`），避免逻辑耦合。 5. **控制器保持精简** 控制器仅处理 HTTP 请求逻辑，业务逻辑应移至 Service 层或 Repository 模式。 6. **模型关联与访问器规范** Eloquent 模型需正确定义关联关系，访问器/修改器使用驼峰命名（如 `getFirstNameAttribute`）。 7. **数据库迁移与填充** 所有数据库变更必须通过迁移文件实现，种子数据使用 Seeder 类，避免直接操作数据库。 8. **验证逻辑集中管理** 表单验证建议使用 Form Request 类（`php artisan make:request`），避免在控制器中直接验证。 9. **缓存与队列优化** 高频查询结果应合理使用缓存（Redis/Memcached），耗时任务需异步处理（队列驱动）。 10. **安全实践** - 始终使用 CSRF 保护（`@csrf` Blade 指令） - SQL 注入防护：优先使用 Eloquent 或参数绑定 - 敏感配置存储于 `.env` 文件，禁止硬编码 11. **测试覆盖** 关键功能需编写单元测试（PHPUnit）和功能测试（Pest），覆盖率建议 ≥80%。 12. **文档注释规范** 公共方法需添加 PHPDoc 注释，包含参数类型、返回值及异常说明。 13. **依赖注入优先** 避免使用全局函数（如 `app()`），通过构造函数或方法注入依赖。 14. **日志记录标准化** 使用 Laravel Log facade（`Log::info()`），错误信息需包含上下文（用户ID、请求参数等）。 15. **性能监控** 启用 Telescope 或自定义中间件记录慢查询、异常请求，定期优化 N+1 问题。 > 提示：Cursor IDE 的 AI 辅助功能可自动检测部分规则违规（如未使用的变量、潜在 SQL 注入），建议开启实时检查。

存档时间线

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

下载存档内容副本