Sayfa yükleniyor

Destek Müşteri Girişi Sepet (0)

Ders 84 – PDO transaction

PDO ile veritabanı transaction kullanımı, birden fazla sorguyu atomik hâle getirir, hatalarda rollBack ile veri bütünlüğünü korur. Bu ders, temel kavramları, adım adım uygulamayı ve sık yapılan hataları anlatıyor.

Ders 84 – PDO transaction

Veritabanı işlemlerinde birden fazla sorgunun bir bütün olarak başarıyla tamamlanması ya da hiç birinin uygulanmaması gerektiği durumlar sıkça karşımıza çıkar. Özellikle finansal uygulamalar, stok yönetimi ve kritik iş akışlarında tutarlılık, sistemin güvenilirliği açısından hayati öneme sahiptir. PHP'nin PDO (PHP Data Objects) uzantısı, bu tür senaryoları güvenli ve etkili bir şekilde yönetebilmek için transaction (işlem) mekanizmasını sunar. Bu makalede, transaction kavramını derinlemesine inceleyecek, beginTransaction, commit ve rollBack metodlarını adım adım nasıl kullanacağınızı gösterecek ve yaygın hatalardan kaçınmanız için ipuçları paylaşacağız.

Temeller

Transaction, bir dizi SQL komutunun atomik bir birim olarak ele alınması anlamına gelir. Yani, bu komutların tamamı başarılı bir şekilde çalışırsa commit ile kalıcı hâle getirilir; aksi takdirde rollBack ile baştan iptal edilir. PDO, bu süreci yönetmek için üç temel metot sağlar:

  • beginTransaction() – Transaction başlatır.
  • commit() – Başarılı bir işlem sonunda değişiklikleri kalıcı hâle getirir.
  • rollBack() – Bir hata oluştuğunda yapılan tüm değişiklikleri geri alır.

Transaction kullanmanın iki ana avantajı vardır:

  1. Veri bütünlüğü: Birden fazla tabloyu etkileyen bir işlemde, sadece bir kısmının başarılı olması durumunda oluşabilecek tutarsızlıkları önler.
  2. Performans: Aynı anda birden fazla sorgu gönderildiğinde, veritabanı motoru kilitleri daha verimli yönetir; ancak uzun süren transaction'lar kilitleri tutarak diğer oturumları bekletebilir. Bu yüzden transaction süresini mümkün olduğunca kısa tutmak kritik bir pratiktir.

Adım adım Transaction Kullanımı

Aşağıda, PDO ile transaction yönetiminin tipik bir akışı yer alıyor. Bu adımları izleyerek, hata yönetimini ve kaynak temizliğini de kapsayan sağlam bir yapı oluşturabilirsiniz.

  1. PDO nesnesi oluşturun ve hata modunu ERRMODE_EXCEPTION olarak ayarlayın. Böylece SQL hataları bir PDOException olarak fırlatılır ve try/catch bloğu içinde yakalanabilir.
  2. beginTransaction() ile transaction'ı başlatın.
  3. İşlem adımlarını prepare ve execute ile güvenli bir şekilde çalıştırın. Kullanıcı girdilerini daima bindParam ya da bindValue ile bağlayarak SQL enjeksiyonuna karşı koruma sağlayın.
  4. Eğer tüm adımlar sorunsuz tamamlandıysa commit() çağırın.
  5. Herhangi bir adımda PDOException yakalanırsa rollBack() ile değişiklikleri geri alın ve hatayı loglayın.
  6. İşlem sonunda finally bloğunda bağlantıyı kapatın (opsiyonel, PHP script sonlandığında otomatik kapanır).

Bu akış, kodun okunabilirliğini artırırken aynı zamanda hataların merkezi bir noktada ele alınmasını sağlar.

Örnek Kod

Aşağıdaki örnek, bir kullanıcının hesabından para çekip başka bir hesaba transfer etme senaryosunu transaction içinde nasıl güvenli bir şekilde gerçekleştirebileceğinizi gösterir. İki ayrı UPDATE sorgusu bir bütün olarak ele alınır; birinde hata oluşursa hiçbir değişiklik veritabanına yansıtılmaz.

