As developers, we’ve all been there – stuck with a database column that’s restricted by a predefined set enum values only to realize that we need to add new cases that aren’t present in the original list. This lead to inconsistencies and errors, especially when working sensitive data user roles. That’s where the code snippet above comes in – clever to dynamically update enum in database, ensuring data integrity and flexibility in your application.
The Problem: Stale Enum Values
namespace App\Enums; enum UserRoles: string
{ case ADMIN = 'admin'; case MODERATOR = 'mod'; case USER = 'user';
} public static function values(): array
{ return array_column(self::cases(), 'value');
}
Imagine you have a roles table in your database, where each role is defined by an enum column name. Initially, you defined the enum values as ['admin', 'mod', 'user']
. However, as your application evolves, you need to add new roles, they won’t be recognized by the database, leading to errors and inconsistencies.
So let’s consider a scenario where you want to add two new roles, editor
and guest
, to the existing enum values. Without this dynamic update mechanism, you would need to manually modify the database to include these new values, which can be error-prone and time-consuming.
The Solution: Dynamic Enum Updates
UserRoles.php
namespace App\Enums; enum UserRoles: string
{ case ADMIN = 'admin'; case MODERATOR = 'mod'; case USER = 'user'; case EDITOR = 'editor'; case GUEST = 'guest';
} // ... reset of the codes ...
UpdateUserRolesEnum.php
namespace App\Console\Commands; use App\Enums\UserRoles;
use Illuminate\Console\Command;
use Illuminate\Support\Facades\DB; class UpdateUserRolesEnum extends Command
{ protected $signature = 'user-roles-enum:update'; protected $description = 'Update enum values in the database'; public function handle() { $enumValues = UserRoles::values(); DB::statement("ALTER TABLE roles MODIFY name ENUM('" . implode("','", $enumValues) . "')" ); $this->info('Enum values updated successfully.'); }
}
The code snippet above provides a solution to this problem by dynamically updating the enum values in the database. Here’s how it works:
The UpdateUserRolesEnumCommand
command retrieves the current enum values from the UserRoles
enum using the values() method.
The command then updates the enum values in the database using a raw SQL query, modifying the name column to include the new enum values.
Run this process every time you add a new case additionally, extract statements inside the handle() method when adding through the dashboard. The code that the enum values in the database are always up-to-date and in sync with the code. This approach has several benefits:
With this code, you can simply add the new roles to the UserRoles enum, and the command will take care of updating the database automatically. The resulting enum values in the database would be ['admin', 'moderator', 'user', 'editor', 'guest']
.
In conclusion, the code snippet above provides a valuable solution to the problem of stale enum values in your database.
Enjoy!
Discover more from Coursity
Subscribe to get the latest posts sent to your email.