Skip to content

This is a multi-page webpack configuration based on the vue - cli rewrite, which supports hot loading and background template rendering

Notifications You must be signed in to change notification settings

Ryuurock/webpack-muilt-page-config

Repository files navigation

webpack的流行给前端开发减少了许多不必要的工作,webpack可以让我们更纯粹的关注我们的代码,但是很多人认为它更适合单页应用,主要有以下一些痛点

  • 如果模板是后台管理的生成的怎么办
  • 我目前没有使用任何模块化的开发方式,或使用了模块加载器(如seajsrequireJs等)

其实第二点我已经在上篇文章中讲过了,如果平滑的过渡到webpack,痛点一也解释过,只是没有详细的说明,此次分享一个完整的配置,来应对你的多页项目。不管是jspphphtmlxshtml都可以通过具体的配置来使用webpack,为什么如此青睐webpack,在我看来热更新技术lesssasses6es7的引入是最吸引我的(尝试过使用gulp、但是感觉并没有webpack这种一站式服务来得顺手),下面我详细讲述下下面一些配置的用途,部分代码来自vue-cli

├─build                 // webpack的配置文件存放目录
├─Public                // 我们的前端资源存放目录
│  ├─dev                // 源码存放目录(可以改名为src)
│  │  ├─css             // 一些共用的css文件,共用才放这里哦
│  │  ├─font            // 字体文件
│  │  ├─images          // 图片文件
│  │  └─js              // js文件
│  │      ├─libs        // npm里没有的第三方插件或库
│  │      ├─modules     // 项目的业务组件存放目录
│  │      └─page        // 页面的目录
│  │          └─Index   // 具体的页面名称
│  └─dist               // 编译后的存放目录
└─static                // 好像是拿来缓存文件用的?vue-cli存在的

当然,我目前开发的项目是半路引入webpack的,大部分都还是jQuery那套东西、但是我还是秉着关注点分离的原则,将htmlcssjs按页面来放了,不再使用老掉牙的按文件类型来放、那是因为有了webpack的打包才可以这么随意。除了分离出来的模板(ThinkPHP<include file=""/>标签来引入模板)文件,js和css都是放到同模板名的Public/dev/js/modules目录里了,这样一来可以直接像这样

require( './style.less' );
...

先在js文件的头部引入这个组件的样式文件,再来写js代码,至少我们在使用组件的时候不必关心css了(下篇文章会讲讲重构后如何连html也不关注了)

images

这里为什么会有一个images目录看起来很多余呢,那是因为我们的php模板里的图片标签src前面都带了一个php的系统变量,webpack插件的静态分析是无法识别这里的路径的,所以保留了这个目录,在打包后用插件拷贝到打包目录里

page

然后是page这个目录,这个目录是拿来存放我们页面的三剑客的,比如有一个叫index的目录,里面有cssjshtml文件,这里的index可以看作是一个页面目录,也可以看作是一个分类,如果是分类,那下面就应该是页面了,html里不应该引用css文件和js文件,因为webpack会帮我们插入生成新的html到我们指定的目录里

最重要的就是build目录下的了

config.js

proxyTable项我已经在上篇文章中讲过了,这里就不赘述了

mapping.js

这个文件就是描述我们entry也就是入口文件和html模板之间的关系映射的文件的

module.exports = {
  // 微知首页
  'Index': {
    // 对应到Public/dev/js/page的文件夹名称
    file: 'main',
    // 视图层的文件名称,默认为index
    viewFile: 'index',
    disable: false,
    templateOutput: 'Index'
  },
  'EditText': {
    chunks: [ 'editor' ],
    disable: false
  },
  // 编辑模板
  'Template': {
    chunks: [ 'editor' ],
    disable: true
  },
  // 默认模板
  'GzhArtStyle': {
    chunks: [ 'editor' ],
    disable: true
  }
};

这里导出的每个对象的键值都对应了page目录里的名字,下面的file字段对应的入口js文件名称,默认为mainviewFile对应的是html模板名称,默认为index,这里很有用,因为在ThinkPHPView目录里模板部分文件夹的,所以我们配合templateOutput把html输出过去就不存在目录了,templateOutput的默认值为这个对象的键值如Index默认为Index。disable字段是开发模式使用的,当运行npm run dev命令时会自动扫描这个字段,若为false才会启动,如果全部都为false,那么你页面越多造成性能开销就越大,所以除非你同时去开发几个页面,这里建议启动的页面不超过5个,其他页面若要运行,提前npm run build一次让它跑编译后的代码就好了。chunks字段是用来标记当前页面依赖的除了共有chunks需要依赖的其他chunks,上面的有chunks字段的三个页面都是引用了百度编辑器,因为百度编辑器的包都太大了,所以不建议抽取到公用的chunk里,这里的配置在webpack.prod.cfg.js文件里有单独配置。