<?php
$dsn = 'mysql:host=localhost;dbname=bankadb;charset=utf8';
$user = 'dbuser';
$pass = 'dbpass';

try {
    $pdo = new PDO($dsn, $user, $pass, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
    $pdo->beginTransaction();

    // Gönderen hesabı güncelle
    $stmt1 = $pdo->prepare('UPDATE accounts SET balance = balance - :amount WHERE id = :from_id');
    $stmt1->execute([':amount' => 1500, ':from_id' => 12]);

    // Alıcı hesabı güncelle
    $stmt2 = $pdo->prepare('UPDATE accounts SET balance = balance + :amount WHERE id = :to_id');
    $stmt2->execute([':amount' => 1500, ':to_id' => 45]);

    // Her iki sorgu da başarılıysa commit
    $pdo->commit();
    echo "Transfer başarılı.";
} catch (PDOException $e) {
    // Hata durumunda tüm değişiklikleri geri al
    if ($pdo->inTransaction()) {
        $pdo->rollBack();
    }
    error_log('Transfer hatası: ' . $e->getMessage());
    echo "Transfer gerçekleştirilemedi. Lütfen tekrar deneyin.";
}
?>

Bu kod parçası, transaction yönetiminin temel adımlarını net bir şekilde ortaya koyar. inTransaction() kontrolü, catch bloğunda rollBack çağrısının güvenli bir şekilde yapılmasını sağlar; aksi takdirde bir rollBack hatası yeni bir istisna fırlatabilir.

Sık Karşılaşılan Hatalar

Transaction kullanırken yeni başlayanların sıkça yaptığı hatalar aşağıdaki gibidir:

  • Transaction süresini gereksiz yere uzatmak: Uzun süren bir transaction, veritabanı kilitlerini tutar ve diğer oturumların beklemesine neden olur. Özellikle büyük SELECT sorgularını transaction içinde çalıştırmak performans sorunlarına yol açar.
  • Hata yakalanmadığında commit çağırmak: try/catch bloğu içinde commit sadece tüm adımlar başarılı olduğunda çalıştırılmalıdır. Aksi takdirde hatalı veriler kalıcı hâle gelir.
  • Otomatik commit modunu kapatmayı unutmak: PDO, beginTransaction() çağrılmadığında her sorguyu ayrı bir transaction olarak işler. Bu, birden fazla sorgunun atomik hâle gelmesini engeller.
  • Rollback sonrası tekrar commit denemek: rollBack() sonrası aynı transaction içinde commit çağrısı bir PDOException üretir. Yeni bir transaction başlatmadan önce beginTransaction() ile yeniden başlamak gerekir.
  • Bağlantı kaybı: Ağ kesintileri ya da veritabanı yeniden başlatmaları sırasında açık bir transaction kalırsa, veritabanı otomatik olarak rollback yapar. Bu durumları loglamak ve kullanıcıya anlamlı bir mesaj göstermek önemlidir.

Aşağıdaki ikinci örnek, bir INSERT ve SELECT işlemini aynı transaction içinde gerçekleştirirken, SELECT sonucuna göre karar verip UPDATE yapmayı gösterir. Böyle bir senaryoda SELECT için FOR UPDATE kilidi kullanmak, aynı anda başka bir oturumun aynı satırı değiştirmesini engeller.

<?php
try {
    $pdo->beginTransaction();

    // Yeni bir sipariş ekle
    $stmtInsert = $pdo->prepare('INSERT INTO orders (user_id, total) VALUES (:uid, :total)');
    $stmtInsert->execute([':uid' => 7, ':total' => 299.99]);
    $orderId = $pdo->lastInsertId();

    // Sipariş detaylarını al (kilitli okuma)
    $stmtSelect = $pdo->prepare('SELECT * FROM orders WHERE id = :oid FOR UPDATE');
    $stmtSelect->execute([':oid' => $orderId]);
    $order = $stmtSelect->fetch(PDO::FETCH_ASSOC);

    if ($order['total'] > 200) {
        // Büyük siparişlerde indirim uygula
        $stmtUpdate = $pdo->prepare('UPDATE orders SET discount = 20 WHERE id = :oid');
        $stmtUpdate->execute([':oid' => $orderId]);
    }

    $pdo->commit();
    echo "Sipariş kaydedildi ve gerekli güncellemeler yapıldı.";
} catch (Exception $e) {
    if ($pdo->inTransaction()) {
        $pdo->rollBack();
    }
    error_log('Sipariş hatası: ' . $e->getMessage());
    echo "Sipariş kaydedilemedi.";
}
?>

Sık Sorulan Sorular

Transaction içinde SELECT kullanabilir miyim?

Evet, SELECT sorguları da transaction içinde çalıştırılabilir. Ancak, veritabanı kilitleri açısından dikkatli olunmalıdır. Okuma sırasında veri değişmemesini garanti altına almak istiyorsanız FOR UPDATE ya da LOCK IN SHARE MODE gibi ifadeler ekleyerek satır kilidi alabilirsiniz.

Transaction süresi ne kadar olmalı?

Idealde, transaction sadece gerekli SQL komutlarını içermeli ve olabildiğince kısa tutulmalıdır. İş mantığını PHP tarafında (örneğin, veri işleme, hesaplama) transaction dışına alarak, veritabanı kilitlerinin sadece veri değişikliği anında aktif olmasını sağlayabilirsiniz.

PDO'da otomatik commit nasıl devre dışı bırakılır?

PDO, beginTransaction() çağrıldığında otomatik commit'i devre dışı bırakır. Yani, beginTransaction() öncesinde setAttribute(PDO::ATTR_AUTOCOMMIT, false) gibi bir ayar yapmanıza gerek yoktur; sadece beginTransaction() metodunu kullanmanız yeterlidir.

Özet

Bu derste, PDO ile transaction yönetiminin temellerini, adım adım uygulama sürecini ve gerçek dünyada karşılaşabileceğiniz yaygın hataları ele aldık. Transaction kullanmanın en kritik iki faydası veri bütünlüğünü sağlamak ve hatalı durumlarda geri dönüş imkanı sunmaktır. Ancak, transaction süresini kısa tutmak, doğru hata yakalama mekanizmalarını kurmak ve kilit yönetimine dikkat etmek, performans kayıplarını önlemek açısından vazgeçilmezdir.

  • Transaction başlatmadan önce PDO::ATTR_ERRMODE ayarını ERRMODE_EXCEPTION yapın.
  • Her işlem adımını prepare/execute ile güvenli hâle getirin.
  • Hata durumunda rollBack() çağırın ve inTransaction() ile kontrol edin.
  • Transaction süresini minimumda tutun; sadece veri değişikliği yapan sorguları içinde bulundurun.
  • Üretim ortamında hata mesajlarını doğrudan kullanıcıya göstermeyin, loglayın.

Bu prensipleri uyguladığınızda, PHP ve PDO ile geliştirdiğiniz uygulamalar veri tutarlılığı açısından daha sağlam ve güvenilir olacaktır. Bir sonraki derste, PDO ile prepared statement'ların performans optimizasyonlarını ve dinamik sorgu oluşturma tekniklerini inceleyeceğiz.

Paylaş

Yorumlar

Henüz onaylanmış yorum yok. İlk yorumu siz yazın.

Yorum yaz

Yorumunuz yönetici onayından sonra yayınlanır.

İlgili yazılar

Ders 100 – İleri yol haritası

PHP serisinin son dersinde ileri seviye konular, framework seçimi, Composer ekosistemi, mikro pro…

Ders 99 – Güvenli yapılandırma kontrol listesi

Üretim ortamı için PHP yapılandırma ayarlarını adım adım kontrol eden, hatasız ve güvenli bir yap…

Ders 98 – OpCache ve performans ipuçları

OpCache'ın çalışma prensibi, yapılandırma adımları ve gerçek dünyada performans artırmak için pra…

Ders 97 – Fibers’a kısa bakış (PHP 8.1)

PHP 8.1 ile gelen Fibers özelliğini adım adım öğrenin, kooperatif concurrency kavramını kavrayın …

Demo
Büyütülmüş Görsel