從零開始最小實現(xiàn)react服務器渲染詳解
前言
最近在寫 koa 的時候想到，如果我部分代碼提供api，部分代碼支持ssr，那我應該如何寫呢？（不想拆成 2個服務的情況下）
而且最近寫的項目里面也用過一些服務端渲染，如nuxt，自己也搭過next的項目，確實開發(fā)體驗都非常友好，但是友好歸友好，具體又是如何實現(xiàn)的呢，諸位有沒有考慮過？
本著求真務實的折騰態(tài)度，選了react作為研究對象（主要是vue寫的有點多，惡心了），那下面就簡單就以最小成本寫一個react的服務端渲染 demo
用到的技術(shù)棧
react 16 + webpack3 + koa2
看看它是如何實現(xiàn)服務端渲染的，here we go！
為什么要用服務端渲染
優(yōu)點
無非就是兩點
- SEO 友好
- 加快首屏渲染，減少白屏時間
那么問題來了什么是SEO
一句話介紹就是，現(xiàn)在我們做的大多是SPA網(wǎng)站，所有頁面啊數(shù)據(jù)啊都是ajax來的，搜索引擎的spider來收錄網(wǎng)頁的時候，發(fā)現(xiàn)全空？那么你覺得你的網(wǎng)站收錄的權(quán)重跟效果是好還是不好？
而我們對SEO優(yōu)化，也是下面內(nèi)容所描述的核心就是：
下面是重點！
讓服務器把有內(nèi)容的HTML返回給我們，事件的話瀏覽器再渲染一次來進行掛載
搭建 koa 環(huán)境
新建一個 ssr 項目，并在項目中初始化 npm
mkdir ssr && cd ssr npm init
下面的代碼我們用到了 import jsx 等語法，node環(huán)境是不支持的，所以需要配置babel
在當前項目中新建文件 app.js跟index.js，然后
babel的入口， index.js代碼如下
require('babel-core/register')()
require('babel-polyfill')
require('./app')
我們項目的入口， app.js代碼如下
import Koa from 'koa'
const app = new Koa()
// response
app.use((ctx) => {
ctx.body = 'Hello Koa'
})
app.listen(3000)
console.log("系統(tǒng)啟動，端口：3000")
根目錄下新建一個.babelrc文件
內(nèi)容是：
{
"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 'react'
export default class Home extends React.Component {
render () {
return <div>hello world</div>
}
}
修改之前server.js
import Koa from 'koa'
import React from 'react'
import { renderToString } from 'react-dom/server'
import App from './app/main'
const app = new Koa()
// response
app.use(ctx => {
let str = renderToString(<App />)
ctx.body = str
})
app.listen(3000)
console.log('系統(tǒng)啟動，端口：8080')
這個時候再 npm run dev
你就會看到屏幕上出現(xiàn)hello world
再打開chrome 開發(fā)者工具查看我們的請求：
我們的最簡單的react組件變成str傳了進來
這里我們用到了一個方法：
renderToString – 其實就是將組件渲染成字符串
目前為止，我們都還沒有給組件加上事件等交互行為，下面那讓我們來試一下
修改main.js的代碼
import React from 'react'
export default class Home extends React.Component {
render () {
return <div onClick={() => window.alert(123)}>hello world</div>
}
}
再刷新一下我們的頁面，，咦，是不是沒有什么卵用
那是因為后端只能講組件渲染成一串html的字符串，事件綁定等事情都是需要在瀏覽器端執(zhí)行的
那事件我們改怎么綁定上去呢？
那你肯定就會猜到，既然服務器渲染出來的是一串html，掛載事件的方式是不是在瀏覽器重新渲染一次就好了呢
說干就干
配制webpack
在根目錄下面新建一個 webpack.config.js
下面是webpack.config.js的內(nèi)容：
var path = require('path')
var webpack = require('webpack')
module.exports = {
entry: {
main: './app/index.js'
},
output: {
filename: '[name].js',
path: path.join(__dirname, 'public'),
publicPath: '/'
},
resolve: {
extensions: ['.js', '.jsx']
},
module: {
loaders: [
{test: /\.jsx?$/,
loaders: ['babel-loader'],
}
]
}
}
上面的配置將entry設置成了app/index.js文件
那我們就創(chuàng)建一個
下面是app/index.js的代碼：
import Demo from './main'
import ReactDOM from 'react-dom'
import React from 'react'
ReactDOM.render(<Demo />, document.getElementById('root'))
因為瀏覽器渲染需要將根組件掛載到某個dom節(jié)點上，所以給我們的react代碼設置一個入口
這個時候就有一個問題，就是，document對象node環(huán)境下并不存在，那怎么解決的呢？
不存在？不存在那我就不用就好了，SSR核心就是讓請求的url里面返回具體HTML內(nèi)容，事件什么的并不care，那么我就把根組件直接renderToString
返回出來就好了唄
下面修改我們的服務代碼，讓代碼支持服務器渲染
新增一點依賴
cnpm i --save koa-static koa-views ejs
- koa-static： 處理靜態(tài)文件的中間件
- koa-views： 配置模板的中間件
- ejs：一個模板引擎
修改server.js的代碼
import Koa from 'koa'
import React from 'react'
import { renderToString } from 'react-dom/server'
import views from 'koa-views'
import path from 'path'
import Demo from './app/main'
const app = new Koa()
// 將/public文件夾設置為靜態(tài)路徑
app.use(require('koa-static')(__dirname + '/public'))
// 將ejs設置為我們的模板引擎
app.use(views(path.resolve(__dirname, './views'), { map: { html: 'ejs' } }))
// response
app.use(async ctx => {
let str = renderToString(<Demo />)
await ctx.render('index', {
root: str
})
})
app.listen(3000)
console.log('系統(tǒng)啟動，端口：8080')
下面新建我們的渲染模板
新建一個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> <div id="root"><%- root %></div> <script src="/main.js"></script> </body> </html>
這個 html 里面可以放一些變量，比如這個<%- root %>，就是等下要放renderToString結(jié)果的地方
/main.js則是react構(gòu)建出來的代碼
下面直接來測試一下我們的代碼
1. 在 package.json里面
新增：
"scripts": {
"dev": "nodemon index.js",
"build": "webpack"
},
2. 運行 npm run build， 構(gòu)建出我們的react代碼
3. npm run dev
點擊一下代碼，是不是會 alert(123)
tada 撒花，恭喜你，一個最簡單服務器渲染就已經(jīng)完成
到這里核心的思想就都已經(jīng)講完了，總結(jié)來說就下面三點：
- 起一個node服務
- 把react 根組件 renderToString渲染成字符串一起返回前端
- 前端再重新render一次
原理就是這么簡單
但是具體開發(fā)的時候還會有各種各樣的需求，比如：
- 不可能我每次改完代碼都重新構(gòu)建看效果吧 => 需要 實時構(gòu)建
- create-react-app 都是熱更新，你還要刷新是不是太蠢了 => 需要支持熱更新
- 其他一些配套的周邊，如： react-router, redux 或者mobx怎么支持呢 => 需要完善的生態(tài)
.etc
這些問題都是用完 官方腳手架之后就回不去了的，所以更多的配置可以參考下面的repo（是一個工具鏈完善的最小實現(xiàn)），歡迎提PR
GitHub - ws456999/koa-react-ssr-starter: to understand && to explain how react ssr works
目前你可以在里面找到 react + react-router + mobx + postcss + 熱更新的配置，除了react-router的配置有些差別，其他都跟client端差別不大
以上就是本文的全部內(nèi)容，希望對大家的學習有所幫助，也希望大家多多支持腳本之家。
相關文章
這篇文章主要介紹了詳解antd+react項目遷移vite的解決方案，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2021-04-04
useEffect是React中的一個鉤子函數(shù),用于處理副作用操作,這篇文章主要為大家介紹了React中useEffect函數(shù)的具體用法,希望對大家有所幫助2023-08-08
中間件就是一個函數(shù)，對store.dispatch方法進行了改造，在發(fā)出 Action 和執(zhí)行 Reducer 這兩步之間，添加了其他功能，要理解中間件，關鍵點是要知道，這個中間件是連接哪些部分的軟件，它在中間做了什么事，提供了什么服務2023-01-01
react使用antd的上傳組件實現(xiàn)文件表單一起提交功能(完整代碼)
最近在做一個后臺管理項目，涉及到react相關知識，項目需求需要在表單中帶附件提交，怎么實現(xiàn)這個功能呢？下面小編給大家?guī)砹藃eact使用antd的上傳組件實現(xiàn)文件表單一起提交功能，一起看看吧2021-06-06
forwardRef 相當于是為 ref 傳遞的一種方式,普通的函數(shù)式組件就是 Render,而 fowardRef 多加了 Ref 參數(shù),這篇文章主要介紹了React 中的 ForwardRef的使用示例詳解,需要的朋友可以參考下2024-06-06
使用react實現(xiàn)手機號的數(shù)據(jù)同步顯示功能的示例代碼
本篇文章主要介紹了使用react實現(xiàn)手機號的數(shù)據(jù)同步顯示功能的示例代碼，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2018-04-04
使用React+ts實現(xiàn)無縫滾動的走馬燈詳細過程
這篇文章主要給大家介紹了關于使用React+ts實現(xiàn)無縫滾動的走馬燈詳細過程,文中給出了詳細的代碼示例以及圖文教程,對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2023-08-08
這篇文章主要為大家介紹了React組件實例三大屬性state props refs使用詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪2022-09-09
react事件綁定時。this并不會指向當前DOM元素。往往使用bind來改變this指向，今天通過本文給大家介紹React事件綁定的方式，感興趣的朋友2021-07-07
這篇文章主要為大家介紹了Ant?Design組件庫之步驟條實現(xiàn)，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪2022-08-08