實作react伺服器渲染基礎方法-js教程-PHP中文網

本文主要跟大家介紹從零開始最小實現react伺服器渲染詳解,小編覺得挺不錯的，現在分享給大家，也給大家做個參考。一起跟著小編過來看看吧，希望能幫助大家。

前言

最近在寫koa 的時候想到，如果我部分程式碼提供api，部分程式碼支援ssr，那我該如何寫呢？（不想拆成2個服務的情況下）
而且最近寫的項目裡面也用過一些服務端渲染，如nuxt，自己也搭過next的項目，確實開發體驗都非常友好，但是友好歸友好，具體又是如何實現的呢，各位有沒有考慮過？

本著求真務實的折騰態度，選了react作為研究對象（主要是vue寫的有點多，噁心了），那下面就簡單就以最小成本寫一個react的服務端渲染demo

用到的技術堆疊

用到的技術堆疊

react 16 + webpack3 + koa2

看看它是如何實作服務端渲染的，here we go！

為什麼要用服務端渲染

加速首屏渲染，減少白屏時間

##那麼問題來什麼是SEO

一句話介紹就是，現在我們做的大多是SPA網站，所有頁面啊資料啊都是ajax來的，搜尋引擎的spider來收錄網頁的時候，發現全空？那你覺得你的網站收錄的權重跟效果好還是不好？

而我們對SEO優化，也是下面內容所描述的核心就是：

下面是重點！讓伺服器把有內容的HTML回傳給我們，事件的話瀏覽器再渲染一次來進行掛載

建置koa 環境

##新建一個ssr 項目，並在專案中初始化npm

mkdir ssr && cd ssr
npm init

登入後複製

下面的程式碼我們用到了import jsx 等語法，node環境是不支援的，所以需要設定babel

在目前專案中新檔app.js跟index.js，然後

babel的入口， index.js程式碼如下

