Eloquent کیا ہے اور آپ models کو کیسے استعمال کرتے ہیں؟

Question

Accepted Answer

**Eloquent** Laravel کا ORM (Object-Relational Mapper) ہے — یہ **Active Record** pattern استعمال کرتا ہے، جہاں ہر database table کے لیے ایک متعلقہ **Model** class ہوتی ہے، اور model instances rows کی نمائندگی کرتے ہیں۔ یہ database کو query کرنے اور manipulate کرنے کا ایک elegant، expressive طریقہ فراہم کرتا ہے بغیر SQL لکھے۔

## ایک model کی تعریف

```php
<?php
class User extends Model {
    // by convention, the User model maps to the "users" table automatically
    protected $fillable = ['name', 'email'];   // mass-assignable fields (security)
}
// generate with: php artisan make:model User
```

ایک model `Model` کو extend کرتا ہے اور naming convention کے ذریعے table سے map کرتا ہے (`User` → `users`)۔ `$fillable` list اس بات کو کنٹرول کرتی ہے کہ کون سے fields mass-assigned ہو سکتے ہیں (ایک security feature)۔

## CRUD operations (Active Record)

```php
// CREATE
$user = User::create(['name' => 'Ann', 'email' => 'ann@x.com']);
$user = new User; $user->name = 'Bob'; $user->save();

// READ
User::all();                              // all rows
User::find(1);                            // by primary key
User::where('active', true)->get();        // query with conditions
User::where('email', $email)->first();     // first match

// UPDATE
$user->update(['name' => 'New Name']);
$user->name = 'X'; $user->save();

// DELETE
$user->delete();
User::destroy(1);
```

Eloquent کا fluent، chainable API تقریباً English کی طرح پڑھا جاتا ہے اور آپ کے لیے SQL generate کرتا ہے — عام operations کے لیے کوئی raw queries نہیں۔

## Fluent builder کے ساتھ querying

```php
User::where('age', '>', 18)
    ->where('active', true)
    ->orderBy('name')
    ->limit(10)
    ->get();                              // chainable query building

User::where('role', 'admin')->count();
User::where('email', $e)->exists();
```

## Models صرف data سے زیادہ ہیں

```php
class Post extends Model {
    public function author() {                          // a relationship
        return $this->belongsTo(User::class);
    }
    public function getExcerptAttribute() {              // an accessor (computed attribute)
        return Str::limit($this->body, 100);
    }
}
$post->author;       // the related User
$post->excerpt;       // computed attribute
```

## یہ کیوں اہم ہے

Eloquent Laravel کے لیے مرکزی ہے — یہ وہ طریقہ ہے جس سے applications database کے ساتھ interact کرتی ہیں، اور اس کا elegant Active Record design framework کی سب سے زیادہ منظور خصوصیات میں سے ایک ہے، اس لیے اسے master کرنا کسی بھی Laravel development کے لیے ضروری ہے۔

یہ سمجھنا کہ models کو کیسے define کریں (tables کو convention کے ذریعے map کرنا)، CRUD operations کو کیسے انجام دیں، اور fluent، chainable builder کے ساتھ کیسے query کریں، روزمرہ کی، بنیادی معلومات ہے کیونکہ data access اکثر applications کے لیے core ہے۔

Eloquent کا expressive، readable API (`User::where(...)->orderBy(...)->get()`) آپ کو database کے ساتھ صاف PHP میں کام کرنے دیتا ہے بغیر SQL لکھے، جو productivity اور readability کو dramatically بہتر بناتا ہے۔

Models صرف data containers سے زیادہ ہیں — وہ **relationships** (متعلقہ tables کو جوڑنا) اور **accessors/mutators** (computed attributes) اور business logic define کر سکتے ہیں، جو انہیں rich domain objects بناتا ہے۔

`$fillable` mass-assignment protection (ایک security consideration) کو جاننا بھی اہم ہے۔

چونکہ Eloquent وہ طریقہ ہے جس سے Laravel applications اپنا data پڑھتے اور لکھتے ہیں — اور یہ virtually ہر Laravel app میں نمودار ہوتا ہے — models اور Eloquent کے query API کو master کرنا foundational ہے، لازمی معلومات ہے جو مؤثر Laravel development کو support کرتی ہے۔