InteractsWithData-trait

Wat is de InteractsWithData-trait

Illuminate\Support\Traits\InteractsWithData is een trait die “een gemeenschappelijke API voor array-achtige invoerdata” bundelt. De trait zelf vereist slechts twee abstracte methodes, all() en data(), en delegeert de logica voor het ophalen van de echte data aan elke klasse. In ruil daarvoor levert hij een verzameling veelgebruikte methodes:

Bestaanscontrole: has(), hasAny(), exists(), missing()
Leegtecontrole: filled(), isNotFilled(), anyFilled()
Voorwaardelijke uitvoering: whenHas(), whenFilled(), whenMissing()
Extractie: only(), except()
Typeconversie: string(), boolean(), integer(), float(), date(), enum(), collect()

Relatie met de Request-methodes

De Illuminate\Http\Request die je via de request()-helper krijgt, neemt InteractsWithData op via Concerns\InteractsWithInput. Daardoor wordt alledaagse toegang tot invoer zoals hieronder via de trait geleverd.

$search = request()->input('search');

if (request()->has('search')) {
    $filters = request()->only(['search', 'status']);
}

$payload = request()->except(['_token']);

Request::get() is een Symfony-compatibele methode op de Request-klasse zelf. Ook in de broncode van Laravel 13 staat expliciet @deprecated use ->input() instead; de aanbevolen methode is input().

$legacy = request()->get('search');  // Compatibiliteitsmethode (aanbevolen is input())

Belangrijkste implementaties in de Laravel-core

Klassen die `InteractsWithData` rechtstreeks gebruiken

Klasse	Doel
`Illuminate\Http\Concerns\InteractsWithInput`	Invoertoegangs-API van `Request`
`Illuminate\Support\ValidatedInput`	Wrapper voor de returnwaarde van `validated()` / `safe()`
`Illuminate\Support\Fluent`	Fluent bewerken van configuratiewaarden en willekeurige attributen
`Illuminate\Support\UriQueryString`	Querystring-bewerkingen van `Uri`
`Illuminate\View\ComponentAttributeBag`	Bewerken van Blade-componentattributen

Verwante implementaties met vergelijkbare verantwoordelijkheden

Illuminate\Session\Store implementeert zelf een vergelijkbare API met has(), get(), only(), except() enzovoort
Illuminate\Validation\Concerns\ValidatesAttributes levert de validatielogica; de invoertoegangs-API zelf is als een aparte verantwoordelijkheid van InteractsWithData ontworpen

Relatie tussen de trait en de belangrijkste klassen

Inbouwen in eigen klassen bij pakketontwikkeling

InteractsWithData is geschikt voor klassen in een pakket die “een invoerarray bewaren en een Laravel-achtige ophaal-API willen bieden”.

Maak een datacontainerklasse

namespace Vendor\Package\Support;

use Illuminate\Support\Arr;
use Illuminate\Support\Traits\InteractsWithData;

class OptionBag
{
    use InteractsWithData;

    /**
     * @param  array<string, mixed>  $items
     */
    public function __construct(
        protected array $items = [],
    ) {}

    public function all($keys = null): array
    {
        if (! $keys) {
            return $this->items;
        }

        $result = [];

        $keyList = is_array($keys) ? $keys : [$keys];

        foreach ($keyList as $key) {
            Arr::set($result, $key, Arr::get($this->items, $key));
        }

        return $result;
    }

    protected function data($key = null, $default = null): mixed
    {
        return data_get($this->items, $key, $default);
    }
}

Lees veilig met getypeerde accessors

$options = new OptionBag([
    'feature.enabled' => 'true',
    'retry.max' => '5',
    'channels' => ['mail', 'slack'],
]);

$enabled = $options->boolean('feature.enabled'); // true
$retryMax = $options->integer('retry.max');      // 5
$channels = $options->collect('channels');       // Collection
$public = $options->except(['secret']);          // secret uitsluiten

Praktische use cases

Een option bag voor een externe API-client
Een normalisatielaag voor webhook-payloads
Een klasse die configuratie-overrides van een pakket oplost

Als je alleen all() en data() implementeert, hoef je de invoertoegangs-API niet telkens zelf te bouwen en houd je de onderhoudskosten laag.

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 InteractsWithData-trait

Relatie met de Request-methodes

Belangrijkste implementaties in de Laravel-core

Klassen die `InteractsWithData` rechtstreeks gebruiken

Verwante implementaties met vergelijkbare verantwoordelijkheden

Relatie tussen de trait en de belangrijkste klassen

Inbouwen in eigen klassen bij pakketontwikkeling

Praktische use cases

Gerelateerde pagina’s

​Wat is de InteractsWithData-trait

​Relatie met de Request-methodes

​Belangrijkste implementaties in de Laravel-core

​Klassen die InteractsWithData rechtstreeks gebruiken

​Verwante implementaties met vergelijkbare verantwoordelijkheden

​Relatie tussen de trait en de belangrijkste klassen

​Inbouwen in eigen klassen bij pakketontwikkeling

​Praktische use cases

​Gerelateerde pagina’s

Wat is de InteractsWithData-trait

Relatie met de Request-methodes

Belangrijkste implementaties in de Laravel-core

Klassen die `InteractsWithData` rechtstreeks gebruiken

Verwante implementaties met vergelijkbare verantwoordelijkheden

Relatie tussen de trait en de belangrijkste klassen

Inbouwen in eigen klassen bij pakketontwikkeling

Praktische use cases

Gerelateerde pagina’s