Helper.php — GiveWP – Donation Plugin and Fundraising Platform 3.14.2

give / vendor / vendor-prefixed / fakerphp / faker / src / Faker / Extension / Helper.php

give / vendor / vendor-prefixed / fakerphp / faker / src / Faker / Extension Last commit date

Helper.php

115 lines

1	<?php
2	/**
3	* @license MIT
4	*
5	* Modified by impress-org on 07-August-2024 using Strauss.
6	* @see https://github.com/BrianHenryIE/strauss
7	*/
8
9	namespace Give\Vendors\Faker\Extension;
10
11	/**
12	* A class with some methods that may make building extensions easier.
13	*
14	* @experimental This class is experimental and does not fall under our BC promise
15	*/
16	final class Helper
17	{
18	/**
19	* Returns a random element from a passed array.
20	*/
21	public static function randomElement(array $array)
22	{
23	if ($array === []) {
24	return null;
25	}
26
27	return $array[array_rand($array, 1)];
28	}
29
30	/**
31	* Replaces all hash sign ('#') occurrences with a random number
32	* Replaces all percentage sign ('%') occurrences with a non-zero number.
33	*
34	* @param string $string String that needs to bet parsed
35	*/
36	public static function numerify(string $string): string
37	{
38	// instead of using randomDigit() several times, which is slow,
39	// count the number of hashes and generate once a large number
40	$toReplace = [];
41
42	if (($pos = strpos($string, '#')) !== false) {
43	for ($i = $pos, $last = strrpos($string, '#', $pos) + 1; $i < $last; ++$i) {
44	if ($string[$i] === '#') {
45	$toReplace[] = $i;
46	}
47	}
48	}
49
50	if ($nbReplacements = count($toReplace)) {
51	$maxAtOnce = strlen((string) mt_getrandmax()) - 1;
52	$numbers = '';
53	$i = 0;
54
55	while ($i < $nbReplacements) {
56	$size = min($nbReplacements - $i, $maxAtOnce);
57	$numbers .= str_pad((string) mt_rand(0, 10 ** $size - 1), $size, '0', STR_PAD_LEFT);
58	$i += $size;
59	}
60
61	for ($i = 0; $i < $nbReplacements; ++$i) {
62	$string[$toReplace[$i]] = $numbers[$i];
63	}
64	}
65
66	$string = self::replaceWildcard($string, '%', static function () {
67	return mt_rand(1, 9);
68	});
69
70	return $string;
71	}
72
73	/**
74	* Replaces all question mark ('?') occurrences with a random letter.
75	*
76	* @param string $string String that needs to bet parsed
77	*/
78	public static function lexify(string $string): string
79	{
80	return self::replaceWildcard($string, '?', static function () {
81	return chr(mt_rand(97, 122));
82	});
83	}
84
85	/**
86	* Replaces hash signs ('#') and question marks ('?') with random numbers and letters
87	* An asterisk ('*') is replaced with either a random number or a random letter.
88	*
89	* @param string $string String that needs to bet parsed
90	*/
91	public static function bothify(string $string): string
92	{
93	$string = self::replaceWildcard($string, '*', static function () {
94	return mt_rand(0, 1) ? '#' : '?';
95	});
96
97	return static::lexify(static::numerify($string));
98	}
99
100	private static function replaceWildcard(string $string, string $wildcard, callable $callback): string
101	{
102	if (($pos = strpos($string, $wildcard)) === false) {
103	return $string;
104	}
105
106	for ($i = $pos, $last = strrpos($string, $wildcard, $pos) + 1; $i < $last; ++$i) {
107	if ($string[$i] === $wildcard) {
108	$string[$i] = call_user_func($callback);
109	}
110	}
111
112	return $string;
113	}
114	}
115