编程语言迁移 / ARTICLE

用 Kiro 构建可重复的 PHP 到 Java 迁移引擎

AWS 介绍了一种 PHP 到 Java 迁移引擎,以发现扫描器、parity harness、八阶段工作流和共享 skill 文件为核心,可在 Kiro 交互运行或由 AWS Transform 代理执行。

发现先于翻译:扫描器只读 token,不执行目标代码

PHP 应用迁移到 Java,会获得更严格的类型安全、更广的库支持和更可预测的扩展。但多年积累的 Laravel、Symfony 或 Doctrine 代码里,业务规则往往藏在 Eloquent trait、XML 映射文件等不明显的地方;结构相似的 Java 移植即使编译通过,行为也可能不同。AWS 发布的这套方法把迁移从一次性冒险变成可测量、可重复的过程,核心是一套可复用的引擎:共享方法论、机械发现扫描器和八阶段工作流。原始 PHP 应用被当作规格说明,Java 移植只有在 parity harness 验证通过后才算完成。

扫描器 discover-models.php 是一个单文件、无依赖的 PHP 命令行工具。它不执行目标代码,只把源码当作 token 读取,因此即使依赖未安装也能运行。每次扫描会运行三种发现策略:Eloquent 模型发现(沿类继承链追溯到 Illuminate\Database\Eloquent\Model)、Doctrine 属性检测(#[ORM\Entity])和 ORM XML 映射(外部 *.orm.xml 文件)。输出是一份 JSON manifest,models[] 数组记录每个字段、类型转换、关系和可见性规则;flags[] 数组出现在每个条目上。扫描器对歧义不做猜测,比如由运行时表达式构建的 $fillable 列表会转成一条人类可读的 flag,交给人工审核队列。

先建裁判,再写 Java

工作流的前四个阶段集中人类判断。Phase 0 运行扫描器并组装库存;Phase 1 在写任何 Java 之前构建 parity harness,用请求/响应对回放 PHP 原版和 Java 移植。harness 必须能在正常 PHP 上通过,并在故意注入错误时失败——一个检测不到人为破坏的 harness 不值得信任。Phase 2 生成 RULEBOOK.md 和 GAP_INVENTORY.md,Phase 3 用代表性文件对规则手册做压力测试,再推广到整个应用。Phase 4 到 Phase 8 大部分是自驱动循环:4 搭建 Spring Boot 项目,5 按 manifest 翻译数据模型为 JPA 实体,6 翻译 I/O 层(路由变 controller,中间件变 filter,验证变注解 DTO),7 批量转换业务逻辑,8 依据 harness 证明 parity 并切换。两条原则约束循环:PHP 代码是规格,移植完成由裁判认定,每个不匹配要么记录为已批准的变更,要么通过修改规则手册重新生成解决——修循环,不修代码。

同一套 skill 文件,两条执行路径

方法论被打包成版本化的 Markdown skill 文件:php-to-java-migration 编码八阶段流程,php-model-discovery 编码扫描器工作流。Kiro 作为 AI IDE,把 AI agent 和代码库配对,在编辑器里逐步驱动迁移。打开仓库根目录为 Kiro 工作区后,skill 自动激活,八个阶段都有明确审批门:检查发现 manifest、批准规则手册,每个阶段结束须签字确认。AWS Transform 是面向大规模迁移的 agentic AI 服务,已原生集成 Kiro。把相同的 skill 文件交给 AWS Transform,它的 agent 会在定义的检查点执行同一套方法论,自主运行。交互模式和代理模式读同一份 skill 文件,任何规则手册修正都会同时改进 Kiro 和 AWS Transform 的下一次运行。扩展方法论只需增加检测行和针对新框架的 references/ 到 spring 的指南,方法能自动识别 Laravel、Symfony、CodeIgniter 和纯 PHP。

Eloquent 到 Spring Boot 的切片与缺口

示例项目 laravel-eloquent-sample 是一个只读切片,把 Book、Chapter、Page、User 四个模型迁移到 Spring Boot 3.4.1、Java 21、Maven 和内存 H2。映射可追溯到 manifest:PHP 命名空间变成 Java 包,Eloquent 模型变成 JPA @Entity,hasMany 变成 @OneToMany,belongsTo 变成 @ManyToOne,Eloquent query scope 变成 Spring Data repository 方法。序列化也由 manifest 驱动:Page 的 $hidden 列表记录了 html、markdown、text,因此这些字段带 @JsonIgnore;Book 的 description 则有意不隐藏。规格文档明确写出 37 个模型中只移植了 4 个,而且该切片从未构建 parity harness,并称之为“最大的缺口”。把未完成之处写清楚,本身就是设计的一部分。

Clone 示例仓库,打开为 Kiro 工作区,就能直接运行这套引擎。workspace 顶层 .kiro/ 是共享方法论层,每个项目文件夹放自己的 PHP 源码、Java 输出和 .kiro/specs/。README 固定了上游 commit,用于复现 parity 基线。

END
反馈