architecture 6 dk okuma 25 Mart 2026

Laravel Paper ile Flat-File İçerik Yönetimi

Veritabanı bağımlılığı olmadan Markdown ve YAML frontmatter dosyalarıyla güçlü, hızlı ve taşınabilir içerik modelleri inşa edin.

Tunahan Çalışkan
Tunahan Çalışkan
Yazar & Topluluk Katkıcısı

Laravel Paper ile Flat-File İçerik Yönetimi

Geleneksel veritabanı odaklı CMS çözümleri yerine, Markdown tabanlı flat-file mimariler versiyon kontrolü, taşınabilirlik ve olağanüstü performans sağlar. jacobjoergensen/laravel-paper paketi, bu yaklaşımı Laravel'in Eloquent sözdizimiyle buluşturur.

Kurulum

Projeye Composer ile dahil edilir:

composer require jacobjoergensen/laravel-paper

Model Tanımlama

Paper modelleri normal bir Eloquent modeline çok benzer; tek fark Paper trait'i ve #[ContentPath] niteliğidir:

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use JacobJoergensen\LaravelPaper\Attributes\ContentPath;
use JacobJoergensen\LaravelPaper\Attributes\Driver;
use JacobJoergensen\LaravelPaper\Paper;

#[Driver('markdown')]
#[ContentPath('content/articles')]
class Article extends Model
{
    use Paper;

    protected $guarded = [];
}

Sorgulama Gücü

Artık dosyalarınızı Eloquent benzeri PaperQueryBuilder ile sorgulayabilirsiniz:

$articles = Article::where('category', 'laravel')
    ->whereContains('tags', 'php')
    ->get();

Git ile versiyonlanan içerikleriniz, deploy edildiği anda canlıya geçer; migration veya veritabanı yedekleme zahmeti ortadan kalkar.