序文
SSRの概念とそのメリット・デメリットについては、前回のブログ「ノードサーバーサイドレンダリング(SSRコンセプト)」でもまとめており、現在はSSRフロントエンドプロジェクトの構築を実際のコードで実装する方法を学習しています。 SSR + フロントエンド フレームワークのレビュー、プロジェクト構築の概要と個人的な理解。
知らせ
目的は、大まかなコード構造、基本的な構造、コードが何に使用されるかを示すことであり、0 から完全に完成したプロジェクトまで初期化することはできません。
Nuxt.jsやNext.jsなどの SSR フレームワークは使用せず、ネイティブ ノード + Vue の説明
コアテクノロジースタック
Node.js + Express + Vue3
動作環境
ノード環境
プロジェクト紹介
主要な実装原則
SSR の実装の焦点は、サーバー側でページの要素 DOM を生成し、それをブラウザーに返すことです。
ここでは SSR を実装するためのフロントエンド フレームワークを組み込みます。これは大きく次の手順に分かれています。
- フロントエンド フレームワークを使用して app.js スクリプトを作成し、フレームワークのコンポーネントを導入します
- サーバー側で静的 HTML ページを返すためのインターフェイスを作成する
- 静的 HTML に、フロントエンド フレームワークのコンポーネントを追加します。
- 静的 HTML では、フロントエンド フレームワークのクライアント スクリプトを追加することで、フロントエンド フレームワークに静的ページを追加してインタラクティブな機能を実現できます。
プロジェクトの構造
プロジェクトディレクトリ
Build はパッケージ化ファイルです。このプロジェクトでは、webpack パッケージ化ツールを使用してプロジェクトをパッケージ化します。
コアモジュールの紹介
「コア実装原則」ステップの手順に従ってプロジェクト構造を実行し、src の下にプロジェクトのコア SSR 構成の機能を導入します。
1.app.js (フレームワークはメインコンポーネントスクリプトを導入します)
フロントエンド フレームワークを使用して app.js を作成し、フレームワークのコンポーネントを導入する
コード
import {
createSSRApp } from "vue";
import App from "./App.vue";
export default function createApp() {
// 创建app
const app = createSSRApp(App);
return app;
}
// createApp(App).mount("#app");
<template>
<div class="app" style="border: 1px solid red">
<h1>App</h1>
<div>count: {
{ count }}</div>
<button @click="addNumber">+1</button>
</div>
</template>
<script setup>
import { ref } from "vue";
const count = ref(100);
function addNumber() {
count.value += 1;
}
</script>
2.サーバー(サーバー)
関数:
- サーバー側で静的 HTML ページを返すためのインターフェイスを作成する
- サーバーを起動します
- リソースパスの構成
- 静的 HTML に、フロントエンド フレームワークのコンポーネントを追加します。
- …
コード
import express from "express";
import createApp from "../app";
import {
renderToString } from "@vue/server-renderer";
let app = express();
let App = createApp();
// 部署 静态资源
app.use(express.static("build"));
// 和注册的顺序有关系,优先匹配第一个符合的路径
app.get("/*", async (req, res) => {
const AppContent = await renderToString(App);
console.log(AppContent);
res.send(`
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="icon" href="data:;base64,=">
<title>Document</title>
</head>
<body>
<h1> Vue + Server Side Render</h1>
<div id="app">${
AppContent}</div>
<script src="/client/client_bundle.js"></script>
</body>
</html>
`);
});
app.listen(3000, () => {
console.log("Node Server Start On 3000");
});
3.クライアント(クライアント)
関数:
- 静的 HTML に、フロントエンド フレームワークのクライアント側スクリプトを追加します。
- インタラクティブな機能を実現するには、フロントエンド フレームワークに静的ページを追加します。
- …
コード
import {
createApp } from "vue";
import App from "../App.vue";
let app = createApp(App);
app.mount("#app"); // 需要在body添加id=app标签
構成モジュール
config (プロジェクトのパッケージ化構成)
let path = require("path");
let nodeExternals = require("webpack-node-externals");
let {
DefinePlugin } = require("webpack");
let {
VueLoaderPlugin } = require("vue-loader/dist/index");
module.exports = {
mode: "development",
module: {
rules: [
{
test: /\.js$/,
use: [
{
loader: "babel-loader",
},
],
},
{
test: /\.vue$/,
loader: "vue-loader",
},
],
},
plugins: [
new VueLoaderPlugin(),
// 定义两个环境变量,关闭option api 和 pro 调试的提示
new DefinePlugin({
__VUE_OPTIONS_API__: false,
__VUE_PROD_DEVTOOLS__: false,
}),
],
resolve: {
extensions: [".js", ".json", ".wasm", ".jsx", ".jsx", "vue"],
},
};
let path = require("path");
let baseConfig = require("./base.config");
let {
merge } = require("webpack-merge");
module.exports = merge(baseConfig, {
target: "web", // 构建目标环境
entry: "./src/client/index.js",
output: {
filename: "client_bundle.js",
path: path.resolve(__dirname, "../build/client"),
},
});
let path = require("path");
let nodeExternals = require("webpack-node-externals");
let baseConfig = require("./base.config");
let {
merge } = require("webpack-merge");
module.exports = merge(baseConfig, {
target: "node",
entry: "./src/server/index.js",
output: {
filename: "server_bundle.js",
path: path.resolve(__dirname, "../build/server"),
},
externals: [nodeExternals()],
});
パッケージ.json
{
"name": "01-node-server",
"version": "1.0.0",
"description": "",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1",
"build:server": "webpack --config ./config/server.config.js --watch",
"build:client": "webpack --config ./config/client.config.js --watch",
"start:server": "nodemon ./build/server/server_bundle.js"
},
"keywords": [],
"author": "",
"license": "ISC",
"dependencies": {
"axios": "^1.2.1",
"express": "^4.18.2",
"nodemon": "^2.0.20",
"pinia": "^2.0.26",
"vue": "^3.2.45",
"vue-loader": "^17.0.1",
"vue-router": "^4.1.6",
"webpack-node-externals": "^3.0.0"
},
"devDependencies": {
"@babel/preset-env": "^7.20.2",
"babel-loader": "^9.1.0",
"webpack": "^5.75.0",
"webpack-cli": "^5.0.0",
"webpack-merge": "^5.8.0"
}
}