TypeORM Kurulumu ve Proje Ayarları

TypeORM, Node.js ve TypeScript tabanlı projelerde popüler olarak kullanılan, güçlü bir ORM (Object Relational Mapping) kütüphanesidir. Özellikle büyük ölçekli uygulamalarda veri tabanı işlemlerini kolaylaştıran TypeORM, kurulumu ve proje ayarları açısından esnek çözümler sunar. Bu makalede TypeORM kurulumu adım adım açıklanacak ve temel proje ayarlarının nasıl yapılacağı örneklerle anlatılacaktır.

TypeORM Kurulumu Nasıl Yapılır?

Başarılı bir TypeORM kurulumu için öncelikle bir Node.js projesi başlatmak gereklidir. Ardından, ihtiyaçlara göre ilgili veritabanı paketleriyle birlikte TypeORM eklenir. Aşağıda PostgreSQL üzerinden örnek bir kurulum gösterilmektedir. Ancak, MySQL, MariaDB, SQLite ve MongoDB gibi farklı veritabanları da desteklenmektedir.

npm init -y
npm install typeorm reflect-metadata pg

typeorm ve reflect-metadata paketleri mutlaka kurulmalıdır. pg paketi ise PostgreSQL desteği için gereklidir. Kullanılan veritabanına bağlı olarak mysql, mariadb veya sqlite3 gibi farklı sürücüler yüklenebilir.

TypeORM Proje Ayarlarını Yapılandırma

Kurulum sonrası projenin kök dizinine bir ormconfig.json dosyası oluşturularak temel veritabanı bağlantı ayarları tanımlanır. Aşağıda modern yöntem olan data-source.ts kullanımıyla ayar örneği verilmiştir. TypeORM'un yeni sürümleriyle birlikte önerilen ayar şekli bu dosya tipidir.

import "reflect-metadata";
import { DataSource } from "typeorm";

export const AppDataSource = new DataSource({
  type: "postgres",
  host: "localhost",
  port: 5432,
  username: "postgres",
  password: "sifre",
  database: "testdb",
  synchronize: true,
  logging: false,
  entities: [__dirname + "/entity/*.{js,ts}"],
  migrations: [],
  subscribers: [],
});

Bu dosyada veritabanı bağlantı ayarları açıkça görülmektedir. synchronize özelliği geliştirme sırasında kolaylık sağlar, fakat üretim ortamında false olarak ayarlanması tavsiye edilir. entities dizisi ise ORM'nin hangi dosyaları takip edeceğini belirtir.

TypeORM ile İlk Bağlantı Testi

Tüm bağlantı ayarları yapıldıktan sonra, ORM'nin doğru çalıştığını kontrol etmek için kısa bir test kodu yazabilirsiniz:

import { AppDataSource } from "./data-source";

AppDataSource.initialize()
  .then(() => {
    console.log("Veritabanına başarıyla bağlanıldı!");
  })
  .catch((error) => console.error("Bağlantı hatası:", error));

Sonuç

TypeORM kurulumu ve proje ayarları, geliştirme sürecine profesyonellik katar ve kodunuzu sürdürülebilir hale getirir. Bu makaledeki adımları izleyerek hızlıca TypeORM ile projelerinize başlayabilir, modern Node.js ekosisteminin avantajlarından faydalanabilirsiniz. TypeORM'un gelişmiş dokümantasyonunu takip ederek, çok daha kompleks ve özelleştirilebilir projeler geliştirmek mümkündür.