WooCommerce后端开发 woocommerce-backend-dev

这个技能提供 WooCommerce 后端 PHP 代码开发的详细指导,涵盖代码结构、命名约定、编码风格、钩子使用、依赖注入、数据完整性和单元测试等,帮助开发者遵循项目标准和最佳实践,适用于电子商务网站后端优化。关键词:WooCommerce、后端开发、PHP、代码规范、单元测试、电子商务、WordPress、项目约定。

后端开发 0 次安装 0 次浏览 更新于 3/7/2026

name: woocommerce-backend-dev description: 添加或修改 WooCommerce 后端 PHP 代码,遵循项目约定。在创建新类、方法、钩子或修改现有后端代码时使用。

WooCommerce 后端开发

这个技能提供根据项目标准和约定开发 WooCommerce 后端 PHP 代码的指导。

指令

在添加或修改后端 PHP 代码时遵循 WooCommerce 项目约定:

  1. 创建新代码结构:参见 file-entities.md 了解创建类和文件组织的约定(但对于新单元测试文件,请参见 unit-tests.md)。
  2. 命名约定:参见 code-entities.md 了解命名方法、变量和参数的约定
  3. 编码风格:参见 coding-conventions.md 了解一般编码标准和最佳实践
  4. 使用钩子:参见 hooks.md 了解钩子回调约定和文档
  5. 依赖注入:参见 dependency-injection.md 了解 DI 容器使用
  6. 数据完整性:参见 data-integrity.md 了解在执行 CRUD 操作时确保数据完整性
  7. 编写测试:参见 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 时,主干中的版本是正确的,即使相对于发布版本似乎“未来”