푸터 콘텐츠로 바로가기
NODE.JS에서 IRONPDF 사용하기
Node.js에서 PDF 파일을 생성하는 방법

Node.js에서 PDF 파일을 생성하는 방법

이 글은 IronPDF 의 미묘한 특징들을 심층적으로 탐구하여, 초기 설치 과정부터 실제 시나리오에서의 활용까지 모든 측면을 독자들에게 안내하고자 합니다.

1. Node.js PDF 생성기는 어떻게 사용하나요?

  1. Node.js 용 PDF 생성 라이브러리인 IronPDF 설치합니다.
  2. 필요한 종속성을 가져옵니다.
  3. PdfDocument.fromHtml 함수를 사용하여 HTML을 PDF로 렌더링합니다.
  4. PdfDocument.fromUrl 메서드를 사용하여 URL에서 PDF를 생성합니다.
  5. imageToPdf 메서드를 사용하여 이미지를 PDF 파일로 변환합니다.
  6. saveAs 메서드를 사용하여 생성된 PDF 파일을 저장합니다.

2. Node.js 용 IronPDF 살펴보기

Iron Software 의 IronPDF Node.js 용으로 세심하게 제작된 강력한 PDF 라이브러리로, 개발자에게 PDF 파일을 손쉽게 생성할 수 있는 완벽한 기능을 제공합니다. IronPDF 다양한 기능을 자랑하며 문서 생성 및 보고서 작성부터 콘텐츠 렌더링에 이르기까지 폭넓은 사용 사례를 지원하여 다재다능함을 입증합니다. 이 라이브러리의 가장 두드러진 특징 중 하나는 HTML 템플릿과 이미지를 PDF 파일로 매끄럽게 변환하는 놀라운 기능으로, 다양한 콘텐츠 소스를 처리하는 데 있어 라이브러리의 적응성과 효율성을 보여줍니다.

2.1. IronPDF 설치

PDF 생성 작업을 시작하기 전에 먼저 IronPDF 설치해야 합니다. Node.js의 패키지 관리자인 npm 덕분에 과정은 간단합니다. 터미널을 열고 다음 명령어를 실행하세요.

 npm과 @ironsoftware/ironpdf

이 명령은 IronPDF 패키지를 가져와 설치하여 Node.js 프로젝트에서 사용할 수 있도록 합니다.

IronPDF 라이브러리 사용에 필요한 IronPDF 엔진을 설치하려면 콘솔에서 다음 명령을 실행하십시오.

npm install @ironsoftware/ironpdf-engine-windows-x64
npm install @ironsoftware/ironpdf-engine-windows-x64
SHELL

3. 필수 패키지 추가

IronPDF 설치한 후에는 import 문을 사용하여 프로젝트에 필요한 패키지를 포함시켜야 합니다. 이렇게 하면 IronPDF 에서 제공하는 기능에 액세스할 수 있습니다. 다음 예를 생각해 보세요.

import { PdfDocument } from "@ironsoftware/ironpdf";
import { PdfDocument } from "@ironsoftware/ironpdf";
JAVASCRIPT

이 import 문은 IronPDF로 PDF 파일을 생성하기 위한 기본 블록인 PdfDocument 클래스를 가져옵니다.

4. PDF 파일 생성

이제 프로젝트에 IronPDF 설정되었으므로 PDF 생성기 패키지를 사용하여 PDF 파일을 생성하는 기본 프로세스를 살펴보겠습니다. IronPDF 사용하여 PDF 파일을 생성하는 방법은 여러 가지가 있지만, 이 글에서는 그중 몇 가지를 살펴보겠습니다.

  1. HTML 문자열을 PDF로 변환
  2. PDF URL
  3. 이미지를 PDF로 변환

4.1. IronPDF 사용하여 HTML을 PDF 문서로 변환

IronPDF의 뛰어난 기능 중 하나는 HTML을 PDF 파일로 손쉽게 변환할 수 있다는 점입니다. 이 기능은 서버에서 생성된 동적 콘텐츠를 PDF 형식으로 표시하려는 경우에 특히 유용합니다. 다음은 간단한 예입니다.

import { PdfDocument } from "@ironsoftware/ironpdf";

(async () => {
  // Create a PDF from an HTML string
  const pdf = await PdfDocument.fromHtml(
    "<h1>Hello Developers This is an Example PDF created with IronPDF</h1>"
  );

  // Export the PDF to a file
  await pdf.saveAs("output.pdf");
})();
import { PdfDocument } from "@ironsoftware/ironpdf";

