De tap()-helper en de Tappable-trait

Wat is tap()?

tap() is een helper om “een waarde te gebruiken en diezelfde waarde ongewijzigd terug te geven”. Je gebruikt hem wanneer je een bijeffect wilt tussenvoegen. De implementatie in Illuminate\Support\helpers.php is eenvoudig.

function tap($value, $callback = null)
{
    if (is_null($callback)) {
        return new HigherOrderTapProxy($value);
    }

    $callback($value);

    return $value;
}

tap() negeert de returnwaarde van de callback. De returnwaarde is altijd de oorspronkelijke waarde.

Basisgebruik

Het meest basale gebruik is: een waarde ontvangen, verwerken en ongewijzigd teruggeven.

use App\Models\User;

$user = tap(User::query()->latest()->firstOrFail(), function (User $model) {
    $model->update(['last_seen_at' => now()]);
});

// $user wordt teruggegeven, ongeacht de returnwaarde van update()

Laat je de callback weg, dan krijg je een HigherOrderTapProxy terug, zodat je direct methodeaanroepen kunt doorketenen.

$updatedUser = tap($user)->update([
    'name' => $name,
    'email' => $email,
]);

// Niet de returnwaarde van update() maar de oorspronkelijke User-instantie wordt teruggegeven

Veelvoorkomende toepassingen

Debugoutput tussenvoegen

$result = tap($query->get(), function ($users) {
    logger()->debug('Fetched users', ['count' => $users->count()]);
});

Logging of events invoegen midden in een keten

$order = tap(Order::create($payload), function (Order $order) {
    event(new OrderCreated($order));
    logger()->info('Order created', ['id' => $order->id]);
});

Alleen een bijeffect uitvoeren zonder de returnwaarde te wijzigen

$response = tap($service->handle($request), function ($response) {
    \Illuminate\Support\Facades\Cache::increment('service_handle_success_total');
});

Wil je de returnwaarde bewerken, gebruik dan with() of een gewone variabeletoewijzing. tap() blijft het leesbaarst als je hem beperkt tot bijeffecten.

Wat is de Tappable-trait?

Door Illuminate\Support\Traits\Tappable te usen, voeg je een tap()-methode toe aan je klasse.

trait Tappable
{
    public function tap($callback = null)
    {
        return tap($this, $callback);
    }
}

De trait biedt dus alleen een instantiemethode-versie van tap().

use Illuminate\Support\Traits\Tappable;

class ReportBuilder
{
    use Tappable;
}

$builder = new ReportBuilder();

$builder = $builder->tap(function (ReportBuilder $instance) {
    logger()->debug('builder initialized');
});

Toepassing in packageontwikkeling

Tappable is handig wanneer je halverwege een fluent API een bijeffect wilt tussenvoegen. In combinatie met Macroable en Conditionable maak je een uitbreidbare builder in Laravel-stijl.

Maak een fluente klasse

use Illuminate\Support\Traits\Conditionable;
use Illuminate\Support\Traits\Macroable;
use Illuminate\Support\Traits\Tappable;

class QueryPresetBuilder
{
    use Macroable;
    use Conditionable;
    use Tappable;

    protected array $filters = [];

    public function where(string $key, mixed $value): static
    {
        $this->filters[$key] = $value;

        return $this;
    }

    public function toArray(): array
    {
        return $this->filters;
    }
}

Combineer Macroable, Conditionable en Tappable

QueryPresetBuilder::macro('forActiveUsers', function () {
    /** @var QueryPresetBuilder $this */
    return $this->where('active', true);
});

$filters = (new QueryPresetBuilder)
    ->forActiveUsers()
    ->when($request->filled('role'), fn ($builder) => $builder->where('role', $request->role))
    ->tap(fn ($builder) => logger()->debug('current filters', $builder->toArray()))
    ->toArray();

Gerelateerde pagina’s:

Macroable-trait
Conditionable-trait
VOICEVOX for Laravel — een praktijkvoorbeeld waarin je TalkAudioQuery en SongAudioQuery met tap() bijstelt voordat je ze naar generate() stuurt

Gebruiksvoorbeelden in de Laravel-core

Ook in Laravel zelf worden tap() / Tappable daadwerkelijk gebruikt.

Illuminate\Routing\Router gebruikt Macroable en Tappable samen
In Router::respondWithRoute() wordt tap($route)->bind(...) zonder callback gebruikt, zodat na het uitvoeren van bind() nog steeds de oorspronkelijke $route wordt teruggegeven
In Router::prepareResponse() wordt na het converteren van de response met tap(..., fn (...) => event(...)) een event afgevuurd
In Illuminate\Testing\Fluent\Concerns\Has wordt assertie-ondersteuning geïmplementeerd met de keten ->tap(...)->first(...)->etc()

// Uit Illuminate\Routing\Router
$route = tap($this->routes->getByName($name))->bind($this->currentRequest);

return tap(static::toResponse($request, $response), function ($response) use ($request) {
    $this->events->dispatch(new ResponsePrepared($request, $response));
});

Op zichzelf is tap() een kleine helper, maar samen met Macroable en Conditionable bouw je er makkelijk de leesbare methodeketens mee die je vaak in Laravel ziet.

Volgende stappen

Macroable-trait

Leer het ontwerp waarmee je eigen methodes toevoegt aan bestaande klassen.

Conditionable-trait

Leer conditionele ketens 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

De tap()-helper en de Tappable-trait

Wat is tap()?

Basisgebruik

Veelvoorkomende toepassingen

Debugoutput tussenvoegen

Logging of events invoegen midden in een keten

Alleen een bijeffect uitvoeren zonder de returnwaarde te wijzigen

Wat is de Tappable-trait?

Toepassing in packageontwikkeling

Gebruiksvoorbeelden in de Laravel-core

Volgende stappen

Macroable-trait

Conditionable-trait

​Wat is tap()?

​Basisgebruik

​Veelvoorkomende toepassingen

​Debugoutput tussenvoegen

​Logging of events invoegen midden in een keten

​Alleen een bijeffect uitvoeren zonder de returnwaarde te wijzigen

​Wat is de Tappable-trait?

​Toepassing in packageontwikkeling

​Gebruiksvoorbeelden in de Laravel-core

​Volgende stappen

Macroable-trait

Conditionable-trait

Wat is tap()?

Basisgebruik

Veelvoorkomende toepassingen

Debugoutput tussenvoegen

Logging of events invoegen midden in een keten

Alleen een bijeffect uitvoeren zonder de returnwaarde te wijzigen

Wat is de Tappable-trait?

Toepassing in packageontwikkeling

Gebruiksvoorbeelden in de Laravel-core

Volgende stappen