galvao/crast

Customizable Random String

0.1.0 2026-02-12 22:51 UTC

Requires

• php: >=8.4

Requires (Dev)

• phpunit/phpunit: ^11.5

Apache-2.0

• Er Galvão Abbott

Published on Packagist.org on 2026-07-12 20:06 UTC

README

A way of generating an ASCII-based random string with full customization. Also, a very simple example of the use of Enumerations in PHP.

Usage

<?php
require '../vendor/autoload.php';

use CRaSt\{
    CRaSt,
    Enumeration\Characters,
};

// In this example:
// Generates a string containing upper and lowecase letters and numbers.
// Excludes confusing characters such as 1, upper and lowecase 'i', lowercase 'l', 0 (zero) and upper and lowecase 'o'.

try {
    $str = new CRaSt(128, [
        Characters::LowerCase,
        Characters::UpperCase,
        Characters::Number,
    ], 'oO0lIi1');
} catch (Error $e) {
    echo $e->getMessage() . PHP_EOL;
    exit(1);
}

echo $str->result . PHP_EOL;

You can run the script at the bin folder to see this very example in action.

License

Apache License 2.0 by Er Galvão Abbott

See the License file for details.