如何为Magento 2.4及PhpStorm安装升级兼容性工具？

一、为Magento 2.4安装升级兼容性工具 #

• 项目级安装（推荐）：在Magento项目根目录执行以下Composer命令

  composer require magento/upgrade-compatibility-tool --dev
  

• 全局安装：若需跨多个项目使用，可执行

  composer global require magento/upgrade-compatibility-tool
  

• 验证安装：项目级环境执行bin/uct list，全局环境执行uct list，能显示完整命令列表即为安装成功
• 基础使用示例：检测当前项目升级到指定Magento版本的兼容性

  # 项目级
  bin/uct upgrade:check 2.4.6
  # 全局
  uct upgrade:check /path/to/your/magento/project 2.4.6
  

二、为PhpStorm配置升级兼容性工具 #

升级兼容性工具为命令行工具，需在PhpStorm中配置外部工具调用：

1. 打开PhpStorm设置面板（Windows/Linux：File > Settings；Mac：PhpStorm > Settings）
2. 导航到Tools > External Tools，点击右上角+按钮新建工具
3. 在配置窗口填写以下信息：
   • Name：Magento Upgrade Compatibility Tool
   • Program：项目级工具填$ProjectFileDir$/bin/uct；全局工具填系统中uct的实际路径（如~/.composer/vendor/bin/uct）
   • Arguments：可预设常用命令（如upgrade:check 2.4.6），也可留空以便每次运行自定义输入
   • Working directory：$ProjectFileDir$
4. 保存配置后，右键点击项目根目录，选择External Tools > Magento Upgrade Compatibility Tool即可运行兼容性检测
5. 可选优化：在配置窗口的Output Filters中添加规则（如$FILE_PATH$:$LINE$:$COLUMN$ - $MESSAGE$），让PhpStorm可直接定位到代码问题位置

内容的提问来源于stack exchange，提问作者César Robledo