Installation

Require the package. The service provider and the Options facade alias are auto-discovered — no manual registration:

composer require roundly-consulting/options-for-laravel

Publish and run the migration:

php artisan vendor:publish --tag="options-migrations"
php artisan migrate

Publish-only migration

The migration is not loaded automatically — the package only publishes it. Until you publish it, php artisan migrate will not create the options table.

If the models that will own options use UUID or ULID primary keys, set the owner key type before you run the migration — the owner_id column type is fixed when the table is created (see Database schema & key type):

# before you publish and run the migration
OPTIONS_KEY_TYPE=uuid   # bigint (default), uuid or ulid

Config (optional)

The key type, cache, event, authorization and live-override settings are all env-backed. Publish the config when you want to swap the model or edit the registry, groups or config-bridge maps:

php artisan vendor:publish --tag="options-config"

The package’s publish tags are options-migrations and options-config.

Next steps

• Define your first option by extending BaseOption — or scaffold one with make:option.
• Read and write it through the Options facade, the options() helper or the fluent API.
• Add the HasOptions trait to models that own their own settings.