使用 Node.js 建立自訂後端：逐步指南-js教程-PHP中文網

Building a Custom Backend with Node.js: A Step-by-Step Guide

在 Node.js 中建立自訂後端涉及多個步驟，從設定 Node.js 環境到建置和部署 API。以下是使用 Node.js 建立自訂後端的詳細逐步指南：

第 1 步：設定您的開發環境

開始編碼之前，您需要在電腦上安裝以下軟體：

Node.js：在伺服器端執行 JavaScript 的執行階段。您可以從nodejs.org下載它。
NPM（節點套件管理器）：它與 Node.js 捆綁在一起。您將使用它來安裝和管理庫。

要檢查 Node.js 和 NPM 是否已安裝，請執行：

node -v
npm -v

登入後複製

如果安裝了它們，您將看到它們的版本號。如果沒有，請安裝 Node.js。

步驟2：建立一個新項目

建立專案資料夾：

mkdir my-custom-backend
cd my-custom-backend

登入後複製

初始化package.json檔案：

npm init -y

登入後複製

此命令建立一個基本的 package.json 文件，它將管理您的依賴項。

第 3 步：安裝所需的軟體包

您需要安裝一些軟體包來建立後端。

Express：一個最小且靈活的 Node.js Web 應用程式框架，為建立 Web 和行動應用程式提供了一組強大的功能。
Nodemon：一種幫助開發 Node.js 應用程式的工具，當偵測到目錄中的檔案變更時自動重新啟動伺服器。
Body-parser：處理 JSON 和 URL 編碼表單資料的中間件。
dotenv：管理環境變數。

透過運行安裝這些依賴項：

npm install express body-parser dotenv
npm install --save-dev nodemon

登入後複製

express：處理 HTTP 請求的核心框架。
body-parser：用於在處理程序之前解析中間件中傳入請求的中間件，可透過 req.body 存取。
dotenv：將環境變數從 .env 檔案載入到 process.env。
nodemon：程式碼變更時會自動重新啟動伺服器（用於開發目的）。

第 4 步：建立伺服器文件

在專案根目錄中，建立一個名為 server.js 的檔案。該檔案將處理 Express 伺服器的設定。

touch server.js

登入後複製

在server.js中，加入以下程式碼：

// Import necessary modules
const express = require('express');
const bodyParser = require('body-parser');
const dotenv = require('dotenv');

// Load environment variables
dotenv.config();

// Initialize the app
const app = express();

// Middleware to parse JSON data
app.use(bodyParser.json());

// Define a basic route
app.get('/', (req, res) => {
  res.send('Welcome to my custom Node.js backend!');
});

// Start the server
const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`Server running on http://localhost:${PORT}`);
});

登入後複製

此檔案設定一個 Express 伺服器，用於偵聽請求並以簡單的訊息回應。

第 5 步：運行伺服器

要運行您的伺服器，您可以使用節點命令：

node -v
npm -v

登入後複製

但是，對於開發來說，最好使用nodemon在更改時自動重新啟動伺服器：

mkdir my-custom-backend
cd my-custom-backend

登入後複製

現在，在瀏覽器中造訪 http://localhost:3000。您應該看到：

npm init -y

登入後複製

第 6 步：定義路由和處理程序

接下來，您需要為後端添加一些自訂路由。例如，您可以建立一個處理使用者資訊的 API：

npm install express body-parser dotenv
npm install --save-dev nodemon

登入後複製

GET /users：取得所有使用者。
GET /users/:id：透過 ID 取得使用者。
POST /users：新增使用者。
DELETE /users/:id：透過 ID 刪除使用者。

步驟7：使用環境變數

您可以使用 dotenv 套件來配置環境變數。在根目錄建立.env檔：

touch server.js

登入後複製

在 .env 中，您可以定義以下變數：

// Import necessary modules
const express = require('express');
const bodyParser = require('body-parser');
const dotenv = require('dotenv');

// Load environment variables
dotenv.config();

// Initialize the app
const app = express();

// Middleware to parse JSON data
app.use(bodyParser.json());

// Define a basic route
app.get('/', (req, res) => {
  res.send('Welcome to my custom Node.js backend!');
});

// Start the server
const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`Server running on http://localhost:${PORT}`);
});

登入後複製

此變數將在您的 server.js 中用於動態設定連接埠：

node server.js

登入後複製

第 8 步：新增錯誤處理和中介軟體

Express 中的中間件是一個可以存取請求物件 (req)、回應物件 (res) 以及應用程式請求-回應週期中的下一個中介軟體函數的函數。

您可以建立自訂中間件來處理錯誤：

npx nodemon server.js

登入後複製

這會捕獲應用程式中任何未處理的錯誤，並以 500 狀態程式碼回應。

第 9 步：建立您的專案（可選）

隨著應用程式的成長，正確組織它是一個好主意：

Welcome to my custom Node.js backend!

登入後複製

controllers/：處理 API 路由的邏輯。
routes/：定義端點並將它們連接到控制器。
models/：處理資料結構，未來可能使用資料庫。

第 10 步：連接到資料庫（可選）

如果你想持久化數據，你可以將你的後端連接到資料庫。例如：

MongoDB：使用 mongoose 與 MongoDB 資料庫互動。
MySQL/PostgreSQL：使用sequelize或pg與SQL資料庫互動。

對於 MongoDB，安裝 mongoose：

// Example user data
let users = [
  { id: 1, name: 'John Doe' },
  { id: 2, name: 'Jane Doe' }
];

// Route to get all users
app.get('/users', (req, res) => {
  res.json(users);
});

// Route to get a user by ID
app.get('/users/:id', (req, res) => {
  const userId = parseInt(req.params.id);
  const user = users.find((u) => u.id === userId);

  if (user) {
    res.json(user);
  } else {
    res.status(404).send('User not found');
  }
});

// Route to create a new user
app.post('/users', (req, res) => {
  const newUser = {
    id: users.length + 1,
    name: req.body.name
  };
  users.push(newUser);
  res.status(201).json(newUser);
});

// Route to delete a user by ID
app.delete('/users/:id', (req, res) => {
  const userId = parseInt(req.params.id);
  users = users.filter((u) => u.id !== userId);
  res.status(204).send();
});

登入後複製

在 server.js 中：