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.
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 birWHERE 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_productdeğil,ps_product_shopveid_shopbağ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);,readonlyDTO’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:
- Aynı Veritabanı İşleminde Kayıt: Sipariş onaylandığında harici API çağrılmaz; yalnızca
ps_tt_sync_outboxtablosuna benzersiz biridempotency_key(ör.order:{id}:v1) ve JSON yükü eklenir (<2 ms). - Asenkron Kuyruk İşleyici: Symfony Messenger veya sistemd/cron işçisi bekleyen kayıtları
SKIP LOCKEDile çekip ERP’ye iletir. - Ü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.
- İdempotency Garantisi: Ağ kopması nedeniyle aynı istek iki kez gönderilse bile ERP tarafı
X-Idempotency-Keybaş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/.ymldosyalarına web sunucusu seviyesinde kesin403uygulanmalı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
ordersGET/PUT) en az yetki ilkesiyle izin verilmelidir. - CSP & Tedarik Zinciri Denetimi: Ödeme ve yönetici sayfalarında
Content-Security-Policynonce kullanımı vecomposer auditile 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.