Text.php — GiveWP – Donation Plugin and Fundraising Platform 2.18.1

give / vendor / fakerphp / faker / src / Faker / Provider / Text.php

give / vendor / fakerphp / faker / src / Faker / Provider Last commit date

ar_JO 5 years ago ar_SA 5 years ago at_AT 5 years ago bg_BG 5 years ago bn_BD 5 years ago cs_CZ 5 years ago da_DK 5 years ago de_AT 5 years ago de_CH 5 years ago de_DE 5 years ago el_CY 5 years ago el_GR 5 years ago en_AU 5 years ago en_CA 5 years ago en_GB 5 years ago en_HK 5 years ago en_IN 5 years ago en_NG 5 years ago en_NZ 5 years ago en_PH 5 years ago en_SG 5 years ago en_UG 5 years ago en_US 5 years ago en_ZA 5 years ago es_AR 5 years ago es_ES 5 years ago es_PE 5 years ago es_VE 5 years ago et_EE 5 years ago fa_IR 5 years ago fi_FI 5 years ago fr_BE 5 years ago fr_CA 5 years ago fr_CH 5 years ago fr_FR 5 years ago he_IL 5 years ago hr_HR 5 years ago hu_HU 5 years ago hy_AM 5 years ago id_ID 5 years ago is_IS 5 years ago it_CH 5 years ago it_IT 5 years ago ja_JP 5 years ago ka_GE 5 years ago kk_KZ 5 years ago ko_KR 5 years ago lt_LT 5 years ago lv_LV 5 years ago me_ME 5 years ago mn_MN 5 years ago ms_MY 5 years ago nb_NO 5 years ago ne_NP 5 years ago nl_BE 5 years ago nl_NL 5 years ago pl_PL 5 years ago pt_BR 5 years ago pt_PT 5 years ago ro_MD 5 years ago ro_RO 5 years ago ru_RU 5 years ago sk_SK 5 years ago sl_SI 5 years ago sr_Cyrl_RS 5 years ago sr_Latn_RS 5 years ago sr_RS 5 years ago sv_SE 5 years ago th_TH 5 years ago tr_TR 5 years ago uk_UA 5 years ago vi_VN 5 years ago zh_CN 5 years ago zh_TW 5 years ago Address.php 5 years ago Barcode.php 5 years ago Base.php 5 years ago Biased.php 5 years ago Color.php 5 years ago Company.php 5 years ago DateTime.php 5 years ago File.php 5 years ago HtmlLorem.php 5 years ago Image.php 5 years ago Internet.php 5 years ago Lorem.php 5 years ago Miscellaneous.php 5 years ago Payment.php 5 years ago Person.php 5 years ago PhoneNumber.php 5 years ago Text.php 5 years ago UserAgent.php 5 years ago Uuid.php 5 years ago

Text.php

142 lines

1	<?php
2
3	namespace Faker\Provider;
4
5	abstract class Text extends Base
6	{
7	protected static $baseText = '';
8	protected static $separator = ' ';
9	protected static $separatorLen = 1;
10	protected $explodedText;
11	protected $consecutiveWords = array();
12	protected static $textStartsWithUppercase = true;
13
14	/**
15	* Generate a text string by the Markov chain algorithm.
16	*
17	* Depending on the $maxNbChars, returns a random valid looking text. The algorithm
18	* generates a weighted table with the specified number of words as the index and the
19	* possible following words as the value.
20	*
21	* @example 'Alice, swallowing down her flamingo, and began by taking the little golden key'
22	* @param integer $maxNbChars Maximum number of characters the text should contain (minimum: 10)
23	* @param integer $indexSize Determines how many words are considered for the generation of the next word.
24	* The minimum is 1, and it produces a higher level of randomness, although the
25	* generated text usually doesn't make sense. Higher index sizes (up to 5)
26	* produce more correct text, at the price of less randomness.
27	* @return string
28	*/
29	public function realText($maxNbChars = 200, $indexSize = 2)
30	{
31	if ($maxNbChars < 10) {
32	throw new \InvalidArgumentException('maxNbChars must be at least 10');
33	}
34
35	if ($indexSize < 1) {
36	throw new \InvalidArgumentException('indexSize must be at least 1');
37	}
38
39	if ($indexSize > 5) {
40	throw new \InvalidArgumentException('indexSize must be at most 5');
41	}
42
43	$words = $this->getConsecutiveWords($indexSize);
44	$result = array();
45	$resultLength = 0;
46	// take a random starting point
47	$next = static::randomKey($words);
48	while ($resultLength < $maxNbChars && isset($words[$next])) {
49	// fetch a random word to append
50	$word = static::randomElement($words[$next]);
51
52	// calculate next index
53	$currentWords = static::explode($next);
54	$currentWords[] = $word;
55	array_shift($currentWords);
56	$next = static::implode($currentWords);
57
58	// ensure text starts with an uppercase letter
59	if ($resultLength == 0 && !static::validStart($word)) {
60	continue;
61	}
62
63	// append the element
64	$result[] = $word;
65	$resultLength += static::strlen($word) + static::$separatorLen;
66	}
67
68	// remove the element that caused the text to overflow
69	array_pop($result);
70
71	// build result
72	$result = static::implode($result);
73
74	return static::appendEnd($result);
75	}
76
77	protected function getConsecutiveWords($indexSize)
78	{
79	if (!isset($this->consecutiveWords[$indexSize])) {
80	$parts = $this->getExplodedText();
81	$words = array();
82	$index = array();
83	for ($i = 0; $i < $indexSize; $i++) {
84	$index[] = array_shift($parts);
85	}
86
87	for ($i = 0, $count = count($parts); $i < $count; $i++) {
88	$stringIndex = static::implode($index);
89	if (!isset($words[$stringIndex])) {
90	$words[$stringIndex] = array();
91	}
92	$word = $parts[$i];
93	$words[$stringIndex][] = $word;
94	array_shift($index);
95	$index[] = $word;
96	}
97	// cache look up words for performance
98	$this->consecutiveWords[$indexSize] = $words;
99	}
100
101	return $this->consecutiveWords[$indexSize];
102	}
103
104	protected function getExplodedText()
105	{
106	if ($this->explodedText === null) {
107	$this->explodedText = static::explode(preg_replace('/\s+/u', ' ', static::$baseText));
108	}
109
110	return $this->explodedText;
111	}
112
113	protected static function explode($text)
114	{
115	return explode(static::$separator, $text);
116	}
117
118	protected static function implode($words)
119	{
120	return implode(static::$separator, $words);
121	}
122
123	protected static function strlen($text)
124	{
125	return function_exists('mb_strlen') ? mb_strlen($text, 'UTF-8') : strlen($text);
126	}
127
128	protected static function validStart($word)
129	{
130	$isValid = true;
131	if (static::$textStartsWithUppercase) {
132	$isValid = preg_match('/^\p{Lu}/u', $word);
133	}
134	return $isValid;
135	}
136
137	protected static function appendEnd($text)
138	{
139	return preg_replace("/([ ,-:;\x{2013}\x{2014}]+$)/us", '', $text).'.';
140	}
141	}
142