如何通过Composer将jackocnr/intl-tel-input适配为Yii2可自动加载的小部件

解决方案 #

jackocnr/intl-tel-input本身是纯前端资源库，没有PSR-4自动加载配置是正常情况，不需要从零开发完整的第三方适配包，有两种低成本方案可实现免手动引入资源、和Yii2生态适配的需求：

方案1：项目内自定义资源包+轻量小部件（最适合你的场景）

你可以直接依托Yii2原生的资源管理机制做简易封装，和你之前用borales/yii2-phone-input的使用体验完全一致：

• 在你项目的组件目录（比如@app/components）下新建资源类IntlTelInputAsset.php，代码示例：

<?php
namespace app\components;

use yii\web\AssetBundle;

class IntlTelInputAsset extends AssetBundle
{
    // 直接映射composer安装后的库文件路径
    public $sourcePath = '@vendor/jackocnr/intl-tel-input/build';
    public $css = [
        'css/intlTelInput.min.css',
    ];
    public $js = [
        'js/intlTelInput.min.js',
        // 按需引入工具类
        'js/utils.js',
    ];
    // 声明依赖jQuery，Yii2会自动处理加载顺序
    public $depends = [
        'yii\web\JqueryAsset',
    ];
}

• 如果需要封装成表单可直接调用的小部件，同目录下新建IntlTelInputWidget.php，继承yii\widgets\InputWidget，核心逻辑仅需完成：注册上述资源包、输出input表单元素、输出JS初始化代码，总代码量不到100行，无需发布为独立composer包即可在项目内直接使用。
• 使用方式和你之前用的第三方小部件完全一致：

<?= $form->field($model, 'phone')->widget(\app\components\IntlTelInputWidget::class, [
    // 自定义配置项
]) ?>

方案2：Composer自动加载映射兜底（仅适用于带PHP类的第三方库）

如果后续你遇到缺PSR-4配置的PHP类库，不需要改第三方库的composer.json，直接在你项目根目录的composer.json里加自定义映射即可：

{
    "autoload": {
        "psr-4": {
            "目标命名空间\\": "vendor/对应库的源码目录路径/"
        }
    }
}

修改完成后执行composer dump-autoload即可生效。

如果后续你需要在多个项目复用这个小部件，再考虑抽成独立的composer适配包即可，单项目使用方案1完全可以满足需求，不需要手动引入任何资源。

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