[面试题] Vue精讲-服务端渲染
在服务端返回生成好的HTML
页面内容,以及客户端SPA
j 脚本,这样既有利SEO
,解决首屏加载慢的问题,同时有利于用户的体验。
也就是说通过服务端渲染首屏直出,解决SPA
应用首屏渲染慢以及不利于SEO
的问题,而通过客户端渲染接管页面内容交互得到更好的用户体验。那么这种方式通常称之为现代化的服务端渲染,也叫同构渲染。而这种方式构建的应用称之为服务端渲染应用或者是同构应用。
什么是渲染
渲染简单的理解就是将数据
与模板
拼接到一起。
对我们前端开发人员来说,我们经常通过 axios 访问服务端的接口,获取数据。然后将获取到的数据通过模板绑定的语法绑定到页面中,最终呈现给用户,这个过程就是我们所说的渲染。
传统的服务端渲染
在早期的WEB
页面渲染都是在服务端进行的,也就是在服务端已经将数据和模板构建好,生成html
,返回给客户端。所以客户端呈现就是包含具体数据内容的页面。
如下图所示:
在上图中最终最重要的就是第四步。
关于这中应用在前面讲解Node
的时候,已经学习过。
但是这种方式,有如下的不足:
- 前后端代码完全耦合在一起,不利于开发和维护
- 前端没有足够发挥空间(不利于前后端分离开发)
- 服务端压力大
- 用户体验一般(查看不同的页面,需要刷新浏览器)
客户端渲染
Ajax
使得客户端动态获取数据成为可能,也就是在服务端的渲染的工作,现在可以在客户端完成。这样带来的好处就是前后端代码完全分离,服务端提供接口,客户端访问接口获取数据,而且有利于前后端开发人员协同开发,提高开发效率。同时由于可以在客户端渲染,从而减轻了服务端的压力。而且也提高了用户体验,进行页面的切换的时候,不会刷新浏览器。
客户端渲染的流程如下图所示:
注意:在第二步返回的html
中没有具体的数据内容。
通过上图,我们可以看到在服务端仅仅是获取了数据,然后将获取到的数据返回给客户端,并不关心页面的渲染。渲染是有客户端完成。
这样就完成了前后端的分离,不仅项目的架构发生了改变,而且开发人员的配置也发生了变化。
也就是前端更为独立,不再受后端的限制。
同构渲染
与传统的服务端渲染不一样的是, 在返回的时候把渲染的页面以及数据和客户端的 spa 脚本也返回给客户端. 所以客户端接收到的是有页面内容还有客户端的 spa 单页面所需要的脚本程序
通过前面的介绍,我们知道了在客户端渲染中,带来的两个比较显著的问题就是,首屏渲染慢和不利于SEO
,那么应该怎样解决这些问题呢?这就需要用到服务端渲染的内容。当然,我们现在提到的服务端渲染与传统的服务端渲染还是有区别的,这里我们称之为现代化的服务端渲染,或者叫做同构渲染。
所谓同构渲染就是后端渲染+前端渲染的模式。这样就集合了前端渲染的优点也集合了服务端渲染的优点。
下面我们具体看一下关于同构渲染的一些具体的介绍:
同构渲染:还是基于React
,Vue
等框架,实现了客户端渲染和服务端渲染的结合,具体的流程就是,在服务端执行一次框架的代码,用于实现服务端渲染,实现首屏的输出,然后在客户端再执行一次,用于接管页面交互(后期的交互都是客户端渲染)。这样就解决了SEO
和首屏渲染慢的问题,拥有传统服务端渲染的优点,也有客户端渲染的优点。
同构渲染的问题
同构渲染主要如下问题
- 开发条件有限
- 涉及构建设置和部署的更多要求
- 更多的服务器负载
首先来看一下开发条件有限:
浏览器特定的代码只能在某些生命周期钩子函数中使用(因为代码既要在服务端渲染运行,也要在客户端渲染运行,这时需要对服务端渲染的生命周期与客户端渲染的生命周期做一定的区分)。
第二就是一些外部扩展库可能需要特殊的处理以后才能在服务端渲染应用中运行。
第三:不能在服务端渲染期间操作DOM
.
涉及构建设置和部署的更多要求
客户端渲染的构建仅仅构建客户端的应用就可以了,而同构渲染需要构建两个端。
客户端渲染的应用可以部署在任意的Web
服务器中,而同构渲染的应用只能部署在Node.js Server
中。
更多的服务器负载
第一:在Node
中渲染完整的应用程序,相比仅仅提供静态文件的服务器需要大量占用CPU
资源。
第二:如果应用在高流量环境下使用,需要准备相应的服务器负载
第三: 需要更多的服务端渲染优化处理工作。
这时,就会有一个问题:在什么时候使用服务端渲染?
需要你认真的考虑如下两个问题:
第一:是否真的需要提升首屏渲染的速度。
第二:是否真的需要SEO
异步数据
Nuxt.js
扩展了Vue.js
,增加了一个叫做asyncData
的方法,使得我们可以在设置组件的数据之前能异步获取或处理数据。
下面,演示一下怎样在asyncData
方法中来获取异步数据。
这里进行异步请求的发送,需要通过axios
来完成
npm i axios
在pages/index.vue
中的实现代码如下:
<template>
<div>
<h1>{{ list[0].courseName }}</h1>
</div>
</template>
<script>
import axios from "axios";
export default {
name: "HomePage",
layout: "foot",
async asyncData() {
const res = await axios({
method: "GET",
url: "https://app.boxuegu.com/bxg/course/all?menuId=141&isFree=&isLive=&pageNum=1&pageSize=16",
});
// console.log(res.data.result.list)
// console.log(res.data)
return res.data.result;
},
};
</script>
<style></style>
通过上面的代码,我们可以看到,在asyncData
方法中发送了异步请求,而将服务端返回的数据直接返回,然后在视图模板中进行展示。
这里我们可以体会到就是在asyncData
方法中获取到的服务端数据,默认合并到了Vue
中的data
属性中了
还要注意的一点就是:asyncData
方法是在服务端渲染的时候执行的。
当然,除了这一点以外,在进行导航跳转的时候,也就是单击链接的时候也会执行asyncData
方法,例如在about.vue
这个组件中有一个链接,单击该链接会进行如index.vue
,这时也会执行asyncData
方法,这时是在客户端调用了asyncData
方法,为什么在服务端调用了该方法也要在客户端调用呢?
在服务端调用保证了返回客户端的时候有数据,而客户端调用是为了防止数据更新了,而无法获取到更新后的数据。
注意:asyncData
方法只能在页面组件中使用,也就是在pages
目录下创建的组件为页面组件,才能使用asyncData
方法,如果其它的组件要使用,只需要将其在页面组件中注册一下,让其成为子组件,然后把asyncData
方法中获取到的数据传递到子组件中就可以了。
还要注意的第二点就是:在asyncData
方法中是没有this
的,因为它是在组件初始化之前被调用的,也就是渲染之前调用的,当然不管是服务端渲染还是客户端渲染。
需要注意的第三点就是,什么时候使用asyncData
,什么时候使用Vue
中的data
函数?
当你想要动态页面内容,并且有利于SEO
或者是提升首屏渲染速度的时候,就在asyncData
中发送请求获取数据。
如果是非异步数据或者是普通数据,则正常的初始化到data
中就可以。最终两者还会合并在一起。
上下文对象
在asyncData
方法中,构建异步请求的时候,我们经常会遇到这样的情况,就是根据传递过来的编号来查询对应的数据,这就要求我们在asyncData
这个方法中,接收传递过来的编号。
<template>
<div></div>
</template>
<script>
export default {
asyncData() {
console.log(this.$router.params);
},
};
</script>
我们首先考虑到的就是通过以上的方式来,接收传递过来的参数,但是我们前面讲解过,在asyncData
方法中是无法获取到this
的。所以以上的方式是错误的。
这里需要通过上下文的方式来获取传递过来的参数,具体如下所示:
在pages
目录下面创建articels
目录,在该目录下面创建_id.vue
文件,对应的代码如下所示:
<template>
<div></div>
</template>
<script>
export default {
asyncData(context) {
// console.log(this.$router.params)
const id = Number.parseInt(context.params.id);
console.log(id);
},
};
</script>
就是,当我们单击浏览器的刷新按钮的时候,数据会丢失,因为默认登录用户的数据是存储在内存中的,所以需要持久化。
搭建自己的 SSR
自己来实现一下,了解服务端渲染的原理。
目标: 在服务端将Vue
实例渲染成一个纯文本字符串。
1、渲染 vue 实例
新建一个vue-ssr
目录,该目录下初始化package.json
npm init -y
安装vue
npm i vue
安装vue-server-renderer
npm i vue-server-renderer
在项目中创建一个server.js
文件,在该文件中添加如下的代码:
// 以下代码在node环境中运行
const Vue = require("vue");
// 创建一个渲染器
const renderer = require("vue-server-renderer").createRenderer();
const app = new Vue({
template: `
<div id="app">
<h1>{{message}}</h1>
</div>
`,
data: {
message: "hello world",
},
});
renderer.renderToString(app, (err, html) => {
if (err) {
throw err;
}
console.log(html);
// <div id="app" data-server-rendered="true"><h1>hello world</h1></div>
});
然后执行:
node server.js
可以看到窗口中输出以下的内容
<div id="app" data-server-rendered="true"><h1>hello world</h1></div>
通过以上的结果,可以看到,差值表达式中的内容被正确的渲染了。
data-server-rendered="true"
进行客户端渲染接管的一个入口,后面还会进行讲解。
通过以上测试,我们可以发现可以服务端Node
环境中使用Vue
.只不过这里是把Vue
渲染成字符串。
2、使用 Web 服务器
下面我们要解决的一个问题就是把上一小节中生成的字符串,发送给客户端浏览器。
这里需要结合Web
服务端来实现。
下面我们要解决的一个问题就是把上一小节中生成的字符串,发送给客户端浏览器。
这里需要结合Web
服务端来实现。
npm i express
修改后的server.js
const Vue = require("vue");
const express = require("express");
// 创建一个渲染器
const renderer = require("vue-server-renderer").createRenderer();
const server = express();
server.get("/", (req, res) => {
const app = new Vue({
template: `
<div id="app">
<h1>{{message}}</h1>
</div>
`,
data: {
message: "你好",
},
});
renderer.renderToString(app, (err, html) => {
if (err) {
res.status(500).end("Internal Server Error");
}
//设置编码,防止中文乱码
res.setHeader("Content-Type", "text/html;charset=utf8");
// console.log(html)
res.end(html);
});
});
server.listen(3000, () => {
console.log("server running at prot 3000");
});
在上面的代码中,当发送一个get
请求的时候,返回相应的内容,并且为了防止出现中文的乱码设置了编码。
或者也可以采用如下的方式:
const Vue = require("vue");
const express = require("express");
// 创建一个渲染器
const renderer = require("vue-server-renderer").createRenderer();
const server = express();
server.get("/", (req, res) => {
const app = new Vue({
template: `
<div id="app">
<h1>{{message}}</h1>
</div>
`,
data: {
message: "你好!",
},
});
renderer.renderToString(app, (err, html) => {
if (err) {
res.status(500).end("Internal Server Error");
}
res.setHeader("Content-Type", "text/html;charset=utf8");
res.end(`
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Document</title>
</head>
<body>
${html}
</body>
</html>
`);
// res.end(html);
});
});
server.listen(3000, () => {
console.log("server running at prot 3000");
});
在上面的代码中,设置了一个返回的文档内容,并且设置了meta
标签,在该标签中设置了编码。
这时,不添加如下语句也是可以的。
res.setHeader("Content-Type", "text/html;charset=utf8");
但是为了严谨,最好两种方式都加上。
3、HTML 模板使用
很多中情况下,都会把上一小节中的模板内容单独的封装到一个文件中。
在项目根目录下,创建一个模板文件index.template.html
.代码如下:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Document</title>
</head>
<body>
<!--vue-ssr-outlet-->
</body>
</html>
在上面的代码中添加了如下注释:
<!--vue-ssr-outlet-->
注意:该注释是固定的写法,后面的内容会填充该位置。
注意这段注释的写法,前后没有空格。
在server.js
文件中读取上面的模板文件
const fs = require("fs");
// 创建一个渲染器
const renderer = require("vue-server-renderer").createRenderer({
template: fs.readFileSync("./index.template.html", "utf-8"),
});
这样renderToString
中的代码如下所示:
renderer.renderToString(app, (err, html) => {
if (err) {
res.status(500).end("Internal Server Error");
}
res.setHeader("Content-Type", "text/html;charset=utf8");
res.end(html);
// res.end(html);
});
4、模板文件中使用外部数据
在通过renderToString
方法渲染模板的时候,可以向模板中传递数据。这就需要用到renderToString
方法的第二个参数。
renderer.renderToString(
app,
{
title: "个人简介",
meta: "<meta name='description' content='用户的个人简介'>",
},
(err, html) => {
if (err) {
res.status(500).end("Internal Server Error");
}
res.setHeader("Content-Type", "text/html;charset=utf8");
res.end(html);
// res.end(html);
}
);
在上面的代码中,我们向模板中传递了title
与meta
两组数据。
下面看一下关于模板中是怎样渲染这两组数据的。
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
{{{meta}}}
<title>{{title}}</title>
</head>
<body>
<!--vue-ssr-outlet-->
</body>
</html>
在上面的代码中,{{}}
会直接渲染相应的内容,是{{{}}}
是渲染成HTML
.
5、构建配置的基本思路
在前面我们所做的案例,仅仅是将Vue
的实例生成HTML
字符串,然后发送给客户端,但是需要与客户端动态交互的功能是没有实现的。
例如:单击按钮,触发对应的事件,或者双向绑定功能的实现。
原因是:这些交互的功能,需要用到客户端的js
脚本来实现,但是这里返回给客户端的内容都是HTML
字符串,没有相应的JS
内容。
下面对应server.js
文件中的代码,做了如下的修改:
const app = new Vue({
template: `
<div id="app">
<h1>{{message}}</h1>
<div>
<input type="text" v-model="message">
</div>
<div>
<button @click="onClick">单击</button>
</div>
</div>
`,
data: {
message: "你好!",
},
methods: {
onClick() {
console.log("Hello World");
},
},
});
演示这段代码发现,能够在浏览器中展示对应的文本框与按钮,但是没有相应的效果。
要想实现这种交互功能,相对来说是比较麻烦一些。
下面我们看一张图,来了解其原理。
在整个左侧,是我们所写的源代码Source
, 中间是Webpack
,右侧为Node Server
到目前位置,我们写的程序中只有一个Server entry
服务端的入口,服务端入口是用来处理服务端渲染的,如果想要让服务端渲染的内容具有客户端动态的交互能力,还需要一个客户端的入口,负责客户端渲染,它会接管服务端渲染的内容,将其激活成一个动态页面。当创建好这两个入口后,需要通过Webpack
进行打包构建,Server entry
会打包成一个Server Bundle
,Server Bundle
的作用就是用来做服务端渲染的。Client entry
会打包成Client Bundle
,其作用就是接管服务端渲染好的静态页面,将其激活成一个动态的客户端页面,这就是同构应用实现的一个基本的流程。
后期我们的实现就是围绕这张图来实现对应的同构应用。
6、源码结构
通过上图,我们可以看到左侧是一个源代码,那么我们必须先构建好源代码,才能够通过Webpack
来进行构建打包。(https://ssr.vuejs.org/zh/guide/structure.html#介绍构建步骤)
如果要构建源代码,首先要构建的就是整体的代码结构。
首先在项目中添加一个src
目录来存放源代码。
在src
目录下面创建一个App.vue
文件(根组件),具体的代码如下:
<template>
<div id="app">
<h1>{{ message }}</h1>
<div>
<input type="text" v-model="message" />
</div>
<div>
<button @click="onClick">单击</button>
</div>
</div>
</template>
<script>
export default {
data() {
return {
message: "Hello World",
};
},
methods: {
onClick() {
console.log("Hello World");
},
},
};
</script>
<style></style>
下面在src
目录创建app.js
文件
// app.js是程序的通用启动入口
import Vue from "vue";
import App from "./App.vue";
// 导出一个工厂函数,用于创建新的
// 应用程序、router 和 store 实例
export function createApp() {
const app = new Vue({
// 根实例简单的渲染应用程序组件。
render: (h) => h(App),
});
return { app };
}
entry-client.js
// 客户端入口
import { createApp } from "./app";
// 客户端特定引导逻辑……
const { app } = createApp();
// 这里假定 App.vue 模板中根元素具有 `id="app"`
app.$mount("#app");
entry-server.js
// 服务端入口
import { createApp } from "./app";
export default (context) => {
const { app } = createApp();
//后面还要做服务端路由处理。
return app;
};
虽然,现在已经将整个的目录结构构建好了,但是程序还是不运行,因为没有通过webpack
进行打包,所以无法处理单文件组件
, 所以需要安装一些 loader. 如果使用脚手架是会给安装
7、安装依赖
通过前面的图,我们知道,通过webpck
进行打包,把Server entry
打包出一个Server Bundle
来处理服务端渲染,把Client entry
打包出Client Bundle
处理客户端渲染,
当然在通过webpack
进行打包构建之前,需要先安装一些依赖
第一:安装生产依赖.
npm i vue vue-server-renderer express cross-env
包 | 说明 |
---|---|
Vue | Vue.js 核心库 |
vue-server-renderer | Vue 服务端渲染工具 |
express | 基于Node 的Web 服务框架 |
cross-env | 通过nmp scripts 设置跨平台环境变量,用来区分不同的打包环境 |
第二:安装开发依赖
npm i -D webpack webpack-cli webpack-merge webpack-node-externals @babel/core @babel/plugin-transform-runtime @babel/preset-env babel-loader css-loader url-loader file-loader rimraf vue-loader vue-template-compiler friendly-errorswebpack-plugin
包 | 说明 |
---|---|
webpack | webpack 核心包 |
webpack-cli | webpack 的命令行工具 |
webpack-merge | webpack 配置信息合并工具(把客户端与服务端打包的公共部分抽取出来,然后在与他们进行合并) |
webpack-node-externals | 排除 webpack 中的 Node 模块(可能会用到path ,http 这些本身的Node 模块,这块模块是没有必要进行打包的) |
rimraf | 基于 Node 封装的一个跨平台rm -rf 工具(该工具会在命令行中执行一些删除的操作,在这里使用该工具的目的就是把以前打包的内容进行删除) |
friendly-errors-webpack-plugin | 友好的 webpack 错误提示 |
@babel/core @babel/plugin-transform-runtime @babel/preset-env babel-loader | Babel 相关工具(把项目中的ES6 转换成es5 ) |
vue-loader vue-template-compiler | 处理 .vue 资源 |
file-loader | 处理字体资源 |
css-loader | 处理 CSS 资源 |
url-loader | 处理图片资源 |
8、webpack 配置文件
这一小节,来看一下关于webpack
的配置文件。
首先,先来初始化webpack
打包的配置文件,具体的做法就是在项目的根目录下面创建一个build
目录,
在该目录下面创建如下三个文件
webpack.base.config.js //公共配置文件
webpack.client.config.js //客户端打包配置
webpack.server.config.js//服务端打包配置
下面是webpack.base.config.js
公共配置文件中的内容
/**
* 公共配置
*/
const VueLoaderPlugin = require("vue-loader/lib/plugin"); //处理vue资源的插件,这个插件配合vue-loader一起使用
const path = require("path");
const FriendlyErrorsWebpackPlugin = require("friendly-errors-webpack-plugin"); //提供webpack打包的时候友好的日志输出
const resolve = (file) => path.resolve(__dirname, file); //获取一个绝对安全的文件路径
const isProd = process.env.NODE_ENV === "production"; //条件成立表示生产模式构建,否则为开发模式构建
//以下是服务端打包与客户端打包的公共内容
module.exports = {
//指定打包模式:根据isProd的值来确定,如果是生产模式,webpack在打包的时候会做一些优化,例如文件的压缩,development模式没有优化,打包速度快
mode: isProd ? "production" : "development",
output: {
path: resolve("../dist/"), //把最终的打包结果输出到dist目录中
publicPath: "/dist/", //设置打包文件的请求路径,打包的这些资源文件的请求路径都是以/dist开头,防止打包出来的文件与本身的路由产生冲突,也就是说所有的打包结果在请求的时候,都是以`/dist`开头
filename: "[name].[chunkhash].js", //打包的文件名,使用了chunkhash,获取的是根据文件块计算出的一个hash值,来作为文件名。使用hash作为文件名的目的就是当文件的内容发生改变后,打包出来的文件的名称也会发生变化,这样可以强制浏览器去请求新的资源。
},
resolve: {
alias: {
// 路径别名,@ 指向 src路径
//也就是在项目中使用import加载资源的时候,使用@这个别名直接指向src.
"@": resolve("../src/"),
},
// 加载资源的时候,可以省略的扩展名
// 当省略扩展名的时候,按照从前往后的顺序依次解析
extensions: [".js", ".vue", ".json"],
},
//配置soruce-map,其作用是为了便于开发调试,输出行号,可以定位错误代码的位置
devtool: isProd ? "source-map" : "cheap-module-eval-source-map",
//其它资源的处理。
module: {
rules: [
// 处理图片资源
{
test: /\.(png|jpg|gif)$/i,
use: [
{
loader: "url-loader",
options: {
limit: 8192,
},
},
],
},
// 处理字体资源
{
test: /\.(woff|woff2|eot|ttf|otf)$/,
use: ["file-loader"],
},
// 处理 .vue 资源
{
test: /\.vue$/,
loader: "vue-loader",
},
// 处理 CSS 资源
// 它会应用到普通的 `.css` 文件
// 以及 `.vue` 文件中的 `<style>` 块
{
test: /\.css$/,
use: ["vue-style-loader", "css-loader"],
},
// CSS 预处理器,参考:https://vue-loader.vuejs.org/zh/guide/pre-processors.html
// 例如处理 Less 资源
// {
// test: /\.less$/,
// use: [
// 'vue-style-loader',
// 'css-loader',
// 'less-loader'
// ]
// },
],
},
plugins: [new VueLoaderPlugin(), new FriendlyErrorsWebpackPlugin()],
};
下面看一下webpack.client.config.js
文件中的内容
/**
* 客户端打包配置
*/
const { merge } = require("webpack-merge"); //合并webpack的配置信息
const baseConfig = require("./webpack.base.config.js");
const VueSSRClientPlugin = require("vue-server-renderer/client-plugin");
//通过webpack-merge将公共文件中的配置与客户端的配置进行了合并,构建了完整的客户端的打包配置
module.exports = merge(baseConfig, {
entry: {
app: "./src/entry-client.js", //设置了客户端打包的入口,注意这里的相对路径指的执行打包所处的目录,也就是打包是在vue-ssr这个目录下面进行打包
},
module: {
rules: [
// ES6 转 ES5,服务端不用es5转es6的配置,node服务端执行es6
{
test: /\.m?js$/,
exclude: /(node_modules|bower_components)/,
use: {
loader: "babel-loader",
options: {
presets: ["@babel/preset-env"],
cacheDirectory: true,
plugins: ["@babel/plugin-transform-runtime"],
},
},
},
],
},
// 重要信息:这将 webpack 运行时分离到一个引导 chunk 中,
// 以便可以在之后正确注入异步 chunk。
optimization: {
splitChunks: {
name: "manifest",
minChunks: Infinity,
},
},
plugins: [
// 此插件在输出目录中生成 `vue-ssr-client-manifest.json`。该文件中描述了客户端打包结果的一些依赖以及一些模块的信息。后面会用到该文件
new VueSSRClientPlugin(),
],
});
下面看一下webpack.server.config
文件的内容。
/**
* 服务端打包配置
*/
const { merge } = require("webpack-merge");
const nodeExternals = require("webpack-node-externals");
const baseConfig = require("./webpack.base.config.js");
const VueSSRServerPlugin = require("vue-server-renderer/server-plugin");
module.exports = merge(baseConfig, {
// 将 entry 指向应用程序的 server entry 文件,也就是服务端打包的入口
entry: "./src/entry-server.js",
// 这允许 webpack 以 Node 的方式处理模块加载
// 并且还会在编译 Vue 组件时,
// 告知 `vue-loader` 输送面向服务器代码(server-oriented code)。
target: "node",
output: {
//输出的文件的名字。
filename: "server-bundle.js",
// 此处告知 server bundle 使用 Node 风格导出模块(Node-style exports)
libraryTarget: "commonjs2",
},
// 不打包 node_modules 第三方包(例如express),而是保留 require 方式直接加载
externals: [
nodeExternals({
// 白名单中的资源依然正常打包,也就是有些资源还是需要打包的,例如css样式。
allowlist: [/\.css$/],
}),
],
plugins: [
// 这是将服务器的整个输出构建为单个 JSON 文件的插件。输入的文件名如下,后面还会用到该文件。
// 默认文件名为 `vue-ssr-server-bundle.json`
new VueSSRServerPlugin(),
],
});
以上三个配置文件的内容,目前我们已经分析完了,下面我们需要根据创建好的配置文件来进行打包,那么在打包之前需要配置构建命令。
9、配置构建命令
下面需要在package.json
文件中的scripts
这一项中,构建出打包的命令。
首先进行如下的配置:
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1",
//指定生产环境客户端打包的配置,这里通过cross-env指定环境为生产环境,webpck打包执行的配置文件为build目录中的webpack.client.config.js
"build:client": "cross-env NODE_ENV=production webpack --config build/webpack.client.config.js",
//指定生产环境中服务端打包
"build:server": "cross-env NODE_ENV=production webpack --config build/webpack.server.config.js",
//为了方便使用以上命令,将以上两项打包内部合并为一个指令。并且在打包前,通过rimraf命令删除dist目录(删除以前的打包文件)
"build": "rimraf dist && npm run build:client && npm run build:server"
},
下面可以对上面的配置进行测试
npm run build
10、启动应用
现在已经通过打包得到了服务端的资源文件以及客户端的资源文件,下面看一下怎样使用这些资源文件。
这里需要对根目录下的server.js
文件中的代码进行修改:
// const Vue=require('vue')
const express = require("express");
const fs = require("fs");
const serverBundle = require("./dist/vue-ssr-server-bundle.json"); //导入生成的vue-ssr-server-bundle.json文件
const template = fs.readFileSync("./index.template.html", "utf-8"); //读取模板文件
const clientManifest = require("./dist/vue-ssr-client-manifest.json"); //导入vue-ssr-client-manifest.json文件
// 创建一个渲染器
// const renderer=require('vue-server-renderer').createRenderer({
// template:fs.readFileSync('./index.template.html','utf-8')
// })
//将createRenderer方法修改成createBundleRenderer方法
const renderer = require("vue-server-renderer").createBundleRenderer(
serverBundle,
{
template,
clientManifest,
}
);
const server = express();
//处理静态资源
//如果请求中带有/dist前缀,查询`/dist`目录,获取对应的静态资源。
//通过返回到客户端的html代码,可以看到这块代码中,包含了打包生成的js文件。
server.use("/dist", express.static("./dist"));
server.get("/", (req, res) => {
//这里不需要手动创建Vue实例,会去src/app.js文件中获取实例(注意:这里的修改)
renderer.renderToString(
{
title: "个人简介",
meta: "<meta name='description' content='用户的个人简介'>",
},
(err, html) => {
if (err) {
console.log("err=", err);
return res.status(500).end("Internal Server Error");
}
res.setHeader("Content-Type", "text/html;charset=utf8");
res.end(html);
// res.end(html);
}
);
});
server.listen(3000, () => {
console.log("server running at prot 3000");
});
这里安装的webpack
的版本为:npm i -D webpack@4.43.0
nodemon server.js
启动服务以后,在浏览器端,可以看到生成的页面,并且具有了动态效果。