(async () => {
  // Create a PDF from an HTML string
  const pdf = await PdfDocument.fromHtml(
    "<h1>Hello Developers This is an Example PDF created with IronPDF</h1>"
  );

  // Export the PDF to a file
  await pdf.saveAs("output.pdf");
})();
JAVASCRIPT

이 코드 조각은 Node.js 라이브러리인 IronPDF 사용하여 지정된 HTML 문자열로부터 PDF 문서를 동적으로 생성합니다. PdfDocument 클래스를 IronPDF 패키지에서 가져오는 것으로 시작합니다. 후속 비동기 함수는 본 예에서 간단한 제목 요소를 사용하여 fromHtml 메서드를 사용하여 PDF 문서를 생성합니다. saveAs 메서드는 'output.pdf'라는 파일로 생성된 PDF를 내보내는 데 사용됩니다.

코드의 비동기적 특성은 async/await 문법을 사용하여 관리되며, PDF 데이터 생성 및 저장 프로세스가 비차단 방식으로 수행되도록 보장합니다. 전반적으로, 이 간결한 예시는 IronPDF Node.js 환경에서 PDF 생성 및 조작을 어떻게 간소화하는지 보여줍니다.

출력

Node.js에서 PDF 파일을 생성하는 방법, 그림 1: IronPDF 라이브러리를 사용하여 HTML 문자열에서 생성된 출력 PDF IronPDF 라이브러리를 사용하여 HTML 문자열에서 생성된 PDF 파일을 출력합니다.

4.2. IronPDF 사용하여 URL에서 PDF 파일 생성

Node.js 에서 IronPDF 사용하여 URL에서 PDF 파일을 생성하는 것은 웹 콘텐츠를 프로그래밍 방식으로 PDF 문서로 변환할 수 있는 강력한 기능입니다. 다음은 이를 구현하는 방법을 보여주는 예제 코드 조각입니다.

import { PdfDocument } from "@ironsoftware/ironpdf";

(async () => {
  // URL of the web page to convert to PDF
  const url = "https://google.com";

  // Create a PDF doc from the specified URL
  const pdf = await PdfDocument.fromUrl(url);

  // Save the PDF to a file
  await pdf.saveAs("output_from_url.pdf");
})();
import { PdfDocument } from "@ironsoftware/ironpdf";

(async () => {
  // URL of the web page to convert to PDF
  const url = "https://google.com";

  // Create a PDF doc from the specified URL
  const pdf = await PdfDocument.fromUrl(url);

  // Save the PDF to a file
  await pdf.saveAs("output_from_url.pdf");
})();
JAVASCRIPT

이 코드에서:

  1. IronPDF 패키지에서 PdfDocument 클래스가 가져옵니다.
  2. 즉시 호출되는 함수 표현식으로 감싸진 비동기 함수 내에서, 변수가 url 웹 페이지를 PDF로 변환하려는 URL로 정의됩니다.
  3. fromUrl 메서드를 사용하여 지정된 URL에서 PDF 문서를 생성합니다. IronPDF URL에서 콘텐츠를 가져와 PDF 문서로 변환합니다.
  4. 마지막으로, saveAs 메서드를 사용하여 생성된 PDF를 'output_from_url.pdf'라는 파일에 저장합니다.

이 예시는 IronPDF 사용하여 URL의 웹 콘텐츠를 PDF 파일로 변환하는 간단한 방법을 보여줍니다. 따라서 동적인 웹 콘텐츠를 PDF 형식으로 보관하거나 공유해야 하는 상황에서 IronPDF는 매우 유용한 도구입니다.

Node.js에서 PDF 파일을 생성하는 방법, 그림 2: IronPDF 라이브러리를 사용하여 URL에서 생성된 출력 PDF IronPDF 라이브러리를 사용하여 URL에서 생성된 PDF 파일을 출력합니다.

4.3. IronPDF 사용하여 이미지에서 PDF 파일 생성하기

IronPDF HTML 외에도 이미지로부터 PDF 파일을 생성하는 기능을 제공합니다. 이 기능은 이미지를 하나의 PDF 문서로 묶어야 하는 경우에 특히 유용합니다. 간단한 예를 살펴보겠습니다.

import { PdfGenerator } from "@ironsoftware/ironpdf";
import fs from "fs";