utils.js

这个文件主要是getHtmlWebpackPlugins方法,配合注释您就能看懂刚才的mapping配置都怎么用的了

exports.getHtmlWebpackPlugins = ( rename ) => {
  let HtmlWebpackPlugins = [];
  Object.keys( mapping ).forEach( function( name ) {
    // 如果不是开发环境 就全部打包
    // 如果是开发环境 就根据disable来进行打包
    ( process.env.NODE_ENV !== 'development' ||
      !mapping[ name ].disable ) &&
    HtmlWebpackPlugins.push(
      new HtmlWebpackPlugin( {
        alwaysWriteToDisk: true,
        // php端使用到的模板
        // 如果是其他目录在此修改路径
        filename: `${ROOT}/Application/Home/View/${mapping[ name ].templateOutput ? mapping[ name ].templateOutput : name}/${mapping[name].viewFile || 'index'}.html`,
        // 插件用的模板文件
        template: `${ROOT}/${config.$d}/js/page/${name}/${mapping[name].viewFile || 'index'}.${mapping[name].templateType || 'html'}`,
        chunks: ( function() {
          if ( !rename ) {
            //let chunks = [ 'vendor.npm', 'vendor.TP', 'manifest', 'vendor.modules' ];
            let chunks = [ 'vendor.modules', 'vendor', 'manifest' ];
            if ( mapping[ name ].chunks ) {
              chunks = chunks.concat( mapping[ name ].chunks );
            }
            return chunks;
          }
          return [];
        }() ).concat( [ `${rename ? config.dev.entryPrefix : ''}${name}` ] ),
        // 手工排序
        chunksSortMode: 'manual',
        inject: true,
        showErrors: false
      } ) );
  } );
  return HtmlWebpackPlugins;
}

alwaysWriteToDisk这个字段是我们能前后端结合开发的关键,没有使用后端模板的项目真的做到前后分离时是不需要这个字段的,因为PHP会读这个文件再渲染数据出来给浏览器

webpack.base.cfg.js、webpack.dev.cfg.js

都是些老生常谈的配置,这里就不赘述了。值得注意的是dev.client.js这个文件被我删了,因为使用了alwaysWriteToDisk实时写入的功能,改变css文件和js文件都会强制刷新,那热更新完全就没法用了,所以html文件的变化还是需要手动刷新的

webpack.prod.cfg.js

HtmlWebpackPlugin这个插件确实是有多少页面就要插入多少个实例进去的,所以直接

...utils.getHtmlWebpackPlugins( false ),

展开这个数组就好了,这里传入的布尔参数是为了区分开发模式和build模式,传入true只会有一个chunk被包含进来,就是当前页面依赖的所有js和css等 然后是chunks

manifest

有的页面因为太简单并没有依赖太多共用的js,但是依赖了共用的css,所以这个chunk仅仅是为了抽取css文件用,造成引用了一个空的js,暂时没有想到好的解决办法,欢迎再issues提出改进建议

vendor.modules

这个chunk是为了抽取我们自己写的业务组件、在修改业务组件后能够很好的利用缓存只更新这一个文件

commonChunk

上文mapping里的chunks字段就是这里配置的,如果还有其他局部共用的大chunk可以在这里再配置一个

vendor

vendor就是拿来放置第三方插件的,这里抽取了npm和lib里面的,当项目稳定后处于一个稳定的维护期,没有较大改动时,这个文件就可以长期缓存在用户的电脑里了。

new CopyWebpackPlugin( [ {
  from: path.resolve( __dirname, `../${config.$d}/images` ),
  to: `${config.build.assetsSubDirectory}/images`,
  ignore: [ '.*' ]
} ] ),

上面的代码就是拷贝images这个目录到我们打包生成的目录里,防止资源丢失的问题


这个脚手架很可能无法直接运行在你的项目里,但是能为你的多页入口的website提供一个很好的引入webpack的思路

have fun ~~

About

This is a multi-page webpack configuration based on the vue - cli rewrite, which supports hot loading and background template rendering

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published