ForwardsCalls-trait

Wat is de ForwardsCalls-trait

Illuminate\Support\Traits\ForwardsCalls is een trait die het delegeren van methodes naar een ander object standaardiseert. In Laravel zelf wordt hij gebruikt in “wrapper-objecten” zoals Eloquent en Mail.

De implementatie staat in src/Illuminate/Support/Traits/ForwardsCalls.php. Als je een niet-bestaande methode doorstuurt, wordt de fout opnieuw gegooid als een BadMethodCallException met de naam van de aanroepende klasse erin.

Kern-API

`forwardCallTo($object, $method, $parameters)`

Stuurt een methode ongewijzigd door naar het opgegeven object. Meestal roep je dit aan vanuit __call().

`forwardDecoratedCallTo($object, $method, $parameters)`

Gebruik je wanneer je in een Builder of Decorator de chain wilt behouden. Als de doorgestuurde methode “het doelobject zelf” teruggeeft, wordt dit vervangen door “het aanroepende object ($this)”.

Combineren met `call()` / `callStatic()`

ForwardsCalls levert zelf geen magic methods. Je implementeert in je eigen klasse __call() (en zo nodig __callStatic()) en roept daarbinnen de forwardCallTo-methodes aan.

Praktijkvoorbeelden (binnen Laravel)

Facades bieden een static proxy

Illuminate\Support\Facades\Facade delegeert via __callStatic() rechtstreeks naar de root instance. Omdat facades statische aanroepen zijn, gebruikt de implementatie directe forwarding in plaats van ForwardsCalls.

De Eloquent Builder gebruikt forwardCallTo

Illuminate\Database\Eloquent\Builder::__call() geeft onopgeloste methodes met forwardCallTo($this->query, ...) door aan de interne Query Builder en geeft daarna $this terug om de fluent chain te behouden.

Relation / Mail / Event gebruiken forwardDecoratedCallTo

In Illuminate\Database\Eloquent\Relations\Relation, Illuminate\Mail\Message en Illuminate\Events\NullDispatcher wordt forwardDecoratedCallTo gebruikt: er wordt gedelegeerd naar het interne object, terwijl de chain van de buitenste API behouden blijft.

Basisimplementatie van een proxy (`forwardCallTo`)

use Illuminate\Support\Traits\ForwardsCalls;

class CourierProxy
{
    use ForwardsCalls;

    public function __construct(
        protected CourierDriver $driver
    ) {}

    public function __call(string $method, array $parameters): mixed
    {
        return $this->forwardCallTo($this->driver, $method, $parameters);
    }
}

In deze vorm kan CourierProxy de publieke API van CourierDriver transparant blootstellen.

Proxy met method chaining (`forwardDecoratedCallTo`)

use Illuminate\Database\Eloquent\Builder;
use Illuminate\Support\Traits\ForwardsCalls;

class QueryProxy
{
    use ForwardsCalls;

    public function __construct(
        protected Builder $query
    ) {}

    public function __call(string $method, array $parameters): static
    {
        $this->forwardDecoratedCallTo($this->query, $method, $parameters);

        return $this;
    }

    public function get(): \Illuminate\Support\Collection
    {
        return $this->query->get();
    }
}

$users = (new QueryProxy(User::query()))
    ->where('active', true)
    ->orderByDesc('created_at')
    ->limit(10)
    ->get();

In plaats van handmatig return $this te schrijven, is het veiliger om te vertrouwen op de regel van forwardDecoratedCallTo: “als de returnwaarde het doelobject zelf is, vervang die dan door $this”.

Automatisch gooien van BadMethodCallException

Als je een niet-bestaande methode aanroept, gooit ForwardsCalls een BadMethodCallException opnieuw met de naam van de aanroepende klasse.

try {
    (new CourierProxy($driver))->missingMethod();
} catch (\BadMethodCallException $e) {
    // Bijv.: Call to undefined method App\Services\CourierProxy::missingMethod()
    report($e);
}

Zo kan de gebruiker meteen achterhalen “in welke buitenste API het misging”.

Vergelijking met Macroable