(async () => {
  // Specify the directory path
  const directoryPath = "./images";

  // Read the contents of the directory
  fs.readdir(directoryPath, (err, files) => {
    if (err) {
      console.error("Error reading directory:", err);
      return;
    }

    // Filter file names to include only .jpg and .jpeg extensions
    const jpegFiles = files.filter(
      (file) =>
        file.toLowerCase().endsWith(".jpg") || file.toLowerCase().endsWith(".jpeg")
    );

    // Construct full file paths for the filtered files
    const filePaths = jpegFiles.map((file) => `${directoryPath}/${file}`);

    // Converts the images to a PDF and save it.
    PdfGenerator.imageToPdf(filePaths).then((returnedPdf) => {
      returnedPdf.saveAs("composite.pdf");
    });

    // Also see PdfDocument.rasterizeToImageFiles() method to flatten a PDF to images or thumbnails
  });
})();
import { PdfGenerator } from "@ironsoftware/ironpdf";
import fs from "fs";

(async () => {
  // Specify the directory path
  const directoryPath = "./images";

  // Read the contents of the directory
  fs.readdir(directoryPath, (err, files) => {
    if (err) {
      console.error("Error reading directory:", err);
      return;
    }

    // Filter file names to include only .jpg and .jpeg extensions
    const jpegFiles = files.filter(
      (file) =>
        file.toLowerCase().endsWith(".jpg") || file.toLowerCase().endsWith(".jpeg")
    );

    // Construct full file paths for the filtered files
    const filePaths = jpegFiles.map((file) => `${directoryPath}/${file}`);

    // Converts the images to a PDF and save it.
    PdfGenerator.imageToPdf(filePaths).then((returnedPdf) => {
      returnedPdf.saveAs("composite.pdf");
    });

    // Also see PdfDocument.rasterizeToImageFiles() method to flatten a PDF to images or thumbnails
  });
})();
JAVASCRIPT

이 코드는 Node.js 라이브러리인 IronPDF 사용하여 지정된 디렉터리에 있는 JPEG 이미지 모음을 단일 PDF 문서로 변환합니다. 처음에 코드는 이미지가 포함된 디렉터리 경로를 지정합니다. 그 다음 fs.readdir 함수를 사용하여 디렉토리의 내용을 읽습니다. 그 후, 파일 이름을 필터링하여 확장자가 ".jpg" 또는 ".jpeg"인 파일만 포함시킵니다.

필터링된 이미지의 전체 파일 경로가 구성되고, PdfGenerator.imageToPdf 메서드를 사용하여 이러한 이미지를 PDF 문서로 변환합니다. 생성된 PDF 파일은 "composite.pdf"라는 이름으로 저장됩니다. 이 스크립트는 IronPDF 를 사용하여 여러 이미지를 하나의 PDF 파일로 통합 변환하는 간소화된 프로세스를 보여줍니다. 이를 통해 이미지 콘텐츠를 단일 문서로 구성하고 제시해야 하는 상황에 실용적인 솔루션을 제공합니다.

Node.js에서 PDF 파일을 생성하는 방법, 그림 3: IronPDF 라이브러리를 사용하여 이미지에서 생성된 출력 PDF IronPDF 라이브러리를 사용하여 이미지에서 생성된 PDF 출력

5. 결론

Node.js 와 IronPDF 결합하면 동적인 PDF 생성을 위한 무궁무진한 가능성이 열립니다. IronPDF 간단한 텍스트 기반 문서부터 동적 콘텐츠가 포함된 복잡한 보고서에 이르기까지 프로세스를 간소화하고 Node.js 애플리케이션의 기능을 향상시켜 줍니다. HTML을 PDF로 변환하든, 템플릿을 채우든, 이미지를 PDF 파일로 컴파일하든, IronPDF 다양한 PDF 생성 요구 사항을 충족하는 효율적인 솔루션을 제공합니다.

이러한 기능들을 계속 살펴보고 구현해 나가다 보면, IronPDF Node.js 라이브러리가 동 적이고 시각적으로 매력적인 PDF 문서를 생성하는 과정을 간소화해 주는 유용한 개발자 도구라는 것을 알게 될 것입니다.

Node.js 용 IronPDF 사용자에게 무료 평가판을 제공합니다. IronPDF 사용을 시작하려면 이 문서 페이지를 방문하세요. HTML을 PDF로 변환하는 코드 예제와 전체 튜토리얼은 다음 튜토리얼 페이지 에서 확인할 수 있습니다.

자주 묻는 질문

Node.js용 PDF 라이브러리를 어떻게 설치하나요?

Node.js용 IronPDF를 설치하려면 터미널에서 `npm i @ironsoftware/ironpdf` 명령을 실행하여 핵심 라이브러리를 설치하세요. 그런 다음 Windows 시스템의 경우 `npm install @ironsoftware/ironpdf-engine-windows-x64` 명령을 사용하여 필요한 엔진을 설치합니다.

