add UUID version 7 generator

[tsurowiec]

Description

added a UUID Version 7 Generator

Motivation and context

with the introduction of new UUID Types, there is a better way then Percona's solution to achieve the sortable, time-based UUIDs that can be efficiently used as primary keys.

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)

PR checklist

• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have read the CONTRIBUTING.md document.
• I have added tests to cover my changes.

[codecov]

Codecov Report

Merging #191 (2bd21fe) into main (6867db3) will not change coverage.
The diff coverage is 100.00%.

❗ Current head 2bd21fe differs from pull request most recent head 9498c0d. Consider uploading reports for the commit 9498c0d to get more accurate results

Additional details and impacted files

@@             Coverage Diff             @@
##                main      #191   +/-   ##
===========================================
  Coverage     100.00%   100.00%           
- Complexity        60        61    +1     
===========================================
  Files              5         6    +1     
  Lines            105       107    +2     
===========================================
+ Hits             105       107    +2     

Impacted Files	Coverage Δ
src/UuidV7Generator.php	100.00% <100.00%> (ø)

[tsurowiec]

@ramsey tests fail on PHP below 8.0. Uuid::uuid7() is not available there. I don't know how to proceed. Any hints?

[ramsey]

Good question. I see two options:

1. Drop support for PHP < 8.0
2. Throw an exception in in the constructor for UuidV7Generator if !method_exists(Uuid::class, 'uuid7')

The second option seems like it might be the best to avoid dropping support for < PHP 8.0 at the moment.

[tsurowiec]

@ramsey updated PR, I hope skipped tests are allowed in workflow. I had to go for full class name instead of ::class due to 5.4 support.

[ramsey]

Thank you for contributing! 🎉

I committed this in 4b56c72