E-Ticaret & PrestaShop 19 Kasım 2026 · 11 dk okuma

PrestaShop 8 ve 9 Mimarisi: Symfony CQRS, Güvenli Modül Geliştirme, Yüksek Trafik ve Sıfır Kesintili ERP Senkronizasyonu

Legacy override alışkanlıklarını geride bırakarak PrestaShop 8/9 üzerinde Symfony CQRS, servis dekorasyonu, InnoDB stok kilitleme, Outbox desenli ERP entegrasyonu ve üretim güvenlik sertleştirmesi üzerine derinlemesine teknik rehber.

PrestaShop 8 ve 9 Mimarisi: Symfony CQRS, Güvenli Modül Geliştirme, Yüksek Trafik ve Sıfır Kesintili ERP Senkronizasyonu

Yüksek trafikli ve çok kanallı e-ticaret operasyonlarında PrestaShop’u yalnızca “kurulum + hazır tema + birkaç eklenti” olarak görmek, büyüme aşamasında ciddi teknik borç ve kesintiler üretir. PrestaShop 8.x ve 9.x serisiyle birlikte çekirdek mimari, klasik ObjectModel yapısından modern Symfony, Doctrine DBAL/ORM ve CQRS (Command Query Responsibility Segregation) tabanlı bir yazılım platformuna evrilmiştir.

Bu yazıda gerçek üretim ortamlarında karşılaşılan darboğazları, sürdürülebilir modül mühendisliğini, yarış durumlarını (race condition) önleyen stok mimarisini ve sıfır kayıplı ERP senkronizasyon desenlerini kod düzeyinde ele alıyoruz.

1. Legacy override/ Tuzaklarından Symfony CQRS ve Servis Dekorasyonuna Geçiş

Eski PrestaShop ekosisteminde çekirdek davranışı değiştirmek için refleks haline gelmiş override/classes/ kullanımı, bugün modern projelerde en büyük bakım riskidir. İki farklı modül aynı sınıf metodunu ezdiğinde sessiz çakışmalar oluşur, class_index.php önbelleği kırılganlaşır ve minör güvenlik güncellemeleri bile saatlerce süren regresyon testlerine dönüşür.

PrestaShop 8 ve 9’da doğru yaklaşım; iş kurallarını CQRS Command/Query Handler katmanına ve Symfony Service Decoration mekanizmasına taşımaktır:

# modules/tt_erp_bridge/config/services.yml
services:
  _defaults:
    autowire: true
    autoconfigure: true
    public: false

  TayfunTaskin\ErpBridge\Domain\Stock\AtomicStockAllocator:
    arguments:
      $connection: '@doctrine.dbal.default_connection'
      $tablePrefix: '%database_prefix%'

  # Çekirdek sınıfı override etmeden servisi dekore etmek
  TayfunTaskin\ErpBridge\Decorator\OrderStatusNotifierDecorator:
    decorates: 'prestashop.core.domain.order.command_handler.update_order_status_handler'
    arguments:
      $inner: '@.inner'
      $outbox: '@TayfunTaskin\ErpBridge\Infrastructure\OutboxRepository'

Bu desen sayesinde çekirdek sınıflara tek satır dokunmadan, sürüm yükseltmelerinde kırılmayan ve birim test (PHPUnit) yazılabilir temiz bir domain katmanı elde edersiniz.

2. İleri Seviye Modül Mimarisi: PSR-4, Hook İzolasyonu ve N+1 Önleme