Node.js용으로 설계된 PDF 라이브러리의 주요 특징은 무엇인가요?

IronPDF는 HTML 및 웹 페이지를 PDF로 변환하고, 이미지를 PDF로 컴파일하며, 다양한 애플리케이션을 위한 동적 콘텐츠 렌더링을 지원하는 등 포괄적인 PDF 생성 기능을 제공합니다.

HTML 콘텐츠를 PDF 문서로 변환하려면 어떻게 해야 하나요?

IronPDF의 PdfDocument.fromHtml 메서드를 사용하여 HTML 콘텐츠를 PDF로 변환할 수 있습니다. PdfDocument 클래스를 임포트하고, HTML 문자열에서 PDF를 생성한 다음, saveAs 메서드를 사용하여 저장하세요.

Node.js를 사용하여 웹 페이지 URL에서 PDF를 생성하는 것이 가능할까요?

네, IronPDF를 사용하면 PdfDocument.fromUrl 메서드를 통해 웹 페이지 URL에서 PDF를 생성할 수 있습니다. 변환하려는 웹 페이지의 URL을 제공한 다음 saveAs 메서드를 사용하여 PDF를 저장하세요.

여러 이미지를 하나의 PDF 파일로 합칠 수 있나요?

IronPDF는 PdfGenerator.imageToPdf 메서드를 사용하여 여러 이미지를 하나의 PDF 파일로 병합할 수 있도록 지원합니다. 변환할 이미지 경로를 지정하고 saveAs 메서드를 사용하여 결과를 PDF 파일로 저장하세요.

Node.js PDF 라이브러리를 프로젝트에서 사용하는 과정은 무엇인가요?

이 과정에는 IronPDF를 설치하고, PdfDocument 와 같은 필요한 클래스를 가져오고, fromHtml 또는 fromUrl 과 같은 메서드를 사용하여 PDF를 생성하고, saveAs 메서드를 사용하여 파일을 저장하는 단계가 포함됩니다.

Node.js에서 비동기 PDF 작업을 어떻게 처리할 수 있나요?

IronPDF는 async/await 구문을 사용하여 비동기 작업을 지원하므로 실행 흐름을 차단하지 않고 PDF 생성 및 저장과 같은 작업을 수행할 수 있습니다.

Node.js용 PDF 라이브러리 사용에 대한 추가 자료는 어디에서 찾을 수 있나요?

더 많은 자료, 튜토리얼 및 예제를 보려면 IronPDF 웹사이트를 방문하세요. 해당 웹사이트는 HTML을 PDF로 변환하는 데 초점을 맞춘 광범위한 문서와 튜토리얼 페이지를 제공합니다.

PDF 라이브러리의 기능을 살펴볼 수 있는 무료 체험판이 있나요?

네, IronPDF는 무료 평가판을 제공하여 사용자가 기능을 살펴볼 수 있도록 합니다. 자세한 내용 및 평가판 시작 방법은 문서 페이지를 참조하세요.

Node.js 애플리케이션에서 PDF 라이브러리를 사용하면 어떤 이점이 있나요?

Node.js 애플리케이션에서 IronPDF를 사용하면 다양한 콘텐츠 유형에서 PDF를 생성할 수 있고, 동적 콘텐츠를 지원하며, JavaScript 라이브러리와 쉽게 통합할 수 있어 문서 처리 기능이 향상됩니다.

다리우스 세란트
풀스택 소프트웨어 엔지니어 (웹 운영)

다리우스 세런트는 마이애미 대학교에서 컴퓨터 과학 학사 학위를 받았으며, Iron Software에서 풀 스택 웹 운영 마케팅 엔지니어로 근무하고 있습니다. 어린 시절부터 코딩에 매료되었던 그는 컴퓨팅이 신비로우면서도 접근하기 쉬운 분야라고 생각했고, 창의력과 문제 해결 능력을 발휘하기에 완벽한 매체라고 여겼습니다.

Iron Software에서 다리우스는 새로운 것을 만들고 복잡한 개념을 단순화하여 더 쉽게 이해할 수 있도록 하는 것을 즐깁니다. 그는 사내 개발자로서 학생들을 가르치는 데에도 자원하여 차세대 인재들과 전문 지식을 공유하고 있습니다.

다리우스에게 있어 그의 일은 가치 있고 실질적인 영향을 미치기 때문에 보람 있는 일입니다.

아이언 서포트 팀

저희는 주 5일, 24시간 온라인으로 운영합니다.
채팅
이메일
전화해