mcpField
M
magento-upgrade-specialist

magento-upgrade-specialist

github.com/maxnorm开发31159 次安装40 周前更新
代码仓库

关于 magento-upgrade-specialist

magento-upgrade-specialist 是面向 Magento 升级团队的技能，适用于版本升级及从 Magento 1 迁移到 Magento 2。内容涵盖兼容性审查、迁移规划、执行、测试和升级后检查。

主要功能

  1. 01升级前系统审计
  2. 02扩展兼容性检查
  3. 03规划升级路径
  4. 04代码与数据库迁移
  5. 05升级后测试

适用场景

  1. 01规划 Magento 版本升级
  2. 02评估自定义代码兼容性
  3. 03从 Magento 1 迁移到 Magento 2
  4. 04发布前验证升级结果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/maxnorm/magento2-agent-skills --skill magento-upgrade-specialist

安装后在 Claude Code 中输入/magento-upgrade-specialist确认已加载。

详细介绍

Magento 2 升级专家

确保 Magento 版本间平稳、无风险迁移，同时维持业务连续性并保留自定义功能的专家。

适用场景

  • 升级 Magento 2 版本（次要版本或主要版本）
  • 从 Magento 1.x 迁移到 Magento 2.x
  • 规划升级策略和时间安排
  • 评估扩展兼容性
  • 处理重大变更
  • 升级后优化

升级流程框架

1. 升级前评估
  • 当前系统审计：全面分析现有 Magento 安装
  • 自定义代码审查：评估所有自定义模块、主题和修改
  • 扩展兼容性：检查第三方扩展与目标版本的兼容性
  • 数据完整性检查：验证数据库一致性并识别潜在问题
  • 性能基线：建立当前性能指标以供比较
2. 兼容性分析
  • 静态代码分析：使用自动化工具识别兼容性问题
  • API 变更审查：分析核心 API 和接口中的重大变更
  • 弃用功能评估：识别弃用功能并规划替代方案
  • 数据库架构变更：审查所需的数据库修改
  • 配置变更：识别所需的系统配置更新
3. 迁移规划
  • 升级路径策略：选择最佳升级路径（直接升级或逐步升级）
  • 环境设置：规划开发、预发布和生产升级环境
  • 尽量减少停机时间：制定减少生产环境停机时间的策略
  • 数据迁移策略：规划大型数据集迁移和优化
  • 应急规划：为各种故障场景和恢复流程做好准备
4. 实施执行
  • 代码迁移：更新自定义代码，使其适用于目标 Magento 版本
  • 数据库升级：执行数据库架构和数据迁移
  • 配置迁移：转移并更新系统配置
  • 扩展更新：升级或替换第三方扩展
  • 测试验证：全面测试所有已升级的功能

升级类别

次要版本升级（2.4.x 到 2.4.y）
  • 安全补丁：应用关键安全更新
  • 错误修复：解决已知问题并提升稳定性
  • 功能增强：利用新增的次要功能
  • 兼容性更新：维持扩展和自定义代码的兼容性
  • 性能改进：受益于性能优化
主要版本升级（2.3.x 到 2.4.x）
  • PHP 版本更新：处理 PHP 版本兼容性要求
  • Composer 依赖项：更新软件包依赖项和约束
  • API 变更：适配核心 API 中的重大变更
  • 全新架构：利用新的架构改进
  • 迁移工具：使用官方迁移工具和脚本
旧版迁移（Magento 1.x 到 2.x）
  • 数据迁移：全面转换数据结构
  • 主题迁移：全面重新设计并实现前端
  • 扩展替换：查找并实现 Magento 2 对应扩展
  • 自定义代码重写：为 Magento 2 重建自定义功能
  • 培训要求：培训团队了解 Magento 2 架构

升级命令

升级前
# Check current version
bin/magento --version

# Check database status
bin/magento setup:db:status

# Backup database
mysqldump -u user -p database > backup.sql

# Check extension compatibility
composer show | grep magento
升级期间
# Update composer dependencies
composer require magento/product-community-edition:2.4.x --no-update
composer update

# Run upgrade
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush
bin/magento indexer:reindex
升级后
# Verify installation
bin/magento setup:db:status
bin/magento setup:upgrade

# Test functionality
# Run automated tests
# Manual testing checklist

常见升级挑战

重大变更
  • API 变更：更新使用已弃用 API 的代码
  • 类变更：更新类引用和命名空间
  • 配置变更：更新 XML 配置文件
  • 数据库架构：处理架构变更和迁移
  • 前端变更：更新模板和布局
扩展兼容性
  • 版本冲突：解决 composer 依赖冲突
  • API 兼容性：更新使用已弃用 API 的扩展
  • 替代扩展：为不兼容的扩展寻找 Magento 2 替代品
  • 自定义补丁：为轻微的兼容性问题创建补丁
数据迁移
  • 架构变更：处理数据库结构变更
  • 数据转换：将数据转换为新格式
  • 自定义属性：迁移自定义 EAV 属性
  • 媒体文件：迁移图像和媒体文件

最佳实践

规划
  • 时间安排：制定合理的升级计划，并安排适当的测试阶段
  • 风险分析：识别潜在的破坏性变更及其业务影响
  • 资源规划：估算工作量、停机时间和团队需求
  • 回滚策略：规划全面的回滚流程
执行
  • 环境测试：在开发和预发布环境中进行全面测试
  • 增量方式：对于主要版本变更，可考虑采用增量升级
  • 文档记录：记录所有变更和自定义内容
  • 沟通：在整个过程中及时向利益相关方通报进展
升级后
  • 性能验证：确保性能达到或超过基准水平
  • 功能测试：全面测试所有功能
  • 安全审查：验证安全改进已得到妥善实施
  • 监控：升级后监控系统运行状况和性能

测试策略

  • 单元测试：运行并更新单元测试
  • 集成测试：测试模块与核心的集成
  • 功能测试：测试端到端场景
  • 性能测试：验证负载下的性能
  • 安全测试：验证是否符合安全要求

参考资料

专注于顺利、无风险的升级，在保持业务连续性的同时充分利用 Magento 的新功能。

评论

支持 Markdown