Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/spatie/laravel-model-states
State support for models
https://github.com/spatie/laravel-model-states
eloquent laravel states
Last synced: about 16 hours ago
JSON representation
State support for models
- Host: GitHub
- URL: https://github.com/spatie/laravel-model-states
- Owner: spatie
- License: mit
- Created: 2019-09-03T07:53:10.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2024-09-27T07:55:10.000Z (4 months ago)
- Last Synced: 2024-10-29T15:37:17.144Z (3 months ago)
- Topics: eloquent, laravel, states
- Language: PHP
- Homepage: https://spatie.be/docs/laravel-model-states
- Size: 450 KB
- Stars: 1,136
- Watchers: 23
- Forks: 95
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
README
# Adding state behaviour to Eloquent models
[](https://packagist.org/packages/spatie/laravel-model-states)
[](https://github.com/spatie/laravel-model-states/actions/workflows/run-tests.yml)
[](https://github.com/spatie/laravel-model-states/actions/workflows/php-cs-fixer.yml)
[](https://packagist.org/packages/spatie/laravel-model-states)
This package adds state support to models. It combines concepts from the [state pattern](https://en.wikipedia.org/wiki/State_pattern) and [state machines](https://www.youtube.com/watch?v=N12L5D78MAA).
It is recommended that you're familiar with both patterns if you're going to use this package.
To give you a feel about how this package can be used, let's look at a quick example.
Imagine a model `Payment`, which has three possible states: `Pending`, `Paid` and `Failed`. This package allows you to represent each state as a separate class, handles serialization of states to the database behind the scenes, and allows for easy state transitions.
For the sake of our example, let's say that, depending on the state, the color of a payment should differ.
Here's what the `Payment` model would look like:
```php
use Spatie\ModelStates\HasStates;
class Payment extends Model
{
use HasStates;
protected $casts = [
'state' => PaymentState::class,
];
}
```
This is what the abstract `PaymentState` class would look like:
```php
use Spatie\ModelStates\State;
use Spatie\ModelStates\StateConfig;
abstract class PaymentState extends State
{
abstract public function color(): string;
public static function config(): StateConfig
{
return parent::config()
->default(Pending::class)
->allowTransition(Pending::class, Paid::class)
->allowTransition(Pending::class, Failed::class)
;
}
}
```
Here's a concrete implementation of one state, the `Paid` state:
```php
class Paid extends PaymentState
{
public function color(): string
{
return 'green';
}
}
```
And here's how it is used:
```php
$payment = Payment::find(1);
$payment->state->transitionTo(Paid::class);
echo $payment->state->color();
```
## Support us
[
](https://spatie.be/github-ad-click/laravel-model-states)
We invest a lot of resources into creating [best in class open source packages](https://spatie.be/open-source). You can support us by [buying one of our paid products](https://spatie.be/open-source/support-us).
We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on [our contact page](https://spatie.be/about-us). We publish all received postcards on [our virtual postcard wall](https://spatie.be/open-source/postcards).
## Installation
You can install the package via composer:
```bash
composer require spatie/laravel-model-states
```
You can publish the config file with:
```bash
php artisan vendor:publish --provider="Spatie\ModelStates\ModelStatesServiceProvider" --tag="model-states-config"
```
This is the content of the published config file:
```php
return [
/*
* The fully qualified class name of the default transition.
*/
'default_transition' => Spatie\ModelStates\DefaultTransition::class,
];
```
## Usage
Please refer to the [docs](https://spatie.be/docs/laravel-model-states/v2/01-introduction/) to learn how to use this package.
## Testing
``` bash
composer test
```
## Changelog
Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.
## Contributing
Please see [CONTRIBUTING](https://github.com/spatie/.github/blob/main/CONTRIBUTING.md) for details.
## Security
If you've found a bug regarding security please mail [[email protected]](mailto:[email protected]) instead of using the issue tracker.
## Credits
- [Brent Roose](https://github.com/brendt)
- [All Contributors](../../contributors)
## License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.