Performans sorunlarının büyük bölümü PrestaShop çekirdeğinden değil, ürün listeleme veya sepet kancalarında (hookDisplayProductPriceBlock, hookActionCartSave) her ürün için ayrı SQL sorgusu atan modüllerden kaynaklanır.

  • İstek Bazlı Memoization: Kategori sayfasında 36 ürün listelenirken her kart için Db::getInstance()->getRow() çağırmak yerine, ürün ID listesini tek bir WHERE id_product IN (...) sorgusuyla çekip istek ömrü boyunca bellek içi haritada (identity map) tutun.
  • Çoklu Mağaza (Multistore) Farkındalığı: Sorgularınızda yalnızca ps_product değil, ps_product_shop ve id_shop bağlamını daima açıkça bağlayın. Aksi halde B2B/B2C çoklu mağazalarda fiyat ve stok sızıntısı yaşanır.
  • Kesin Tipli PHP 8.2/8.3 Kod Tabanı: Modül sınıflarınızda declare(strict_types=1);, readonly DTO’lar ve Doctrine parametreli sorgular kullanarak hem statik analiz (PHPStan seviye 7+) hem de SQL enjeksiyon güvenliğini standart hale getirin.

3. Kampanya Anlarında Yarış Durumları ve Atomik Stok Kilitleme

Büyük indirim kampanyalarında aynı anda 100 kullanıcının son 1 adet ürünü sepete ekleyip ödeme adımına geçmesi, klasik “önce oku, sonra güncelle” (read-modify-write) yaklaşımında negatif stok ve iptal krizine yol açar.

<?php
declare(strict_types=1);

namespace TayfunTaskin\ErpBridge\Domain\Stock;

use Doctrine\DBAL\Connection;

final readonly class AtomicStockAllocator
{
    public function __construct(
        private Connection $connection,
        private string $tablePrefix,
    ) {}

    public function reserve(int $productId, int $attributeId, int $shopId, int $qty): bool
    {
        $table = $this->tablePrefix . 'stock_available';

        // Tek atomik UPDATE: yarış durumunu InnoDB satır kilidi ile veritabanı seviyesinde engeller
        $affected = $this->connection->executeStatement(
            "UPDATE {$table}
             SET quantity = quantity - :qty
             WHERE id_product = :pid
               AND id_product_attribute = :aid
               AND id_shop = :sid
               AND quantity >= :qtyCheck",
            [
                'qty'      => $qty,
                'pid'      => $productId,
                'aid'      => $attributeId,
                'sid'      => $shopId,
                'qtyCheck' => $qty,
            ]
        );

        return $affected === 1;
    }
}

Bu yöntemle uygulama tarafında ekstra dağıtık kilit (Redis lock) karmaşıklığına girmeden, InnoDB satır düzeyi atomik garantisiyle aşırı satışı (overselling) sıfıra indirebilirsiniz.

4. Yüksek Trafik İçin Veritabanı ve Çok Katmanlı Önbellek Mühendisliği

50.000+ SKU ve yoğun eşzamanlı oturum barındıran PrestaShop kurulumlarında şu dört teknik müdahale yanıt sürelerini saniyelerden milisaniyelere çeker:

Katman Yaygın Darboğaz İleri Seviye Çözüm
InnoDB & Şema ps_connections, ps_guest ve ps_cart tablolarının milyonlarca satıra şişmesi Periyodik arşivleme/temizlik işi + (id_shop, active, date_upd) bileşik indeksleri
PHP OPcache Her istekte binlerce Symfony/Smarty dosyasının stat() kontrolü opcache.validate_timestamps=0, opcache.memory_consumption=256, atomic deploy sonrası OPcache reset
Oturum & Uygulama Disk tabanlı PHP session kilitlenmesi (AJAX isteklerinin sıraya girmesi) Redis session handler + Symfony Cache Pool için ayrı Redis DB indeksi
HTTP Kenar Katmanı Kategori ve ürün sayfalarının her ziyaretçide PHP ile yeniden üretilmesi Nginx FastCGI / Varnish tam sayfa önbelleği + sepet/kullanıcı bloğunun hafif AJAX/ESI ile ayrıştırılması

5. Sıfır Kesintili ERP & Pazaryeri Entegrasyonu: Transactional Outbox + Idempotency

