从零开始搭建React同构应用(三):配置SSR

Larry_

从零开始搭建React同构应用(三):配置SSR

这篇文章来讲解来配置server side render,我们先从最简单的方法开始,用cli的方式模拟实现SSR。

demo在这里

主要内容:

  1. 添加webpack的server render配置

  2. 使用CLI的方式测试SSR输出

添加webpack的server render配置

之前我是考虑在node端直接require源码,例如:

//hook require
require("babel-register")({
    babelrc: "false",
    presets: ['react'],
    plugins: [
        "transform-decorators-legacy",
        "transform-es2015-modules-commonjs"
    ]
});

//直接引入源码
const IndexBundle = require("./src/index/Index.jsx");


//do server side render...

这样少编译一套代码,觉得这样维护起来更方便,但是后来实践发现有几个问题:

  1. import "xxx.styl",引入样式文件会报错。

  2. 这种模式下需要使用babel-registerbabel编译速度较慢,开发模式下每次修改文件再重启服务器耗时太长。

  3. 影响生产环境下执行效率。

最后权衡下,还是决定使用现在多一套ssr编译配置的方案。

webpack.config.js添加以下代码

let serverConfig = {};

Object.assign(serverConfig, browserConfig, {
    output: {
        path: path.join(__dirname, 'build_server'),
        filename: "[name].bundle.js",
        libraryTarget: 'commonjs2' //设置导出类型,web端默认是var,node需要module.exports = xxx的形式
    },
    module: {
        loaders: [
            {
                test: /\.jsx?$/,
                exclude: /node_modules/,
                loader: "babel-loader",
                query: {                //node端的babel编译配置可以简化很多
                    babelrc: "false",
                    presets: ['react'],
                    plugins: [
                        "transform-decorators-legacy",
                        "transform-es2015-modules-commonjs" //如果不转换成require,import 'xxx.styl'会报错
                    ]
                }
            },
            {
                test: /\.(styl|css)$/,          //node端不能 require('xx.css'),会报错
                loader: 'null'
            },
        ]
    },
    plugins: [
        new webpack.ProvidePlugin({
            React: 'react',
            ReactDOM: 'react-dom',
            fetch: 'isomorphic-fetch',
            promise: 'promise'
        }),
        new webpack.DefinePlugin({
            'process.env.NODE_ENV': JSON.stringify(process.env.NODE_ENV) || JSON.stringify('development')
        }),
    ],
    target: 'node',
    externals: [nodeExternals()], //不把node_modules中的文件打包
});

因为serverConfig的配置和browserConfig相似,我就使用Object.assign来复制一份,同时做下修改。

nodejs启用 --harmony参数就可以支持绝大部分的ES6,ES7语法,如async等,因此只需要编译JSX语法和import语法。babel的编译速度也因此可以提高很多。babelrc: "false"是为了屏蔽项目目录下的babel.rc文件,那是给浏览器端编译使用的。

同时,在node环境不支持直接引入CSS文件的,如require('xx.css'),因此在打包的时候要忽略样式文件和资源文件,否则会报错。

这里我使用了webpack-node-externals插件,这个插件的原理是利用了webapck中的externals配置项,来剔除node_modules文件的,因为默认webapck会把所有用到的js文件统统打包,而我们由于是在node端,因此不需要把用到的库也打包了。

执行试试

npm run watch

clipboard.png

如果不用webpack-node-externals,打包出的文件体积会大很多

clipboard.png

测试SSR输出

其实使用React的ssr很简单,熟悉下面两个API即可:

  1. React.createElement

  2. ReactDOMServer.renderToString

React.createElement

clipboard.png

这里简单解释下,React.createElementReact类进行实例化,实例化后的组件就可以进行mount操作了,在浏览器环境我们是使用ReactDOM.render()来进行挂载操作的。

ReactDOMServer.renderToString

clipboard.png

ReactDOMServer.renderToString则是把React实例渲染成HTML标签。

测试

这里我们先不搭建HTTP server,暂时用cli的方式模拟一下,方便大家理解。

新建cli.js,写入以下内容(以Index.jsx为例),注意:.defalut不能少。

/**
 * Created by chenchen on 2017/2/4.
 *
 * React server render 命令行测试
 */

//以Index.jsx为例
const IndexBundle = require("../build_server/index.bundle.js");
const React = require("react");
const ReactDOMServer = require("react-dom/server");
let {renderToString} = ReactDOMServer;
let initialData = {todoList: ['11', '22', '33']};
let instance = React.createElement(IndexBundle.default, initialData); //.defalut不能少


let str = renderToString(instance);

console.log(str);

我们添加一条npm script

"test-ssr": "node --harmony test/cli.js"

执行后效果如图

clipboard.png

可以看到我们已经成功输出了组件渲染后的HTML文本了。

下一篇文章我将讲解如何搭建一个简单的Koa server,并结合这边文章内容,实现真正意义上的server side render ^_^。

要注意的地方

React生命周期

React组件的声明周期只会到componentWillMount,因此你不能在componentWillMount及其之前的生命周期钩子中写浏览器环境下的代码,如$.ajax(...),会报错。

前后端数据同步

要注意浏览器端和服务器端的数据要一致,否则会出现HTML重用失败的错误:
clipboard.png

server side render 没有用到redux

可能有人会疑惑,在浏览器编译的代码是:

 //初始数据,用于和server render数据同步
let initialData = window._SERVER_DATA || {};

let store = createStore(reducers, initialData, window.__REDUX_DEVTOOLS_EXTENSION__ && window.__REDUX_DEVTOOLS_EXTENSION__());

let App = connect(_ => _)(Layout);//用connect包装一下,这里只用到mapStateToProps,而且不对state加以过滤

ReactDOM.render(
    <Provider store={store}>
        <App/>
    </Provider>,
    document.getElementById('wrap'));

而server端的编译没有和Redux沾边,因为Providerconnect(...)(Layout)functional component,本身不会多渲染出来HTML,因此可以不用Redux参与渲染。

阅读 20.7k

前端笔记
该用户没有描述

FE

693 声望
184 粉丝
0 条评论
你知道吗?

FE

693 声望
184 粉丝
宣传栏