ndtan/id-generator

NDT ID Generator — pluggable PHP ID generation library (UUID v4/v6/v7/v8, ULID, Snowflake, NanoID, KSUID, Mongo ObjectId, ShortUUID) with per-driver configuration and integrations for Laravel & Doctrine.

v0.3.0 2025-09-21 05:00 UTC

Requires

• php: >=8.1

Requires (Dev)

• phpunit/phpunit: ^11.0

Suggests

• doctrine/dbal: Use custom Doctrine types for UUIDv7/ULID.
• laravel/framework: Use the Laravel ServiceProvider integration.

MIT

• Tony Nguyen

• php
• library
• mongo
• uuid
• snowflake
• ulid
• ObjectId
• nanoid
• id-generator
• ksuid
• uuidv7
• uuid6
• uuid8
• shortuuid
• ndtan

README

Pluggable PHP ID generation library — UUID v4/v6/v7/v8, ULID, Snowflake, NanoID, KSUID, Mongo ObjectId, ShortUUID — with per-driver options and integrations for Laravel & Doctrine. Namespace: ndtan · PHP 8.1+

Features

• ✅ Multiple strategies: UUID v4/v6/v7/v8, ULID (monotonic option), Snowflake, NanoID, KSUID, Mongo ObjectId, ShortUUID(Base58)
• ✅ Pluggable drivers via IdGeneratorInterface + Manager
• ✅ Per-driver configuration (epoch/worker/datacenter/alphabet/size/monotonic…)
• ✅ Framework integrations: Laravel ServiceProvider, Doctrine DBAL types
• ✅ Tests + GitHub Actions CI, MIT License

Installation

composer require ndtan/id-generator

Quick Start

use ndtan\Manager;
use ndtan\Uuid\UuidV7Generator;
use ndtan\Ulid\UlidGenerator;
use ndtan\Snowflake\SnowflakeGenerator;

$mgr = new Manager([
  'default' => 'uuid7',
  'drivers' => [
    'uuid7' => [ 'class' => UuidV7Generator::class ],
    'ulid'  => [ 'class' => UlidGenerator::class, 'monotonic' => true ],
    'snowflake' => [ 'class' => SnowflakeGenerator::class, 'epoch' => '2020-01-01T00:00:00Z' ],
  ]
]);

echo $mgr->generate();                 // UUIDv7
echo $mgr->driver('ulid')->generate(); // ULID

Documentation

• Getting started: docs/GETTING_STARTED.md
• Driver reference (all options): docs/DRIVERS.md
• Laravel & Doctrine integration: docs/INTEGRATIONS.md

Roadmap

• Benchmarks workflow, PHPStan/Psalm
• Additional encoders (Base32/Base64 for binaries)
• More framework snippets (Symfony bundle, Laminas)

License

MIT © Tony Nguyen