#ReactApp项目构建流程【2】

时间 2019-11-09

标签 reactapp 项目构建流程繁體版

原文原文链接

ReactApp项目构建流程【2】

React服务端渲染

为何会有服务端渲染？html
- webapp开发模式不少框架都由浏览器渲染HTML内容，而seo抓取url内容时并不会执行js代码，抓取webapp时获得的是一个HTML[空内容]+js[内容写在js中],seo难以进行推广
- 而且由浏览器渲染的webapp HTML内容必须等到js文件加载完成，首次请求时等待时间会比较长，体验差
- React团队运用nodejs,使得用react构建的app可以在nodejs环境中进行渲染，以获得内容，再返回给浏览器，此时的HTML就可以被seo以及爬虫抓取，用户等待时间也会变短

服务端渲染准备

工具 `react-dom`下的`server`模块

reat-dom是React专门为web端开发的渲染工具。
 
 在客户端，咱们可使用react-dom的render方法渲染组件
 
 在服务端，react-dom/server提供咱们将react组件渲染成HTML的方法

基础配置

打开咱们以前作好的项目，这里是以前的项目连接，未上传至github
首先打开app.js，发现以前是将<App />这个JSX标签render(中文：传递)到document.body中的，而问题是在服务端中并无浏览器环境，天然也就没有document这个dom对象node
- 同级目录下新建server-entry.js,将须要服务端渲染的内容export出去
  import React from 'react' //用到了JSX就须要import 'react'
  import App from './App.jsx' //须要添加 [./],由于默认的import目录是node_modules
  export default <App /> //返回的应该是jsx语法再转义
  至此一个简单的server-entry.js文件就写好了
  该文件的做用：在服务端渲染时使用该文件，要把该文件单独打包出来，由于是JSX语法，须要用babel
- 与webpack.config.js同级创建webpack.config.server.js
  内容拷贝自webpack.config.js，与entry选项同级添加react
  
  target:"node",webpack
```
//指定webpack打包出来的文件是使用在哪一个执行环境中的，选项有且不只有web/node/...
```
  entry中的app修改成server-entry.jsgit
  
  output中的filename修改成'server-entry.js'而非hash化文件名github
```
//此项可用于输出版本号用于缓存更新，而服务端无浏览器缓存概念，而且这会加大import难度
而且添加一项libraryTarget:"commonjs2" 
    //打包出js时使用的模块方案，有多种global/cmd/amd/umd/commjs/...，commonjs2适用于node端
```
  删除plugins：[new HTMLPlugin()]，web
```
同时删除其引用const HTMLPlugin=require('html-webpack-plugin')
由于服务端负责渲染而非输出HTML文件
```

配置完上步以后就能够把上部分的js打包出来，为方便后续打包，修改下package.json配置express

* 删除`scripts`下的`test`，当前暂时用不到
       "test": "echo \"Error: no test specified\" && exit 1",
       
   * 为分别build`客户端`和`服务端`以及区分不一样端文件，在`scripts`添加两个`script`并修改`build`用于，将`webpack.config.js`修改成下端代码中的文件名
       "build:client":"webpack --config webpack.config.client.js",
       "build:server":"webpack --config webpack.config.server.js",
       "clear":"rimraf dist",
       //用于每次build时覆盖dist目录，该包专门用于删除文件夹，须要安装[该段第五步]
       "build":"npm run clear && npm run build:client && npm run build:server"
       //使用npm 按顺序 run clear，build:client 和build:server 脚本
       
       $npm i rimraf -D
       //安装完会自动更新package.json文件依赖关系

写到这里咱们能够发现`npm run`这个命令实际上是是运行`package.json`中的`scripts`中相应的`script`片断的key-value中的value,好比`npm run clear`实际是运行`npm run rimraf dist`

npm run buildnpm

编译后能够在output目录dist中，分别看到客户端js文件`[name].[hash].js`以及服务端js文件`server-entry.js`
对比能够发现server-entry.js在顶部使用了module.exports这一node语法，所以能够发现是能够被node执行各类操做包括渲染的

