gutenbergdocs/docs/contributors/code/back-merging-to-wp-core.md

38 lines
1.6 KiB
Markdown
Raw Normal View History

2025-10-21 17:33:45 +00:00
# 将代码反向合并至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核心](https://developer.wordpress.org/block-editor/contributors/versions-in-wordpress/)所包含的最终版Gutenberg发布之日起所有提交至Gutenberg代码库的PHP代码都应考虑反向合并至WP核心。
但存在以下例外情况符合这些标准的PR_无需_反向合并至WP核心
- 未包含PHP代码变更
- 具有`Backport from WordPress Core`标签 - 该代码已存在于WP核心正在同步回Gutenberg
- 具有`Backported to WordPress Core`标签 - 该代码已完成向WP核心的同步
## 扩展阅读
另请参阅关于[Gutenberg PHP代码](/lib/README.md)的补充文档。