Skip to content
⏱️Make Laravel model versionable
Branch: master
Clone or download
Latest commit fdb54d7 Jun 5, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Create FUNDING.yml Jun 3, 2019
config CS & Readme. May 31, 2019
migrations CS & Readme. May 31, 2019
src CS & Readme. May 31, 2019
tests CS & Readme. May 31, 2019
.editorconfig wip May 31, 2019
.gitattributes wip May 31, 2019
.gitignore wip May 31, 2019
.php_cs wip May 31, 2019
.travis.yml Remove PHP 7.1 Jun 3, 2019
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Jun 2, 2019
LICENSE Create LICENSE Jun 2, 2019
README.md Update README.md Jun 5, 2019
composer.json wip May 31, 2019
phpunit.xml.dist wip May 31, 2019

README.md

laravel-versionable

⏱️ Make Laravel model versionable.

Build Status Latest Stable Version Latest Unstable Version Scrutinizer Code Quality Code Coverage Total Downloads License

It's a minimalist way to make your model support version history, and it's very simple to roll back to the specified version.

Features

  • Keep the specified number of versions.
  • Whitelist and blacklist for versionable attributes.
  • Easily roll back to the specified version.
  • Record only changed attributes.
  • Easy to customize.

Installing

$ composer require overtrue/laravel-versionable -vvv

Optional, you can publish the config file:

$ php artisan vendor:publish --provider="Overtrue\\LaravelVersionable\\ServiceProvider" --tag=config

And if you want to custom the migration of the versions table, you can publish the migration file to your database path:

$ php artisan vendor:publish --provider="Overtrue\\LaravelVersionable\\ServiceProvider" --tag=migration

Then run this command to create a database migration:

$ php artisan migrate

Usage

Add Overtrue\LaravelVersionable\Versionable trait to the model and set versionable attributes:

use Overtrue\LaravelVersionable\Versionable;

class Post extends Model
{
    use Versionable;
    
    /**
     * Versionable attributes
     *
     * @var array
     */
    protected $versionable = ['title', 'content'];
    
    <...>
}

Versions will be created on vensionable model saved.

$post = Post::create(['title' => 'version1', 'content' => 'version1 content']);
$post->update(['title' => 'version2']);

Get versions

Get all versions

$post->versions;

Get last version

$post->lastVersion;

Reversion

Reversion a model instance to the specified version:

$post->getVersion(3)->revert();

// or

$post->revertToVersion(3);

Remove All versions

$post->removeAllVersions();

Contributing

You can contribute in one of three ways:

  1. File bug reports using the issue tracker.
  2. Answer questions or fix bugs on the issue tracker.
  3. Contribute new features or update the wiki.

The code contribution process is not very formal. You just need to make sure that you follow the PSR-0, PSR-1, and PSR-2 coding guidelines. Any new code contributions must be accompanied by unit tests where applicable.

License

MIT

You can’t perform that action at this time.