WeChat ミニプログラム開発チュートリアル: Node.js に基づいたミニプログラムバックエンドサーバーの構築

Node.js に基づいて WeChat アプレットバックエンドサーバーを構築するには、いくつかの主要な手順が必要です。これは、Node.js サーバーを最初からセットアップするのに役立つ簡単なチュートリアルです。 Nodejs 開発には WebStorm ソフトウェアを使用することをお勧めします。これについては、チュートリアルの後半で引き続き説明します。

準備

始める前に、開発環境が次の条件を満たしていることを確認してください。

Node.js および npm (Node.js パッケージマネージャー) がインストールされている
テキストエディターがインストールされている (Visual Studio Code など)
Postman のインストール (API インターフェイスのテスト用)

ステップ 1: プロジェクトを初期化する

プロジェクトフォルダーとして新しいディレクトリを作成し、ターミナル (またはコマンドプロンプト) でそのディレクトリに移動します。
次のコマンドを実行して、新しい Node.js プロジェクトを初期化します。

npm init -y

これにより、プロジェクトのメタデータを含む package.json ファイルが作成されます。

ステップ 2: Express をインストールする

Express は、サーバーと API を構築するための人気のある Node.js Web アプリケーションフレームワークです。 Express をインストールするには、次のコマンドを実行します。

npm install express --save

ステップ 3: サーバーファイルを作成する

プロジェクトのルートディレクトリに server.js という名前のファイルを作成します。
server.js を開き、次のコードを追加して基本的な Express サーバーをセットアップします。

const express = require('express');
const app = express();

app.use(express.json()); // 用于解析 JSON 请求体

const PORT = process.env.PORT || 3000;

app.get('/', (req, res) => {
  res.send('Hello World!');
});

app.listen(PORT, () => {
  console.log(`Server is running on port ${PORT}`);
});

ステップ 4: サーバーを実行する

ターミナルで次のコマンドを実行してサーバーを起動します。

node server.js

すべてが正常であれば、「サーバーはポート 3000 で実行されています」という出力が表示されるはずです。

ステップ 5: API ルートを作成する

プロジェクトディレクトリに routes という名前の新しいフォルダを作成します。
routes フォルダに api.js という名前のファイルを作成します。
api.js ファイルで、WeChat アプレットのバックグラウンドインターフェイスをシミュレートする簡単なルートを設定します。

const express = require('express');
const router = express.Router();

// 假设这是一个获取用户信息的接口
router.get('/userinfo', (req, res) => {
  res.json({
    id: 1,
    name: 'John Doe',
    age: 30
  });
});

module.exports = router;

このルートを server.js に導入して使用します:

const apiRoutes = require('./routes/api');

// ... 其他代码

app.use('/api', apiRoutes);

// ... 其他代码

ステップ 6: API をテストする

Postman または別の API テストツールを使用して GET リクエストを http://localhost:3000/api/userinfo に送信し、期待される JSON レスポンスを受信するかどうかを確認します。

ステップ 7: サーバーを展開する

WeChat アプレットをサーバーに接続するには、それをインターネットに展開する必要があります。 Tencent Cloud や Alibaba Cloud などのクラウドサービスプロバイダーを使用してアプリケーションを展開できます。

ステップ 8: WeChat アプレットを構成する

WeChat パブリックプラットフォームのミニプログラム管理インターフェイスで、サーバーアドレスをサーバードメイン名のホワイトリストに追加して、ミニプログラムがサーバーと正しく通信できるようにします。

これで、WeChat アプレットのバックエンドとして使用できる基本的な Node.js サーバーが完成しました。ルート、ミドルウェア、データベース接続などを引き続き追加して、サーバーの機能を拡張できます。運用環境では、セキュリティとパフォーマンスの最適化の問題に必ず対処してください。