README

PHP Mask is a PHP library to make masks for a string.
It is an adapation of ngx-mask by JsDaddy.

Installation

PHP-Mask is available on composer:

composer require clemdesign/php-mask

Usage

In your PHP application, use the static method apply of Mask:

$output = \Clemdesign\PhpMask\Mask::apply($inputValue, $maskExpression, $config);

Arguments

• $inputValue: string - The input value to apply mask.
• $maskExpression: string - The mask expression for $output.
• $config: array - The configuration for operation

$maskExpression: Patterns

The patterns are used to filter $inputValue:

$maskExpression: Special chars

Special chars are used in mask expressions to format output:

$maskExpression: Thousand separator

You can format a number in thousand separator and control precision.

The mask keys are:

• separator: Input 1234.56 is ouputed as 1 234.56
• dot_separator: Input 1234,56 is ouputed as 1.234,56
• comma_separator: Input 1234.56 is ouputed as 1,234.56

To manage precision, keys shall be suffixed by .{Number}.

Example:

• separator.1: Input 1234.56743 is ouputed as 1 234.5
• dot_separator.4: Input 1234,56743 is ouputed as 1.234,5674
• comma_separator.2: Input 1234.56743 is ouputed as 1,234.56

$maskExpression: Time validation

You can format a time according limit:

$maskExpression: Percent validation

You can format a value from $inputValue as a percent and manage the precision.

Use the key percent to have a extract value from $inputValue within 0 to 100.

Suffix the key with .{Number} to manage precision (percent.2).

Example:

$output = \Clemdesign\PhpMask\Mask::apply("99.4125", "percent.2");

// $output contains: 99.41

$config: Prefix and suffix

You have possibility to set suffix and prefix in output:

$output = \Clemdesign\PhpMask\Mask::apply("0102030405", "00 00 00 00 00", array(
  "prefix" => "My phone is ",
  "suffix" => "!"
));

// $output contains: My phone is 01 02 03 04 05!

Examples

Contributing

If you think any implementation are just not the best, feel free to submit ideas and pull requests. All your comments and suggestion are welcome.

Credits:

• ngx-mask of JsDaddy

License

Copyright (c) 2019 clemdesign.

For use under the terms of the MIT license.