RBN Core - Framework v0.9.7 76 belge

Core/Base/Services — servis, sağlayıcı ve yönetici tabanları

Doğrulanan kod tabanı: 1d89c431 (dal feat/fw-license-master) · Tarih: 2026-10-05 · Yayın: 0.9.7 = bu commit + sonrası; belge yalnız doğrulama anındaki kodu anlatır
Kaynak klasör: Core/Base/Services/ — 18 *.php.
Envanter: 18 dosyanın 18'i aşağıda anlatıldı.

1. Ne işe yarar, kim kullanır

İş mantığının tabanları: BaseService (tekil orkestratör; bulunmayan metotları
bağlı provider'a devreder), BaseProvider (veri erişim sağlayıcısı),
BaseManager (kanonik yönlendirme gibi istek-öncesi yöneticiler),
BasePrompt (içerik üretim şablonları). Alt trait'ler CRUD/toplu/okuma
akışlarını servis ve provider katmanında yeniden kullanılabilir hale getirir.

Kimler çağırır: Core/Services/*, Bundles/*/Services/*,
Packages/*/Services/*; controller'lar service('<alias>') ile.

2. Dosya envanteri

2.1 Kök (4)

Dosya Görev Önemli public yöntemler
BaseService.php Servis kökü; singleton (get()), aktif controller kaydı, boot(), provider'a devir (__call). boot(): void, setActiveController(object): void, activeController(): ?object, __construct(?BaseService $rbn=null), static get(): self, static forgetInstance(): void, __call(string $method,array $args)
BaseProvider.php Sağlayıcı kökü (BaseProviderInterface). __construct(?BaseService $rbn=null)
BaseManager.php Yönetici kökü; afterBoot() kancası. afterBoot(): void (protected)
BasePrompt.php İçerik üretim şablonları (şema, metin, görsel ayarları, ayar birleştirme). getSchema(array $context): array, getContentText(string $title, array $context): string, getContentTextSettings(array $context): array, getImageSettings(array $context): array, mergeSettings(array $base,array $custom): array

2.2 Traits/Provider/ (1) + Traits/Provider/Engine/ (3)

Dosya Görev Önemli yöntemler
Traits/Provider/ActionProviderTrait.php Sağlayıcı trait'lerini birleştirir. — (trait bileşimi)
Engine/CrudProviderTrait.php Sağlayıcı CRUD yüzeyi (id'li, eski imzalar dahil). save(array $data): bool\|int, create(array): int\|bool, update(int $id,array $data): bool, updateById(int $id,array $data): bool, destroy(int $id): bool, setStatusById(int $id,string $field,?bool $status=null): bool, toggleStatus(int $id,string $field='is_active'): bool, increment/decrement(int $id,string $column,int $amount=1)
Engine/BulkProviderTrait.php Sağlayıcı toplu yazma. destroyBulk(array $ids): int, toggleStatusBulk(array $ids,bool $status,string $field='is_active'): int, updateBulk(array $ids,array $data): int
Engine/ReadProviderTrait.php Sağlayıcı okuma + eager load. with($relations): self, find($id): ?array, all(): array

2.3 Traits/Service/ (1) + Blogcontent/ (4) + Engine/ (5)

Dosya Görev Önemli yöntemler
Traits/Service/ActionServiceTrait.php Servis ortak durumu (targetId, lastResult, criteria) ve sonuç/önbellek temizleme. withId(int $id): self, success(): bool, clearCache($customKeys=null,?string $projectKey=null): self
Blogcontent/ContentServiceTrait.php İçerik CRUD + listeleme + önbellek. getPosts(array $options=[]): array, savePost(array $data), destroyPost(?int $id=null): self, flushContentCache(): bool, deletePost(?int $id=null): bool, getPostBySlug(string,?string=null): ?array, getPostBySimilarSlug(string,?string=null): ?array, incrementViews(int $id): bool
Blogcontent/ContentDataServiceTrait.php Görünüm verisi üretimi (ana sayfa, liste, kategori, detay). getMappedPosts(?string $projectKey=null,array $options=[]): array, getCategory(int\|string $idOrSlug,?string=null): ?array, getListingData(?string=null,?string $search=null): array, getHomeData(?string=null,array $options=[]): array, getCategoryListingData(string $categorySlug,?string=null): array, getDetailData(string $categorySlug,string $postSlug,?string=null,?string $currentUrl=null,?string $prefix=null): array (blog-author doluysa yazı verisine author ekler: Blog-Yazar-Kunyesi)
Blogcontent/ContentMetaTrait.php Yazı içeriğine SEO/özet meta ekleme. enrichPost($post, array $contentFields=['content','author_comment'],?string $customUrl=null), blogAuthor(): ?array (blog-author / blog-author-title)
Blogcontent/ContentLegacyRedirectServiceTrait.php Eski içerik/kategori/etiket slug yönlendirmesi (WordPress kalıntıları). resolveLegacyPostRedirect(string $slug,?string $projectKey=null,string $prefix='/blog'): string, resolveLegacyCategoryRedirect(string $categorySlug,?string $projectKey=null,string $prefix='/blog'): string, resolveLegacyTagRedirect(string $tagSlug,string $prefix='/blog'): string, sanitizeLegacySlug(string): string
Engine/CrudServiceTrait.php Servis CRUD + durum değiştirme; zincir (fluent) API. create(array $data): self, update(array $data): self, updateById(int $id,array $data=[]): self, destroy(?int $id=null): self, setStatus(?int $id=null,$status=null,string $field='is_active'): self, toggleStatus(?int $id=null,$status=null,string $field='is_active'): self, save(mixed $id=null,array $data=[]), truncate(?string $modelName=null): self
Engine/BulkServiceTrait.php Toplu servis işlemleri. bulkDestroy(array $ids): self, bulkToggleStatus(array $ids,bool $status,string $field='is_active'): self, bulkUpdateOrder(array $order,string $field='order_num'): self, bulkValueUpdate(array $data): self
Engine/ReadServiceTrait.php Okuma servis yardımcıları (aktif/pasif, hiyerarşi). active(string $field='is_active',$value=1): self, passive(string $field='is_active',$value=0): self, find(int $id): ?object, all(): array, count(): int, parents(?int $excludeId=null): array, children(int $parentId): array, atCategory(int $categoryId): array
Engine/FileServiceTrait.php Geçici dosya/zip üretimi, güvenli yol çözümleme, depolama istatistiği. prepareTempFile(string $filename,string $content): string, prepareTempZip(string $filename,array $files): string, executeBulkDelete(string $directory,array $filenames): bool, calculateStorageStats(string $directory,string $pattern='*',bool $recursive=false): array, resolveSafePath(string $baseDir,string $identifier): string
Engine/FileTransferServiceTrait.php Dosya indirme/yükleme/dışa-içe aktarma (CSV). deliverFile(string $path,?string $displayName=null): void, deliverZip(array $files,?string $zipName=null): void, deliverRaw(string $content,string $filename): void, receiveUpload(string $inputName,string $targetPath,array $allowedExtensions=[]): string, exportData(array $items,array $headerMap,string $filename='export.csv',string $format='csv'): void, exportCsv(array $items,array $headerMap,string $filename): void, importCsv(string $filePath,callable $callback,string $delimiter=';'): void, contentDispositionHeader(string $filename): string

Kapsama: 18/18.

3. Akış

3.1 Servis → provider devri

$service->create($data)                 → CrudServiceTrait (varsa)
 ├─ yoksa __call()                      BaseService.php:105
 │    ├─ kısa ad: 'UserService' → 'User' → provider anahtarı 'UserProvider'  :108-110
 │    ├─ component('provider', 'UserProvider', false)  :114 (zorunlu DEĞİL)
 │    └─ varsa call_user_func_array  :117-119
 │         yoksa Exception "RBN Framework Service Error"  :121
 └─ provider->create() → CrudProviderTrait

3.2 Servis kuruluşu

new PageService()
 ├─ BaseService::__construct()          BaseService.php:52
 │    ├─ self::$instance = $this (ilk örnek kazanır)  :55-57
 │    ├─ parent::__construct($rbn) → BaseComponent → bootConcernsContext()  :60
 │    └─ $this->boot()                  :63

4. Yapılandırma

Öğe Yer Not
toggleStatus() 2. parametre uyumu CrudServiceTrait.php:46 Eski imza ($status değer) ve yeni imza ($field adı) birlikte desteklenir
bulkUpdateOrder varsayılan alanı BulkServiceTrait.php:63 order_num
ContentCacheTrait TTL ../Data.md §4 3600 sn
importCsv ayraç FileTransferServiceTrait.php:211 ';' (Excel TR varsayılanı)

5. Tuzaklar ve kurallar

  1. Singleton tek statik slottur. self::$instance static::class DEĞİLDİR;
    bu yüzden test izolasyonu için forgetInstance() vardır ve yalnız test/
    teardown çağırır (BaseService.php:31, 89-103).
  2. Provider zorunlu değildir. component('provider', $key, false) — bulunamazsa
    teşhis mesajı üretilir, istisna fırlatılmaz (BaseService.php:112).
  3. Devir sırası kesindir. __call yalnız metot serviste yoksa devreder.
  4. CrudServiceTrait::update(array $data) korunur. Yeni giriş noktası
    updateById()'dir; save() yolu bilinçli olarak değiştirilmemiştir
    (CrudServiceTrait.php:167).
  5. Eski/kayıt ID tuzağı: targetId=0 + id=42 → update(42) eskiden
    yanlış çalışıyordu; artık varlık null ayrımı kullanılır
    (CrudServiceTrait.php:140).
  6. Geçici dosyalar E:\tmp\_gecici\-benzer geçici alana yazılır; görev
    kuralı gereği çalışma dizinine yazılmaz. prepareTempFile()/
    prepareTempZip() bu yüzden sys_get_temp_dir() tabanlıdır.
  7. resolveSafePath() yol geçişini kapatır — taban dizin dışına çıkış
    reddedilir (FileServiceTrait.php:135).

6. Örnek (gerçek koddan)

// Servis CRUD (akışkan) — CrudServiceTrait.php:126, 221
$service = $this->service('page');
$ok = $service->updateById($id, $data)->success();

// Toplu sıra güncelleme — BulkServiceTrait.php:63
$this->service('sidebarMenu')->bulkUpdateOrder([12 => 1, 13 => 2]);

// Eski WordPress yolu yönlendirmesi — ContentLegacyRedirectServiceTrait.php:19
$hedef = $this->resolveLegacyPostRedirect('yazi-slug', $projectKey, '/blog');

7. İlgili belgeler

© 2026 RBN Core. Tüm hakları saklıdır.
| Site Haritası
Powered by RBN Core - Framework