PHPackages                             katmore/intl-rand-string - 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. [Localization & i18n](/categories/localization)
4. /
5. katmore/intl-rand-string

ActiveLibrary[Localization & i18n](/categories/localization)

katmore/intl-rand-string
========================

generate internationalized random alpha-numeric strings

v1.0.5(7y ago)015MITPHPPHP >=7.2.0

Since Jun 4Pushed 7y ago1 watchersCompare

[ Source](https://github.com/katmore/intl-rand-string)[ Packagist](https://packagist.org/packages/katmore/intl-rand-string)[ Docs](https://github.com/katmore/intl-rand-string)[ RSS](/packages/katmore-intl-rand-string/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (5)Dependencies (2)Versions (6)Used By (0)

IntlRandString
==============

[](#intlrandstring)

generate internationalized random alpha-numeric strings

- [Usage in a PHP Project](#usage-in-a-php-project)
- [Standalone Utility](#rand-string-standalone-installation)
- [Development](#development)

About
-----

[](#about)

The **IntlRandString** package facilitates generating random strings in multiple internationalized character sets. A typical use-case is generating random passwords in a targeted "language", i.e. using characters familiar to a language rather than simply using only english latin characters, as is typical. For similar reasons, it could also prove ideal in other use-cases, such as: password reset validation codes, coupon or promotional codes, etc.

Usage in a PHP Project
----------------------

[](#usage-in-a-php-project)

use composer to add **IntlRandString** to your PHP project:

```
composer require katmore/intl-rand-string
```

A random string can be generated with the following character sets:

- [Cyrillic](#cyrillic-charset)
- [English](#english-charset)
- [German](#german-charset)
- [Italian](#italian-charset)
- [Spanish](#spanish-charset)

### Cyrillic Charset

[](#cyrillic-charset)

Example, using the **Cyrillic** Charset to generate a random string:

```
$randString = new IntlRandString\Charset\Cyrillic();
echo $randString->randomString(12);
```

The above example should output a random string that includes only cyrillic characters and latin digits, such as follows:

```
МхЫЖЬкхЛДхЦЗ
```

### English Charset

[](#english-charset)

Example, using the **English** Charset to generate a random string:

```
$randString = new IntlRandString\Charset\English();
echo $randString->randomString(12);
```

The above example should output a random string that includes only latin characters and latin digits as used in English, such as follows:

```
fMomhRErXWa8
```

### German Charset

[](#german-charset)

Example, using the **German** Charset to generate a random string:

```
$randString = new IntlRandString\Charset\German();
echo $randString->randomString(12);
```

The above example should output a random string that includes only latin characters and latin digits as used in German, such as follows:

```
0ZNuXÄGksyse
```

### Italian Charset

[](#italian-charset)

Example, using the **Italian** Charset to generate a random string:

```
$randString = new IntlRandString\Charset\Italian();
echo $randString->randomString(12);
```

The above example should output a random string that includes only latin characters and latin digits as used in Italian, such as follows:

```
DMFPZNusSJTO
```

### Spanish Charset

[](#spanish-charset)

Example, using the **Spanish** Charset to generate a random string:

```
$randString = new IntlRandString\Charset\Spanish();
echo $randString->randomString(12);
```

The above example should output a random string that includes only latin characters and latin digits as used in Spanish, such as follows:

```
Uí64DSYjWóQr
```

Development
-----------

[](#development)

The following utility scripts facilitate development of character sets:

- [make-charset.php](#make-charsetphp-dev-utility)
- [make-all-charsets.sh](#make-all-charsetssh-dev-utility)

### unit tests

[](#unit-tests)

The unit tests specified by [`phpunit.xml`](./phpunit.xml) check the basic sanity and entropy of generated random strings for each character set.

```
$ vendor/bin/phpunit
```

### make-charset.php dev utility

[](#make-charsetphp-dev-utility)

The **`bin/devel/make-charset.php`** command-line developer utility script creates a character set class defintion PHP source file in the `src/IntlRandString/Charset` directory. After creating a character set, [perform all unit tests](#unit-tests) to ensure conformity.

Specifying the `--help` option will display usage details.

```
$ bin/devel/make-charset.php --help
```

### make-all-charsets.sh dev utility

[](#make-all-charsetssh-dev-utility)

The **`bin/devel/make-all-charsets.sh`** command-line developer utility script contains the Unicode start and end points for all [*Charset* class defintions](#character-sets). Invoking it will (re-)generate all [character set defintion source files](./src/IntlRandString/Charset).

```
$ bin/devel/make-all-charsets.sh
```

The Unicode character ranges for the *Charsets* are ultimately defined in [bin/devel/make-all-charsets.sh](./bin/devel/make-all-charsets.sh#L52-L10000). Therefore, by modifying the [make-all-charsets.sh](./bin/devel/make-all-charsets.sh#L52-L10000) source file, character sets can be permanently added or modified. After modifying the source and invoking to (re-)generate character sets, [perform all unit tests](#unit-tests) to ensure conformity.

For example, the ["German" character set](./src/IntlRandString/Charset/German.php) is defined in [*make-all-charsets.sh*](./bin/devel/make-all-charsets.sh#L82-L92) as follows:

```
#
# German Charset
#
CHARSET_LETTERS=
CHARSET_LETTERS="$CHARSET_LETTERS U+00E4 U+00E5 U+00F6 U+00F7 U+00FC U+00FD" #diaresis a,o,u
CHARSET_LETTERS="$CHARSET_LETTERS U+00C4 U+00C5 U+00D6 U+00D7 U+00DC U+00DD" #diaresis A,O,U
CHARSET_LETTERS="$CHARSET_LETTERS U+00DF U+00E0 U+1E9E U+1E9F" #sharp s,S
make_charset german\
   $LATIN_NUMBERS\
   $BASIC_LATIN_LETTERS\
   $CHARSET_LETTERS
```

rand-string utility
-------------------

[](#rand-string-utility)

A standalone utility is provided by the [`bin/rand-string.php`](./bin/rand-string.php) script. Details regarding the usage of this utility and instructions for an optional global installation are included in this section.

### rand-string standalone installation

[](#rand-string-standalone-installation)

These installation instructions rely on the `make-phar.sh` installer script. See the [*make-phar.sh utility*](#make-pharsh-utility) section for more in-depth details and troubleshooting.

Installation instructions:

- Download **intl-rand-string** project using git (or similar), and enter the project directory. ```
    $ git clone git@github.com:katmore/intl-rand-string.git
    $ cd intl-rand-string
    ```
- Use the `bin/install/make-phar.sh` utility with the `--install` flag to create and install the phar package on your system. ```
    $ bin/install/make-phar.sh --install
    ```

### rand-string utility examples

[](#rand-string-utility-examples)

The `rand-string` (or `bin/rand-string.php`) command line utility generates random strings.

Example #1, using default charset and length.

- the following command ```
    $ rand-string
    ```
- should produce output similar to the following ```
    195tTXDob0ol
    ```

The first positional argument specifies the length of the random string.

Example #2, using default charset and specifying length:

- the following command ```
    $ rand-string 20
    ```
- should produce output similar to the following ```
    3QCBSV3YC3Dow62Jib5C
    ```

A charset may be specified for one-time use with the `--charset=` flag.

Example #3, using `cyrillic` charset:

- the following command ```
    $ rand-string --charset=cyrillic
    ```
- should produce output similar to the following ```
    ЯИкМСзГД8уя9
    ```

The `English` charset is the global default, though this may be changed [(see usage)](#rand-string-utility-usage).

Example #3, setting the `german` as default:

- the following command ```
    $ rand-string --set-default-charset=german
    ```
- should produce output similar to the following ```
    $ rand-string: default-charset is now 'german'
    ```
- subsequent executions should produce random strings using the `german` charset, the following command ```
    $ rand-string
    ```
- should produce output similar to the following ```
    öt7ß1vCQwtNE
    ```

Any Charset available in [`IntlRandString\Charset`](./src/IntlRandString/Charset) may be used.

Example #4, getting a list of available charsets:

- the following command ```
    $ rand-string --list
    ```
- should produce output similar to the following ```
    Cyrillic
    English
    German
    Italian
    Spanish
    ```
- and thus, the following command ```
    $ rand-string --charset=Spanish
    ```
- should produce output similar to the following ```
    rñQ0m1úDkáMV
    ```

### rand-string utility usage

[](#rand-string-utility-usage)

```
usage:
rand-string [-hl|] | [--charset=][][]

mode flags:
  -h,--help
    Print a help message and exit.
  -l,--list
    Print each available charset and exit.

setting commands:
  --set-default-charset=
    Set the default charset for the current user and exit.
  --print-default-charset
    Print the default charset for the current user and exit.

random string options:
  --charset=
    Optionally specify random string charset.

  char flags:
    --no-upper-letters
      Random string will not include upper-case characters.
    --no-lower-letters
      Random string will not include lower-case letter characters.
    --no-digits
      Random string will not include digit numeral characters.
    --only-upper-letters
      Random string will only include upper-case characters.
      Cannot be used with any other char flag.
    --only-lower-letters
      Random string will only include lower-case characters.
      Cannot be used with any other char flag.
    --only-digits
      Random string will only include digit numerical characters.
      Cannot be used with any other char flag.

arguments:

    Optionally specify random string length.
    Default: 12
```

### make-phar.sh utility

[](#make-pharsh-utility)

The [`bin/install/make-phar.sh`](./bin/install/make-phar.sh) utility creates a standalone `rand-string.phar` phar package file using `bin/rand-string.php` as the entrypoint. Optionally, it will copy the phar package file to an installation path.

**Prerequisites**

- composer
- php command line binary

**Usage**

```
make-phar.sh [-h] | [--install [--install-path=]] []
options:
  -h,--help: Print a help message and exit.
  --install: Optionally install as a global system command.
  --install-path=
    Optionally specify global system command installation path.
    Default: /usr/local/bin/rand-string

bin path options:
  --composer-bin=
    Optionally specify path to composer.
  --php-bin=
    Optionally specify path to php binary.
```

Legal
-----

[](#legal)

### Copyright

[](#copyright)

IntlRandString -

Copyright (c) 2012-2018 Doug Bird. All Rights Reserved.

### License

[](#license)

IntlRandString is copyrighted free software. You may redistribute and modify it under either the terms and conditions of the "The MIT License (MIT)"; or the terms and conditions of the "GPL v3 License". See [LICENSE](https://github.com/katmore/intl-rand-string/blob/master/LICENSE) and [GPLv3](https://github.com/katmore/intl-rand-string/blob/master/GPLv3).

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~2 days

Total

5

Last Release

2889d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ef3cde32b1ac961c229cb3e76202b38b5d1a2c571334152c6cee08c43732ce7c?d=identicon)[acksponies](/maintainers/acksponies)

---

Top Contributors

[![ackspony](https://avatars.githubusercontent.com/u/1947018?v=4)](https://github.com/ackspony "ackspony (7 commits)")

---

Tags

character-encodingcoupon-code-generatorinternationalinternationalizationpassword-generatorphpphp-libraryphpunit-testsrandom-generationrandom-stringrandom-string-generatorsvanilla-php

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/katmore-intl-rand-string/health.svg)

```
[![Health](https://phpackages.com/badges/katmore-intl-rand-string/health.svg)](https://phpackages.com/packages/katmore-intl-rand-string)
```

###  Alternatives

[symfony/translation

Provides tools to internationalize your application

6.6k836.5M2.0k](/packages/symfony-translation)[nesbot/carbon

An API extension for DateTime that supports 281 different languages.

169661.4M4.8k](/packages/nesbot-carbon)[joedixon/laravel-translation

A tool for managing all of your Laravel translations

717911.4k11](/packages/joedixon-laravel-translation)[illuminate/translation

The Illuminate Translation package.

6936.4M491](/packages/illuminate-translation)[lajax/yii2-translate-manager

Translation management extension for Yii 2

227578.8k13](/packages/lajax-yii2-translate-manager)[larswiegers/laravel-translations-checker

Make sure your laravel translations are checked and are included in all languages.

256423.2k2](/packages/larswiegers-laravel-translations-checker)

PHPackages © 2026

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