README

The php-string-formatter package provides a simple and efficient way to generate formatted strings by replacing placeholders (#, ?, *, %) with random characters, numbers, or a mix of both. It's perfect for creating test data, unique codes, or flexible string patterns.

Features

• Replace # with random digits (0-9).
• Replace % with random digits (1-9).
• Replace ? with random lowercase letters (a-z).
• Replace * with random digits or letters.
• Easy integration with PHP projects.

Installation

Install the package via Composer:

composer require cndrsdrmn/php-string-formatter  

Usage

Basic Wildcard Replacement

use Cndrsdrmn\PhpStringFormatter\StringFormatter;

// Replace '#' with random digits (0-9)
echo StringFormatter::numerify('Order-###');  
// Output: Order-123  

// Replace '%' with random digits (1-9)
echo StringFormatter::numerify('Code-%-%-%');  
// Output: Code-3-7-8  

// Replace '?' with random lowercase letters (a-z)
echo StringFormatter::lexify('User-???');  
// Output: User-abc  

// Replace '*' with random digits or letters
echo StringFormatter::bothify('Key-***');  
// Output: Key-a3b  

Advanced Replacement

You can mix and match placeholders in a single string:

echo StringFormatter::bothify('Code-#?%-*?#');  
// Output: Code-3a9-b1c3  

Supported Placeholders

Methods

numerify(string $string): string

Replaces all # with random digits (0-9) and % with random digits (1-9).

lexify(string $string): string

Replaces all ? with random lowercase letters (a-z).

bothify(string $string): string

Replaces all * with random digits (0-9) or letters (a-z).

Testing

This package can be tested with PHPUnit. To run tests:

composer test  

Contributing

Contributions are welcome! Feel free to fork the repository, submit pull requests, or open issues for suggestions and bug reports.

License

This package is open-source software licensed under the MIT license.