基于dojo/dijit的PHP/Zend遗留应用迁移至DOJO2的实施方式问询

Great question—this is a super common scenario when migrating from legacy Dojo to Dojo 2, and the answer depends a bit on your long-term goals and how much of the system you want to refactor at once. Let’s break down both approaches and when to use them:

This is the approach most teams take for full or large-scale refactors, and for good reason:

• 完全隔离新旧代码：Dojo 1和Dojo 2架构差异极大（Dojo 2基于TypeScript、采用ES模块、拥有现代组件模型），混在同一代码库会引发依赖冲突、全局变量覆盖和维护难题。独立构建Dojo 2应用能彻底规避这些问题。
• 支持渐进式迁移：无需一次性重写所有功能。先从一个独立模块入手（比如用户资料管理、订单历史页），用Dojo 2实现后对接现有PHP/Zend后端接口，再通过Web服务器（如Nginx）将流量导向新模块。逐步迁移更多功能，直到完全替代遗留系统。
• 充分利用现代工具：WebStorm对TypeScript的完美支持能和Dojo 2无缝配合。你可以享受完整的类型检查、智能自动补全和重构工具，让新应用的开发与维护比遗留代码轻松得多。
• 低风险部署：独立部署Dojo 2应用（甚至可以用容器化方式），通过路由规则将用户引导至新功能。如果出现问题，能快速将流量切回遗留系统，不会影响整体业务。

这种方式仅适用于替换少量UI组件，而非重构整个功能模块：

• 快速实现小改进：如果你只想把某个笨重的dijit组件换成现代Dojo 2组件，直接将Dojo 2编译后的代码放到遗留应用的部署目录中，操作快速直接。
• 注意冲突问题：必须处理Dojo 1和Dojo 2之间的潜在冲突，比如CSS样式冲突、全局dojo变量覆盖等。需要用Shadow DOM或作用域CSS等技术做隔离处理。
• 长期维护隐患：随着Dojo 2代码增多，部署目录会变成新旧代码的混合体，调试、测试和扩展都会越来越困难，不适合全系统重构。

对于大多数拥有Dojo/PHP遗留系统的团队，优先选择新建Dojo 2应用+渐进式迁移的方案，具体可以这么做：

1. 梳理后端API：整理现有接口文档，确保接口契约清晰；如果接口不规范，可以添加轻量API网关或后端适配层，为Dojo 2应用提供标准化响应格式。
2. 从小功能入手：选择一个低风险但高价值的功能（比如设置页）作为第一个迁移目标，在验证Dojo 2与后端的集成流程时，不会影响核心业务。
3. 发挥WebStorm优势：利用其TypeScript支持为API响应定义接口类型，提前发现潜在bug，让代码更健壮。
4. 独立部署新应用：将Dojo 2应用部署在单独服务器或容器中，通过Web服务器路由规则将新功能的请求导向它，保持遗留部署环境不受影响，直到你准备好淘汰旧系统。

内容的提问来源于stack exchange，提问作者ebcken