Yii2如何配置AssetBundle将web目录静态资源发布到assets文件夹

你当前配置没有触发资源自动复制的核心原因是：当AssetBundle手动配置了$basePath为可直接web访问的@webroot、$baseUrl为@web时，Yii会判定对应资源已经在可公开访问路径下，不会执行发布复制逻辑，直接引用源文件路径。要实现资源自动发布到web/assets下的哈希目录，可按以下方案配置：

这是Yii官方设计的标准资源发布流程，不需要额外扩展，稳定性最高。

• 调整目录结构
  将需要发布的css、js、images目录从web/下移动到非web公开访问的目录，比如放到frontend/resources/下，避免资源存在双访问路径，调整后结构如下：

frontend/
├── resources/
│   ├── css/
│   │   └── site.css
│   ├── js/
│   └── images/
└── web/
    └── assets/  # 系统自动生成的资源发布目录，不需要手动放文件

• 修改AssetBundle配置
  给资源包配置$sourcePath指向原始资源目录，移除手动配置的$basePath和$baseUrl，这两个属性会在资源发布完成后由系统自动赋值为assets下的对应哈希路径，配置代码如下：

namespace frontend\assets;
use yii\web\AssetBundle;
class AppAsset extends AssetBundle
{
    // 指向待发布的原始资源根目录
    public $sourcePath = '@frontend/resources';
    public $css = [
        'css/site.min.css'
    ];
    public $js = [
        // 按需引入js目录下的文件，例：'js/common.js'
    ];
    public $publishOptions = [
        // 配置只发布需要的目录，过滤无关文件
        'only' => [
            'css/*',
            'js/*',
            'images/*',
        ],
        // 生产环境建议开启，用软链接代替文件复制，减少磁盘占用、提升发布效率
        'linkAssets' => true,
    ];
}

配置完成后刷新页面，系统会自动计算资源目录的哈希值，将指定目录下的资源复制/软链到web/assets/[8位哈希字符串]/目录下，最终生成的资源引入路径就是你预期的带哈希目录的格式。

如果你不想调整现有web/css、web/js、web/images的目录结构，也可以直接将$sourcePath指向@webroot，通过发布规则过滤只发布这三个目录即可，配置如下：

namespace frontend\assets;
use yii\web\AssetBundle;
class AppAsset extends AssetBundle
{
    // 直接将web根目录作为源资源目录
    public $sourcePath = '@webroot';
    public $css = [
        'css/site.min.css'
    ];
    public $publishOptions = [
        'only' => [
            'css/*',
            'js/*',
            'images/*',
        ],
        'linkAssets' => true,
        // 开发环境可以开启，修改资源后自动强制重新发布，不需要手动清空assets目录
        // 'forceCopy' => YII_DEBUG,
    ];
}

注意：这个方案存在明显弊端，原始资源放在web公开目录下，会同时存在源路径和assets发布路径两个可访问入口，容易出现客户端缓存不一致、资源冗余的问题，仅作为临时适配方案使用。

• 开发环境下在config/main.php的assetManager组件中配置'forceCopy' => YII_DEBUG，修改静态资源后自动重新发布，不需要手动删除assets目录下的缓存文件
• 生产环境务必开启linkAssets软链配置，大幅提升资源发布速度，减少磁盘空间占用
• 可以通过配置assetManager的appendTimestamp参数为true，自动给资源引入路径加时间戳参数，解决客户端缓存旧资源的问题

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