Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
54 changes: 54 additions & 0 deletions Eloquent/Builder.php
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@
use Illuminate\Database\Eloquent\Concerns\QueriesRelationships;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;
use Illuminate\Database\Eloquent\Relations\Relation;
use Illuminate\Database\Eloquent\ModelNotFoundException;
use Illuminate\Database\Query\Builder as QueryBuilder;
use Illuminate\Database\RecordsNotFoundException;
use Illuminate\Database\UniqueConstraintViolationException;
Expand Down Expand Up @@ -638,6 +639,59 @@ public function findOrFail($id, $columns = ['*'])
return $result;
}

/**
* Find a model by its primary key and eager load relations.
*
* @param mixed $id
* @param array $relations
* @param array|string $columns
* @return ($id is (\Illuminate\Contracts\Support\Arrayable<array-key, mixed>|array<mixed>)
* ? \Illuminate\Database\Eloquent\Collection<int, TModel>
* : TModel|null)
*/
public function findWith($id, array $relations = [], $columns = ['*'])
{
return $this->with($relations)->find($id, $columns);
}

/**
* Find a model by its primary key and eager load relations or throw an exception.
*
* @param mixed $id
* @param array $relations
* @param array|string $columns
* @return ($id is (\Illuminate\Contracts\Support\Arrayable<array-key, mixed>|array<mixed>)
* ? \Illuminate\Database\Eloquent\Collection<int, TModel>
* : TModel)
*
* @throws \Illuminate\Database\Eloquent\ModelNotFoundException<TModel>
*/
public function findOrFailWith($id, array $relations = [], $columns = ['*'])
{
$result = $this->findWith($id, $relations, $columns);

$id = $id instanceof Arrayable ? $id->toArray() : $id;

if (is_array($id)) {
if (count($result) !== count(array_unique($id))) {
throw (new ModelNotFoundException)->setModel(
get_class($this->model), array_diff($id, $result->modelKeys())
);
}

return $result;
}

if (is_null($result)) {
throw (new ModelNotFoundException)->setModel(
get_class($this->model), $id
);
}

return $result;
}


/**
* Find a model by its primary key or return fresh model instance.
*
Expand Down
Loading