gutenbergdocs/docs/contributors/code/back-merging-to-wp-core.md
2025-10-22 01:40:18 +08:00

1.6 KiB
Raw Permalink Blame History

将代码反向合并至WordPress核心

在WordPress软件的主要版本发布时需要将Gutenberg的功能合并到WordPress核心代码中。通常这涉及提取Gutenberg代码库中.php文件的变更并在WP核心代码库中进行相应更新。

合并标准

文件/目录范围

以下文件/目录内的变更通常需要反向合并至WP核心

  • lib/ 目录
  • phpunit/ 目录

排除目录/文件

以下目录/文件_无需_反向合并至WP核心

  • lib/load.php - 插件专用代码
  • lib/experiments-page.php - 实验性功能为插件专用
  • packages/block-library - 将在程序包同步过程中自动处理
  • packages/e2e-tests/plugins - 仅限端到端测试相关的PHP文件主要为测试数据生成器
  • phpunit/blocks - 该代码由Gutenberg维护测试文件也应保留在此

请注意此列表并未涵盖所有情况。

拉取请求标准

通常来说,自上一稳定版WP核心所包含的最终版Gutenberg发布之日起所有提交至Gutenberg代码库的PHP代码都应考虑反向合并至WP核心。

但存在以下例外情况符合这些标准的PR_无需_反向合并至WP核心

  • 未包含PHP代码变更
  • 具有Backport from WordPress Core标签 - 该代码已存在于WP核心正在同步回Gutenberg
  • 具有Backported to WordPress Core标签 - 该代码已完成向WP核心的同步

扩展阅读

另请参阅关于Gutenberg PHP代码的补充文档。