> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Eloquent-collecties

> Uitleg over de speciale methoden van Illuminate\Database\Eloquent\Collection en het maken van eigen collecties.

## Aan de slag

Wanneer je met Eloquent meerdere modellen ophaalt, krijg je het resultaat terug als een `Illuminate\Database\Eloquent\Collection`.\
Omdat deze klasse `Illuminate\Support\Collection` extendt, kun je de methoden van de basiscollectie gewoon gebruiken.

```mermaid theme={null}
classDiagram
    class "Illuminate\\Support\\Collection" as SupportCollection
    class "Illuminate\\Database\\Eloquent\\Collection" as EloquentCollection
    SupportCollection <|-- EloquentCollection
```

```php theme={null}
use App\Models\User;

$users = User::where('active', true)->get();

foreach ($users as $user) {
    echo $user->name;
}
```

Als je eerst de basis van [collecties](/nl/collections) en de [introductie tot Eloquent](/nl/eloquent) doorneemt, begrijp je de uitbreidingen van Eloquent-collecties gemakkelijker.

## Beschikbare methoden

`Eloquent\Collection` erft alle methoden van de basiscollectie en voegt daar methoden voor modellen aan toe.

### `append` / `withoutAppends` / `setAppends`

Hiermee bewerk je de extra attributen bij serialisatie (appends) voor de hele collectie.

```php theme={null}
$users->append('team');
$users->append(['team', 'is_admin']);

$users = $users->withoutAppends();
$users = $users->setAppends(['is_admin']);
```

### `contains` / `diff` / `except` / `intersect` / `only`

Voert op basis van modelinstanties of primaire sleutels controles op aanwezigheid, verschil, doorsnede, uitsluiting en selectie uit.

```php theme={null}
use App\Models\User;

$users->contains(1);
$users->contains(User::find(1));

$subset = User::whereIn('id', [1, 2, 3])->get();

$users->diff($subset);
$users->intersect($subset);

$users->except([1, 2, 3]);
$users->only([1, 2, 3]);
```

### `find` / `findOrFail`

Zoekt een model op primaire sleutel in een al opgehaalde collectie.

```php theme={null}
$users = User::all();

$user = $users->find(1);
$user = $users->findOrFail(1);
```

### `fresh`

Haalt elk model in de collectie opnieuw op met de nieuwste toestand uit de database.

```php theme={null}
$users = $users->fresh();
$users = $users->fresh('comments');
```

### `load` / `loadMissing`

Hiermee kun je op een al opgehaalde collectie achteraf relaties eager loaden.

```php theme={null}
$users->load(['comments', 'posts']);
$users->load('comments.author');
$users->load(['comments', 'posts' => fn ($query) => $query->where('active', 1)]);

$users->loadMissing(['comments', 'posts']);
$users->loadMissing('comments.author');
$users->loadMissing(['comments', 'posts' => fn ($query) => $query->where('active', 1)]);
```

### `modelKeys`

Haalt de lijst met primaire sleutels van de modellen in de collectie op.

```php theme={null}
$users->modelKeys();
// [1, 2, 3, ...]
```

### `makeVisible` / `makeHidden` / `mergeVisible` / `mergeHidden` / `setVisible` / `setHidden`

Hiermee pas je op collectieniveau de zichtbare en verborgen attributen bij serialisatie aan.

```php theme={null}
$users = $users->makeVisible(['address', 'phone_number']);
$users = $users->makeHidden(['address', 'phone_number']);

$users = $users->mergeVisible(['middle_name']);
$users = $users->mergeHidden(['last_login_at']);

$users = $users->setVisible(['id', 'name']);
$users = $users->setHidden(['email', 'password', 'remember_token']);
```

### `partition`

Splitst op basis van een voorwaarde in twee `Eloquent\Collection`-instanties; de buitenkant wordt teruggegeven als `Illuminate\Support\Collection`.

```php theme={null}
$partition = $users->partition(fn ($user) => $user->age > 18);

dump($partition::class);    // Illuminate\Support\Collection
dump($partition[0]::class); // Illuminate\Database\Eloquent\Collection
dump($partition[1]::class); // Illuminate\Database\Eloquent\Collection
```

### `toQuery`

Maakt een `whereIn`-query op de primaire sleutels van de opgehaalde modellen, zodat je ze in bulk kunt bijwerken of verwijderen.

```php theme={null}
use App\Models\User;

// Haal eerst de gebruikers op die aan de voorwaarde voldoen
$vipUsers = User::where('status', 'VIP')->get();

// Werk alleen de collectie in bulk bij
$vipUsers->toQuery()->update([
    'status' => 'Administrator',
]);
```

<Tip>
  In plaats van een lus met losse `save()`-aanroepen kun je met `toQuery()` één bulkquery maken; zo combineer je in de praktijk prestaties met leesbaarheid.
</Tip>

### `unique`

Verwijdert dubbele modellen met dezelfde primaire sleutel.

```php theme={null}
$users = $users->unique();
```

## Van Eloquent-collectie naar basiscollectie

`collapse`, `flatten`, `flip`, `keys`, `pluck` en `zip` geven een `Illuminate\Support\Collection` terug.\
Ook als het resultaat van `map` geen Eloquent-modellen bevat, wordt het omgezet naar de basiscollectie.

## Eigen collecties

Wil je een collectieklasse specifiek voor een model gebruiken, kies dan eerst de aanpak met het `#[CollectedBy]`-attribuut; dat is het duidelijkst.

### Het `#[CollectedBy]`-attribuut (aanbevolen)

```php theme={null}
<?php

namespace App\Models;

use App\Support\UserCollection;
use Illuminate\Database\Eloquent\Attributes\CollectedBy;
use Illuminate\Database\Eloquent\Model;

#[CollectedBy(UserCollection::class)]
class User extends Model
{
    // ...
}
```

### De `newCollection()`-methode (alternatief)

```php theme={null}
<?php

namespace App\Models;

use App\Support\UserCollection;
use Illuminate\Database\Eloquent\Collection;
use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    public function newCollection(array $models = []): Collection
    {
        $collection = new UserCollection($models);

        if (Model::isAutomaticallyEagerLoadingRelationships()) {
            $collection->withRelationshipAutoloading();
        }

        return $collection;
    }
}
```

Zodra je `newCollection()` of `#[CollectedBy]` definieert, wordt je eigen collectie teruggegeven op de plekken waar normaal een `Eloquent\Collection` terugkomt.\
Wil je dit op alle modellen toepassen, definieer dan `newCollection()` in een gemeenschappelijk basismodel.

## Gerelateerde pagina's

<Card title="Collecties" icon="list" href="/nl/collections">
  Bekijk eerst de basisbewerkingen van `Illuminate\\Support\\Collection`.
</Card>

<Card title="Introductie tot Eloquent" icon="database" href="/nl/eloquent">
  Fris de basis van modellen en queries op voordat je met Eloquent-collecties aan de slag gaat.
</Card>


## Related topics

- [Higher-order messages van collecties](/nl/advanced/higher-order-messages.md)
- [Laravel AI SDK](/nl/ai-sdk.md)
- [Eloquent-serialisatie](/nl/eloquent-serialization.md)
- [Eloquent API-resources](/nl/eloquent-resources.md)
- [Macroable-trait](/nl/advanced/macroable.md)