cycle / schema-builder

src/Relation/Morphed/BelongsToMorphed.php

<?php
/**
 * Cycle ORM Schema Builder.
 *
 * @license   MIT
 * @author    Anton Titov (Wolfy-J)
 */
declare(strict_types=1);

namespace Cycle\Schema\Relation\Morphed;

use Cycle\ORM\Relation;
use Cycle\Schema\Exception\RelationException;
use Cycle\Schema\InversableInterface;
use Cycle\Schema\Registry;
use Cycle\Schema\Relation\RelationSchema;
use Cycle\Schema\Relation\Traits\FieldTrait;
use Cycle\Schema\Relation\Traits\MorphTrait;
use Cycle\Schema\RelationInterface;

class BelongsToMorphed extends RelationSchema implements InversableInterface
{
    use FieldTrait, MorphTrait;

    // internal relation type
    protected const RELATION_TYPE = Relation::BELONGS_TO_MORPHED;

    // relation schema options
    protected const RELATION_SCHEMA = [
        // save with parent
        Relation::CASCADE                => true,

        // nullable by default
        Relation::NULLABLE               => true,

        // default field name for inner key
        Relation::OUTER_KEY              => '{target:primaryKey}',

        // link to parent entity primary key by default
        Relation::INNER_KEY              => '{relation}_{outerKey}',

        // link to parent entity primary key by default
        Relation::MORPH_KEY              => '{relation}_role',

        // rendering options
        RelationSchema::INDEX_CREATE     => true,
        RelationSchema::MORPH_KEY_LENGTH => 32
    ];

    /**
     * @param Registry $registry
     */
    public function compute(Registry $registry)
    {
        // compute local key
        $this->options = $this->options->withContext([
            'source:primaryKey' => $this->getPrimary($registry->getEntity($this->source))
        ]);

        $source = $registry->getEntity($this->source);

        list($outerKey, $outerField) = $this->findOuterKey($registry, $this->target);

        // register primary key reference
        $this->options = $this->options->withContext(['target:primaryKey' => $outerKey]);

        // create target outer field
        $this->ensureField(
            $source,
            $this->options->get(Relation::INNER_KEY),
            $outerField,
            $this->options->get(Relation::NULLABLE)

It seems like $this->options->get(Cycle\ORM\Relation::NULLABLE) can also be of type string; however, parameter $nullable of Cycle\Schema\Relation\Morphed\BelongsToMorphed::ensureField() does only seem to accept boolean, maybe add an additional type check?

        );

        $this->ensureMorphField(
            $source,
            $this->options->get(Relation::MORPH_KEY),
            $this->options->get(RelationSchema::MORPH_KEY_LENGTH),

It seems like $this->options->get(Cycle\Schema\Relation\RelationSchema::MORPH_KEY_LENGTH) can also be of type string; however, parameter $lenght of Cycle\Schema\Relation\Morphed\BelongsToMorphed::ensureMorphField() does only seem to accept integer, maybe add an additional type check?

            $this->options->get(Relation::NULLABLE)

It seems like $this->options->get(Cycle\ORM\Relation::NULLABLE) can also be of type string; however, parameter $nullable of Cycle\Schema\Relation\Morphed\BelongsToMorphed::ensureMorphField() does only seem to accept boolean, maybe add an additional type check?

        );
    }

    /**
     * @param Registry $registry
     */
    public function render(Registry $registry)
    {
        $source = $registry->getEntity($this->source);

        $innerField = $this->getField($source, Relation::INNER_KEY);
        $morphField = $this->getField($source, Relation::MORPH_KEY);

        $table = $registry->getTableSchema($source);

        if ($this->options->get(self::INDEX_CREATE)) {
            $table->index([$innerField->getColumn(), $morphField->getColumn()]);
        }
    }

    /**
     * @param Registry $registry
     * @return array
     */
    public function inverseTargets(Registry $registry): array
    {
        return iterator_to_array($this->findTargets($registry, $this->target));
    }

    /**
     * @param RelationInterface $relation
     * @param string            $into
     * @return RelationInterface
     *
     * @throws RelationException
     */
    public function inverseRelation(RelationInterface $relation, string $into): RelationInterface
    {
        if (!$relation instanceof MorphedHasOne && !$relation instanceof MorphedHasMany) {
            throw new RelationException(
                "BelongsToMorphed relation can only be inversed into MorphedHasOne or MorphedHasMany"
            );
        }

        return $relation->withContext(
            $into,
            $this->target,
            $this->source,
            $this->options->withOptions([
                Relation::INNER_KEY => $this->options->get(Relation::OUTER_KEY),
                Relation::OUTER_KEY => $this->options->get(Relation::INNER_KEY),
            ])
        );
    }
}