docs(zh-CN): sync Chinese docs with latest upstream changes

This commit is contained in:
neo
2026-03-21 12:55:58 +08:00
parent 0af0fbf40b
commit e73c2ffa34
85 changed files with 11028 additions and 747 deletions

View File

@@ -26,6 +26,11 @@ paths:
* 使用 **PHPStan****Psalm** 进行静态分析。
* 将 Composer 脚本纳入版本控制,以便在本地和 CI 中运行相同的命令。
## 导入
* 为所有引用的类、接口和特征添加 `use` 语句。
* 避免依赖全局命名空间,除非项目明确偏好使用完全限定名称。
## 错误处理
* 对于异常状态抛出异常;避免在新代码中返回 `false`/`null` 作为隐藏的错误通道。

View File

@@ -30,4 +30,5 @@ paths:
## 参考
关于端点约定和响应格式的指导,请参见技能:`api-design`
参见技能:`api-design` 了解端点约定和响应格式指导。
参见技能:`laravel-patterns` 了解 Laravel 特定架构指导。

View File

@@ -32,3 +32,7 @@ paths:
* 使用 `password_hash()` / `password_verify()` 存储密码。
* 在身份验证和权限变更后重新生成会话标识符。
* 对状态变更的 Web 请求强制实施 CSRF 保护。
## 参考
有关 Laravel 特定安全指南,请参阅技能:`laravel-security`

View File

@@ -12,7 +12,7 @@ paths:
## 测试框架
默认使用 **PHPUnit** 作为测试框架。如果项目已在使用 **Pest**也是可以接受的
使用 **PHPUnit** 作为默认测试框架。如果项目中配置了 **Pest**则新测试优先使用 Pest并避免混合使用框架
## 覆盖率
@@ -30,6 +30,11 @@ vendor/bin/pest --coverage
* 使用工厂/构建器来生成测试数据,而不是手动编写大量的数组。
* 保持 HTTP/控制器测试专注于传输和验证;将业务规则移到服务层级的测试中。
## Inertia
如果项目使用了 Inertia.js优先使用 `assertInertia` 搭配 `AssertableInertia` 来验证组件名称和属性,而不是原始的 JSON 断言。
## 参考
关于整个仓库范围内的 RED -> GREEN -> REFACTOR 循环,请参见技能:`tdd-workflow`
查看技能:`tdd-workflow` 以了解项目范围内的 RED -> GREEN -> REFACTOR 循环。
查看技能:`laravel-tdd` 以了解 Laravel 特定的测试模式PHPUnit 和 Pest