Node.js로 사용자 정의 백엔드 구축: 단계별 가이드

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단계: 새 프로젝트 만들기

1. 프로젝트 폴더 만들기:

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

1. package.json 파일 초기화:

npm init -y

이 명령은 종속성을 관리하는 기본 package.json 파일을 생성합니다.

3단계: 필수 패키지 설치

백엔드를 구축하려면 일부 패키지를 설치해야 합니다.

• Express: 웹 및 모바일 애플리케이션 구축을 위한 강력한 기능 세트를 제공하는 최소한의 유연한 Node.js 웹 애플리케이션 프레임워크입니다.
• 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 명령을 사용할 수 있습니다.

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에서:

touch .env

11단계: Postman 또는 Curl을 사용하여 API 테스트

API를 테스트하려면 Postman 또는 컬을 사용할 수 있습니다.

PORT=3000

또는 요청하고 응답을 볼 수 있는 GUI를 제공하는 Postman을 설치할 수도 있습니다.

12단계: 백엔드 배포

백엔드가 준비되면 다음과 같은 클라우드 플랫폼을 사용하여 배포할 수 있습니다.

• Heroku: 빠른 배포를 위해.
• AWS EC2: 서버에 대한 제어를 강화합니다.
• DigitalOcean: 간단한 클라우드 호스팅용.

배포의 경우 PORT가 동적인지, API 키와 같은 민감한 정보가 환경 변수에 저장되어 있는지 확인하세요.

결론

이러한 단계를 따르면 이제 Node.js를 사용하여 기본 사용자 정의 백엔드를 구축하게 되었습니다. 인증을 추가하고, 데이터베이스에 연결하고, WebSocket을 통한 실시간 통신과 같은 고급 기능을 처리하여 이를 계속 확장할 수 있습니다.

위 내용은 Node.js로 사용자 정의 백엔드 구축: 단계별 가이드의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!