Package Data | |
---|---|
Maintainer Username: | konekt |
Package Create Date: | 2017-10-05 |
Package Last Update: | 2024-03-12 |
Language: | PHP |
License: | MIT |
Last Refreshed: | 2024-12-22 03:18:34 |
Package Statistics | |
---|---|
Total Downloads: | 1,305,479 |
Monthly Downloads: | 40,688 |
Daily Downloads: | 438 |
Total Stars: | 62 |
Total Watchers: | 6 |
Total Forks: | 6 |
Total Open Issues: | 2 |
This package provides support for auto casting konekt enum fields in Eloquent models.
Supported Konekt Enum versions are 2.0+ and Eloquent 5.0+
composer require konekt/enum-eloquent
CastsEnums
trait to your modelprotected $enums
property on the modelThe Enum:
namespace App;
use Konekt\Enum\Enum;
class OrderStatus extends Enum
{
const __default = self::PENDING;
const PENDING = 'pending';
const CANCELLED = 'cancelled';
const COMPLETED = 'completed';
}
The Model:
namespace App;
use Illuminate\Database\Eloquent\Model;
use Konekt\Enum\Eloquent\CastsEnums;
class Order extends Model
{
use CastsEnums;
protected $enums = [
'status' => OrderStatus::class
];
}
Client code:
$order = Order::create([
'status' => 'pending'
]);
// The status attribute will be an enum object:
echo get_class($order->status);
// output: App\OrderStatus
echo $order->status->value();
// output: 'pending'
echo $order->status->isPending() ? 'yes' : 'no';
// output: yes
echo $order->status->isCancelled() ? 'yes' : 'no';
// output: no
// You can assign an enum object as attribute value:
$order->status = OrderStatus::COMPLETED();
echo $order->status->value();
// output: 'completed'
// It also works with mass assignment:
$order = Order::create([
'status' => OrderStatus::COMPLETED()
]);
echo $order->status->value();
// output 'completed'
// It still accepts scalar values:
$order->status = 'completed';
echo $order->status->isCompleted() ? 'yes' : 'no';
// output: yes
// But it doesn't accept scalar values that aren't in the enum:
$order->status = 'negotiating';
// throws UnexpectedValueException
// Given value (negotiating) is not in enum `App\OrderStatus`
It is possible to defer the resolution of an Enum class to runtime.
It happens using the ClassName@method
notation known from Laravel.
This is useful for libraries, so you can 'late-bind' the actual enum class and let the user to extend it.
The Model:
namespace App;
use Illuminate\Database\Eloquent\Model;
use Konekt\Enum\Eloquent\CastsEnums;
class Order extends Model
{
use CastsEnums;
protected $enums = [
'status' => 'OrderStatusResolver@enumClass'
];
}
The Resolver:
namespace App;
class OrderStatusResolver
{
/**
* Returns the enum class to use as order status enum
*
* @return string
*/
public static function enumClass()
{
return config('app.order.status.class', OrderStatus::class);
}
}
This way the enum class becomes configurable without the need to modify the Model code.
Laravel Collective Forms Package provides the
Form
facade known from Laravel v4.x.
In case you want to use the Forms package with this one, you need to add the
EnumsAreCompatibleWithLaravelForms
trait to your model, next to CastsEnums
.
This will fix a problem where the forms package detects the enum label instead of its actual value as the value of the field.
It is being done by adding the (undocumented) getFormValue()
method to the model, that is being
used by the forms library to obtain form field value.
Enjoy!
For detailed usage of konekt enums refer to the Konekt Enum Documentation.