68 lines
2.1 KiB
PHP
68 lines
2.1 KiB
PHP
<?php
|
|
|
|
namespace Illuminate\Database\Eloquent\Relations;
|
|
|
|
use Illuminate\Database\Eloquent\Collection as EloquentCollection;
|
|
use Illuminate\Database\Eloquent\Model;
|
|
use Illuminate\Database\Eloquent\Relations\Concerns\InteractsWithDictionary;
|
|
use Illuminate\Database\Eloquent\Relations\Concerns\SupportsDefaultModels;
|
|
|
|
/**
|
|
* @template TRelatedModel of \Illuminate\Database\Eloquent\Model
|
|
* @template TIntermediateModel of \Illuminate\Database\Eloquent\Model
|
|
* @template TDeclaringModel of \Illuminate\Database\Eloquent\Model
|
|
*
|
|
* @extends \Illuminate\Database\Eloquent\Relations\HasOneOrManyThrough<TRelatedModel, TIntermediateModel, TDeclaringModel, ?TRelatedModel>
|
|
*/
|
|
class HasOneThrough extends HasOneOrManyThrough
|
|
{
|
|
use InteractsWithDictionary, SupportsDefaultModels;
|
|
|
|
/** @inheritDoc */
|
|
public function getResults()
|
|
{
|
|
return $this->first() ?: $this->getDefaultFor($this->farParent);
|
|
}
|
|
|
|
/** @inheritDoc */
|
|
public function initRelation(array $models, $relation)
|
|
{
|
|
foreach ($models as $model) {
|
|
$model->setRelation($relation, $this->getDefaultFor($model));
|
|
}
|
|
|
|
return $models;
|
|
}
|
|
|
|
/** @inheritDoc */
|
|
public function match(array $models, EloquentCollection $results, $relation)
|
|
{
|
|
$dictionary = $this->buildDictionary($results);
|
|
|
|
// Once we have the dictionary we can simply spin through the parent models to
|
|
// link them up with their children using the keyed dictionary to make the
|
|
// matching very convenient and easy work. Then we'll just return them.
|
|
foreach ($models as $model) {
|
|
if (isset($dictionary[$key = $this->getDictionaryKey($model->getAttribute($this->localKey))])) {
|
|
$value = $dictionary[$key];
|
|
$model->setRelation(
|
|
$relation, reset($value)
|
|
);
|
|
}
|
|
}
|
|
|
|
return $models;
|
|
}
|
|
|
|
/**
|
|
* Make a new related instance for the given model.
|
|
*
|
|
* @param TDeclaringModel $parent
|
|
* @return TRelatedModel
|
|
*/
|
|
public function newRelatedInstanceFor(Model $parent)
|
|
{
|
|
return $this->related->newInstance();
|
|
}
|
|
}
|