Blockchain teknolojilerinin y\u00fckseli\u015fiyle birlikte, merkeziyetsiz uygulamalar (dApps) ve ak\u0131ll\u0131 s\u00f6zle\u015fmeler hayat\u0131m\u0131z\u0131n her alan\u0131na girmeye ba\u015flad\u0131. Ancak bu teknolojilerin getirdi\u011fi yeniliklerle birlikte, geleneksel yaz\u0131l\u0131m geli\u015ftirme yakla\u015f\u0131mlar\u0131m\u0131zla entegrasyon konusunda baz\u0131 zorluklar da ortaya \u00e7\u0131k\u0131yor. \u00d6zellikle Stellar ekosisteminde yeni nesil ak\u0131ll\u0131 s\u00f6zle\u015fmeler platformu olan Soroban’dan gelen verileri, h\u0131zl\u0131 sorgulanabilirlik ve karma\u015f\u0131k analizler i\u00e7in PHP tabanl\u0131 web uygulamalar\u0131m\u0131z\u0131n kulland\u0131\u011f\u0131 geleneksel veritabanlar\u0131na senkronize etmek, bir\u00e7ok geli\u015ftiricinin kar\u015f\u0131la\u015ft\u0131\u011f\u0131 kritik bir ihtiya\u00e7t\u0131r. Peki, Soroban’daki dinamik verileri PHP kullanarak geleneksel bir veritaban\u0131na sorunsuz bir \u015fekilde nas\u0131l ta\u015f\u0131yabiliriz? Bu makale, bu sorunun yan\u0131tlar\u0131n\u0131 ad\u0131m ad\u0131m ve pratik \u00f6rneklerle sunarak, blockchain ile web geli\u015ftirme aras\u0131ndaki k\u00f6pr\u00fcy\u00fc kurman\u0131za yard\u0131mc\u0131 olacak.<\/p>\n
Blockchain teknolojileri, \u015feffafl\u0131k, de\u011fi\u015fmezlik ve merkeziyetsizlik gibi \u00f6nemli avantajlar sunsa da, geleneksel uygulamalar\u0131n bekledi\u011fi h\u0131z ve esneklikte veri eri\u015fimi konusunda belirli k\u0131s\u0131tlamalara sahiptir. \u00d6zellikle Soroban gibi ak\u0131ll\u0131 s\u00f6zle\u015fme platformlar\u0131 \u00fczerinde ger\u00e7ekle\u015fen binlerce i\u015flem ve \u00fcretilen event, do\u011frudan zincir \u00fczerinden sorguland\u0131\u011f\u0131nda performans darbo\u011fazlar\u0131na yol a\u00e7abilir. Geleneksel veritabanlar\u0131 (SQL veya NoSQL), karma\u015f\u0131k sorgulama yetenekleri, indeksleme mekanizmalar\u0131 ve binlerce e\u015f zamanl\u0131 iste\u011fi i\u015fleme kapasiteleri sayesinde web uygulamalar\u0131 i\u00e7in vazge\u00e7ilmezdir. \u0130\u015fte tam da bu noktada, Soroban’dan gelen verileri geleneksel bir veritaban\u0131na senkronize etmek bir zorunluluk haline gelir.<\/p>\n
\u00d6ncelikle, kullan\u0131c\u0131 deneyimi a\u00e7\u0131s\u0131ndan d\u00fc\u015f\u00fcnelim. Bir blockchain uygulamas\u0131n\u0131n, her veri talebi i\u00e7in blok zincirini taramas\u0131n\u0131 beklemek, modern web standartlar\u0131n\u0131n \u00e7ok gerisinde kal\u0131r. Bir kullan\u0131c\u0131n\u0131n kendi i\u015flemlerini veya c\u00fczdan bakiyesini an\u0131nda g\u00f6rmesini sa\u011flamak i\u00e7in h\u0131zl\u0131 eri\u015fime ihtiya\u00e7 duyar\u0131z. \u0130kincisi, karma\u015f\u0131k veri analizi ve raporlama yetenekleri. Blockchain \u00fczerinde depolanan ham veriler genellikle yap\u0131land\u0131r\u0131lmam\u0131\u015f veya yar\u0131 yap\u0131land\u0131r\u0131lm\u0131\u015f formattad\u0131r. Bu verileri belirli kriterlere g\u00f6re filtrelemek, gruplamak veya farkl\u0131 tablolarla birle\u015ftirmek, geleneksel bir ili\u015fkisel veritaban\u0131nda \u00e7ok daha kolay ve performansl\u0131d\u0131r. Ayr\u0131ca, zincir \u00fcst\u00fc veriler genellikle yaln\u0131zca uygulaman\u0131n temel i\u015f mant\u0131\u011f\u0131n\u0131 i\u00e7erir; kullan\u0131c\u0131 profilleri, ayarlar veya di\u011fer merkezi sistemlerle entegrasyon i\u00e7in gereken ek veriler, geleneksel veritabanlar\u0131nda saklan\u0131r. Bu nedenle, Soroban’daki ak\u0131ll\u0131 s\u00f6zle\u015fme eventlerini dinleyerek, bu eventlerden t\u00fcretilen anlaml\u0131 verileri geleneksel bir veritaban\u0131na aktarmak, sadece performans\u0131 art\u0131rmakla kalmaz, ayn\u0131 zamanda daha zengin ve i\u015flevsel uygulamalar geli\u015ftirmemize olanak tan\u0131r. PHP ise, g\u00fc\u00e7l\u00fc veritaban\u0131 entegrasyon yetenekleri ve geni\u015f k\u00fct\u00fcphane ekosistemi sayesinde bu senkronizasyon katman\u0131n\u0131 in\u015fa etmek i\u00e7in ideal bir adayd\u0131r.<\/p>\n
Bu karma\u015f\u0131k konuya dalmadan \u00f6nce, temel bile\u015fenleri anlamak faydal\u0131 olacakt\u0131r. Soroban, Stellar blockchain \u00fczerinde \u00e7al\u0131\u015fan, Rust tabanl\u0131 bir ak\u0131ll\u0131 s\u00f6zle\u015fme platformudur. Geli\u015ftiricilerin y\u00fcksek performansl\u0131 ve g\u00fcvenli merkeziyetsiz uygulamalar (dApps) olu\u015fturmas\u0131na olanak tan\u0131r. Soroban \u00fczerindeki ak\u0131ll\u0131 s\u00f6zle\u015fmeler, belirli eylemler ger\u00e7ekle\u015ftirdi\u011finde ‘event’ ad\u0131 verilen olaylar\u0131 yayabilir. \u00d6rne\u011fin, bir token transfer edildi\u011finde veya bir NFT bas\u0131ld\u0131\u011f\u0131nda (mint edildi\u011finde) ilgili bir event yay\u0131nlan\u0131r. Bu eventler, s\u00f6zle\u015fmenin d\u0131\u015f d\u00fcnyayla ileti\u015fim kurma ve durum de\u011fi\u015fikliklerini bildirme mekanizmas\u0131d\u0131r.<\/p>\n
Di\u011fer yandan PHP, sunucu taraf\u0131nda \u00e7al\u0131\u015fan, geni\u015f bir kullan\u0131c\u0131 taban\u0131na ve zengin bir ekosisteme sahip pop\u00fcler bir programlama dilidir. Web uygulamalar\u0131 geli\u015ftirmek, API’ler olu\u015fturmak ve veritabanlar\u0131yla etkile\u015fim kurmak i\u00e7in yayg\u0131n olarak kullan\u0131l\u0131r. PHP’nin veritaban\u0131 abstraction katmanlar\u0131 (PDO) ve ORM (Object-Relational Mapping) k\u00fct\u00fcphaneleri (\u00f6rne\u011fin Laravel’in Eloquent’i veya Doctrine), veritaban\u0131 i\u015flemlerini olduk\u00e7a kolayla\u015ft\u0131r\u0131r. Senkronizasyon s\u00fcrecinde PHP, Soroban’dan gelen eventleri dinleyecek, i\u015fleyecek ve bu verileri yap\u0131land\u0131r\u0131lm\u0131\u015f bir \u015fekilde bir veritaban\u0131na kaydedecektir. Bu, uygulaman\u0131z\u0131n blockchain’deki de\u011fi\u015fmez verilerle g\u00fcncel kalmas\u0131n\u0131 sa\u011flarken, ayn\u0131 zamanda h\u0131zl\u0131 sorgulama ve karma\u015f\u0131k analiz yetenekleri sunar.<\/p>\n
Veritaban\u0131 senkronizasyonu ise, blockchain \u00fczerinde ger\u00e7ekle\u015fen belirli olaylar\u0131 (eventleri) veya durum de\u011fi\u015fikliklerini izleyerek, bu bilgileri geleneksel bir veritaban\u0131na aktarma ve orada s\u00fcrekli g\u00fcncel tutma s\u00fcrecidir. Bu s\u00fcre\u00e7, blok zincirindeki verinin bir kopyas\u0131n\u0131 veya t\u00fcretilmi\u015f bir versiyonunu off-chain (zincir d\u0131\u015f\u0131) olarak saklamak anlam\u0131na gelir. Bu, \u00f6zellikle karma\u015f\u0131k sorgular \u00e7al\u0131\u015ft\u0131r\u0131lmas\u0131 gereken durumlar, kullan\u0131c\u0131 aray\u00fczlerinin an\u0131nda veri sunmas\u0131 gereken anlar ve raporlama\/analiz ihtiya\u00e7lar\u0131 i\u00e7in hayati \u00f6nem ta\u015f\u0131r. Soroban ile PHP aras\u0131ndaki senkronizasyon, bir ‘dinleyici’ (listener) g\u00f6revi g\u00f6ren PHP uygulamas\u0131n\u0131n, Soroban a\u011f\u0131ndaki ak\u0131ll\u0131 s\u00f6zle\u015fme eventlerini s\u00fcrekli olarak takip etmesi ve bu eventler tetiklendi\u011finde ilgili verileri kendi veritaban\u0131na i\u015flemesi prensibine dayan\u0131r. Bu sayede, blockchain’in g\u00fcc\u00fcnden faydalan\u0131rken, geleneksel veritabanlar\u0131n\u0131n esneklik ve performans avantajlar\u0131n\u0131 da korumu\u015f oluruz.<\/p>\n
Soroban’dan gelen eventleri etkili bir \u015fekilde yakalay\u0131p geleneksel bir veritaban\u0131na senkronize etmek i\u00e7in sa\u011flam bir mimari ve stratejiye ihtiyac\u0131m\u0131z var. Temel olarak, bu s\u00fcre\u00e7 bir “event dinleyici” mekanizmas\u0131 etraf\u0131nda d\u00f6ner. Soroban ak\u0131ll\u0131 s\u00f6zle\u015fmeleri, belirli eylemler (token transferi, NFT bas\u0131m\u0131 vb.) ger\u00e7ekle\u015fti\u011finde loglar veya eventler arac\u0131l\u0131\u011f\u0131yla d\u0131\u015f d\u00fcnyaya bildirimde bulunur. Bu bildirimleri yakalamak, senkronizasyonun ilk ve en kritik ad\u0131m\u0131d\u0131r. \u0130ki ana strateji bulunmaktad\u0131r: Polling (sorgulama) ve Webhook’lar (e\u011fer Soroban ekosistemi taraf\u0131ndan destekleniyorsa veya bir arac\u0131 katman olu\u015fturulabiliyorsa).<\/p>\n
Polling, PHP uygulaman\u0131z\u0131n belirli aral\u0131klarla (\u00f6rne\u011fin her 10 saniyede bir) Soroban a\u011f\u0131ndaki RPC (Remote Procedure Call) veya Stellar Horizon API’sini sorgulayarak yeni eventleri kontrol etmesidir. Bu yakla\u015f\u0131m basit kurulumuyla \u00f6ne \u00e7\u0131kar:<\/p>\n
Polling, \u00f6zellikle d\u00fc\u015f\u00fck frekansl\u0131 eventler i\u00e7in basit ve etkili bir \u00e7\u00f6z\u00fcmd\u00fcr. Ancak y\u00fcksek frekansl\u0131 eventlerde veya ger\u00e7ek zamanl\u0131ya yak\u0131n senkronizasyon gerektiren durumlarda gecikmelere yol a\u00e7abilir ve API \u00fczerinde gereksiz y\u00fck olu\u015fturabilir.<\/p>\n
Webhook’lar, bir olay ger\u00e7ekle\u015fti\u011finde (bu durumda Soroban’da bir event) bir sunucu taraf\u0131ndan tan\u0131mlanan bir URL’ye otomatik olarak bir HTTP POST iste\u011fi g\u00f6nderme prensibine dayan\u0131r. Bu, an\u0131nda bildirim ve daha verimli bir senkronizasyon sa\u011flar. Soroban’\u0131n kendisi do\u011frudan geli\u015fmi\u015f webhook yetenekleri sunmasa da, bu t\u00fcr bir mekanizma bir arac\u0131 hizmet veya \u00f6zel bir indeksleme katman\u0131 olu\u015fturularak taklit edilebilir. \u00d6rne\u011fin, \u00f6zel bir hizmet, Soroban eventlerini dinleyip, bu eventleri ayr\u0131\u015ft\u0131r\u0131p \u00f6nceden tan\u0131mlanm\u0131\u015f PHP endpoint’inize bir POST iste\u011fi g\u00f6nderebilir.<\/p>\n
Bu y\u00f6ntem, daha d\u00fc\u015f\u00fck gecikme ve daha verimli kaynak kullan\u0131m\u0131 sunar ancak ek bir “dinleyici\/tetikleyici” servisinin kurulmas\u0131n\u0131 ve bak\u0131m\u0131n\u0131 gerektirir.<\/p>\n
Her iki durumda da, temel mimari bir Listener (Dinleyici)<\/strong>, bir Processor (\u0130\u015fleyici)<\/strong> ve bir Database (Veritaban\u0131)<\/strong> \u00fc\u00e7l\u00fcs\u00fcnden olu\u015fur. Listener Soroban eventlerini yakalar, Processor bu eventleri anlaml\u0131 verilere d\u00f6n\u00fc\u015ft\u00fcr\u00fcr ve Database bu verileri kal\u0131c\u0131 olarak saklar. Bu s\u00fcre\u00e7te veri b\u00fct\u00fcnl\u00fc\u011f\u00fcn\u00fc ve tekilli\u011fi sa\u011flamak kritik \u00f6neme sahiptir. Ayn\u0131 event’in birden fazla kez i\u015flenmesini \u00f6nlemek i\u00e7in her event’in benzersiz bir kimli\u011fe sahip oldu\u011funu ve bu kimli\u011fin veritaban\u0131nda kontrol edildi\u011fini varsaymal\u0131y\u0131z. Bu sayede, senkronizasyon i\u015flemleri s\u0131ras\u0131nda ya\u015fanabilecek olas\u0131 a\u011f hatalar\u0131na veya yeniden denemelere kar\u015f\u0131 dayan\u0131kl\u0131l\u0131k kazan\u0131r\u0131z. Genel olarak, basit uygulamalar i\u00e7in polling yeterli olabilirken, y\u00fcksek \u00f6l\u00e7ekli ve ger\u00e7ek zamanl\u0131ya yak\u0131n senkronizasyon gerektiren projelerde webhook benzeri bir yakla\u015f\u0131m\u0131 d\u00fc\u015f\u00fcrmek daha mant\u0131kl\u0131 olacakt\u0131r.<\/p>\n PHP ile Soroban eventlerini dinlemek ve i\u015flemek i\u00e7in, \u00f6ncelikle Soroban a\u011f\u0131na eri\u015fim sa\u011flayan bir yol bulmal\u0131y\u0131z. Stellar Horizon API, genellikle Stellar a\u011f\u0131ndaki bilgilere eri\u015fim i\u00e7in kullan\u0131l\u0131rken, Soroban i\u00e7in do\u011frudan bir RPC endpoint’i veya \u00f6zel bir indeksleyici hizmeti \u00fczerinden ileti\u015fim kurmak daha yayg\u0131nd\u0131r. Bu \u00f6rnekte, Soroban RPC endpoint’ine HTTP istekleri g\u00f6ndererek eventleri \u00e7ekece\u011fiz. Bunun i\u00e7in PHP’de pop\u00fcler bir HTTP istemci k\u00fct\u00fcphanesi olan Guzzle’\u0131 kullanabiliriz.<\/p>\n \u00d6ncelikle, projenize Guzzle’\u0131 Composer arac\u0131l\u0131\u011f\u0131yla dahil etmelisiniz:<\/p>\n <\/code><\/p>\n Daha sonra, Soroban RPC endpoint'ini hedefleyerek belirli bir blok aral\u0131\u011f\u0131ndaki veya belirli bir s\u00f6zle\u015fmeye ait eventleri sorgulayabiliriz. Genellikle <\/code><\/p>\n Bu kod blo\u011fu, Soroban RPC endpoint'ine d\u00fczenli olarak Soroban'dan gelen event verilerini geleneksel bir veritaban\u0131na aktarmak i\u00e7in sa\u011flam ve \u00f6l\u00e7eklenebilir bir veri modeline ihtiyac\u0131m\u0131z var. Veritaban\u0131 tasar\u0131m\u0131m\u0131z, hem Soroban ak\u0131ll\u0131 s\u00f6zle\u015fmesinin yap\u0131s\u0131n\u0131 yans\u0131tmal\u0131 hem de uygulamam\u0131z\u0131n sorgulama ihtiya\u00e7lar\u0131n\u0131 kar\u015f\u0131lamal\u0131d\u0131r. Bir \u00f6rnek \u00fczerinden gidelim: diyelim ki bir NFT pazar yeri ak\u0131ll\u0131 s\u00f6zle\u015fmeniz var. Bu s\u00f6zle\u015fme NFT bas\u0131m\u0131 (mint), transferi ve sat\u0131\u015f eventleri yay\u0131nl\u0131yor. Bu eventlerden t\u00fcretilen verileri bir PostgreSQL veya MySQL veritaban\u0131nda nas\u0131l saklayaca\u011f\u0131m\u0131z\u0131 inceleyelim.<\/p>\n NFT pazar yeri s\u00f6zle\u015fmemiz \u015fu eventleri yay\u0131nlayabilir:<\/p>\n \u00c7o\u011fu durumda, Soroban'dan gelen yap\u0131land\u0131r\u0131lm\u0131\u015f veya yar\u0131 yap\u0131land\u0131r\u0131lm\u0131\u015f verileri saklamak i\u00e7in ili\u015fkisel veritabanlar\u0131 (SQL) olduk\u00e7a uygundur. \u00d6zellikle karma\u015f\u0131k ili\u015fkiler, g\u00fc\u00e7l\u00fc sorgu yetenekleri ve veri b\u00fct\u00fcnl\u00fc\u011f\u00fc garantileri ar\u0131yorsan\u0131z, PostgreSQL veya MySQL tercih edilebilir. E\u011fer event verileri \u00e7ok dinamik ve esnek bir yap\u0131ya sahipse, veya \u00e7ok b\u00fcy\u00fck hacimli verileri h\u0131zl\u0131 bir \u015fekilde indekslemeniz gerekiyorsa MongoDB gibi NoSQL veritabanlar\u0131 da bir se\u00e7enek olabilir. Bu makalede, daha yayg\u0131n oldu\u011fu i\u00e7in SQL (PostgreSQL\/MySQL) \u00fczerine odaklanaca\u011f\u0131z.<\/p>\n NFT pazar yeri senaryomuz i\u00e7in a\u015fa\u011f\u0131daki gibi tablolar tasarlayabiliriz:<\/p>\n <\/code><\/p>\n Bu tablo, her bir Soroban event'ini orijinal haliyle kaydetmemize olanak tan\u0131r. <\/code><\/p>\n <\/code><\/p>\n <\/code><\/p>\n Bu yap\u0131, ham event verilerini tutman\u0131n yan\u0131 s\u0131ra, bu eventlerden t\u00fcretilen anlaml\u0131 i\u015f verilerini (NFT'ler, transferler, sat\u0131\u015flar) ili\u015fkisel bir \u015fekilde saklamam\u0131z\u0131 sa\u011flar. \u00d6rne\u011fin, bir Soroban'dan gelen eventleri ba\u015far\u0131yla yakalay\u0131p ayr\u0131\u015ft\u0131rd\u0131ktan sonra, s\u0131ra bu verileri geleneksel veritaban\u0131m\u0131za kaydetmeye gelir. Bu ad\u0131mda, veri b\u00fct\u00fcnl\u00fc\u011f\u00fcn\u00fc sa\u011flamak, ayn\u0131 event'in birden fazla kez i\u015flenmesini \u00f6nlemek (idempotency) ve olas\u0131 hatalar\u0131 y\u00f6netmek kritik \u00f6neme sahiptir. PHP'de veritaban\u0131 etkile\u015fimi i\u00e7in PDO (PHP Data Objects) veya bir ORM (Object-Relational Mapping) k\u00fct\u00fcphanesi (Laravel i\u00e7in Eloquent, Symfony i\u00e7in Doctrine gibi) kullanabiliriz. ORM'ler, veritaban\u0131 i\u015flemlerini nesne odakl\u0131 bir yakla\u015f\u0131mla daha okunabilir ve y\u00f6netilebilir hale getirir.<\/p>\n Senkronizasyon s\u00fcre\u00e7lerinde a\u011f hatalar\u0131, sunucu kesintileri veya yeniden denemeler nedeniyle ayn\u0131 event'in birden fazla kez i\u015flenme riski vard\u0131r. Idempotency, bir i\u015flemin birden fazla kez yap\u0131lsa bile sistemin durumunun yaln\u0131zca bir kez etkilenmesini sa\u011flar. Bunu sa\u011flamak i\u00e7in:<\/p>\n A\u015fa\u011f\u0131daki \u00f6rnek, PHP PDO kullanarak bir NFT 'mint' event'ini nas\u0131l i\u015fleyip <\/code><\/p>\n Senkronizasyon s\u00fcreci, a\u011f kesintileri, veritaban\u0131 ba\u011flant\u0131 sorunlar\u0131 veya ge\u00e7ersiz event verileri gibi \u00e7e\u015fitli hatalarla kar\u015f\u0131la\u015fabilir. Bu durumlar i\u00e7in sa\u011flam bir hata y\u00f6netimi stratejisi geli\u015ftirmek \u00f6nemlidir:<\/p>\n Etkin hata y\u00f6netimi ve idempotency, senkronizasyon sisteminizin g\u00fcvenilirli\u011fini ve veri b\u00fct\u00fcnl\u00fc\u011f\u00fcn\u00fc b\u00fcy\u00fck \u00f6l\u00e7\u00fcde art\u0131r\u0131r. Bu sayede, Soroban'dan gelen veriler, PHP uygulaman\u0131z\u0131n gereksinimlerine uygun, tutarl\u0131 ve eri\u015filebilir bir \u015fekilde veritaban\u0131n\u0131zda yerini al\u0131r.<\/p>\n Teorik bilgileri ve teknik ad\u0131mlar\u0131 \u00f6\u011frendikten sonra, ger\u00e7ek d\u00fcnyadan bir senaryo ile konuyu peki\u015ftirelim: Bir NFT Pazar Yeri. Bu senaryoda, kullan\u0131c\u0131lar NFT'leri basabilir (mint), birbirlerine transfer edebilir ve belirledikleri fiyatlarla satabilirler. T\u00fcm bu i\u015flemler Soroban ak\u0131ll\u0131 s\u00f6zle\u015fmeleri \u00fczerinde ger\u00e7ekle\u015firken, pazar yerinin web aray\u00fcz\u00fc (PHP ile geli\u015ftirilmi\u015f) bu verilere h\u0131zl\u0131 ve etkin bir \u015fekilde eri\u015fmek zorundad\u0131r. \u0130\u015fte bu noktada, Soroban eventlerini PHP ile veritaban\u0131na senkronize etme mimarimiz devreye giriyor.<\/p>\n Kurgusal NFT Pazar Yerimiz \"SorobanArt\" a\u015fa\u011f\u0131daki \u00f6zelliklere sahip:<\/p>\n Bu \u00f6zellikler, blockchain'deki veriye dayan\u0131r ancak do\u011frudan zincir \u00fczerinden sorgulamak performans, maliyet ve kullan\u0131c\u0131 deneyimi a\u00e7\u0131s\u0131ndan verimsizdir. Bu y\u00fczden bir senkronizasyon katman\u0131na ihtiyac\u0131m\u0131z var.<\/p>\n SorobanArt'taki ak\u0131ll\u0131 s\u00f6zle\u015fme, mint, transfer ve sale gibi farkl\u0131 event'ler yayar. PHP ile yazd\u0131\u011f\u0131m\u0131z event dinleyici (\u00f6nceki b\u00f6l\u00fcmlerde g\u00f6sterilen polling mekanizmas\u0131 gibi), bu eventleri yakalar. Her bir event t\u00fcr\u00fc i\u00e7in, veriler ayr\u0131\u015ft\u0131r\u0131l\u0131r ve daha \u00f6nce tasarlad\u0131\u011f\u0131m\u0131z veritaban\u0131 tablolar\u0131na ( T\u00fcm bu veriler geleneksel veritaban\u0131m\u0131zda sakland\u0131\u011f\u0131 i\u00e7in, PHP tabanl\u0131 bir framework (Laravel veya Symfony gibi) kullanarak kolayca g\u00f6r\u00fcnt\u00fclenebilir. \u00d6rne\u011fin, bir kullan\u0131c\u0131n\u0131n kendi NFT koleksiyonunu g\u00f6r\u00fcnt\u00fclemek i\u00e7in basit bir sorgu yeterli olacakt\u0131r:<\/p>\n <\/code><\/p>\n Bu \u015fekilde, pahal\u0131 ve yava\u015f blockchain sorgular\u0131na gerek kalmadan, h\u0131zl\u0131 ve etkile\u015fimli bir kullan\u0131c\u0131 deneyimi sunabiliriz. PHP uygulaman\u0131z, an\u0131nda veritaban\u0131ndan gerekli bilgileri \u00e7ekerek sayfa y\u00fckleme s\u00fcrelerini optimize eder ve geli\u015fmi\u015f filtreleme, s\u0131ralama gibi \u00f6zellikler sunabilir.<\/p>\n B\u00fcy\u00fck \u00f6l\u00e7ekli bir pazar yerinde milyonlarca NFT ve y\u00fcz binlerce i\u015flem olabilir. Bu durumda, senkronizasyon s\u00fcrecinin kendisi bir darbo\u011faz haline gelebilir.<\/p>\n Bu senaryo, Soroban'dan gelen blockchain verilerinin PHP uygulamalar\u0131 taraf\u0131ndan nas\u0131l etkin bir \u015fekilde kullan\u0131labilece\u011fini ve geleneksel veritabanlar\u0131n\u0131n g\u00fcc\u00fcyle nas\u0131l birle\u015febilece\u011fini somut bir \u015fekilde g\u00f6stermektedir. Geli\u015ftiriciler, bu entegrasyonla hem blockchain'in temel avantajlar\u0131ndan yararlanabilir hem de kullan\u0131c\u0131lar\u0131na \u00fcst d\u00fczey bir deneyim sunabilirler.<\/p>\n K\u00fc\u00e7\u00fck ve orta \u00f6l\u00e7ekli uygulamalar i\u00e7in basit polling ve do\u011frudan veritaban\u0131 yazma yeterli olabilirken, b\u00fcy\u00fck \u00f6l\u00e7ekli ve y\u00fcksek i\u015flem hacmine sahip dApp'ler i\u00e7in daha sofistike senkronizasyon teknikleri ve optimizasyonlar ka\u00e7\u0131n\u0131lmaz hale gelir. Performans\u0131, \u00f6l\u00e7eklenebilirli\u011fi ve veri tutarl\u0131l\u0131\u011f\u0131n\u0131 art\u0131rmak i\u00e7in a\u015fa\u011f\u0131daki ileri d\u00fczey yakla\u015f\u0131mlar\u0131 g\u00f6z \u00f6n\u00fcnde bulundurmal\u0131y\u0131z.<\/p>\n Do\u011frudan veritaban\u0131na yazma, \u00f6zellikle yo\u011fun event ak\u0131\u015f\u0131 oldu\u011funda veritaban\u0131 \u00fczerinde y\u00fcksek y\u00fck olu\u015fturabilir ve PHP dinleyicisinin eventleri ka\u00e7\u0131rmas\u0131na neden olabilir. Bu senaryolarda, bir mesaj kuyru\u011fu sistemi kullanmak kritik bir optimizasyondur.<\/p>\n Nas\u0131l \u00c7al\u0131\u015f\u0131r?<\/p>\n Avantajlar\u0131:<\/p>\n Blockchain do\u011fas\u0131 gere\u011fi de\u011fi\u015ftirilemez ve tutarl\u0131d\u0131r. Ancak, zincir d\u0131\u015f\u0131 veritaban\u0131m\u0131za senkronize ederken bu tutarl\u0131l\u0131\u011f\u0131 sa\u011flamak bizim sorumlulu\u011fumuzdadur.<\/p>\n Sistemin sa\u011fl\u0131kl\u0131 \u00e7al\u0131\u015ft\u0131\u011f\u0131ndan emin olmak i\u00e7in kapsaml\u0131 monit\u00f6rleme ve loglama \u015fartt\u0131r.<\/p>\n Soroban eventlerinden gelen ham veriler, kullan\u0131c\u0131 aray\u00fcz\u00fcnde do\u011frudan kullan\u0131labilecek formda olmayabilir.<\/p>\n Bu ileri d\u00fczey teknikler, Soroban ile PHP senkronizasyonunuzu daha dayan\u0131kl\u0131, \u00f6l\u00e7eklenebilir ve y\u00f6netilebilir hale getirerek, blockchain'in dinamik d\u00fcnyas\u0131 ile geleneksel web uygulamalar\u0131n\u0131n beklentileri aras\u0131nda kusursuz bir k\u00f6pr\u00fc kurman\u0131z\u0131 sa\u011flar.<\/p>\n Blockchain teknolojilerinin, \u00f6zellikle de Soroban gibi ak\u0131ll\u0131 s\u00f6zle\u015fme platformlar\u0131n\u0131n sundu\u011fu potansiyel, merkeziyetsiz uygulamalar\u0131n gelece\u011fini \u015fekillendiriyor. Ancak bu potansiyeli tam anlam\u0131yla ortaya \u00e7\u0131karmak i\u00e7in, blockchain'in sundu\u011fu de\u011fi\u015fmezlik ve \u015feffafl\u0131k avantajlar\u0131n\u0131, geleneksel veritabanlar\u0131n\u0131n sundu\u011fu performans ve esneklikle birle\u015ftirmek esast\u0131r. Bu makalede, Soroban'dan gelen eventleri PHP kullanarak geleneksel bir veritaban\u0131na nas\u0131l senkronize edece\u011fimizi ad\u0131m ad\u0131m ele ald\u0131k.<\/p>\n Giri\u015f seviyesinden ba\u015flayarak, neden bu senkronizasyona ihtiya\u00e7 duydu\u011fumuzu, temel kavramlar\u0131 ve mimari stratejileri inceledik. PHP ile Soroban RPC API'sine nas\u0131l ba\u011flan\u0131laca\u011f\u0131n\u0131, eventlerin nas\u0131l dinlenece\u011fini ve ayr\u0131\u015ft\u0131r\u0131laca\u011f\u0131n\u0131 detayl\u0131 kod \u00f6rnekleriyle g\u00f6sterdik. Ard\u0131ndan, gelen verileri bar\u0131nd\u0131rmak i\u00e7in veritaban\u0131 tasar\u0131m prensiplerini ve g\u00fcvenli veri kay\u0131t i\u015flemlerini ele ald\u0131k. Bir NFT pazar yeri senaryosu \u00fczerinden ger\u00e7ek d\u00fcnya uygulamas\u0131n\u0131 somutla\u015ft\u0131rd\u0131k ve son olarak, b\u00fcy\u00fck \u00f6l\u00e7ekli uygulamalar i\u00e7in kritik olan ileri d\u00fczey optimizasyon tekniklerine de\u011findik.<\/p>\n Bu entegrasyon, PHP geli\u015ftiricilerine blockchain d\u00fcnyas\u0131na a\u00e7\u0131lan g\u00fc\u00e7l\u00fc bir kap\u0131 sunuyor. Mevcut PHP becerilerinizi kullanarak, Soroban \u00fczerindeki ak\u0131ll\u0131 s\u00f6zle\u015fmelerle etkile\u015fim kuran, zengin \u00f6zelliklere sahip, h\u0131zl\u0131 ve g\u00fcvenilir dApp'ler geli\u015ftirebilirsiniz. Unutmay\u0131n, senkronizasyon s\u00fcreci devaml\u0131l\u0131k gerektiren bir i\u015ftir; sisteminizin monit\u00f6rlenmesi, loglanmas\u0131 ve olas\u0131 hatalara kar\u015f\u0131 dayan\u0131kl\u0131 olmas\u0131 kritik \u00f6neme sahiptir. Blockchain teknolojileri olgunla\u015ft\u0131k\u00e7a, bu t\u00fcr senkronizasyon ara\u00e7lar\u0131 ve y\u00f6ntemleri de geli\u015fmeye devam edecektir. Geli\u015ftiriciler olarak, bu s\u00fcrekli evrimi takip ederek sistemlerimizi g\u00fcncel ve etkin tutmak, gelece\u011fin merkeziyetsiz web'ini in\u015fa etme yolculu\u011fumuzda bize \u00f6nemli avantajlar sa\u011flayacakt\u0131r.<\/p>\n Cevap:<\/strong> Soroban RPC API'sine HTTP istekleri g\u00f6nderebilen herhangi bir programlama dilini kullanabilirsiniz. Python, Node.js (JavaScript\/TypeScript), Go ve Rust bu t\u00fcr i\u015flemleri ger\u00e7ekle\u015ftirmek i\u00e7in olduk\u00e7a pop\u00fcler se\u00e7eneklerdir. Se\u00e7iminiz genellikle ekosistem deste\u011fine, performans gereksinimlerinize ve kendi uzmanl\u0131\u011f\u0131n\u0131za ba\u011fl\u0131 olacakt\u0131r.<\/p>\n Cevap:<\/strong> Do\u011frudan Soroban'dan veri okumak genellikle daha yava\u015ft\u0131r, maliyetli olabilir (RPC \u00e7a\u011fr\u0131lar\u0131 limitli olabilir) ve karma\u015f\u0131k sorgular i\u00e7in uygun de\u011fildir. Geleneksel veritabanlar\u0131 ise h\u0131zl\u0131 indeksleme, karma\u015f\u0131k JOIN i\u015flemleri, geli\u015fmi\u015f filtreleme ve raporlama yetenekleri sunar. Senkronizasyon, kullan\u0131c\u0131lar\u0131n\u0131za h\u0131zl\u0131 ve ak\u0131c\u0131 bir deneyim sunarken, blockchain'in de\u011fi\u015fmezli\u011fini koruman\u0131z\u0131 sa\u011flar.<\/p>\n Cevap:<\/strong> Veri kayb\u0131n\u0131 \u00f6nlemek i\u00e7in birka\u00e7 strateji uygulanmal\u0131d\u0131r: 1) Her event i\u00e7in benzersiz bir kimlik kullanarak (i\u015flem hash'i, blok numaras\u0131 + event indeksi gibi) idempotency (tekrarlanan i\u015flem \u00f6nleme) sa\u011flay\u0131n. 2) Eventleri do\u011frudan veritaban\u0131na yazmak yerine bir mesaj kuyru\u011funa (RabbitMQ, Redis Queue) atarak asenkron i\u015fleme yap\u0131n. Bu, dinleyicinin eventleri ka\u00e7\u0131rmamas\u0131n\u0131 sa\u011flar. 3) Veritaban\u0131 i\u015flemleri s\u0131ras\u0131nda (ACID \u00f6zellikleri olan) transaction'lar kullan\u0131n. 4) Hata loglamay\u0131 ve yeniden deneme mekanizmalar\u0131n\u0131 uygulay\u0131n. 5) Son olarak, i\u015flenemeyen eventler i\u00e7in bir \"dead letter queue\" (hatal\u0131 event kuyru\u011fu) bulundurun.<\/p>\n Cevap:<\/strong> Soroban eventleri genellikle base64 kodlu XDR (External Data Representation) format\u0131ndad\u0131r. PHP ekosisteminde Stellar\/Soroban XDR \u00e7\u00f6z\u00fcmleyici k\u00fct\u00fcphaneleri s\u0131n\u0131rl\u0131 olabilir. Bu durumda, ya kendinize \u00f6zel bir XDR \u00e7\u00f6z\u00fcmleyici yazman\u0131z ya da Python ( Cevap:<\/strong> Bir CLI beti\u011fi olarak yazd\u0131\u011f\u0131n\u0131z senkronizasyon kodunu kal\u0131c\u0131 olarak \u00e7al\u0131\u015ft\u0131rmak i\u00e7in farkl\u0131 y\u00f6ntemler mevcuttur:<\/p>\n Her durumda, beti\u011finizin do\u011fru loglama ve hata y\u00f6netimi mekanizmalar\u0131na sahip olmas\u0131, sorun giderme ve y\u00f6netim i\u00e7in hayati \u00f6neme sahiptir.<\/p>\n <\/body><\/p>\n","protected":false},"excerpt":{"rendered":"Blockchain teknolojilerinin y\u00fckseli\u015fiyle birlikte, merkeziyetsiz uygulamalar (dApps) ve ak\u0131ll\u0131 s\u00f6zle\u015fmeler hayat\u0131m\u0131z\u0131n her alan\u0131na girmeye ba\u015flad\u0131. Ancak bu teknolojilerin…","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"csco_page_header_type":"","csco_page_load_nextpost":"","csco_page_subscribe_form":"","csco_page_contact_form":"","footnotes":""},"categories":[133],"tags":[],"class_list":{"0":"post-36053","1":"post","2":"type-post","3":"status-publish","4":"format-standard","6":"category-php","7":"cs-entry","8":"cs-video-wrap"},"yoast_head":"\nPHP ile Soroban Eventlerini Dinleme ve \u0130\u015fleme: Ad\u0131m Ad\u0131m Entegrasyon Rehberi<\/h3>\n
\ncomposer require guzzlehttp\/guzzle\n<\/pre>\ngetEvents<\/code> RPC metodunu kullan\u0131r\u0131z. \u0130\u015fte temel bir PHP beti\u011fi ile bu i\u015flemi nas\u0131l yapabilece\u011finizi g\u00f6steren bir \u00f6rnek:<\/p>\n\n\n $sorobanRpcUrl]);\n\n \/\/ Sonsuz d\u00f6ng\u00fc i\u00e7inde eventleri s\u00fcrekli dinleyelim\n while (true) {\n echo \"Eventler dinleniyor... Son i\u015flenen blok: \" . $lastProcessedLedger . PHP_EOL;\n\n \/\/ RPC iste\u011fi i\u00e7in parametreler\n \/\/ getEvents metodu genellikle bir 'startLedger' ve 'filters' parametresi al\u0131r.\n $payload = [\n 'jsonrpc' => '2.0',\n 'id' => 1,\n 'method' => 'getEvents',\n 'params' => [\n 'startLedger' => $lastProcessedLedger + 1, \/\/ Bir sonraki bloktan itibaren\n 'filters' => [\n [\n 'type' => 'contract',\n \/\/ E\u011fer belirli bir s\u00f6zle\u015fmenin eventlerini dinlemek istiyorsan\u0131z\n \/\/ 'contractId' => 'CONTRACT_ID_BURAYA_GELECEK',\n \/\/ T\u00fcm eventleri dinlemek i\u00e7in 'contractId' filtresini kald\u0131rabilirsiniz.\n ]\n ],\n 'pagination' => [\n 'limit' => 10, \/\/ Her seferinde en fazla 10 event \u00e7ek\n ]\n ]\n ];\n\n $response = $client->post('', [\n 'json' => $payload\n ]);\n\n $result = json_decode($response->getBody()->getContents(), true);\n\n if (isset($result['error'])) {\n echo \"RPC Hatas\u0131: \" . $result['error']['message'] . PHP_EOL;\n sleep(5); \/\/ Hata durumunda bekle\n continue;\n }\n\n if (empty($result['result']['events'])) {\n echo \"Yeni event bulunamad\u0131. \" . PHP_EOL;\n sleep(10); \/\/ Yeni event yoksa 10 saniye bekle\n continue;\n }\n\n foreach ($result['result']['events'] as $event) {\n echo \"Yeni Event Al\u0131nd\u0131: \" . PHP_EOL;\n echo \" Ledger: \" . $event['ledger'] . PHP_EOL;\n echo \" Contract ID: \" . $event['contractId'] . PHP_EOL;\n echo \" Topic: \" . json_encode($event['topic']) . PHP_EOL;\n echo \" Data: \" . $event['data'] . PHP_EOL;\n echo \"------------------------------------\" . PHP_EOL;\n\n \/\/ Burada event verilerini ayr\u0131\u015ft\u0131rma ve veritaban\u0131na kaydetme mant\u0131\u011f\u0131 gelecek.\n \/\/ \u00d6rnek: saveEventToDatabase($event);\n\n \/\/ En son i\u015flenen blo\u011fu g\u00fcncelle\n $lastProcessedLedger = max($lastProcessedLedger, $event['ledger']);\n }\n\n \/\/ Bir sonraki sorgulamadan \u00f6nce biraz bekle\n sleep(5);\n\n }\n\n} catch (GuzzleException $e) {\n echo \"HTTP \u0130ste\u011fi Hatas\u0131: \" . $e->getMessage() . PHP_EOL;\n} catch (Exception $e) {\n echo \"Genel Hata: \" . $e->getMessage() . PHP_EOL;\n}\n\n\/\/ saveEventToDatabase fonksiyonu \u00f6rnek\nfunction saveEventToDatabase(array $event) {\n \/\/ Veritaban\u0131 ba\u011flant\u0131s\u0131 burada kurulmal\u0131 (PDO veya ORM ile)\n \/\/ \u00d6rnek olarak:\n \/\/ $pdo = new PDO('mysql:host=localhost;dbname=soroban_db', 'user', 'password');\n \/\/ $stmt = $pdo->prepare(\"INSERT INTO events (ledger, contract_id, topic, data) VALUES (?, ?, ?, ?)\");\n \/\/ $stmt->execute([$event['ledger'], $event['contractId'], json_encode($event['topic']), $event['data']]);\n echo \"Event veritaban\u0131na kaydedildi: \" . $event['ledger'] . PHP_EOL;\n}\n<\/pre>\ngetEvents<\/code> iste\u011fi g\u00f6nderen basit bir polling mekanizmas\u0131n\u0131 g\u00f6sterir. lastProcessedLedger<\/code> de\u011fi\u015fkeni, ayn\u0131 eventleri tekrar i\u015flemeyi \u00f6nlemek i\u00e7in kritik \u00f6neme sahiptir ve ger\u00e7ek bir uygulamada kal\u0131c\u0131 olarak (bir veritaban\u0131nda veya bir Redis anahtar\u0131nda) saklanmal\u0131d\u0131r. Gelen eventlerin topic<\/code> ve data<\/code> alanlar\u0131, ak\u0131ll\u0131 s\u00f6zle\u015fmenin mant\u0131\u011f\u0131na ba\u011fl\u0131 olarak ayr\u0131\u015ft\u0131r\u0131lmal\u0131d\u0131r. data<\/code> alan\u0131 genellikle base64 encoded ve XDR format\u0131nda olabilir, bu da \u00f6zel bir \u00e7\u00f6z\u00fcmleme gerektirebilir. Bu k\u0131s\u0131mlar\u0131 kendi ak\u0131ll\u0131 s\u00f6zle\u015fmenizin yap\u0131s\u0131na g\u00f6re \u00f6zelle\u015ftirmelisiniz. Bu PHP beti\u011fi, bir CLI arac\u0131 olarak \u00e7al\u0131\u015ft\u0131r\u0131labilir ve bir cron job ile d\u00fczenli aral\u0131klarla tetiklenebilir veya s\u00fcrekli \u00e7al\u0131\u015fan bir daemon olarak yap\u0131land\u0131r\u0131labilir.<\/p>\nVeritaban\u0131 Tasar\u0131m\u0131 ve Veri Modeli: Soroban Ak\u0131ll\u0131 S\u00f6zle\u015fme Verileri Nas\u0131l Saklanmal\u0131?<\/h2>\n
\u00d6rnek Senaryo: NFT Pazar Yeri S\u00f6zle\u015fmesi<\/h3>\n
\n
mint<\/code>: Bir NFT bas\u0131ld\u0131\u011f\u0131nda (tokenId, owner, tokenUri)<\/li>\ntransfer<\/code>: Bir NFT transfer edildi\u011finde (from, to, tokenId)<\/li>\nsale<\/code>: Bir NFT sat\u0131ld\u0131\u011f\u0131nda (tokenId, seller, buyer, price, currency)<\/li>\n<\/ul>\nVeritaban\u0131 Se\u00e7imi: SQL mi, NoSQL mi?<\/h3>\n
\u00d6rnek Tablo Yap\u0131lar\u0131<\/h3>\n
\n
events<\/code> Tablosu:<\/strong> Genel event loglar\u0131n\u0131 saklamak i\u00e7in birincil tablo. Bu tablo, Soroban'dan gelen her ham event'i kaydeder.<\/li>\n<\/ol>\n\n\nCREATE TABLE events (\n id BIGSERIAL PRIMARY KEY,\n ledger_sequence INT NOT NULL,\n transaction_hash VARCHAR(64) NOT NULL,\n contract_id VARCHAR(64) NOT NULL,\n event_type VARCHAR(50) NOT NULL, -- 'contract' gibi\n topic JSONB NOT NULL, -- Eventin konular\u0131 (\u00f6rne\u011fin [\"mint\", \"token_id\"])\n data TEXT NOT NULL, -- Ham event verisi (base64 encoded)\n created_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,\n CONSTRAINT unique_event_tx_id UNIQUE (transaction_hash, event_type, topic, data) -- Yinelenen eventleri \u00f6nlemek i\u00e7in\n);\n<\/pre>\ntransaction_hash<\/code> ve di\u011fer alanlar\u0131n birle\u015fimiyle benzersizlik sa\u011flayarak, ayn\u0131 event'in tekrar i\u015flenmesini \u00f6nleriz. topic<\/code> alan\u0131n\u0131 JSONB (PostgreSQL) veya JSON (MySQL) olarak tutmak, dinamik topic yap\u0131lar\u0131na uyum sa\u011flar.<\/p>\n\n
nfts<\/code> Tablosu:<\/strong> Bas\u0131lan her bir NFT'nin temel bilgilerini saklar.<\/li>\n<\/ol>\n\n\nCREATE TABLE nfts (\n id BIGSERIAL PRIMARY KEY,\n token_id VARCHAR(255) UNIQUE NOT NULL, -- Blockchain'deki NFT ID'si\n owner_address VARCHAR(64) NOT NULL,\n token_uri TEXT, -- NFT metadata URI'si\n minted_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,\n last_updated_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP\n);\n<\/pre>\n\n
nft_transfers<\/code> Tablosu:<\/strong> NFT transfer eventlerini kaydeder.<\/li>\n<\/ol>\n\n\nCREATE TABLE nft_transfers (\n id BIGSERIAL PRIMARY KEY,\n nft_id BIGINT NOT NULL REFERENCES nfts(id),\n from_address VARCHAR(64) NOT NULL,\n to_address VARCHAR(64) NOT NULL,\n transfer_time TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP\n);\n<\/pre>\n\n
nft_sales<\/code> Tablosu:<\/strong> NFT sat\u0131\u015f eventlerini kaydeder.<\/li>\n<\/ol>\n\n\nCREATE TABLE nft_sales (\n id BIGSERIAL PRIMARY KEY,\n nft_id BIGINT NOT NULL REFERENCES nfts(id),\n seller_address VARCHAR(64) NOT NULL,\n buyer_address VARCHAR(64) NOT NULL,\n price NUMERIC(20, 7) NOT NULL,\n currency_code VARCHAR(10) NOT NULL,\n sale_time TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP\n);\n<\/pre>\nmint<\/code> event'i geldi\u011finde nfts<\/code> tablosuna yeni bir kay\u0131t eklenir. Bir transfer<\/code> event'i geldi\u011finde, hem nft_transfers<\/code> tablosuna bir kay\u0131t eklenir hem de ilgili nfts<\/code> kayd\u0131n\u0131n owner_address<\/code> alan\u0131 g\u00fcncellenir. Bu, veri modelini g\u00fcncel ve tutarl\u0131 tutar.<\/p>\nVeritaban\u0131na Kay\u0131t ve G\u00fcncelleme \u0130\u015flemleri: PHP ile G\u00fcvenli ve Etkin Veri Y\u00f6netimi<\/h2>\n
Idempotency (Tekrarlanan \u0130\u015flemleri \u00d6nleme)<\/h3>\n
\n
UNIQUE<\/code> k\u0131s\u0131tlamalar\u0131 (constraint) kullan\u0131n.<\/li>\nPDO ile Veritaban\u0131 Kay\u0131t \u00d6rne\u011fi<\/h3>\n
nfts<\/code> ve events<\/code> tablolar\u0131na kaydedece\u011finizi g\u00f6sterir. Bu \u00f6rnekte, parseSorobanEventData<\/code> fonksiyonunun Soroban event'inin data<\/code> ve topic<\/code> alanlar\u0131n\u0131 ayr\u0131\u015ft\u0131r\u0131p anlaml\u0131 verilere d\u00f6n\u00fc\u015ft\u00fcrd\u00fc\u011f\u00fcn\u00fc varsay\u0131yoruz.<\/p>\n\n\n 'mint',\n 'token_id' => 'nft_' . bin2hex(random_bytes(8)), \/\/ \u00d6rnek ID\n 'owner' => 'GA...' . substr(md5($decodedData), 0, 5) . '...', \/\/ \u00d6rnek adres\n 'token_uri' => 'https:\/\/example.com\/nft\/' . bin2hex(random_bytes(10)) . '.json'\n ];\n }\n \/\/ Di\u011fer event t\u00fcrleri i\u00e7in benzer ayr\u0131\u015ft\u0131rma mant\u0131\u011f\u0131\n return ['type' => 'unknown', 'raw_data' => $sorobanEvent['data']];\n}\n\nfunction processAndSaveSorobanEvent(array $sorobanEvent, PDO $pdo)\n{\n \/\/ Event zaten i\u015flenmi\u015f mi kontrol et (idempotency)\n \/\/ Bu kontrol, events<\/code> tablosundaki unique_event_tx_id<\/code> k\u0131s\u0131tlamas\u0131 ile de sa\u011flanabilir.\n $stmt = $pdo->prepare(\"SELECT COUNT(*) FROM events WHERE transaction_hash = ? AND ledger_sequence = ? AND event_type = ?\");\n $stmt->execute([$sorobanEvent['txHash'], $sorobanEvent['ledger'], $sorobanEvent['type']]); \/\/ 'type' burada Soroban event'inin kendi tipi (contract, system)\n if ($stmt->fetchColumn() > 0) {\n echo \"Event zaten i\u015flenmi\u015f: \" . $sorobanEvent['txHash'] . PHP_EOL;\n return;\n }\n\n \/\/ Ham event'i 'events' tablosuna kaydet\n try {\n $stmt = $pdo->prepare(\"INSERT INTO events (ledger_sequence, transaction_hash, contract_id, event_type, topic, data) VALUES (?, ?, ?, ?, ?, ?)\");\n $stmt->execute([\n $sorobanEvent['ledger'],\n $sorobanEvent['txHash'],\n $sorobanEvent['contractId'],\n $sorobanEvent['type'], \/\/ Orjinal event tipi (contract, system)\n json_encode($sorobanEvent['topic']),\n $sorobanEvent['data']\n ]);\n $eventId = $pdo->lastInsertId(); \/\/ Kaydedilen event'in ID'si\n echo \"Ham event kaydedildi (ID: {$eventId}).\" . PHP_EOL;\n } catch (PDOException $e) {\n \/\/ Unique constraint hatas\u0131 olabilir, bu da idempotentcy'yi sa\u011flar\n if ($e->getCode() == '23505' || $e->getCode() == '23000') { \/\/ PostgreSQL veya MySQL unique violation\n echo \"Event zaten mevcut (muhtemelen ayn\u0131 anda i\u015flendi): \" . $sorobanEvent['txHash'] . PHP_EOL;\n return;\n }\n throw $e; \/\/ Di\u011fer hatalar\u0131 yeniden f\u0131rlat\n }\n\n\n \/\/ Event verilerini ayr\u0131\u015ft\u0131r\n $parsedData = parseSorobanEventData($sorobanEvent);\n\n \/\/ Ayr\u0131\u015ft\u0131r\u0131lan verilere g\u00f6re ilgili tablolara kaydet\/g\u00fcncelle\n if ($parsedData['type'] === 'mint') {\n \/\/ NFT mint event'i\n $stmt = $pdo->prepare(\"INSERT INTO nfts (token_id, owner_address, token_uri) VALUES (?, ?, ?)\");\n $stmt->execute([\n $parsedData['token_id'],\n $parsedData['owner'],\n $parsedData['token_uri']\n ]);\n echo \"Yeni NFT mint edildi: \" . $parsedData['token_id'] . PHP_EOL;\n\n } elseif ($parsedData['type'] === 'transfer') {\n \/\/ NFT transfer event'i\n \/\/ \u00d6nce NFT'yi bulal\u0131m\n $stmt = $pdo->prepare(\"SELECT id FROM nfts WHERE token_id = ?\");\n $stmt->execute([$parsedData['token_id']]);\n $nftId = $stmt->fetchColumn();\n\n if ($nftId) {\n \/\/ Transfer kayd\u0131n\u0131 ekle\n $stmt = $pdo->prepare(\"INSERT INTO nft_transfers (nft_id, from_address, to_address) VALUES (?, ?, ?)\");\n $stmt->execute([\n $nftId,\n $parsedData['from'],\n $parsedData['to']\n ]);\n\n \/\/ NFT'nin sahibini g\u00fcncelle\n $stmt = $pdo->prepare(\"UPDATE nfts SET owner_address = ?, last_updated_at = NOW() WHERE id = ?\");\n $stmt->execute([$parsedData['to'], $nftId]);\n echo \"NFT transfer edildi ve sahip g\u00fcncellendi: \" . $parsedData['token_id'] . PHP_EOL;\n } else {\n echo \"Hata: Transfer edilen NFT bulunamad\u0131: \" . $parsedData['token_id'] . PHP_EOL;\n }\n }\n \/\/ Di\u011fer event t\u00fcrleri (sale vb.) i\u00e7in benzer mant\u0131k eklenebilir.\n}\n\n\/\/ Veritaban\u0131 ba\u011flant\u0131s\u0131\ntry {\n $pdo = new PDO('pgsql:host=localhost;dbname=soroban_nft_db', 'user', 'password'); \/\/ PostgreSQL \u00f6rne\u011fi\n $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);\n $pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);\n\n \/\/ \u00d6rnek bir Soroban event nesnesi (ger\u00e7ek RPC'den geldi\u011fini varsayal\u0131m)\n $sampleSorobanMintEvent = [\n 'txHash' => '0x123abc...', \/\/ \u00d6rnek i\u015flem hash'i\n 'ledger' => 1234567, \/\/ \u00d6rnek blok numaras\u0131\n 'contractId' => 'CONTRACT_ID_ABC',\n 'type' => 'contract', \/\/ Soroban event tipi\n 'topic' => ['AAAAAQ==', 'mint'], \/\/ Base64 encoded 'mint' string\n 'data' => 'AQIDBAUGBwgJCgsMDQ4PEBESExQVFhcYGRobHB0eHyA=' \/\/ \u00d6rnek base64 data\n ];\n\n processAndSaveSorobanEvent($sampleSorobanMintEvent, $pdo);\n\n} catch (PDOException $e) {\n echo \"Veritaban\u0131 ba\u011flant\u0131 veya i\u015flem hatas\u0131: \" . $e->getMessage() . PHP_EOL;\n} catch (Exception $e) {\n echo \"Genel Hata: \" . $e->getMessage() . PHP_EOL;\n}\n<\/pre>\nHata Y\u00f6netimi ve Yeniden Deneme Mekanizmalar\u0131<\/h3>\n
\n
try-catch<\/code> bloklar\u0131 kullanarak istisnalar\u0131 yakalay\u0131n.<\/li>\nGer\u00e7ek D\u00fcnya Senaryosu: Bir NFT Pazar Yeri Veri Senkronizasyonu<\/h2>\n
Senaryo Tan\u0131t\u0131m\u0131 ve \u0130htiya\u00e7lar<\/h3>\n
\n
Eventlerin Yakalanmas\u0131 ve Veritaban\u0131na \u0130\u015flenmesi<\/h3>\n
nfts<\/code>, nft_transfers<\/code>, nft_sales<\/code>) kaydedilir veya g\u00fcncellenir.<\/p>\n\u00d6rnek Event Ak\u0131\u015f\u0131 ve Veritaban\u0131 Etkile\u015fimi:<\/h4>\n
\n
\n
mint(token_id, owner_address, token_uri)<\/code> event'ini yay\u0131nlar.<\/li>\ntoken_id<\/code>, owner_address<\/code> ve token_uri<\/code> verileri ayr\u0131\u015ft\u0131r\u0131l\u0131r.<\/li>\nnfts<\/code> tablosuna yeni bir kay\u0131t eklenir (token_id, owner_address, token_uri ile).<\/li>\nevents<\/code> tablosuna da ham event loglan\u0131r.<\/li>\n<\/ul>\n<\/li>\n\n
transfer(from_address, to_address, token_id)<\/code> event'ini yay\u0131nlar.<\/li>\nnfts<\/code> tablosundaki ilgili token_id<\/code> kayd\u0131n\u0131n owner_address<\/code> alan\u0131 yeni sahibin adresiyle g\u00fcncellenir.<\/li>\nnft_transfers<\/code> tablosuna yeni bir transfer kayd\u0131 eklenir (nft_id, from_address, to_address ile).<\/li>\nevents<\/code> tablosuna da ham event loglan\u0131r.<\/li>\n<\/ul>\n<\/li>\n\n
sale(token_id, seller_address, buyer_address, price, currency)<\/code> event'ini yay\u0131nlar.<\/li>\nnft_sales<\/code> tablosuna yeni bir sat\u0131\u015f kayd\u0131 eklenir (nft_id, seller_address, buyer_address, price, currency ile).<\/li>\nnfts<\/code> tablosundaki owner_address<\/code> alan\u0131 g\u00fcncellenir (seller'dan buyer'a).<\/li>\nevents<\/code> tablosuna da ham event loglan\u0131r.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\nKullan\u0131c\u0131 Aray\u00fcz\u00fcnde Verilerin G\u00f6sterilmesi (PHP Laravel\/Symfony \u00d6rne\u011fi)<\/h3>\n
\n\n\/\/ Laravel Controller \u00f6rne\u011fi\nnamespace App\\Http\\Controllers;\n\nuse App\\Models\\Nft; \/\/ Eloquent modeli\nuse Illuminate\\Http\\Request;\n\nclass NftController extends Controller\n{\n public function getUserNfts(Request $request, string $userAddress)\n {\n \/\/ Veritaban\u0131ndan kullan\u0131c\u0131n\u0131n sahip oldu\u011fu NFT'leri \u00e7ek\n $nfts = Nft::where('owner_address', $userAddress)->get();\n\n return view('user.nfts', ['nfts' => $nfts, 'userAddress' => $userAddress]);\n }\n\n public function getAllListings()\n {\n \/\/ Aktif sat\u0131\u015f listelemelerini \u00e7ek (\u00f6rne\u011fin, nft_sales tablosunda 'is_active' alan\u0131 varsayarak)\n $listings = NftSale::with('nft')->where('is_active', true)->get();\n\n return view('marketplace.listings', ['listings' => $listings]);\n }\n}\n<\/pre>\nPerformans ve \u00d6l\u00e7eklenebilirlik D\u00fc\u015f\u00fcnceleri<\/h3>\n
\n
owner_address<\/code>, token_id<\/code>, transfer_time<\/code> gibi s\u0131k\u00e7a sorgulanan s\u00fctunlara uygun indeksler ekleyin.<\/li>\n\u0130leri D\u00fczey Senkronizasyon Teknikleri ve Optimizasyonlar: B\u00fcy\u00fck \u00d6l\u00e7ekli Uygulamalar \u0130\u00e7in \u0130pu\u00e7lar\u0131<\/h2>\n
Kuyruk Sistemleri (Message Queues) Kullan\u0131m\u0131<\/h3>\n
\n
\n
Veri B\u00fct\u00fcnl\u00fc\u011f\u00fc ve Tutarl\u0131l\u0131k Garantileri<\/h3>\n
\n
nfts<\/code> ve nft_transfers<\/code> tablolar\u0131), veritaban\u0131 i\u015flemlerini kullan\u0131n. Bu, t\u00fcm de\u011fi\u015fikliklerin ya ba\u015far\u0131l\u0131 bir \u015fekilde ger\u00e7ekle\u015fmesini ya da hi\u00e7birinin ger\u00e7ekle\u015fmemesini sa\u011flar (ACID \u00f6zellikleri).<\/li>\nSenkronizasyonun Monit\u00f6rlenmesi ve Loglama<\/h3>\n
\n
Veri Transformasyonu ve Zenginle\u015ftirme (Enrichment)<\/h3>\n
\n
contractId<\/code> veya owner_address<\/code> gibi bilgilerle, off-chain (zincir d\u0131\u015f\u0131) ba\u015fka veritabanlar\u0131ndan veya API'lerden ek bilgiler (\u00f6rne\u011fin, s\u00f6zle\u015fme ad\u0131, kullan\u0131c\u0131 profili resmi) \u00e7ekerek veriyi zenginle\u015ftirin. Bu zenginle\u015ftirilmi\u015f veriyi do\u011frudan veritaban\u0131na kaydederek, frontend'in daha az API \u00e7a\u011fr\u0131s\u0131 yapmas\u0131n\u0131 sa\u011flay\u0131n.<\/li>\nSonu\u00e7: Soroban-PHP Senkronizasyonunun Gelece\u011fi<\/h2>\n
S\u0131k\u00e7a Sorulan Sorular (SSS)<\/h3>\n
1. Soroban eventlerini dinlemek i\u00e7in PHP d\u0131\u015f\u0131nda hangi dilleri kullanabilirim?<\/h4>\n
2. Neden Soroban'daki verileri do\u011frudan okumak yerine veritaban\u0131na senkronize etmeliyim?<\/h4>\n
3. Senkronizasyon i\u015flemi s\u0131ras\u0131nda veri kayb\u0131n\u0131 nas\u0131l \u00f6nleyebilirim?<\/h4>\n
4. Soroban event verilerini XDR format\u0131ndan PHP'ye nas\u0131l \u00e7evirebilirim?<\/h4>\n
xdr-py<\/code>) veya Node.js (stellar-sdk<\/code>) gibi daha g\u00fc\u00e7l\u00fc XDR k\u00fct\u00fcphanelerine sahip dillerde k\u00fc\u00e7\u00fck bir mikroservis olu\u015fturarak bu d\u00f6n\u00fc\u015f\u00fcm\u00fc yap\u0131p PHP'ye haz\u0131r veriyi g\u00f6ndermeniz gerekebilir.<\/p>\n5. Senkronizasyon beti\u011fimi nas\u0131l kal\u0131c\u0131 olarak \u00e7al\u0131\u015ft\u0131rabilirim ve y\u00f6netimini nas\u0131l yapabilirim?<\/h4>\n
\n