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

Barbara Streisand
풀어 주다: 2024-10-18 22:43:02
원래의
740명이 탐색했습니다.

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

  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 중국어 웹사이트의 기타 관련 기사를 참조하세요!

원천:dev.to
본 웹사이트의 성명
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.
저자별 최신 기사
인기 튜토리얼
더>
최신 다운로드
더>
웹 효과
웹사이트 소스 코드
웹사이트 자료
프론트엔드 템플릿
회사 소개 부인 성명 Sitemap
PHP 중국어 웹사이트:공공복지 온라인 PHP 교육,PHP 학습자의 빠른 성장을 도와주세요!