السمات في PHP: use وعدة سمات وinsteadof

السمة في PHP كتلة قابلة لإعادة الاستخدام من التوابع والخصائص. تصرّح بها بـ trait Name { ... } وتجلبها إلى أي صنف بـ use Name; داخل جسم الصنف. تنسخ PHP أعضاء السمة إلى الصنف، فتعمل تمامًا كأنك كتبتها هناك.

<?php
trait Greets
{
    public function hello(): string
    {
        return 'Hello from ' . static::class;
    }
}

class User
{
    use Greets;
}

class Robot
{
    use Greets;
}

echo (new User())->hello(), "\n";
echo (new Robot())->hello(), "\n";

ليس لـ User وRobot أب مشترك، ومع ذلك صار لكليهما hello(). وُجدت السمات لهذه الحالة: أصناف PHP لا ترث إلا صنفًا واحدًا، والسمة تشارك الشيفرة أفقيًا، بين أصناف غير مترابطة.

السمات مع الخصائص

تستطيع السمة جلب خصائص مع توابعها. وتستخدم التوابع $this مثل أي تابع في الصنف، لأنها بعد نسخ السمة تصبح توابع الصنف:

<?php
trait HasTimestamps
{
    protected ?string $createdAt = null;
    protected ?string $updatedAt = null;

    public function touch(string $now): void
    {
        $this->createdAt ??= $now;
        $this->updatedAt = $now;
    }

    public function timestamps(): string
    {
        return "created {$this->createdAt}, updated {$this->updatedAt}";
    }
}

class Post
{
    use HasTimestamps;

    public function __construct(public string $title) {}
}

$post = new Post('Traits in PHP');
$post->touch('2026-03-14 09:30');
$post->touch('2026-03-15 18:05');
echo $post->title, ': ', $post->timestamps(), "\n";

لا يجوز للصنف التصريح بخاصية بالاسم نفسه لخاصية في السمة ما لم يتطابق التصريحان (الرؤية والنوع والقيمة الافتراضية نفسها)؛ وإلا فهو خطأ فادح.

استخدام عدة سمات

اذكر عدة سمات في جملة use واحدة، مفصولة بفواصل، أو اكتب عدة أسطر use. ويحصل الصنف على أعضائها كلها:

<?php
trait Loggable
{
    private array $log = [];

    public function log(string $msg): void
    {
        $this->log[] = $msg;
    }

    public function history(): array
    {
        return $this->log;
    }
}

trait Sluggable
{
    public function slug(string $text): string
    {
        return trim(preg_replace('/[^a-z0-9]+/', '-', strtolower($text)), '-');
    }
}

class Article
{
    use Loggable, Sluggable;

    public function __construct(public string $title)
    {
        $this->log("created '$title'");
    }

    public function url(): string
    {
        $url = '/blog/' . $this->slug($this->title);
        $this->log("url built: $url");
        return $url;
    }
}

$a = new Article('PHP Traits, Explained!');
echo $a->url(), "\n";
print_r($a->history());

حل التعارضات بـ insteadof وas

عندما تعرّف سمتان تابعًا بالاسم نفسه، ترفض PHP التخمين وتتوقف بخطأ فادح. داخل كتلة use، تختار insteadof الفائز، وتُبقي as التابع الخاسر باسم آخر:

<?php
trait EnglishGreeting
{
    public function greet(): string { return 'Hello'; }
}

trait FrenchGreeting
{
    public function greet(): string { return 'Bonjour'; }
}

class Host
{
    use EnglishGreeting, FrenchGreeting {
        EnglishGreeting::greet insteadof FrenchGreeting;
        FrenchGreeting::greet as greetFrench;
    }
}

$h = new Host();
echo $h->greet(), "\n";
echo $h->greetFrench(), "\n";

مع use EnglishGreeting, FrenchGreeting; عادية دون كتلة، يتوقف السكربت قبل طباعة أي شيء:

