Lorem.php — GiveWP – Donation Plugin and Fundraising Platform 2.19.7

give / vendor / fakerphp / faker / src / Faker / Provider / Lorem.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

Lorem.php

204 lines

1	<?php
2
3	namespace Faker\Provider;
4
5	class Lorem extends Base
6	{
7	protected static $wordList = array(
8	'alias', 'consequatur', 'aut', 'perferendis', 'sit', 'voluptatem',
9	'accusantium', 'doloremque', 'aperiam', 'eaque','ipsa', 'quae', 'ab',
10	'illo', 'inventore', 'veritatis', 'et', 'quasi', 'architecto',
11	'beatae', 'vitae', 'dicta', 'sunt', 'explicabo', 'aspernatur', 'aut',
12	'odit', 'aut', 'fugit', 'sed', 'quia', 'consequuntur', 'magni',
13	'dolores', 'eos', 'qui', 'ratione', 'voluptatem', 'sequi', 'nesciunt',
14	'neque', 'dolorem', 'ipsum', 'quia', 'dolor', 'sit', 'amet',
15	'consectetur', 'adipisci', 'velit', 'sed', 'quia', 'non', 'numquam',
16	'eius', 'modi', 'tempora', 'incidunt', 'ut', 'labore', 'et', 'dolore',
17	'magnam', 'aliquam', 'quaerat', 'voluptatem', 'ut', 'enim', 'ad',
18	'minima', 'veniam', 'quis', 'nostrum', 'exercitationem', 'ullam',
19	'corporis', 'nemo', 'enim', 'ipsam', 'voluptatem', 'quia', 'voluptas',
20	'sit', 'suscipit', 'laboriosam', 'nisi', 'ut', 'aliquid', 'ex', 'ea',
21	'commodi', 'consequatur', 'quis', 'autem', 'vel', 'eum', 'iure',
22	'reprehenderit', 'qui', 'in', 'ea', 'voluptate', 'velit', 'esse',
23	'quam', 'nihil', 'molestiae', 'et', 'iusto', 'odio', 'dignissimos',
24	'ducimus', 'qui', 'blanditiis', 'praesentium', 'laudantium', 'totam',
25	'rem', 'voluptatum', 'deleniti', 'atque', 'corrupti', 'quos',
26	'dolores', 'et', 'quas', 'molestias', 'excepturi', 'sint',
27	'occaecati', 'cupiditate', 'non', 'provident', 'sed', 'ut',
28	'perspiciatis', 'unde', 'omnis', 'iste', 'natus', 'error',
29	'similique', 'sunt', 'in', 'culpa', 'qui', 'officia', 'deserunt',
30	'mollitia', 'animi', 'id', 'est', 'laborum', 'et', 'dolorum', 'fuga',
31	'et', 'harum', 'quidem', 'rerum', 'facilis', 'est', 'et', 'expedita',
32	'distinctio', 'nam', 'libero', 'tempore', 'cum', 'soluta', 'nobis',
33	'est', 'eligendi', 'optio', 'cumque', 'nihil', 'impedit', 'quo',
34	'porro', 'quisquam', 'est', 'qui', 'minus', 'id', 'quod', 'maxime',
35	'placeat', 'facere', 'possimus', 'omnis', 'voluptas', 'assumenda',
36	'est', 'omnis', 'dolor', 'repellendus', 'temporibus', 'autem',
37	'quibusdam', 'et', 'aut', 'consequatur', 'vel', 'illum', 'qui',
38	'dolorem', 'eum', 'fugiat', 'quo', 'voluptas', 'nulla', 'pariatur',
39	'at', 'vero', 'eos', 'et', 'accusamus', 'officiis', 'debitis', 'aut',
40	'rerum', 'necessitatibus', 'saepe', 'eveniet', 'ut', 'et',
41	'voluptates', 'repudiandae', 'sint', 'et', 'molestiae', 'non',
42	'recusandae', 'itaque', 'earum', 'rerum', 'hic', 'tenetur', 'a',
43	'sapiente', 'delectus', 'ut', 'aut', 'reiciendis', 'voluptatibus',
44	'maiores', 'doloribus', 'asperiores', 'repellat'
45	);
46
47	/**
48	* @example 'Lorem'
49	* @return string
50	*/
51	public static function word()
52	{
53	return static::randomElement(static::$wordList);
54	}
55
56	/**
57	* Generate an array of random words
58	*
59	* @example array('Lorem', 'ipsum', 'dolor')
60	* @param integer $nb how many words to return
61	* @param bool $asText if true the sentences are returned as one string
62	* @return array\|string
63	*/
64	public static function words($nb = 3, $asText = false)
65	{
66	$words = array();
67	for ($i=0; $i < $nb; $i++) {
68	$words []= static::word();
69	}
70
71	return $asText ? implode(' ', $words) : $words;
72	}
73
74	/**
75	* Generate a random sentence
76	*
77	* @example 'Lorem ipsum dolor sit amet.'
78	* @param integer $nbWords around how many words the sentence should contain
79	* @param boolean $variableNbWords set to false if you want exactly $nbWords returned,
80	* otherwise $nbWords may vary by +/-40% with a minimum of 1
81	* @return string
82	*/
83	public static function sentence($nbWords = 6, $variableNbWords = true)
84	{
85	if ($nbWords <= 0) {
86	return '';
87	}
88	if ($variableNbWords) {
89	$nbWords = self::randomizeNbElements($nbWords);
90	}
91
92	$words = static::words($nbWords);
93	$words[0] = ucwords($words[0]);
94
95	return implode(' ', $words) . '.';
96	}
97
98	/**
99	* Generate an array of sentences
100	*
101	* @example array('Lorem ipsum dolor sit amet.', 'Consectetur adipisicing eli.')
102	* @param integer $nb how many sentences to return
103	* @param bool $asText if true the sentences are returned as one string
104	* @return array\|string
105	*/
106	public static function sentences($nb = 3, $asText = false)
107	{
108	$sentences = array();
109	for ($i=0; $i < $nb; $i++) {
110	$sentences []= static::sentence();
111	}
112
113	return $asText ? implode(' ', $sentences) : $sentences;
114	}
115
116	/**
117	* Generate a single paragraph
118	*
119	* @example 'Sapiente sunt omnis. Ut pariatur ad autem ducimus et. Voluptas rem voluptas sint modi dolorem amet.'
120	* @param integer $nbSentences around how many sentences the paragraph should contain
121	* @param boolean $variableNbSentences set to false if you want exactly $nbSentences returned,
122	* otherwise $nbSentences may vary by +/-40% with a minimum of 1
123	* @return string
124	*/
125	public static function paragraph($nbSentences = 3, $variableNbSentences = true)
126	{
127	if ($nbSentences <= 0) {
128	return '';
129	}
130	if ($variableNbSentences) {
131	$nbSentences = self::randomizeNbElements($nbSentences);
132	}
133
134	return implode(' ', static::sentences($nbSentences));
135	}
136
137	/**
138	* Generate an array of paragraphs
139	*
140	* @example array($paragraph1, $paragraph2, $paragraph3)
141	* @param integer $nb how many paragraphs to return
142	* @param bool $asText if true the paragraphs are returned as one string, separated by two newlines
143	* @return array\|string
144	*/
145	public static function paragraphs($nb = 3, $asText = false)
146	{
147	$paragraphs = array();
148	for ($i=0; $i < $nb; $i++) {
149	$paragraphs []= static::paragraph();
150	}
151
152	return $asText ? implode("\n\n", $paragraphs) : $paragraphs;
153	}
154
155	/**
156	* Generate a text string.
157	* Depending on the $maxNbChars, returns a string made of words, sentences, or paragraphs.
158	*
159	* @example 'Sapiente sunt omnis. Ut pariatur ad autem ducimus et. Voluptas rem voluptas sint modi dolorem amet.'
160	*
161	* @param integer $maxNbChars Maximum number of characters the text should contain (minimum 5)
162	*
163	* @return string
164	*/
165	public static function text($maxNbChars = 200)
166	{
167	if ($maxNbChars < 5) {
168	throw new \InvalidArgumentException('text() can only generate text of at least 5 characters');
169	}
170
171	$type = ($maxNbChars < 25) ? 'word' : (($maxNbChars < 100) ? 'sentence' : 'paragraph');
172
173	$text = array();
174	while (empty($text)) {
175	$size = 0;
176
177	// until $maxNbChars is reached
178	while ($size < $maxNbChars) {
179	$word = ($size ? ' ' : '') . static::$type();
180	$text[] = $word;
181
182	$size += strlen($word);
183	}
184
185	array_pop($text);
186	}
187
188	if ($type === 'word') {
189	// capitalize first letter
190	$text[0] = ucwords($text[0]);
191
192	// end sentence with full stop
193	$text[count($text) - 1] .= '.';
194	}
195
196	return implode('', $text);
197	}
198
199	protected static function randomizeNbElements($nbElements)
200	{
201	return (int) ($nbElements * mt_rand(60, 140) / 100) + 1;
202	}
203	}
204