fastify npm（開發者的使用方法）

Fastify 的主要功能

安裝 Fastify

npm install fastify

npm install fastify

我們將安裝 Fastify 並將其新增至package.json檔案中的 Fastify 專案包。

設定 Fastify 伺服器

// server.js -> Create Fastify instance
const fastify = require('fastify')({ logger: true });

// Define a route
fastify.get('/', async (request, reply) => {
  return { hello: 'world' };
});

// Run the server
const start = async () => {
  try {
    await fastify.listen(3000);
    fastify.log.info(`Server listening on ${fastify.server.address().port}`);
  } catch (err) {
    fastify.log.error(err);
    process.exit(1);
  }
};

start();

// server.js -> Create Fastify instance
const fastify = require('fastify')({ logger: true });

// Define a route
fastify.get('/', async (request, reply) => {
  return { hello: 'world' };
});

// Run the server
const start = async () => {
  try {
    await fastify.listen(3000);
    fastify.log.info(`Server listening on ${fastify.server.address().port}`);
  } catch (err) {
    fastify.log.error(err);
    process.exit(1);
  }
};

start();

• const fastify = require('fastify')({ logger: true }); : 匯入 Fastify 並啟用日誌記錄進行初始化。
• fastify.get('/', async (request, reply) => { ... });: Defines a GET route for the root URL (/), returning a JSON response{ hello: 'world' }。
• await fastify.listen(3000); : 在連接埠 3000 上啟動 Fastify 伺服器。
• fastify.log.info(...); : 記錄一則訊息，表示伺服器正在執行。

! fastify npm（開發者使用方法）：圖 2 - 執行在本機連接埠 3000 上託管 Fastify 伺服器的程式後的控制台輸出。

由 Postman 工具中的程式碼產生的結果。

! fastify npm（開發者如何操作）：圖 3 - 使用 Postman 工具運行在本機連接埠 3000 上託管 Fastify 伺服器的程式後的輸出。

什麼是 IronPDF？

IronPDF是一個功能強大的 Node.js PDF 庫，旨在根據 HTML 資訊建立高品質的 PDF 檔案。 在不犧牲原始網頁內容的前提下，它可以加快將 HTML、CSS 和其他 JavaScript 檔案轉換為格式正確的 PDF 的過程。 對於需要產生動態、可列印文件（如報表、發票和憑證）的 Web 應用程式來說，這是一個非常有用的工具。

IronPDF 的眾多功能中，可自訂頁面設定、頁首、頁腳，以及新增字體和圖像的功能只是其中的一部分。 它可以處理複雜的佈局和樣式，以確保每個測試 PDF 輸出都符合要求。 此外，IronPDF 還管理 HTML 中 JavaScript 的執行，從而實現精確的動態互動內容渲染。

fastify npm（開發者使用方法）：圖 4 - IronPDF for Node.js：Node.js PDF 函式庫

IronPDF 的特點

安裝 IronPDF

安裝IronPDF 包，即可取得在 Node.js 專案中處理 PDF 所需的工具。

npm install @ironsoftware/ironpdf

npm install @ironsoftware/ironpdf

設定與 IronPDF 整合的 Fastify 伺服器

以下是關於如何在Node.js應用程式中整合IronPDF和Fastify以建立PDF文件的詳細步驟：

// index.js

const fastify = require('fastify')({ logger: true });
const IronPdf = require("@ironsoftware/ironpdf");
const document = IronPdf.PdfDocument;
const config = IronPdf.IronPdfGlobalConfig;

// Set the license key for IronPDF (empty string if not using a paid license)
config.setConfig({ licenseKey: '' });

// Define a Fastify route to generate PDF
fastify.get('/generate-pdf', async (request, reply) => {
  try {
    // Generate a simple PDF document from HTML
    const pdfDocument = await document.fromHtml('<h1>Hello, IronPDF!</h1>');
    const pdfBuffer = await pdfDocument.saveAsBuffer();

    // Set response headers to serve the PDF
    reply
      .code(200)
      .header('Content-Type', 'application/pdf')
      .header('Content-Disposition', 'attachment; filename="generated.pdf"')
      .send(pdfBuffer);

    fastify.log.info('PDF generated successfully!');
  } catch (err) {
    fastify.log.error('Failed to generate PDF: ', err);
    reply.code(500).send({ error: 'Failed to generate PDF' });
  }
});

// Run the server
const start = async () => {
  try {
    await fastify.listen(3000);
    fastify.log.info(`Server listening on ${fastify.server.address().port}`);
  } catch (err) {
    fastify.log.error(err);
    process.exit(1);
  }
};

start();

// index.js

const fastify = require('fastify')({ logger: true });
const IronPdf = require("@ironsoftware/ironpdf");
const document = IronPdf.PdfDocument;
const config = IronPdf.IronPdfGlobalConfig;

// Set the license key for IronPDF (empty string if not using a paid license)
config.setConfig({ licenseKey: '' });

// Define a Fastify route to generate PDF
fastify.get('/generate-pdf', async (request, reply) => {
  try {
    // Generate a simple PDF document from HTML
    const pdfDocument = await document.fromHtml('<h1>Hello, IronPDF!</h1>');
    const pdfBuffer = await pdfDocument.saveAsBuffer();

    // Set response headers to serve the PDF
    reply
      .code(200)
      .header('Content-Type', 'application/pdf')
      .header('Content-Disposition', 'attachment; filename="generated.pdf"')
      .send(pdfBuffer);

    fastify.log.info('PDF generated successfully!');
  } catch (err) {
    fastify.log.error('Failed to generate PDF: ', err);
    reply.code(500).send({ error: 'Failed to generate PDF' });
  }
});

// Run the server
const start = async () => {
  try {
    await fastify.listen(3000);
    fastify.log.info(`Server listening on ${fastify.server.address().port}`);
  } catch (err) {
    fastify.log.error(err);
    process.exit(1);
  }
};

start();

建立 Fastify 伺服器：將 IronPDF ( const IronPdf = require('@ironsoftware/ironpdf'); ) 和 Fastify ( const fastify = require('fastify')({ logger: true }); ) 匯入到index.js中。 這樣，系統內部就透過 Fastify 準備好了，以便管理 HTTP 請求和涉及建立 PDF 的任務。

建立 PDF 產生路徑：在 Fastify 中建立一個名為/generate-pdf路由來處理 PDF 產生請求。 Specify the HTML content to be converted into a PDF ('<h1>Hello, IronPDF!</h1>') and instantiate IronPDF inside the route handler. 可以使用fromHtml()方法非同步產生 PDF，並使用saveAsBuffer()方法將其轉換為位元組，以便下載，然後透過伺服器回應發送。

fastify npm（開發者使用方法）：圖 5 - 控制台輸出

啟動 Fastify 伺服器：使用 `start()函數處理設定過程中可能出現的任何錯誤。在指定的連接埠（例如 3000）上執行 Fastify 伺服器（ fastify.listen(3000); ）。這可以確保伺服器已啟動並準備好處理傳入的請求。

! fastify npm（開發者使用方法）：圖 6 - Fastify 伺服器與 IronPDF 集成，用於將 HTML 轉換為 PDF