E-ticaret projelerinde yapılan en pahalı mimari hata, hookActionValidateOrder içinde harici ERP, e-Fatura veya kargo API’sine senkron HTTP çağrısı yapmaktır. Karşı sunucu 8 saniye yavaşladığında müşterinin ödeme ekranı zaman aşımına uğrar; karttan para çekilir ama sipariş kaydı yarım kalır.

Ödeme akışı hiçbir harici üçüncü parti API’nin ayakta kalma süresine (uptime) bağımlı olmamalıdır.

Üretim standardı çözüm Transactional Outbox + İdempotent Worker desenidir:

  1. Aynı Veritabanı İşleminde Kayıt: Sipariş onaylandığında harici API çağrılmaz; yalnızca ps_tt_sync_outbox tablosuna benzersiz bir idempotency_key (ör. order:{id}:v1) ve JSON yükü eklenir (<2 ms).
  2. Asenkron Kuyruk İşleyici: Symfony Messenger veya sistemd/cron işçisi bekleyen kayıtları SKIP LOCKED ile çekip ERP’ye iletir.
  3. Üstel Geri Çekilme (Exponential Backoff) & DLQ: ERP bakım modundaysa görev 1 dk, 5 dk, 15 dk aralıklarla yeniden denenir; kalıcı hatalar yönetici panelindeki Dead-Letter Queue ekranına düşer ve tek tıkla tekrar tetiklenebilir.
  4. İdempotency Garantisi: Ağ kopması nedeniyle aynı istek iki kez gönderilse bile ERP tarafı X-Idempotency-Key başlığı sayesinde mükerrer fatura veya çift stok düşümü üretmez.

6. PrestaShop Üretim Güvenlik Sertleştirme Kontrol Listesi

  • Yönetim Dizinini Gizleme & IP/2FA Koruması: Özel admin dizinine ek olarak yönetici girişinde TOTP 2FA ve hız sınırlama (rate-limit) zorunlu kılınmalıdır.
  • Dizin Erişim Kısıtları: /var/, /config/, /vendor/, /src/ ve .env/.yml dosyalarına web sunucusu seviyesinde kesin 403 uygulanmalıdır.
  • Parametreli Sorgular: Eski modüllerde görülen string birleştirmeli SQL yerine daima Doctrine DBAL prepared statement veya zorunlu legacy çağrılarda (int) / pSQL() + Validate::is*() doğrulaması kullanılmalıdır.
  • Webservice API Kapsamı: Her entegrasyon (ERP, kargo, mobil uygulama) için ayrı API anahtarı oluşturulmalı; yalnızca gerekli kaynaklara (ör. sadece orders GET/PUT) en az yetki ilkesiyle izin verilmelidir.
  • CSP & Tedarik Zinciri Denetimi: Ödeme ve yönetici sayfalarında Content-Security-Policy nonce kullanımı ve composer audit ile düzenli bağımlılık taraması yapılmalıdır.

7. Sıfır Kesintili (Zero-Downtime) Yayın Disiplini

Canlı mağazada FTP üzerinden tek tek dosya ezmek, ziyaretçi tam ödeme yaparken yarım yüklenmiş bir PHP sınıfının 500 Fatal Error vermesine neden olur. Bunun yerine releases/20261119_01 gibi sürüm klasörlerinde derleme, bağımlılık kurulumu ve Symfony cache ısıtma tamamlandıktan sonra current sembolik bağlantısı atomik olarak yeni sürüme çevrilmeli ve PHP-FPM OPcache temizlenmelidir.


Özetle: PrestaShop 8 ve 9, doğru mimari disiplinle kurgulandığında hem kurumsal ölçekte yüksek dönüşüm sağlayan hem de yıllarca güvenle büyütülebilen son derece güçlü bir e-ticaret çekirdeğidir. Mevcut mağazanızda performans darboğazları, özel modül ihtiyacı veya hatasız ERP/Shopier/kargo entegrasyonu planlıyorsanız iletişim bölümünden projenizin kapsamını paylaşabilirsiniz.

← Tüm Yazılara Dön Bu Konuda İletişime Geç ↗

İlgili Yazılar