Aspect	`Macroable`	`ForwardsCalls`
Doel	Nieuwe methodes toevoegen aan een bestaande klasse	Methodes delegeren naar een ander object
Belangrijkste ingang	`macro()`, `mixin()`	`forwardCallTo()`, `forwardDecoratedCallTo()`
Geschikt voor	API-uitbreiding	Proxy / Decorator / Adapter

Als je ForwardsCalls gebruikt terwijl je eigenlijk “methodes wilt toevoegen”, zullen methodes die het doelobject niet heeft altijd falen. Kies Macroable als API-uitbreiding je doel is.

Toepassingen in pakketontwikkeling

1) Een Manager die van driver wisselt

use Illuminate\Support\Traits\ForwardsCalls;

class SmsManager
{
    use ForwardsCalls;

    public function __construct(
        protected SmsDriver $driver
    ) {}

    public function via(string $name): static
    {
        $this->driver = app(SmsDriverFactory::class)->make($name);

        return $this;
    }

    public function __call(string $method, array $parameters): mixed
    {
        return $this->forwardCallTo($this->driver, $method, $parameters);
    }
}

2) Een Adapter met meerdere backends

Verschillende backends zoals HTTP, Queue of WebSocket kun je onder één API verenigen en de aanroepen delegeren.

3) Spy / Stub voor tests

Je kunt een Spy injecteren in plaats van de echte driver, de aanroepen via forwardCallTo gewoon laten doorstromen en vervolgens het aantal aanroepen en de argumenten verifiëren.

Gerelateerde pagina’s

Macroable-trait

Leer het uitbreidingspatroon waarmee je nieuwe methodes toevoegt aan bestaande klassen.

Conditionable-trait

Leer hoe je voorwaardelijke chains ontwerpt met when() / unless().

AI-ontwikkeling

Design patterns

Package-ontwikkeling

Applicatiestructuur

Nieuwe functies in Laravel 13

Eloquent in detail

Validatie-uitbreidingen

Authenticatie uitbreiden

Beveiliging

Queues

Testen

Wat is de ForwardsCalls-trait

Kern-API

`forwardCallTo($object, $method, $parameters)`

`forwardDecoratedCallTo($object, $method, $parameters)`

Combineren met `call()` / `callStatic()`

Praktijkvoorbeelden (binnen Laravel)

Basisimplementatie van een proxy (`forwardCallTo`)

Proxy met method chaining (`forwardDecoratedCallTo`)

Automatisch gooien van BadMethodCallException

Vergelijking met Macroable

Toepassingen in pakketontwikkeling

1) Een Manager die van driver wisselt

2) Een Adapter met meerdere backends

3) Spy / Stub voor tests

Gerelateerde pagina’s

Macroable-trait

Conditionable-trait

​Wat is de ForwardsCalls-trait

​Kern-API

​forwardCallTo($object, $method, $parameters)

​forwardDecoratedCallTo($object, $method, $parameters)

​Combineren met __call() / __callStatic()

​Praktijkvoorbeelden (binnen Laravel)

​Basisimplementatie van een proxy (forwardCallTo)

​Proxy met method chaining (forwardDecoratedCallTo)

​Automatisch gooien van BadMethodCallException

​Vergelijking met Macroable

​Toepassingen in pakketontwikkeling

​1) Een Manager die van driver wisselt

​2) Een Adapter met meerdere backends

​3) Spy / Stub voor tests

​Gerelateerde pagina’s

Macroable-trait

Conditionable-trait

Wat is de ForwardsCalls-trait

Kern-API

`forwardCallTo($object, $method, $parameters)`

`forwardDecoratedCallTo($object, $method, $parameters)`

Combineren met `call()` / `callStatic()`

Praktijkvoorbeelden (binnen Laravel)

Basisimplementatie van een proxy (`forwardCallTo`)

Proxy met method chaining (`forwardDecoratedCallTo`)

Automatisch gooien van BadMethodCallException

Vergelijking met Macroable

Toepassingen in pakketontwikkeling

1) Een Manager die van driver wisselt

2) Een Adapter met meerdere backends

3) Spy / Stub voor tests

Gerelateerde pagina’s