Yii2 Masked Input Widget无法发布jquery.inputmask.bundle.js问题求助

问题场景 #

删除整个vendor文件夹、调整composer.json升级包并执行composer install清理过时包后，Yii2（2.0.49.2版本）自带的Masked Input Widget出现资源加载失败问题：MaskedInputAsset.php尝试加载jquery.inputmask.bundle.js，但该文件不存在于间接安装的inputmask 5.0.9版本的vendor/bower-asset/inputmask/dist目录中，查看inputmask官方仓库确认5.x版本确实移除了该文件。

临时修复方案 #

手动修改本地vendor/yiisoft/yii2-widget-maskedinput/MaskedInputAsset.php文件，将JS配置项替换为存在的文件：

// 原代码
public $js = ['jquery.inputmask.bundle.js'];

// 修改后
public $js = ['jquery.inputmask.min.js'];

修改后浏览器可正常加载资源，组件功能恢复。

提交Yii2 GitHub PR前需检查的内容 #

• 多版本兼容性：确认jquery.inputmask.min.js在inputmask 4.x版本中是否存在，因为仍有用户可能依赖旧版inputmask。如果4.x版本中该文件路径或名称不同，需要考虑通过版本判断来适配不同版本的inputmask，避免破坏现有兼容。
• Yii2分支适配：Yii2的2.0.x为稳定维护分支，需确认修改是否符合该分支的维护要求，是否需要同步提交到开发分支（如master或dev）。
• Asset配置完整性：检查MaskedInputAsset中的其他配置（如$depends依赖项、$sourcePath路径等）是否需要同步调整，确保没有遗漏的兼容性问题。
• 功能测试覆盖：在开发、生产环境分别测试修改后的Masked Input Widget，验证掩码输入、资源加载、交互逻辑是否正常，确认没有引入新bug。
• 已有问题排查：先在Yii2 GitHub仓库搜索相关issue和PR，确认是否已有用户报告该问题或正在处理的修复，避免重复提交。
• 代码规范一致性：确保修改后的代码符合Yii2官方代码规范（如命名、缩进、注释风格），与现有代码保持一致。

内容的提问来源于stack exchange，提问作者João Marques