Weave Code
Code Weaver
Helps Laravel developers discover, compare, and choose open-source packages. See popularity, security, maintainers, and scores at a glance to make better decisions.
Feedback
Share your thoughts, report bugs, or suggest improvements.
Subject
Message
Log in Register
Home
Packages
Laravel Model States
Changelog

Laravel Model States Laravel Package

spatie/laravel-model-states

Add robust state behavior to Laravel Eloquent models using the state pattern and state machines. Represent each state as a class, cast states transparently to/from the database, and define clear, safe transitions with configurable state logic.

View on GitHub
Deep Wiki
Context7
2.13.1

What's Changed

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.13.0...2.13.1

2.13.0

What's Changed

  • Add Laravel 13 support
2.12.2

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.12.1...2.12.2

2.12.1

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.12.0...2.12.1

2.12.0

What's Changed

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.11.3...2.12.0

2.11.3

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.11.2...2.11.3

2.11.2

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.11.1...2.11.2

2.11.1

What's Changed

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.11.0...2.11.1

2.11.0

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.10.1...2.11.0

2.10.1

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.10.0...2.10.1

2.10.0

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.9.0...2.10.0

2.9.0

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.8.0...2.9.0

2.8.0

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.7.2...2.8.0

2.7.2

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.7.1...2.7.2

2.7.1

What's Changed

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.7.0...2.7.1

2.7.0

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.6.2...2.7.0

2.6.2

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.6.1...2.6.2

2.6.1

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.6.0...2.6.1

2.6.0

What's Changed

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.5.0...2.6.0

2.5.0

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.4.6...2.5.0

2.4.6

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.4.5...2.4.6

2.4.5

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.4.4...2.4.5

2.4.4

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.4.3...2.4.4

2.4.3

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.4.2...2.4.3

2.4.2

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.4.1...2.4.2

2.4.1

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.4.0...2.4.1

2.4.0

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.3.0...2.4.0

2.3.0
2.2.0
  • Better internal use of getMorphClass (#198)
2.1.2
  • Support for custom transition classes in transitionableStates method
2.1.1
  • Support for custom transition classes' canTransition in State::canTransitionTo (#185)
2.1.0
  • Add default transition config (#159)
2.0.2
  • Add State::getModel() and State::getField()
2.0.1
  • Fix bug on two consecutive transitions (#145)
2.0.0

The biggest change in v2 is that states now know which fields they belong to. So instead of having to pass in fields like so:

$model->canTransitionTo(StateB::class, 'status');

You can now do:

$model->status->canTransitionTo(StateB::class);

This change means that a lot of boilerplate code can be removed. Also keep in mind that this package wants you to always use state objects, and never their serialized values. That's why many other methods have been removed, in favour of Laravel's built-in model casts.

  • States aren't configured on models anymore, but on the state class itself. Refer to the docs for more info.
  • HasStates::transitionableStates(string $fromClass, string $field) has been removed.
  • State::transitionableStates() now doesn't need the $field parameter anymore.
  • HasStates::getStates() now returns the morph values instead of the hardcoded class names.
  • Default states are only set on model creations.
  • State::find() has been removed.
  • State::isOneOf() is removed, State::equals now accepts multiple state objects or morph classes.
  • State::is() is removed, you should use State::equals().
  • Dropped support for Laravel 5, 6, and 7. The minimal required version is laravel/framework:^8
  • Dropped support for PHP 7.2 and 7.3. The minimal required version is php:^7.4
  • Proper support for finalState in StateChanged event
1.9.1
  • add support for PHP 8.0 (#141)
1.9.0
  • add support for Laravel 8 (#101)
1.8.0
  • Add getters for TransitionNotFound attributes (#99)
1.7.0
  • Add canTransitionTo (#92)
1.6.3
  • Support 0 state (#89)
1.6.2
  • Support model::updated state casting (#88, 351c008)
1.6.1
  • change static:: call to self:: for private State::resolveStateMapping method (#75)
1.6.0
  • add support for Laravel 7
1.5.1
  • Add support for fully qualified column names in whereState scope (#63)
1.5.0
  • ❗️ $finalState in the StateChanged event is deprecated and will always be null. This is because of a fix for bug #49. This fix might have unforeseen effects if you're using StateChanged.
1.4.2
  • Fix for unknown $modelClass variable (#47)
1.4.1
  • Return Eloquent model when using transitionTo method directly (#33)
1.4.0
  • Add better exceptions and Ignition support (#23)
1.3.1
1.3.0
  • Allow to get transitional states (#17)
1.2.0
  • Add state listing methods (#21)
1.1.3
  • Proper support for non-string columns
1.1.2
  • Proper support for JSON serialise
1.1.1
  • Default support via new
1.1.0
  • Improved default support
1.0.1
  • Properly handle corrupt state values from the database
1.0.0
  • initial release
What's
New

Full Changelog: https://github.com/spatie/laravel-model-states/compare/2.1.4...2.2.0

Weaver

How can I help you explore Laravel packages today?

Conversation history is not saved when not logged in.
Prompt
Add packages to context
No packages found.
davejamesmiller/laravel-breadcrumbs
artisanry/parsedown
christhompsontldr/phpsdk
enqueue/dsn
bunny/bunny
enqueue/test
enqueue/null
enqueue/amqp-tools
milesj/emojibase
bower-asset/punycode
bower-asset/inputmask
bower-asset/jquery
bower-asset/yii2-pjax
laravel/nova
spatie/laravel-mailcoach
spatie/laravel-superseeder
laravel/liferaft
nst/json-test-suite
danielmiessler/sec-lists
jackalope/jackalope-transport