name: woocommerce-backend-dev description: 添加或修改 WooCommerce 后端 PHP 代码,遵循项目约定。在创建新类、方法、钩子或修改现有后端代码时使用。
WooCommerce 后端开发
这个技能提供根据项目标准和约定开发 WooCommerce 后端 PHP 代码的指导。
指令
在添加或修改后端 PHP 代码时遵循 WooCommerce 项目约定:
- 创建新代码结构:参见 file-entities.md 了解创建类和文件组织的约定(但对于新单元测试文件,请参见 unit-tests.md)。
- 命名约定:参见 code-entities.md 了解命名方法、变量和参数的约定
- 编码风格:参见 coding-conventions.md 了解一般编码标准和最佳实践
- 使用钩子:参见 hooks.md 了解钩子回调约定和文档
- 依赖注入:参见 dependency-injection.md 了解 DI 容器使用
- 数据完整性:参见 data-integrity.md 了解在执行 CRUD 操作时确保数据完整性
- 编写测试:参见 unit-tests.md 了解单元测试约定
关键原则
- 始终遵循 WordPress 编码标准
- 使用类方法而不是独立函数
- 默认将新内部类放在
src/Internal/中 - 使用带有
Automattic\WooCommerce命名空间的 PSR-4 自动加载 - 为新功能编写全面的单元测试
- 在提交更改前运行代码检查和测试
- 在适用时,优先使用 bun 而不是 npm/bunx 进行 Node.js 包管理
版本信息
要确定 @since 注释的下一 WooCommerce 版本号:
- 在 主干分支 上读取
includes/class-woocommerce.php中的$version属性 - 如果存在,移除
-dev后缀 - 示例:如果主干显示
10.4.0-dev,使用@since 10.4.0 - 注意:在审查针对主干的 PR 时,主干中的版本是正确的,即使相对于发布版本似乎“未来”