Kas yra traits ir kada juos naudoti?

Question

Accepted Answer

**Trait** (savybė) yra mechanizmas **kodui pakartotinai naudoti keliose klasėse**, kurios nėra susijusios paveldėjimu. Kadangi PHP leidžia tik viengubą paveldėjimą, traits suteikia būdą bendrai naudoti metodus (ir savybes) horizontaliai — tai yra "komponuojamas" kodų pakartotinio naudojimo būdas, panašus į mixins.

## Problema, kurią sprendžia 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 apibrėžimas ir naudojimas

```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 yra metodų/savybių rinkinys. Klasė `use` vieną ar daugiau traits, kad **susimaišytų** jų narius — įgydama funkcionalumą be paveldėjimo iš bendro tėvinio elemento.

## Traits vs paveldėjimas vs sąsajos

```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.
```

## Konfliktų sprendimas

```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
    }
}
```

Kai du traits apibrėžia tą patį metodą, PHP reikalauja, kad jūs aiškiai išspręstumėte konfliktą.

## Kodėl tai svarbu

Traits yra svarbi PHP savybė **kodui pakartotinai naudoti nesusijusiose klasėse**, sprendžiant tikrą apribojimą: kadangi PHP leidžia tik viengubą paveldėjimą, traits suteikia horizontalų pakartotinį naudojimą (mixins) bendrai naudojamos funkcionalumui bendrai panaudoti — logavimui, laiko žymoms, soft-delete, serializacijos pagalbinėms funkcijoms — klasėse, kurios neturi bendro tėvinio elemento.

Jų supratimas yra vertingas, nes jie plačiai naudojami PHP karkuose (Laravel Eloquent naudoja traits modelio elgsenoms, tokioms kaip `SoftDeletes`, `HasFactory`), todėl jūs nuolat juos susidursite ir naudosite.

Žinoti, kaip traits skiriasi nuo paveldėjimo (pakartotinis naudojimas be yra santykio) ir nuo sąsajų (traits suteikia tikrą *įgyvendimą*/kodą, o sąsajos apibrėžia tik *sutartį*/signatūras — ir šie du dažnai yra derinami: sąsaja deklaruoja galimybę, trait suteikia bendrąjį įgyvendimą) yra esminis dalykas juos tinkamai naudoti.

Traits įgalina DRY, komponuojamus projektus, kurių viengubas paveldėjimas negali, todėl jie yra praktinės, dažnai sutinkamos žinios tiek rašant pakartotinai naudotiną PHP kodą, tiek suprantant aplink juos sukurtus karkus. (Išlyga: pernelyg dažnas traits naudojimas gali paslėpti, iš kur kyla elgsena, todėl naudokite juos tikram tarpiniam pakartotiniam panaudojimui, o ne kaip numatytu atveju.)