Express ve Node.js ile PDF Oluşturma

Express ve Node.js ile PDF Oluşturma

Merhaba! Bu makalede, Express.js ve Node.js kullanarak PDF dosyaları nasıl oluşturulacağını adım adım açıklayacağım. Node.js sunucu tarafında çalışan JavaScript ortamı, Express.js ise Node.js için bir web uygulama framework’üdür. Bu güçlü ikiliyi kullanarak, web uygulamalarınızda PDF oluşturma işlevselliğini kolayca entegre edebilirsiniz. Yazılım geliştirme sürecinde, PDF oluşturma sıkça ihtiyaç duyulan bir işlemdir; özellikle raporlama, faturalandırma veya doküman oluşturma gibi durumlarda oldukça kullanışlıdır.

Gerekli Kütüphaneler

Öncelikle, PDF oluşturmak için gerekli kütüphaneleri projenize eklememiz gerekiyor. En popüler seçeneklerden biri, pdfmake kütüphanesidir. Bu kütüphane, client-side ve server-side olarak kullanılabilir, ancak biz server-side kullanımına odaklanacağız. İşte projenize nasıl ekleyeceğiniz:

npm install pdfmake pdfmake-fonts

Bu komut, pdfmake kütüphanesini ve beraberinde kullanılabilen bazı fontları projenize ekleyecektir. Başka kütüphaneler de kullanabilirsiniz fakat pdfmake oldukça popüler ve kullanımı kolaydır. Kütüphanelerin doğru kurulumundan sonra, kodumuza geçebiliriz.

Express Uygulamasında PDF Oluşturma

Şimdi, Express.js uygulamanızda PDF oluşturma işlemini nasıl entegre edeceğinize bakalım. Aşağıdaki örnekte, bir “GET” isteği aldığında bir PDF oluşturan basit bir endpoint tanımlıyoruz:

const express = require('express');
const pdfMake = require('pdfmake');
const fs = require('node:fs');
const app = express();
const port = 3000;

app.get('/pdf', (req, res) => {
  const documentDefinition = {
    content: [
      { text: 'Merhaba, PDF Oluşturma Örneği!', style: 'header' },
      { text: 'Bu bir örnek PDF dosyasıdır.', margin: [0, 20, 0, 0] },
    ],
    styles: {
      header: {
        fontSize: 18,
        bold: true,
        margin: [0, 0, 0, 20],
      },
    },
  };

  const pdfDoc = new pdfMake({
    Roboto: {normal: new Buffer.from(require('pdfmake/build/vfs_fonts.js').pdfMake.vfs['Roboto-Regular.ttf'], 'base64'),
    bold: new Buffer.from(require('pdfmake/build/vfs_fonts.js').pdfMake.vfs['Roboto-Medium.ttf'], 'base64')
    }
  }).createPdfKitDocument(documentDefinition);
  pdfDoc.pipe(fs.createWriteStream('output.pdf'));
  pdfDoc.end();
    res.download('output.pdf');

});

app.listen(port, () => {
  console.log(Sunucu ${port} portunda çalışıyor!);
});

Bu kod, basit bir PDF dosyası oluşturur ve bunu sunucudan indirebilirsiniz. Daha karmaşık PDF’ler oluşturmak için, documentDefinition nesnesini istediğiniz gibi düzenleyebilirsiniz. Örneğin, tablolar, resimler ve daha fazlasını ekleyebilirsiniz. Detaylı bilgi için pdfmake github sayfasını inceleyebilirsiniz. Ayrıca, daha gelişmiş kontrol için farklı kütüphaneleri de araştırabilirsiniz. Örneğin, veri tabanı entegrasyonuna ihtiyacınız varsa, verileri bir veritabanından okuyarak PDF’e ekleyebilirsiniz.

Hata Ayıklama ve İpuçları

PDF oluşturma sürecinde hatalarla karşılaşmanız durumunda, kodunuzu dikkatlice inceleyin. Hata mesajları size yardımcı olacaktır. Ayrıca, kütüphane dökümantasyonunu inceleyerek, kullanımını daha iyi anlayabilirsiniz. PDF oluşturma işlemi, kullandığınız verilerin yapısına ve kütüphanenin özelliklerine bağlı olarak karmaşıklaşabilir. Bu nedenle, uygulama geliştirme aşamasında karşılaşacağınız sorunları çözmek için blog sayfamı ziyaret edebilirsiniz. Herhangi bir sorunla karşılaşırsanız, sorularınızı yorumlar bölümünde sorabilirsiniz.

Umarım bu makale, Express ve Node.js ile PDF oluşturma konusunda size yardımcı olmuştur. Başarılar!

#Etiketler: Node.js, Express.js, PDF Oluşturma, pdfmake, JavaScript, Sunucu Tarafı Programlama, Web Geliştirme, PDF Kütüphanesi, PDF Döküman Oluşturma, API