PHPackages                             snortlin/nano-id - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. snortlin/nano-id

ActiveLibrary[Utility & Helpers](/categories/utility)

snortlin/nano-id
================

A tiny, secure, URL-friendly, unique string ID generator for PHP

1.0.1(1y ago)526.5k↓64.8%1MITPHPPHP ^7.4|^8.0

Since May 3Pushed 1y ago1 watchersCompare

[ Source](https://github.com/snortlin/nano-id)[ Packagist](https://packagist.org/packages/snortlin/nano-id)[ RSS](/packages/snortlin-nano-id/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (1)DependenciesVersions (3)Used By (1)

Nano ID
=======

[](#nano-id)

[![Nano ID logo by Anton Lovchikov](https://camo.githubusercontent.com/682f981e83617354735ab5431235d4b06580ad5fc9eb24baca0a8c04e5734697/68747470733a2f2f61692e6769746875622e696f2f6e616e6f69642f6c6f676f2e737667)](https://camo.githubusercontent.com/682f981e83617354735ab5431235d4b06580ad5fc9eb24baca0a8c04e5734697/68747470733a2f2f61692e6769746875622e696f2f6e616e6f69642f6c6f676f2e737667)

A tiny, secure, URL-friendly, unique string ID generator for PHP.

This package is PHP implementation of [ai's](https://github.com/ai) [nanoid](https://github.com/ai/nanoid). Read its documentation for more information.

- **Fast.** It is faster than UUID.
- **Safe.** It uses cryptographically strong random APIs. Can be used in clusters.
- **Compact.** It uses a larger alphabet than UUID (`A-Za-z0-9_-`). So ID size was reduced from 36 to 21 symbols.
- **Customizable.** Size, alphabet and Random Bytes Generator may be overridden.

Installation
------------

[](#installation)

The preferred method of installation is via [Composer](https://getcomposer.org/):

```
composer require snortlin/nano-id
```

Usage
-----

[](#usage)

### Base usage

[](#base-usage)

```
use Snortlin\NanoId\NanoId;

$nanoId = NanoId::nanoId(); // "unQ87dO06B5B-Ybq2Aum5"

// Custom size, default = 21
$nanoId = NanoId::nanoId(16); // "6PUg-8nn5IQrvKNw"

// Custom size and alphabet
$nanoId = NanoId::nanoId(16, '0123456789abcdef'); // "58b141975c2b72f3"
```

### Custom alphabet

[](#custom-alphabet)

```
use Snortlin\NanoId\NanoId;

// Default size (21), numbers (0123456789)
$nanoId = NanoId::nanoId(NanoId::SIZE_DEFAULT, NanoId::ALPHABET_NUMBERS); // "782295634533276321176"

// Custom size, numbers and English alphabet without unreadable letters: 1, l, I, 0, O, o, u, v, 5, S, s, 2, Z
$nanoId = NanoId::nanoId(12, NanoId::ALPHABET_ALPHA_NUMERIC_READABLE); // "AcFQM9X3pCi8"
```

### Faster and Non-Secure

[](#faster-and-non-secure)

By default, Nano ID uses random bytes generation for security and low collision probability. If you are not so concerned with security and more concerned with performance, you can use the faster non-secure generator.

```
use Snortlin\NanoId\NanoId;

$nanoId = NanoId::nanoIdNonSecure();

// Custom size, default = 21
$nanoId = NanoId::nanoIdNonSecure(16);

// Custom size and alphabet
$nanoId = NanoId::nanoIdNonSecure(16, '0123456789abcdef');
```

Tools
-----

[](#tools)

- [ID size calculator](https://github.com/CyberAP/nanoid-dictionary) shows collision probability when adjusting the ID alphabet or size.

Credits
-------

[](#credits)

- Andrey Sitnik [ai](https://github.com/ai) for [Nano ID](https://github.com/ai/nanoid).
- Stanislav Lashmanov [CyberAP](https://github.com/CyberAP) for [Predefined character sets to use with Nano ID](https://github.com/CyberAP/nanoid-dictionary).

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance49

Moderate activity, may be stable

Popularity32

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 57.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1513 days

Total

2

Last Release

373d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9af5cb9ca24e0eb3598369e199ab5ed10f1053f929da7d868da5f9fcb286d6af?d=identicon)[snortlin](/maintainers/snortlin)

---

Top Contributors

[![snortlin](https://avatars.githubusercontent.com/u/68695718?v=4)](https://github.com/snortlin "snortlin (4 commits)")[![leixner-qcm](https://avatars.githubusercontent.com/u/81631795?v=4)](https://github.com/leixner-qcm "leixner-qcm (3 commits)")

### Embed Badge

![Health badge](/badges/snortlin-nano-id/health.svg)

```
[![Health](https://phpackages.com/badges/snortlin-nano-id/health.svg)](https://phpackages.com/packages/snortlin-nano-id)
```

###  Alternatives

[ptahdunbar/wp-skeleton-plugin

A walking skeleton WordPress plugin. -\_O

1811.2k](/packages/ptahdunbar-wp-skeleton-plugin)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)