inst-add-feature-laravel

在 Laravel 11 应用程序中添加新功能的指南 1. **遵循 Laravel 最佳实践** - 使用 Laravel 提供的结构和约定（如 MVC 模式）。 - 利用服务容器、依赖注入和门面等核心特性。 2. **使用 Artisan 命令生成代码** - 通过 `php artisan make:` 命令生成控制器、模型、迁移文件、中间件等，确保命名规范且结构清晰。 3. **数据库变更使用迁移** - 所有数据库结构的修改必须通过迁移文件完成，避免直接操作数据库。 - 编写可回滚的迁移，并在团队中同步执行。 4. **保持路由简洁与分组** - 将相关路由组织到路由组中，使用中间件进行权限控制。 - 优先使用资源路由（`Route::resource`）处理标准 CRUD 操作。 5. **验证请求数据** - 使用表单请求验证（Form Request Validation）或 `Validator` 类对用户输入进行严格校验。 - 返回清晰的错误信息，提升用户体验。 6. **使用 Eloquent ORM 进行数据操作** - 避免直接使用查询构造器或原生 SQL，除非性能要求极高。 - 利用模型关联、访问器、修改器等功能简化业务逻辑。 7. **实现业务逻辑于服务层** - 将复杂业务逻辑从控制器移至服务类中，提高代码可维护性和可测试性。 - 使用 Repository 模式解耦数据访问层（可选但推荐）。 8. **添加适当的中间件** - 为功能添加认证、授权、日志记录等中间件，增强安全性与可观测性。 9. **编写单元测试和功能测试** - 使用 PHPUnit 和 Laravel 的测试工具为新功能编写测试。 - 覆盖关键路径、边界情况和异常场景。 10. **文档化新功能** - 更新 API 文档（如使用 Swagger/OpenAPI）。 - 在代码中添加必要的注释，说明功能用途和使用方式。 11. **版本控制与代码审查** - 提交代码时使用清晰的提交信息。 - 通过 Pull Request 进行代码审查，确保质量与一致性。 12. **考虑性能与可扩展性** - 使用缓存、队列和事件系统优化性能。 - 避免 N+1 查询问题，合理使用预加载（`with()`）。 13. **遵循 PSR 编码标准** - 代码风格符合 PSR-12，使用 Laravel Pint 自动格式化代码。 14. **环境配置管理** - 新功能涉及的配置项应添加到 `.env` 文件和 `config/` 目录中，避免硬编码。 15. **部署前测试** - 在 staging 环境中充分测试新功能，确保与现有系统兼容。 遵循以上指南，有助于在 Laravel 11 应用中高效、安全地添加新功能，同时保持代码质量和团队协作效率。

存档时间线

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

下载存档内容副本