在root下newserver文件夹用于添加node server，用到express，须要安装，$npm i express -S，由于该服务是正常服务中须要用到的，因此要使用-S安装到依赖模块当中json

安装好后在server文件夹内新建server.js并加入如下代码

const express=require('express');                //node方式引入expeess
const ReactSSR=require('react-dom/server');      //node方式引入react-dom/serve
const serverEntry=require('../dist/server-entry').default;
//此处为什么须要添加.default呢，由于若是不添加default时，下面的打印说明了问题
const app=express();
console.log(serverEntry);
/*会发现打印出来的是这么个东西，其中default中的东西才是nodeServer须要渲染的东西
{ __esModule: true,
     default:
         { 
            '$$typeof': Symbol(react.element),
            type: [Function: App],
            key: null,
            ref: null,
            props: {},
             _owner: null,
            _store: {} 
           }
  }
*/
由于当前使用的是commonjs2模块方案，而commonjs2默认使用export.default来export模块，
能够回到server-entry.js看下代码

export default <APP /> 对应的引入方法 import app from './App.jsx'】
export const app=App   对应的引入方法 import {app} from '..'     】->ES6中解构的写法
node中使用的是require引入，require默认不会读取default内容
             
 app.get('*',function (req,res) {
        const appString=ReactSSR.renderToString(serverEntry);
        res.send(appString)
     });
          
     app.listen(3000,function () {         //监听端口，成功函数
         console.log('server is listening')
     })

$npm start

进入http://localhost:3000端口，打开network查看Headers以及Response

至此最简单的服务端渲染已经完成，此时的返回内容html少以及未引用客户端的业务代码js
为解决该问题，须要把服务端渲染出来的内容（当前为server-entry.js）插入到index.html
(html-webpack-plugin插件经过编译成的HTML)的body当中并总体返回body，这才算打通一个整的
服务端渲染过程

添加模板文件template.html以及修改webpack.config.client.js配置

在client目录下新建`template.html`,在body中添加如下代码

<div id="root"><app></app></div>
//这个名为root的div就能够替代以前app.js中App组件挂载的document.body了，而内部的app标签则是用于覆盖，下面讲怎么覆盖

在webpack.config.client.js的HTMLPlugin中添加刚才新建的template模板
     {
       template：path.join(__dirname,'../client/template.html')
     }
     
 app.js中以前挂载的document.body修改成document.getElementById('root')
 ReactDOM.render(<App />,document.body)
 ->
 ReactDOM.render(<App />,document.getElementById('root'))
 //把渲染出来的内容render到root节点中

配置好template后，在server.js中读取template.html而且替换掉<app>标签

const fs=require('fs')            //node文件模块
const path=require('path')        //node路径模块
const template=fs.readFileSync(path.join(__dirname,'../client/template.html'),'utf-8')    
//同步读取绝对路径文件，而且以utf-8格式输出，不指定的话回默认输出buffer格式
           
//修改app的get方法
app.get('*',function (req,res) {
       const appString=ReactSSR.renderToString(serverEntry);
       res.send(template.replace('<app></app>',appString));//修改用于替换掉<app>标签
});

$npm run build ->$npm start

进入http://localhost:3000，成功，可是network时发现请求localhost和请求js文件时返回结果同样，
也就是说有资源被重复返回的状况出现
由于咱们的服务接受到的全部请求都会返回服务端渲染的内容
针对此问题，须要添加配置以肯定哪些是不须要屡次返回的静态资源文件
                
app.use('/public',express.static(path.join(__dirname,'../dist')));
//express中为咱们提供的专门处理此问题的模块，用于肯定哪些文件夹下的资源是静态文件
由于咱们的client下的全部内容都在webpack.config.client.js中配置编译到dist(output->path)下，
因此此处的静态文件路径就join dist，其中的publicPath在上次在跟走代码时置为空了，如今从新加回去，
webpack.config.server.js中也须要加回去
                
#咱们能够在编译好的index.html中查看资源路径是否正确