Update (May 2026): v1.1 has been released! The minimum supported PHP version is now 8.4, and all tests fully pass against the official specification.
TypeID PHP brings type-safe, globally unique identifiers to your PHP projects. This library implements TypeIDs - an elegant extension of UUIDv7 that adds descriptive type prefixes to identifiers.
Instead of working with opaque UUIDs like 01890a5d-ac96-774b-bcce-b302099a8057, you get human-readable IDs like user_01h455vb4pex5vsknk084sn02q that instantly communicate their purpose.
Why Use TypeID?#
- Type Safety: Prevent errors by distinguishing between different entity types
- Intuitive Debugging: Immediately identify what an ID represents
- Database Performance: K-sortable for better index locality
- Space Efficiency: URL-safe base32 encoding (26 characters vs 36 for UUIDs)
Quick Example#
// Generate a user ID
$userId = TypeID::generate('user');
// user_01h455vb4pex5vsknk084sn02q
// Create a product ID from an existing UUID
$productId = TypeID::fromUuid('product', $uuid);TypeID PHP integrates seamlessly with existing systems while enhancing readability and safety. Install today with composer require jewei/typeid-php and bring more clarity to your identifiers.
To see where TypeIDs fit next to integer keys, read Database Primary Key: Integer vs UUID vs NanoID.
