Yii2引入NavBar组件后额外加载本地Bootstrap资源问题咨询

问题原因 #

你使用的yii\bootstrap5\NavBar组件默认会自动注册yii\bootstrap5\BootstrapAsset和yii\bootstrap5\BootstrapPluginAsset两个资源包，你之前的资源重写配置没有覆盖这两个Bootstrap5专属的资源包，因此组件加载时触发了本地Bootstrap资源的拉取。

解决方法 #

你可以任选以下一种方案解决：

方案1：补全Bootstrap5资源包的CDN重写配置 #

在你的web应用配置文件（通常为config/web.php）的assetManager配置段中，添加Bootstrap5对应资源包的CDN配置：

return [
    // 其他配置项
    'components' => [
        'assetManager' => [
            'bundles' => [
                // 保留你之前已配置的YiiAsset、JqueryAsset重写规则
                // 新增Bootstrap5相关资源包的重写规则
                'yii\bootstrap5\BootstrapAsset' => [
                    'sourcePath' => null, // 禁用本地资源源目录
                    'css' => [
                        'https://cdn.jsdelivr.net/npm/bootstrap@5.1.1/dist/css/bootstrap.min.css'
                    ],
                    'cssOptions' => [
                        'integrity' => 'sha384-F3w7mX95PdgyTmZZMECAngseQB83DfGTowi0iMjiWaeVhAn4FJkqJByhZMI3AhiU',
                        'crossorigin' => 'anonymous'
                    ]
                ],
                'yii\bootstrap5\BootstrapPluginAsset' => [
                    'sourcePath' => null,
                    'js' => [
                        'https://cdn.jsdelivr.net/npm/bootstrap@5.1.1/dist/js/bootstrap.bundle.min.js'
                    ],
                    'jsOptions' => [
                        'integrity' => 'sha384-/bQdsTh/da6pkI1MST/rWKFNjaCP5gBSY4sEBT38Q/9RBh9AH40zEOg7Hlq2THRZ',
                        'crossorigin' => 'anonymous'
                    ]
                ],
            ],
        ],
        // 其他组件配置
    ],
];

配置生效后，NavBar组件注册资源时会直接使用你指定的CDN地址，不会再加载本地Bootstrap资源。

方案2：关闭NavBar的自动资源注册 #

如果你的heroic-features.css已经内置了所有需要的Bootstrap样式，不需要额外引入Bootstrap核心文件，可以直接在调用NavBar时关闭自动注册资源的属性：

NavBar::begin([
    'autoRegisterClientAssets' => false,
]);
// 导航栏内容
NavBar::end();

该方案不需要修改资源配置，即可直接阻止额外本地资源的加载。

额外检查项 #

• 确认你的资源重写配置写在web应用对应的配置文件中，console端的配置不会对前端页面资源加载生效。

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