webpack-qiniu-cdn-plugin

将webpack输出的资源上传至七牛对象存储(kodo)，并修改资源访问链接为指定的CDN链接

Usage

webpack.config.js

const QiniuCDNPlugin = require('webpack-qiniu-cdn-plugin');
module.exports = {
  plugins: [
    new QiniuCDNPlugin({
      accessKey: '__access_ket__',
      secretKey: '__secret_key__',
      cdnHost: '__host__',
      bucket: '__bucket__',
      dir: 'access',
      exclude: /\.html$/,
      expire: {
        versions: 1,
        time: 60
      },
      refresh: true,
      prefetch: true,
      dry: true
    });
  ]
}

Options

字段名 | 类型 | 描述 | 默认值 -- | -- | -- | -- accessKey | string | 七牛accessKey | - secretKey | string | 七牛secretKey | - bucket | string | 对象存储bucket | - cdnHost | string | 用于访问DNS资源的域名 | - dir | string | 存储文件时使用的文件夹前缀，不包括末尾的/ | '' logFile | string | 版本记录文件的文件名 | 'upload-log.json' expire | Expire | false | 版本过期策略，false表示不过期 | false exclude | RegExp | function | 选择哪些文件不需要上传，当值为函数是接收文件路径作为参数，返回true表示排除该文件 | () => false refresh | boolean | 覆盖上传是否刷新CDN缓存 | false prefetch | boolean | 上传后是否执行CDN预取 | false silent | boolean | 安静模式 | false dry | boolean | 不执行实际的上传删除操作，用于调试 | false

加粗表示必填项

过期版本中不被使用的文件会被插件从存储空间中删除

expire选项包含两个成员

字段名 | 类型 | 描述 -- | -- | -- time | number | 过期时间(秒) versions | number | 需要保留的版本数

过期时间是指本次构建时间 - 对应版本构建时间，即版本的存活时间。 保留版本数是指需要保留的先前版本的数量，不包括当前版本。

同时满足两个条件的会被认为是过期版本(当前时间距离记录的构建时间大于过期时间，并且不在保留版本范围内) 省略某一条件表示不校验该条件

UploadStatus

当silent不为true时会在控制台打印下列统计信息：

名称 | 描述 -- | -- remote | 存储空间中现有的文件列表 exclude | 被exclude选项排除的文件 overwrite | 覆盖性上传的文件 omit | 忽略上传的文件（存储空间中已存在名称相同且hash相同的文件） upload | 新上传的文件 clean | 被回收的文件

Tips

• 不需要在webpack额外设置output.publicPath，插件会根据cdnHost与dir自动设置
• 记录文件的保存路径是${cdnHost}/${dir}/${logFile}
• 回收操作只会清除logFile中有记录的条目，所以更改prefix或是logFile选项后需要手动清除旧的资源
• CDN refresh操作只会刷新被覆盖更新的资源
• CDN prefetch操作只会预取新上传的资源