NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #2767 most downloaded on Packagist
This package allows you to easily work with UUIDs in your Laravel models.
Latest stable
8.3.0
Last release 8 months ago
19 Mar 2026
Ships fairly regularly
a new release about every 5 months
Most releases are documented
notes for 31 of 36 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
38 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
Feature: Configurable UUID version by @zagreusinoz in https://github.com/michaeldyrynda/laravel-model-uuid/pull/142
Full Changelog: https://github.com/michaeldyrynda/laravel-model-uuid/compare/8.2.0...8.3.0
Note that the minimum version for this package is now Laravel 12.x, however, PHP >= 8.2 is still supported.
Note that the minimum version for this package is now Laravel 12.x, however, PHP >= 8.2 is still supported.
This is due to some changes in the way that database connections/grammar operate at the framework level, meaning the tests won't run in a consistent way between 11.x and 12.x
excluding specific UUID(s) in query builder by @mostafaznv in https://github.com/michaeldyrynda/laravel-model-uuid/pull/138whereNotUuid in the documentation by @mostafaznv in https://github.com/michaeldyrynda/laravel-model-uuid/pull/139Full Changelog: https://github.com/michaeldyrynda/laravel-model-uuid/compare/8.1.1...8.2.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Pin laravel/pint version to stop CI breaking when a new version is released.
laravel/pint version to stop CI breaking when a new version is released.Full Changelog: https://github.com/michaeldyrynda/laravel-model-uuid/compare/8.1.0...8.1.1
Updates minimum PHP version to 8.2 and Laravel version to 11.15, addressing recent changes in laravel/framework#51373
Updates minimum PHP version to 8.2 and Laravel version to 11.15, addressing recent changes in laravel/framework#51373
Adds support for Laravel 11.x and combines functionality previously provided by dyrynda/laravel-efficient-uuid.
Adds support for Laravel 11.x and combines functionality previously provided by dyrynda/laravel-efficient-uuid.
Laravel 11.x Compatibility by @laravel-shift in https://github.com/michaeldyrynda/laravel-model-uuid/pull/129
This version adds support for Laravel 11, and combines functionality previously available in laravel-efficient-uuid.
As a standalone package, laravel-efficient-uuid was a cyclic dependency on laravel-model-uuid, which made maintenance of the two packages tricky. The new functionality is, however, opt-in, so you can continue without this if you choose to.
Full Changelog: https://github.com/michaeldyrynda/laravel-model-uuid/compare/7.1.1...8.0.0-beta.1
Fixes spatie/laravel-package-tools dependency
Fixes spatie/laravel-package-tools dependency
Adds support for UUIDv7 (@atymic) #124
Full Changelog: https://github.com/michaeldyrynda/laravel-model-uuid/compare/7.0.0...7.1.0
Laravel 10.x Compatibility by @laravel-shift in https://github.com/michaeldyrynda/laravel-model-uuid/pull/122
This version replaces the protected $uuidVersion = ''; in favour of a public function uuidVersion(): string;
If you are upgrading from an earlier version, you will need to replace instances of the property declaration with a method that returns the version string. The default UUID version remains uuid4.
Full Changelog: https://github.com/michaeldyrynda/laravel-model-uuid/compare/6.6.3...7.0.0
Validation for UUIDs passed to the whereUuid scope by @MrThePlague in https://github.com/michaeldyrynda/laravel-model-uuid/pull/115
whereUuid scope by @MrThePlague in https://github.com/michaeldyrynda/laravel-model-uuid/pull/115Full Changelog: https://github.com/michaeldyrynda/laravel-model-uuid/compare/6.6.1...6.6.3
Fix cyclic dependency on dyrynda/laravel-efficient-uuid.
Fix cyclic dependency on dyrynda/laravel-efficient-uuid.
Note, this doesn't affect installation into a Laravel 9.x application, only development and testing of the package itself.
Target minimum dyrynda/laravel-efficient-uuid that supports Laravel 9.x
Target minimum dyrynda/laravel-efficient-uuid that supports Laravel 9.x
Update README.md by @bilfeldt in https://github.com/michaeldyrynda/laravel-model-uuid/pull/112
Full Changelog: https://github.com/michaeldyrynda/laravel-model-uuid/compare/6.5.0...6.6.0
Update README.md by @bilfeldt in https://github.com/michaeldyrynda/laravel-model-uuid/pull/112
Full Changelog: https://github.com/michaeldyrynda/laravel-model-uuid/compare/6.5.0...6.6.0-beta.1
Adds support for route model binding with the new BindsOnUuid trait, which should be used in combination with the GeneratesUuid trait - #106 (@afshine
Adds support for route model binding with the new BindsOnUuid trait, which should be used in combination with the GeneratesUuid trait - #106 (@afshiney)
Add support for qualifying UUID column so nested queries work as expected - (#102, 3935ba9f243df04addd3e097989733933d9a2daf)
Add support for qualifying UUID column so nested queries work as expected - (#102, 3935ba9f243df04addd3e097989733933d9a2daf)
Nothing published for this version
Nothing published for this version
b273499c41f62a8601a385f1652ba5ee584b0a5f - Add support for `ramsey/uuid=^4.1.
b273499c41f62a8601a385f1652ba5ee584b0a5f - Add support for `ramsey/uuid=^4.1.
Note that this release drops support for UUID versions 2, 3, and 5. These versions required additional configuration i.e. didn't work out of the box.
ordered now maps through to uuid6, and will be removed once the spec for v6 has been finalised.
Note
It may be possible, given that the ordered UUID does not appear to actually be a proper time-ordered UUID, to see collisions if you were previously using the ordered UUID version..
It may be worth considering updating the UUID to use the new format which forms a truer representation of an ordered UUID, albeit from a draft specification.
Nothing published for this version
#83 - Support ramsey/uuid 4.0, removing deprecation warning for moontoast/math (#66, #70, #79)
#83 - Support ramsey/uuid 4.0, removing deprecation warning for moontoast/math (#66, #70, #79)
0849adc855c3f1c1a55f8b3387da393dd77552e8 - Fix scope for finding models using `laravel-efficient-uuid` casts
0849adc855c3f1c1a55f8b3387da393dd77552e8 - Fix scope for finding models using laravel-efficient-uuid casts
6c76aa0a - Add tests, better handling for when `laravel-efficient-uuid` is used in conjunction with this package
6c76aa0a - Add tests, better handling for when laravel-efficient-uuid is used in conjunction with this package
This package now uses custom casts when used in combination with `laravel-efficient-uuid`, rather than the customised behaviour in <4.0.0.
This package now uses custom casts when used in combination with laravel-efficient-uuid, rather than the customised behaviour in <4.0.0.
* #62 - Add compatibility for Laravel 6 * #59, #58 - Allow multiple UUID columns in same table * #61 - Pass an array of UUIDs to whereUuid
whereUuidAdded support for customising the UUID column name
Added support for customising the UUID column name (#53)
Nothing published for this version
Introduces the ability to make the uuid column configurable.
Introduces the ability to make the uuid column configurable.
Add a public uuidColumn method to your model, which returns the string name of the column that should be used for your UUID.
Adds support for Laravel 5.6's time-ordered UUIDs
Adds support for Laravel 5.6's time-ordered UUIDs
Fixes dependency of illuminate/events, which would otherwise pin it to 5.6.0.
Fixes dependency of illuminate/events, which would otherwise pin it to 5.6.0.
Nothing published for this version
### Implemented pull requests #36 - compatibility for Laravel 5.5 #37 - loosen version constraint on ramsey/uuid
#36 - compatibility for Laravel 5.5
#37 - loosen version constraint on ramsey/uuid
### Implemented pull requests #35 - update tests to use TestCase namespace
#35 - update tests to use TestCase namespace
Miscellaneous additions of project dotfiles and configuration
#3, #4, #5, #6, #7, #9, #10, #11, #15, #16, #18
Thanks to @lucasmichot!
Add abstract hasCast method to trait Scrutinizer.
Add abstract hasCast method to trait Scrutinizer.
This is a breaking change - release, no longer allowing you to specify the UUID field name, further on the recommendation that you should use an auto-…
#2 - more opinionated handling of UUID
This is a breaking change - release, no longer allowing you to specify the UUID field name, further on the recommendation that you should use an auto-incrementing integer as your database's primary key in addition to an indexed uuid field.
Tighter integration with laravel-efficient-uuid means that you'll need to use a cast in order to properly store and retrieve your binary UUID values from the (MySQL) database. You can continue to use uncast values if you use Laravel's default uuid schema definitions.
Note that doctrine/dbal does not support changing uuid fields, and even if it did your data would be truncated in the process so ensure you are using laravel-efficient-uuid only if you are adding fresh uuid fields.
Add suggestion to composer.json for dyrynda/laravel-efficient-uuid package
Add suggestion to composer.json for dyrynda/laravel-efficient-uuid package
Easily manage UUIDs on your Eloquent models
First release of package:
whereUuid query scope to easily find your UUID-based modelsOne column per quarter.