https://github.com/myerscode/utilities-random

A fluent PHP utility class to help create random values.
https://github.com/myerscode/utilities-random

php-library random random-generation utilities utility utility-library

Last synced: about 2 months ago
JSON representation

A fluent PHP utility class to help create random values.

• Host: GitHub
• URL: https://github.com/myerscode/utilities-random
• Owner: myerscode
• License: mit
• Created: 2024-06-03T16:45:08.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2026-05-25T14:14:07.000Z (about 2 months ago)
• Last Synced: 2026-05-25T16:17:42.410Z (about 2 months ago)
• Topics: php-library, random, random-generation, utilities, utility, utility-library
• Language: PHP
• Homepage:
• Size: 85.9 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Random Utilities

> A fluent PHP utility class to help create random values.

> ⚠️ This package is designed for generating random strings, codes, and identifiers — not for cryptographic purposes. Do not use it for passwords, tokens, or anything requiring cryptographic security.

[![Latest Stable Version](https://poser.pugx.org/myerscode/utilities-random/v/stable)](https://packagist.org/packages/myerscode/utilities-random)

[![Total Downloads](https://poser.pugx.org/myerscode/utilities-random/downloads)](https://packagist.org/packages/myerscode/utilities-random)

[![PHP Version Require](http://poser.pugx.org/myerscode/utilities-random/require/php)](https://packagist.org/packages/myerscode/utilities-random)

[![License](https://poser.pugx.org/myerscode/utilities-random/license)](https://github.com/myerscode/utilities-random/blob/main/LICENSE)

[![Tests](https://github.com/myerscode/utilities-random/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/myerscode/utilities-random/actions/workflows/tests.yml)

[![codecov](https://codecov.io/gh/myerscode/utilities-random/graph/badge.svg)](https://codecov.io/gh/myerscode/utilities-random)

## Requirements

- PHP 8.5+

## Install

```shell

composer require myerscode/utilities-random

```

## Usage

```php

use Myerscode\Utilities\Random\Drivers\AlphaNumericDriver;

use Myerscode\Utilities\Random\Utility;

$utility = new Utility(AlphaNumericDriver::class);

// Generate a random string of length 5

$random = $utility->generate();

// Generate with custom length

$random = $utility->length(10)->generate();

// Generate chunked values

$random = $utility->length(4)->chunks(3)->spacer('-')->generate();

// e.g. "aB3x-Kp9z-mN2q"

// Generate unique values

$unique = $utility->length(10)->unique();

```

## Documentation

- [Usage](docs/usage.md) — full API reference and usage examples

- [Drivers](docs/drivers.md) — built-in drivers and creating custom ones

- [Constraints](docs/constraints.md) — constraining generation with pool filters and output constraints

## License

MIT