require(&#39;babel-core/register&#39;)()

require(&#39;babel-polyfill&#39;)
require(&#39;./app&#39;)

登入後複製

我們專案的入口，app.js程式碼如下

import Koa from &#39;koa&#39;
const app = new Koa()

// response
app.use((ctx) => {
 ctx.body = &#39;Hello Koa&#39;
})

app.listen(3000)
console.log("系统启动，端口：3000")

登入後複製

根目錄下新建一個.babelrc檔

##內容是：

{
 "presets": ["react", "env"]
}

登入後複製

安裝上面所需的相依性

npm install babel-core babel-polyfill babel-preset-env babel-preset-react nodemon --save-dev
npm i koa --save

登入後複製

配置啟動腳本

package .json

"scripts": {
 "dev": "nodemon index.js",
}

登入後複製

到這裡你執行npm run dev 打開localhost:3000

你就會看到hello Koa了

是不是很簡單就起了一個服務

安裝React

cnpm install react react-dom --save

登入後複製

在根目錄下新建一個app資料夾，並在資料夾中新建一個main.js

main.js程式碼如下

import React from &#39;react&#39;

export default class Home extends React.Component {
 render () {
  return <p>hello world</p>
 }
}

登入後複製

修改之前server.js

import Koa from &#39;koa&#39;
import React from &#39;react&#39;
import { renderToString } from &#39;react-dom/server&#39;
import App from &#39;./app/main&#39;

const app = new Koa()

// response
app.use(ctx => {
 let str = renderToString(<App />)

 ctx.body = str
})

app.listen(3000)

console.log(&#39;系统启动，端口：8080&#39;)

登入後複製

這時候再npm run dev

你就會看到螢幕上出現hello world

再開啟chrome 開發者工具查看我們的請求：

我們的最簡單的react元件變成str傳了進來

這裡我們用到了一個方法：

renderToString – 其實就是將元件渲染成字串

目前為止，我們都還沒有給元件加上事件等互動行為，下面那讓我們來試試

修改main. js的程式碼

import React from &#39;react&#39;

export default class Home extends React.Component {
 render () {
  return <p onClick={() => window.alert(123)}>hello world</p>
 }
}

登入後複製

再刷新一下我們的頁面，，咦，是不是沒有什麼卵用

那是因為後端只能講元件渲染成一串html的字串，事件綁定等事情都是需要在瀏覽器端執行的

那事件我們改怎麼綁定上去呢？

那你一定會猜到，既然伺服器渲染出來的是一串html，掛載事件的方式是不是在瀏覽器重新渲染一次就好了呢

說乾就乾

配製webpack

在根目錄下方新建一個webpack.config.js

下面是webpack.config. js的內容：

var path = require(&#39;path&#39;)
var webpack = require(&#39;webpack&#39;)

module.exports = {
 entry: {
  main: &#39;./app/index.js&#39;
 },
 output: {
  filename: &#39;[name].js&#39;,
  path: path.join(__dirname, &#39;public&#39;),
  publicPath: &#39;/&#39;
 },
 resolve: {
  extensions: [&#39;.js&#39;, &#39;.jsx&#39;]
 },
 module: {
  loaders: [
   {test: /\.jsx?$/,
    loaders: [&#39;babel-loader&#39;],
   }
  ]
 }
}

登入後複製

上面的設定將entry設定成了app/index.js檔案

那我們就建立一個

下面是app/index.js的程式碼：

import Demo from &#39;./main&#39;
import ReactDOM from &#39;react-dom&#39;
import React from &#39;react&#39;
ReactDOM.render(<Demo />, document.getElementById(&#39;root&#39;))

登入後複製

因為瀏覽器渲染需要將根元件掛載到某個dom節點上，所以給我們的react程式碼設定一個入口

這時候就有一個問題，就是，document物件node環境下並不存在，那怎麼解決的呢？

不存在？不存在那我就不用就好了，SSR核心就是讓請求的url裡面回傳具體HTML內容，事件什麼的並不care，那麼我就把根元件直接renderToString

回來就好了唄

下面修改我們的服務程式碼，讓程式碼支援伺服器渲染

新增一點依賴

########

cnpm i --save koa-static koa-views ejs

登入後複製

koa-static：处理静态文件的中间件
koa-views：配置模板的中间件
ejs：一个模板引擎

修改server.js的代码

import Koa from &#39;koa&#39;
import React from &#39;react&#39;
import { renderToString } from &#39;react-dom/server&#39;
import views from &#39;koa-views&#39;
import path from &#39;path&#39;

import Demo from &#39;./app/main&#39;
const app = new Koa()
// 将/public文件夹设置为静态路径
app.use(require(&#39;koa-static&#39;)(__dirname + &#39;/public&#39;))
// 将ejs设置为我们的模板引擎
app.use(views(path.resolve(__dirname, &#39;./views&#39;), { map: { html: &#39;ejs&#39; } }))

// response
app.use(async ctx => {
 let str = renderToString(<Demo />)
 await ctx.render(&#39;index&#39;, {
  root: str
 })
})

app.listen(3000)

console.log(&#39;系统启动，端口：8080&#39;)

登入後複製

下面新建我们的渲染模板

新建一个views文件夹

里面新建一个index.html：

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <meta http-equiv="X-UA-Compatible" content="ie=edge">
  <title>Document</title>
  <base href="/client" rel="external nofollow" >
</head>
<body>
  <p id="root"><%- root %></p>
  <script src="/main.js"></script>
</body>
</html>

登入後複製

这个 html 里面可以放一些变量，比如这个<%- root %>，就是等下要放renderToString结果的地方

/main.js则是react构建出来的代码

下面直接来测试一下我们的代码

1. 在 package.json里面

新增：

 "scripts": {
  "dev": "nodemon index.js",
  "build": "webpack"
 },

登入後複製

2. 运行 npm run build，构建出我们的react代码

3. npm run dev

点击一下代码，是不是会 alert(123)

tada 撒花，恭喜你，一个最简单服务器渲染就已经完成

到这里核心的思想就都已经讲完了，总结来说就下面三点：

起一个node服务
把react 根组件 renderToString渲染成字符串一起返回前端
前端再重新render一次

原理就是这么简单

但是具体开发的时候还会有各种各样的需求，比如：

不可能我每次改完代码都重新构建看效果吧 => 需要实时构建
create-react-app 都是热更新，你还要刷新是不是太蠢了 => 需要支持热更新
其他一些配套的周边，如： react-router, redux 或者mobx怎么支持呢 => 需要完善的生态

.etc

这些问题都是用完官方脚手架之后就回不去了的，所以更多的配置可以参考下面的repo（是一个工具链完善的最小实现），欢迎提PR

GitHub - ws456999/koa-react-ssr-starter: to understand && to explain how react ssr works

目前你可以在里面找到 react + react-router + mobx + postcss + 热更新的配置，除了react-router的配置有些差别，其他都跟client端差别不大