ما هي الـ Traits ومتى تستخدمها؟

Question

Accepted Answer

**الـ trait** هي آلية لـ **إعادة استخدام الكود عبر عدة classes** غير مرتبطة بالوراثة. بما أن PHP تسمح فقط بالوراثة الفردية، فإن الـ traits توفر طريقة لمشاركة الـ methods (والـ properties) بشكل أفقي — وهي شكل من أشكال إعادة استخدام الكود "التركيبي"، مثل الـ mixins.

## المشكلة التي تحلها الـ Traits

```text
PHP has single inheritance — a class can extend only ONE parent. But you often want
to share the SAME methods across unrelated classes (e.g. logging, timestamps).
Duplicating the code is bad; traits let you reuse it without inheritance.
```

## تعريف واستخدام الـ Trait

```php
<?php
trait Timestampable {
    private ?DateTime $createdAt = null;

public function setCreatedAt(): void {
        $this->createdAt = new DateTime();
    }
    public function getCreatedAt(): ?DateTime {
        return $this->createdAt;
    }
}

trait Loggable {
    public function log(string $msg): void {
        echo "[" . static::class . "] $msg";
    }
}

// a class can USE MULTIPLE traits — their methods become part of the class
class Article {
    use Timestampable, Loggable;     // mix in BOTH traits' methods
}

$a = new Article();
$a->setCreatedAt();    // from Timestampable
$a->log("created");     // from Loggable
```

الـ trait هي مجموعة من الـ methods والـ properties. تقوم الـ class بـ `use` لـ trait واحد أو أكثر لـ **خلط** أعضائها — مما يوفر الوظيفة دون الوراثة من parent مشترك.

## الـ Traits مقابل الوراثة مقابل الـ Interfaces

```text
Inheritance (extends) → single parent, "is-a", inherits implementation
Interface → a CONTRACT (signatures only, no code), multiple allowed
Trait → reusable IMPLEMENTATION (actual code), multiple allowed, NO contract
→ Interfaces say WHAT a class can do; traits provide HOW (shared code).
  They're often used together: implement an interface, use a trait for the impl.
```

## حل التضارب

```php
class X {
    use TraitA, TraitB {
        TraitA::hello insteadof TraitB;   // if both define hello(), pick TraitA's
        TraitB::hello as helloB;           // alias TraitB's version
    }
}
```

عندما تعرّف trait اثنتان نفس الـ method، يجعلك PHP تحل التضارب بشكل صريح.

## لماذا يهمك ذلك

الـ Traits هي ميزة PHP مهمة لـ **إعادة استخدام الكود عبر classes غير مرتبطة**، وتحل قيداً حقيقياً: بما أن PHP تسمح فقط بالوراثة الفردية، فإن الـ traits توفر إعادة استخدام أفقية (mixins) لمشاركة الوظيفة المشتركة — مثل الـ logging، timestamps، soft-deletes، serialization helpers — عبر classes التي لا تشترك في parent واحد.

فهمها قيّم لأنها تُستخدم على نطاق واسع في أطر عمل PHP (يستخدم Laravel's Eloquent الـ traits بشكل واسع لسلوكيات النماذج مثل `SoftDeletes` و `HasFactory`)، لذا ستواجهها وتستخدمها باستمرار.

معرفة كيفية اختلاف الـ traits عن الوراثة (إعادة استخدام بدون علاقة is-a) وعن الـ interfaces (الـ traits توفر **implementation** فعلية/كود، بينما الـ interfaces تحدد فقط **contract**/signatures — والاثنان غالباً ما يُدمجان معاً: interface يعلن عن الإمكانية، و trait يوفر تنفيذاً مشتركاً) هو المفتاح لاستخدامها بشكل صحيح.

الـ Traits تُمكّن من تصاميم DRY وتركيبية لا تستطيع الوراثة الفردية وحدها تحقيقها، مما يجعلها معرفة عملية وشائعة لكل من كتابة كود PHP قابل لإعادة الاستخدام وفهم الأطر المبنية حولها. (التحفظ: الإفراط في استخدام الـ traits يمكن أن يخفي مصدر السلوك، لذا استخدمها لإعادة الاستخدام الحقيقية عبر الأنظمة، وليس كخيار افتراضي.)