PHP Fatal error:  Trait method FrenchGreeting::greet has not been applied as Host::greet, because of collision with EnglishGreeting::greet in /home/index.php on line 12

تستطيع as أيضًا تغيير الرؤية. تجعل use Loggable { log as protected; } التابع log() من السمة محميًا في هذا الصنف فقط، وتضيف use Loggable { log as private writeLog; } اسمًا بديلًا خاصًا.

الأعضاء المجردة والساكنة في السمة

تستطيع السمة أن تطلب شيئًا من الصنف الذي يستخدمها بالتصريح بتابع مجرد. ويمكن أن تكون لها أيضًا توابع ساكنة وخصائص ساكنة. وكل صنف يستخدم السمة يحصل على نسخته الخاصة من الخاصية الساكنة:

<?php
trait CountsInstances
{
    private static int $instances = 0;

    public static function created(): int
    {
        return self::$instances;
    }

    // The using class must say what it is called
    abstract public function label(): string;

    public function register(): string
    {
        self::$instances++;
        return $this->label() . ' #' . self::$instances;
    }
}

class Car
{
    use CountsInstances;

    public function label(): string { return 'Car'; }
}

class Bike
{
    use CountsInstances;

    public function label(): string { return 'Bike'; }
}

echo (new Car())->register(), "\n";
echo (new Car())->register(), "\n";
echo (new Bike())->register(), "\n";
echo 'Cars: ', Car::created(), ', Bikes: ', Bike::created(), "\n";

يعدّ Car وBike كلٌّ على حدة، لأن الخاصية الساكنة تُنسخ إلى كل صنف. وهذا يختلف عن خاصية ساكنة مصرّح بها في صنف أب مشترك، يتشاركها كل الأبناء؛ وتعرض صفحة static تلك الحالة.

أي تابع يفوز: الصنف أم السمة أم الأب

إذا وُجد اسم التابع نفسه في الصنف ذاته، وفي سمة يستخدمها، وفي صنفه الأب، تختار PHP بهذا الترتيب: تابع الصنف نفسه، ثم تابع السمة، ثم تابع الأب. وداخل السمة، تظل parent:: تصل إلى نسخة الأب:

<?php
class Base
{
    public function hello(): string { return 'Base'; }
    public function bye(): string { return 'Base bye'; }
}

trait Friendly
{
    public function hello(): string { return 'Trait, then ' . parent::hello(); }
    public function bye(): string { return 'Trait bye'; }
}

class Child extends Base
{
    use Friendly;

    public function bye(): string { return 'Child bye'; }
}

$c = new Child();
echo $c->hello(), "\n";  // trait overrides parent
echo $c->bye(), "\n";    // class overrides trait

السمة ليست نوعًا

لا تطابق instanceof سمة أبدًا، والمعامل الذي نوعه اسم سمة يرفض كل كائن بـ TypeError. لتسأل «هل لهذا الصنف هذا السلوك»، اقرن السمة بواجهة، أو افحص الصنف بـ class_uses():

<?php
interface Exportable
{
    public function export(): array;
}

trait ExportsProperties
{
    public function export(): array
    {
        return get_object_vars($this);
    }
}

class Invoice implements Exportable
{
    use ExportsProperties;

    public function __construct(public int $id = 7, public float $total = 99.5) {}
}

$inv = new Invoice();
print_r($inv->export());

var_dump($inv instanceof Exportable);
print_r(class_uses($inv));

النمط أعلاه هو المعتاد: الواجهة Exportable هي ما تلمّح به الدوال وما تفحصه instanceof، والسمة ExportsProperties تنفيذ جاهز تستطيع الأصناف استخدامه أو استبداله. السمة وحدها شيفرة مشتركة بلا عقد؛ وعندما تلاحظ أنك تفحص class_uses() في منطق العمل، فالسمة كانت تحتاج إلى واجهة بجانبها. وللشيفرة المشتركة بين عائلة من الأصناف المترابطة، قد يكون الصنف المجرد الخيار الأبسط.