Overtrue\LaravelVersionable\Versionable

Complexity

Total Complexity

44

Size/Duplication

Total Lines	284
Duplicated Lines	0 %

Importance

Changes	5
Bugs	0	Features	0

<?php
use Illuminate\Database\Eloquent\Relations\MorphOne;
use Illuminate\Support\Collection;
use function array_diff_key;
use function array_intersect_key;
use function array_keys;
use function config;
use function property_exists;
use function optional;

/**
 * Trait Versionable
 * @package CalamandreiLorenzo\LaravelVersionable
 * @author 安正超 - overtrue
 * @github https://github.com/overtrue
 * @property-read Collection|Version[] versions
 * @property-read Version lastVersion
 */
trait Versionable
{
    /**
     * @var bool $versioning
     */
    protected static bool $versioning = true;

This code did not parse for me. Apparently, there is an error somewhere around this line:

Syntax error, unexpected T_STRING, expecting T_FUNCTION or T_CONST

    /**
     * @var bool $forceDeleteVersion
     */
    protected bool $forceDeleteVersion = false;

    // You can add these properties to you versionable model
    //protected $versionable = [];
    //protected $dontVersionable = ['*'];

    /**
     * bootVersionable
     * @noinspection PhpUnused
     * @noinspection UnknownInspectionInspection
     */
    public static function bootVersionable(): void
    {
        static::saved(static function (Model $model) {
            self::createVersionForModel($model);
        });

        static::deleted(static function (Model $model) {
            if (property_exists($model, 'forceDeleting') && $model->forceDeleting) {
                /**
                 * @var Versionable|Model $model
                 */
                $model->forceRemoveAllVersions();
            } else {
                self::createVersionForModel($model);
            }
        });
    }

    /**
     * createVersionForModel
     * @param Versionable|Model $model
     * @throws Exceptions\NotVersionableModel
     */
    private static function createVersionForModel(Model $model): void
    {
        if (self::$versioning && $model->shouldVersioning()) {
            Version::createForModel($model);
            $model->removeOldVersions($model->getKeepVersionsCount());
        }
    }

    /**
     * versions
     * @return MorphMany
     */
    public function versions(): MorphMany
    {
        return $this->morphMany(
            config('versionable.version_model'),
            'versionable'
        )->latest('version_number');
    }


    /**
     * lastVersion
     * @return MorphOne
     */
    public function lastVersion(): MorphOne
    {
        return $this->morphOne(
            config('versionable.version_model'),
            'versionable'
        )->latest('version_number');
    }

    /**
     * getVersion
     * @param $id
     * @return Model|null
     */
    public function getVersion($id): ?Model
    {
        return $this->versions()->find($id);
    }

    /**
     * getVersion
     * @param int $id
     * @return Model|null
     */
    public function getVersionByVersionNumber(int $id): ?Model
    {
        return $this->versions()->where('version_number', $id)->first();
    }

    /**
     * getThrashedVersions
     * @return mixed
     */
    public function getThrashedVersions()
    {
        /** @noinspection PhpUndefinedMethodInspection */
        return $this->versions()->onlyTrashed()->get();
    }

    /**
     * restoreThrashedVersion
     * @param $id
     * @return mixed
     */
    public function restoreThrashedVersion($id)
    {
        /** @noinspection PhpUndefinedMethodInspection */
        return $this->versions()->onlyTrashed()->whereId($id)->restore();
    }

    /**
     * revertToVersion
     * @param $id
     * @return mixed
     */
    public function revertToVersion($id)
    {
        return optional($this->versions()->findOrFail($id))->revert();
    }

    /**
     * revertToVersionNumber
     * @param int $id
     * @return mixed
     */
    public function revertToVersionNumber(int $id)
    {
        return optional(
            $this->versions()->where('version_number', $id)->firstOrFail()
        )->revert();
    }

    /**
     * removeOldVersions
     * @param int $keep
     */
    public function removeOldVersions(int $keep): void
    {
        if ($keep <= 0) {
            return;
        }

        /** @noinspection PhpUndefinedMethodInspection */
        $this->versions()->skip($keep)->take(PHP_INT_MAX)->get()->each->delete();
    }

    /**
     * removeVersions
     * @param array $ids
     * @return mixed
     */
    public function removeVersions(array $ids)
    {
        if ($this->forceDeleteVersion) {
            return $this->forceRemoveVersions($ids);
        }

        return $this->versions()->find($ids)->each->delete();
    }

    /**
     * removeVersion
     * @param $id
     * @return bool|mixed|null
     * @throws Exception
     */
    public function removeVersion($id)
    {
        if ($this->forceDeleteVersion) {
            return $this->forceRemoveVersion($id);
        }

        return optional($this->versions()->findOrFail($id))->delete();
    }

    /**
     * removeAllVersions
     */
    public function removeAllVersions(): void
    {
        if ($this->forceDeleteVersion) {
            $this->forceRemoveAllVersions();
        }

        /** @noinspection PhpUndefinedMethodInspection */
        $this->versions->each->delete();
    }

    /**
     * forceRemoveVersion
     * @param $id
     * @return mixed
     */
    public function forceRemoveVersion($id)
    {
        return optional($this->versions()->findOrFail($id))->forceDelete();
    }

    /**
     * forceRemoveVersions
     * @param array $ids
     * @return mixed
     */
    public function forceRemoveVersions(array $ids)
    {
        return $this->versions()->find($ids)->each->forceDelete();
    }

    /**
     * forceRemoveAllVersions
     */
    public function forceRemoveAllVersions(): void
    {
        /** @noinspection PhpUndefinedMethodInspection */
        $this->versions->each->forceDelete();
    }

    /**
     * shouldVersioning
     * @return bool
     */
    public function shouldVersioning(): bool
    {
        return !empty($this->getVersionableAttributes());
    }

    /**
     * getVersionableAttributes
     * @return array
     */
    public function getVersionableAttributes(): array
    {
        $changes = $this->getDirty();

        if (empty($changes)) {
            return [];
        }

        $contents = $this->attributesToArray();

        if ($this->getVersionStrategy() === VersionStrategy::DIFF) {
            $contents = $this->only(array_keys($changes));
        }

        return $this->versionableFromArray($contents);
    }

    /**
     * setVersionable
     * @param array $attributes
     * @return $this
     * @throws Exception
     */
    public function setVersionable(array $attributes): self
    {
        if (!property_exists($this, 'versionable')) {
            throw new MissingVersionableProperty('Property $versionable not exist.');
        }
        $this->versionable = $attributes;
        return $this;