שליטה ב-Eloquent ORM: הגדרת Laravel ואופטימיזציה של שאילתות N+1

שליטה ב-Eloquent ORM: הגדרת Laravel ואופטימיזציה של שאילתות N+1

בעיה נפוצה: Eloquent איטי עקב שאילתות N+1, יחסים שגויים, או אינדקסים חסרים. זה גורם לזמני טעינת עמוד מעל 2 שניות ועומס גבוה על מסד הנתונים. לדוגמה, בפרויקט אחד צמצמנו שאילתות מ-150 ל-5, והאצנו את עמוד הקטלוג מ-3.5 שניות ל-0.3 שניות — פי 10 מהר יותר. אנו מגדירים Eloquent ORM במפתח סגור, ומתקנים את צווארי הבקבוק הללו. לצוות שלנו יש ניסיון של 5+ שנים עם Laravel והוא ביצע אופטימיזציה ליותר מ-50 פרויקטים, תוך הפחתת שאילתות בעד 90% והאצת תגובות פי 3–5. מאמר זה מכסה את מחזור ההגדרה המלא: מהתצורה ועד טכניקות מתקדמות כמו mutators ו-global scopes. צרו קשר להערכת פרויקט – ננתח את מסד הנתונים הנוכחי שלכם ונציע תוכנית אופטימיזציה.

תיעוד Laravel ממליץ להשתמש ב-preventLazyLoading בסביבת פיתוח.

תצורת חיבור

config/database.php — שנה רק פרמטרים קריטיים, השאר מגיע מ-.env:

'pgsql' => [
    'driver' => 'pgsql',
    'url' => env('DATABASE_URL'),
    'host' => env('DB_HOST', '127.0.0.1'),
    'port' => env('DB_PORT', '5432'),
    'database' => env('DB_DATABASE', 'forge'),
    'username' => env('DB_USERNAME', 'forge'),
    'password' => env('DB_PASSWORD', ''),
    'charset' => 'utf8',
    'prefix' => '',
    'search_path' => 'public',
    'sslmode' => env('DB_SSLMODE', 'prefer'),
    'options' => [
        PDO::ATTR_PERSISTENT => env('DB_PERSISTENT', false),
        PDO::ATTR_TIMEOUT => 10,
    ],
],

לייצור מאחורי פרוקסי הפוך, הגדר 'pgsql' => [ 'driver' => 'pgsql', 'url' => env('DATABASE_URL'), 'host' => env('DB_HOST', '127.0.0.1'), 'port' => env('DB_PORT', '5432'), 'database' => env('DB_DATABASE', 'forge'), 'username' => env('DB_USERNAME', 'forge'), 'password' => env('DB_PASSWORD', ''), 'charset' => 'utf8', 'prefix' => '', 'search_path' => 'public', 'sslmode' => env('DB_SSLMODE', 'prefer'), 'options' => [ PDO::ATTR_PERSISTENT => env('DB_PERSISTENT', false), PDO::ATTR_TIMEOUT => 10, ], ], — חיבורים מתמשכים מתנגשים עם pgBouncer במצב עסקאות.

מודל

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Casts\Attribute;
use Illuminate\Database\Eloquent\SoftDeletes;
use Illuminate\Database\Eloquent\Builder;

class Product extends Model
{
    use SoftDeletes;

    protected $table = 'products';

    protected $fillable = [
        'title',
        'slug',
        'price',
        'status',
        'category_id',
    ];

    protected $casts = [
        'price' => 'decimal:2',
        'meta' => 'array', // JSON колонка
        'published_at' => 'datetime',
        'is_featured' => 'boolean',
    ];

    // Scope для фильтрации
    public function scopePublished(Builder $query): Builder
    {
        return $query->where('status', 'published');
    }

    public function scopeInCategory(Builder $query, int $categoryId): Builder
    {
        return $query->where('category_id', $categoryId);
    }

    // Computed attribute (Laravel 9+)
    protected function priceWithTax(): Attribute
    {
        return Attribute::make(
            get: fn () => round($this->price * 1.2, 2),
        );
    }

    // Отношения
    public function category(): \Illuminate\Database\Eloquent\Relations\BelongsTo
    {
        return $this->belongsTo(Category::class);
    }

    public function tags(): \Illuminate\Database\Eloquent\Relations\BelongsToMany
    {
        return $this->belongsToMany(Tag::class, 'product_tags')
            ->withTimestamps();
    }

    public function images(): \Illuminate\Database\Eloquent\Relations\HasMany
    {
        return $this->hasMany(ProductImage::class)->orderBy('sort_order');
    }
}

מיגרציות

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    public function up(): void
    {
        Schema::create('products', function (Blueprint $table) {
            $table->id();
            $table->string('title', 500);
            $table->string('slug', 520)->unique();
            $table->foreignId('category_id')->constrained()->restrictOnDelete();
            $table->decimal('price', 12, 2);
            $table->string('status', 20)->default('draft');
            $table->jsonb('meta')->nullable();
            $table->boolean('is_featured')->default(false);
            $table->timestamp('published_at')->nullable();
            $table->timestamps();
            $table->softDeletes();
            $table->index(['status', 'created_at']);
            $table->index(['category_id', 'status']);
        });
    }

    public function down(): void
    {
        Schema::dropIfExists('products');
    }
};

ATTR_PERSISTENT = false יוצר מפתח זר בשם <?php namespace App\Models; use Illuminate\Database\Eloquent\Model; use Illuminate\Database\Eloquent\Casts\Attribute; use Illuminate\Database\Eloquent\SoftDeletes; use Illuminate\Database\Eloquent\Builder; class Product extends Model { use SoftDeletes; protected $table = 'products'; protected $fillable = [ 'title', 'slug', 'price', 'status', 'category_id', ]; protected $casts = [ 'price' => 'decimal:2', 'meta' => 'array', // JSON колонка 'published_at' => 'datetime', 'is_featured' => 'boolean', ]; // Scope для фильтрации public function scopePublished(Builder $query): Builder { return $query->where('status', 'published'); } public function scopeInCategory(Builder $query, int $categoryId): Builder { return $query->where('category_id', $categoryId); } // Computed attribute (Laravel 9+) protected function priceWithTax(): Attribute { return Attribute::make( get: fn () => round($this->price * 1.2, 2), ); } // Отношения public function category(): \Illuminate\Database\Eloquent\Relations\BelongsTo { return $this->belongsTo(Category::class); } public function tags(): \Illuminate\Database\Eloquent\Relations\BelongsToMany { return $this->belongsToMany(Tag::class, 'product_tags') ->withTimestamps(); } public function images(): \Illuminate\Database\Eloquent\Relations\HasMany { return $this->hasMany(ProductImage::class)->orderBy('sort_order'); } } המפנה ל-<?php use Illuminate\Database\Migrations\Migration; use Illuminate\Database\Schema\Blueprint; use Illuminate\Support\Facades\Schema; return new class extends Migration { public function up(): void { Schema::create('products', function (Blueprint $table) { $table->id(); $table->string('title', 500); $table->string('slug', 520)->unique(); $table->foreignId('category_id')->constrained()->restrictOnDelete(); $table->decimal('price', 12, 2); $table->string('status', 20)->default('draft'); $table->jsonb('meta')->nullable(); $table->boolean('is_featured')->default(false); $table->timestamp('published_at')->nullable(); $table->timestamps(); $table->softDeletes(); $table->index(['status', 'created_at']); $table->index(['category_id', 'status']); }); } public function down(): void { Schema::dropIfExists('products'); } }; . foreignId('category_id')->constrained() עדיף על פני products_category_id_foreign עבור קטלוגי מוצרים: הוא מונע מחיקה מקרית של קטגוריה עם מוצרים.

כיצד להימנע משאילתות N+1 ב-Eloquent?

עבור נקודת קצה של קטלוג עם פגינציה, השתמש ב-eager loading:

$products = Product::query()
    ->published()
    ->with(['category', 'tags', 'images' => fn ($q) => $q->limit(1)])
    ->whereHas('category', fn ($q) => $q->where('is_active', true))
    ->orderBy('created_at', 'desc')
    ->paginate(24);

categories.id מבצע שלוש שאילתות נוספות במקום N+1. ה-restrictOnDelete() על תמונות הוא טריק נפוץ לתצוגות מקדימות. הגדרה נכונה של eager loading מאיצה עמודים פי 10 בהשוואה ל-lazy loading כאשר קיימים מודלים קשורים רבים. כדי למנוע N+1 באופן גלובלי בסביבת הבדיקות, הוסף cascadeOnDelete() ב-$products = Product::query() ->published() ->with(['category', 'tags', 'images' => fn ($q) => $q->limit(1)]) ->whereHas('category', fn ($q) => $q->where('is_active', true)) ->orderBy('created_at', 'desc') ->paginate(24); – זה זורק LazyLoadingViolationException על טעינה עצלה ראשונה, ומאלץ אותך לתקן את השאילתה לפני הייצור.

עסקאות

use Illuminate\Support\Facades\DB;

DB::transaction(function () use ($orderId, $items) {
    $order = Order::findOrFail($orderId);
    $order->update(['status' => 'processing']);

    foreach ($items as $item) {
        Product::where('id', $item['product_id'])
            ->decrement('stock', $item['quantity']);
    }

    $order->payments()->create([
        'amount' => $order->total,
        'gateway' => 'stripe',
    ]);
});

במקרה של חריגה, מתבצע rollback אוטומטי. הארגומנט השלישי with() מגדיר ניסיונות חוזרים במקרה של deadlock.

למה להשתמש ב-restrictOnDelete במקום cascadeOnDelete?

בקטלוג מוצרים, מחיקה מקרית של קטגוריה לא אמורה להרוס מוצרים. limit(1) מוביל לאובדן נתונים. Model::preventLazyLoading() חוסם מחיקה כל עוד קיימים רשומות קשורות. זו טעות נפוצה במיגרציות שאנו מתקנים במהלך ביקורות. בפרויקט אחד, לקוח איבד 15,000 מוצרים עקב cascade — לאחר הביקורת שלנו, שחזרנו את הנתונים והגדרנו אילוצים מתאימים.

Mutators ו-Accessors

Mutators ו-accessors הופכים ערכי תכונות בכתיבה ובקריאה. לדוגמה, באמצעות AppServiceProvider ניתן ליצור שדה וירטואלי use Illuminate\Support\Facades\DB; DB::transaction(function () use ($orderId, $items) { $order = Order::findOrFail($orderId); $order->update(['status' => 'processing']); foreach ($items as $item) { Product::where('id', $item['product_id']) ->decrement('stock', $item['quantity']); } $order->payments()->create([ 'amount' => $order->total, 'gateway' => 'stripe', ]); }); שמחושב תוך כדי תנועה. זה מפשט את טיפול הנתונים ומפחית כפילות לוגיקה. הנה דוגמה נוספת: mutator להצפנת סיסמה בשמירה:

protected function password(): Attribute { return Attribute::make( set: fn (string $value) => bcrypt($value), ); } 

שגיאות הגדרת Eloquent נפוצות

מה כלול בהגדרת Eloquent במפתח סגור

אנו גם מספקים תיעוד API והדרכה לצוות על Eloquent. אנו מבטיחים איכות ומציעים המלצות לשיפורים עתידיים. הזמינו הגדרת Eloquent במפתח סגור — מסד הנתונים שלכם יהיה מהיר ויציב. חיסכון בתשתית לאחר אופטימיזציה יכול להיות משמעותי: לדוגמה, חיסכון טיפוסי הוא $500–$2000 לחודש על אחסון עקב הפחתת עומס על מסד הנתונים וזמני תגובה מהירים יותר.

ציר זמן

הגדרת Eloquent לפרויקט Laravel חדש: מיום אחד (מודלים, מיגרציות, seeders, בדיקות בסיסיות). ביקורת ו-refactoring של פרויקטים קיימים עם בעיות N+1, אינדקסים לא אופטימליים ואילוצי FK חסרים: 1–2 ימים. קבלו ייעוץ על הפרויקט שלכם — נעריך את היקף העבודה.

הגדרה יעילה של Eloquent ORM היא לא רק על ביצועים אלא גם על תחזוקת קוד. Eloquent ORM הוא הסטנדרט עבור Laravel, והתצורה הנכונה שלו היא קריטית ליישומים ניתנים להרחבה. צרו קשר כדי להתחיל באופטימיזציה.