1
|
|
|
<?php |
2
|
|
|
/** |
3
|
|
|
* CakePHP(tm) : Rapid Development Framework (http://cakephp.org) |
4
|
|
|
* Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org) |
5
|
|
|
* |
6
|
|
|
* Licensed under The MIT License |
7
|
|
|
* For full copyright and license information, please see the LICENSE.txt |
8
|
|
|
* Redistributions of files must retain the above copyright notice. |
9
|
|
|
* |
10
|
|
|
* @copyright Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org) |
11
|
|
|
* @link http://cakephp.org CakePHP(tm) Project |
12
|
|
|
* @since 0.2.9 |
13
|
|
|
* @license http://www.opensource.org/licenses/mit-license.php MIT License |
14
|
|
|
*/ |
15
|
|
|
namespace Cake\Utility; |
16
|
|
|
|
17
|
|
|
/** |
18
|
|
|
* Pluralize and singularize English words. |
19
|
|
|
* |
20
|
|
|
* Inflector pluralizes and singularizes English nouns. |
21
|
|
|
* Used by CakePHP's naming conventions throughout the framework. |
22
|
|
|
* |
23
|
|
|
* @link http://book.cakephp.org/3.0/en/core-libraries/inflector.html |
24
|
|
|
*/ |
25
|
|
|
class Inflector |
26
|
|
|
{ |
27
|
|
|
|
28
|
|
|
/** |
29
|
|
|
* Plural inflector rules |
30
|
|
|
* |
31
|
|
|
* @var array |
32
|
|
|
*/ |
33
|
|
|
protected static $_plural = [ |
34
|
|
|
'/(s)tatus$/i' => '\1tatuses', |
35
|
|
|
'/(quiz)$/i' => '\1zes', |
36
|
|
|
'/^(ox)$/i' => '\1\2en', |
37
|
|
|
'/([m|l])ouse$/i' => '\1ice', |
38
|
|
|
'/(matr|vert|ind)(ix|ex)$/i' => '\1ices', |
39
|
|
|
'/(x|ch|ss|sh)$/i' => '\1es', |
40
|
|
|
'/([^aeiouy]|qu)y$/i' => '\1ies', |
41
|
|
|
'/(hive)$/i' => '\1s', |
42
|
|
|
'/(?:([^f])fe|([lre])f)$/i' => '\1\2ves', |
43
|
|
|
'/sis$/i' => 'ses', |
44
|
|
|
'/([ti])um$/i' => '\1a', |
45
|
|
|
'/(p)erson$/i' => '\1eople', |
46
|
|
|
'/(?<!u)(m)an$/i' => '\1en', |
47
|
|
|
'/(c)hild$/i' => '\1hildren', |
48
|
|
|
'/(buffal|tomat)o$/i' => '\1\2oes', |
49
|
|
|
'/(alumn|bacill|cact|foc|fung|nucle|radi|stimul|syllab|termin)us$/i' => '\1i', |
50
|
|
|
'/us$/i' => 'uses', |
51
|
|
|
'/(alias)$/i' => '\1es', |
52
|
|
|
'/(ax|cris|test)is$/i' => '\1es', |
53
|
|
|
'/s$/' => 's', |
54
|
|
|
'/^$/' => '', |
55
|
|
|
'/$/' => 's', |
56
|
|
|
]; |
57
|
|
|
|
58
|
|
|
/** |
59
|
|
|
* Singular inflector rules |
60
|
|
|
* |
61
|
|
|
* @var array |
62
|
|
|
*/ |
63
|
|
|
protected static $_singular = [ |
64
|
|
|
'/(s)tatuses$/i' => '\1\2tatus', |
65
|
|
|
'/^(.*)(menu)s$/i' => '\1\2', |
66
|
|
|
'/(quiz)zes$/i' => '\\1', |
67
|
|
|
'/(matr)ices$/i' => '\1ix', |
68
|
|
|
'/(vert|ind)ices$/i' => '\1ex', |
69
|
|
|
'/^(ox)en/i' => '\1', |
70
|
|
|
'/(alias)(es)*$/i' => '\1', |
71
|
|
|
'/(alumn|bacill|cact|foc|fung|nucle|radi|stimul|syllab|termin|viri?)i$/i' => '\1us', |
72
|
|
|
'/([ftw]ax)es/i' => '\1', |
73
|
|
|
'/(cris|ax|test)es$/i' => '\1is', |
74
|
|
|
'/(shoe)s$/i' => '\1', |
75
|
|
|
'/(o)es$/i' => '\1', |
76
|
|
|
'/ouses$/' => 'ouse', |
77
|
|
|
'/([^a])uses$/' => '\1us', |
78
|
|
|
'/([m|l])ice$/i' => '\1ouse', |
79
|
|
|
'/(x|ch|ss|sh)es$/i' => '\1', |
80
|
|
|
'/(m)ovies$/i' => '\1\2ovie', |
81
|
|
|
'/(s)eries$/i' => '\1\2eries', |
82
|
|
|
'/([^aeiouy]|qu)ies$/i' => '\1y', |
83
|
|
|
'/(tive)s$/i' => '\1', |
84
|
|
|
'/(hive)s$/i' => '\1', |
85
|
|
|
'/(drive)s$/i' => '\1', |
86
|
|
|
'/([le])ves$/i' => '\1f', |
87
|
|
|
'/([^rfoa])ves$/i' => '\1fe', |
88
|
|
|
'/(^analy)ses$/i' => '\1sis', |
89
|
|
|
'/(analy|diagno|^ba|(p)arenthe|(p)rogno|(s)ynop|(t)he)ses$/i' => '\1\2sis', |
90
|
|
|
'/([ti])a$/i' => '\1um', |
91
|
|
|
'/(p)eople$/i' => '\1\2erson', |
92
|
|
|
'/(m)en$/i' => '\1an', |
93
|
|
|
'/(c)hildren$/i' => '\1\2hild', |
94
|
|
|
'/(n)ews$/i' => '\1\2ews', |
95
|
|
|
'/eaus$/' => 'eau', |
96
|
|
|
'/^(.*us)$/' => '\\1', |
97
|
|
|
'/s$/i' => '' |
98
|
|
|
]; |
99
|
|
|
|
100
|
|
|
/** |
101
|
|
|
* Irregular rules |
102
|
|
|
* |
103
|
|
|
* @var array |
104
|
|
|
*/ |
105
|
|
|
protected static $_irregular = [ |
106
|
|
|
'atlas' => 'atlases', |
107
|
|
|
'beef' => 'beefs', |
108
|
|
|
'brief' => 'briefs', |
109
|
|
|
'brother' => 'brothers', |
110
|
|
|
'cafe' => 'cafes', |
111
|
|
|
'child' => 'children', |
112
|
|
|
'cookie' => 'cookies', |
113
|
|
|
'corpus' => 'corpuses', |
114
|
|
|
'cow' => 'cows', |
115
|
|
|
'criterion' => 'criteria', |
116
|
|
|
'ganglion' => 'ganglions', |
117
|
|
|
'genie' => 'genies', |
118
|
|
|
'genus' => 'genera', |
119
|
|
|
'graffito' => 'graffiti', |
120
|
|
|
'hoof' => 'hoofs', |
121
|
|
|
'loaf' => 'loaves', |
122
|
|
|
'man' => 'men', |
123
|
|
|
'money' => 'monies', |
124
|
|
|
'mongoose' => 'mongooses', |
125
|
|
|
'move' => 'moves', |
126
|
|
|
'mythos' => 'mythoi', |
127
|
|
|
'niche' => 'niches', |
128
|
|
|
'numen' => 'numina', |
129
|
|
|
'occiput' => 'occiputs', |
130
|
|
|
'octopus' => 'octopuses', |
131
|
|
|
'opus' => 'opuses', |
132
|
|
|
'ox' => 'oxen', |
133
|
|
|
'penis' => 'penises', |
134
|
|
|
'person' => 'people', |
135
|
|
|
'sex' => 'sexes', |
136
|
|
|
'soliloquy' => 'soliloquies', |
137
|
|
|
'testis' => 'testes', |
138
|
|
|
'trilby' => 'trilbys', |
139
|
|
|
'turf' => 'turfs', |
140
|
|
|
'potato' => 'potatoes', |
141
|
|
|
'hero' => 'heroes', |
142
|
|
|
'tooth' => 'teeth', |
143
|
|
|
'goose' => 'geese', |
144
|
|
|
'foot' => 'feet', |
145
|
|
|
'foe' => 'foes', |
146
|
|
|
'sieve' => 'sieves' |
147
|
|
|
]; |
148
|
|
|
|
149
|
|
|
/** |
150
|
|
|
* Words that should not be inflected |
151
|
|
|
* |
152
|
|
|
* @var array |
153
|
|
|
*/ |
154
|
|
|
protected static $_uninflected = [ |
155
|
|
|
'.*[nrlm]ese', '.*data', '.*deer', '.*fish', '.*measles', '.*ois', |
156
|
|
|
'.*pox', '.*sheep', 'people', 'feedback', 'stadia', '.*?media', |
157
|
|
|
'chassis', 'clippers', 'debris', 'diabetes', 'equipment', 'gallows', |
158
|
|
|
'graffiti', 'headquarters', 'information', 'innings', 'news', 'nexus', |
159
|
|
|
'proceedings', 'research', 'sea[- ]bass', 'series', 'species', 'weather' |
160
|
|
|
]; |
161
|
|
|
|
162
|
|
|
/** |
163
|
|
|
* Default map of accented and special characters to ASCII characters |
164
|
|
|
* |
165
|
|
|
* @var array |
166
|
|
|
*/ |
167
|
|
|
protected static $_transliteration = [ |
168
|
|
|
'ä' => 'ae', |
169
|
|
|
'æ' => 'ae', |
170
|
|
|
'ǽ' => 'ae', |
171
|
|
|
'ö' => 'oe', |
172
|
|
|
'œ' => 'oe', |
173
|
|
|
'ü' => 'ue', |
174
|
|
|
'Ä' => 'Ae', |
175
|
|
|
'Ü' => 'Ue', |
176
|
|
|
'Ö' => 'Oe', |
177
|
|
|
'À' => 'A', |
178
|
|
|
'Á' => 'A', |
179
|
|
|
'Â' => 'A', |
180
|
|
|
'Ã' => 'A', |
181
|
|
|
'Å' => 'A', |
182
|
|
|
'Ǻ' => 'A', |
183
|
|
|
'Ā' => 'A', |
184
|
|
|
'Ă' => 'A', |
185
|
|
|
'Ą' => 'A', |
186
|
|
|
'Ǎ' => 'A', |
187
|
|
|
'à' => 'a', |
188
|
|
|
'á' => 'a', |
189
|
|
|
'â' => 'a', |
190
|
|
|
'ã' => 'a', |
191
|
|
|
'å' => 'a', |
192
|
|
|
'ǻ' => 'a', |
193
|
|
|
'ā' => 'a', |
194
|
|
|
'ă' => 'a', |
195
|
|
|
'ą' => 'a', |
196
|
|
|
'ǎ' => 'a', |
197
|
|
|
'ª' => 'a', |
198
|
|
|
'Ç' => 'C', |
199
|
|
|
'Ć' => 'C', |
200
|
|
|
'Ĉ' => 'C', |
201
|
|
|
'Ċ' => 'C', |
202
|
|
|
'Č' => 'C', |
203
|
|
|
'ç' => 'c', |
204
|
|
|
'ć' => 'c', |
205
|
|
|
'ĉ' => 'c', |
206
|
|
|
'ċ' => 'c', |
207
|
|
|
'č' => 'c', |
208
|
|
|
'Ð' => 'D', |
209
|
|
|
'Ď' => 'D', |
210
|
|
|
'Đ' => 'D', |
211
|
|
|
'ð' => 'd', |
212
|
|
|
'ď' => 'd', |
213
|
|
|
'đ' => 'd', |
214
|
|
|
'È' => 'E', |
215
|
|
|
'É' => 'E', |
216
|
|
|
'Ê' => 'E', |
217
|
|
|
'Ë' => 'E', |
218
|
|
|
'Ē' => 'E', |
219
|
|
|
'Ĕ' => 'E', |
220
|
|
|
'Ė' => 'E', |
221
|
|
|
'Ę' => 'E', |
222
|
|
|
'Ě' => 'E', |
223
|
|
|
'è' => 'e', |
224
|
|
|
'é' => 'e', |
225
|
|
|
'ê' => 'e', |
226
|
|
|
'ë' => 'e', |
227
|
|
|
'ē' => 'e', |
228
|
|
|
'ĕ' => 'e', |
229
|
|
|
'ė' => 'e', |
230
|
|
|
'ę' => 'e', |
231
|
|
|
'ě' => 'e', |
232
|
|
|
'Ĝ' => 'G', |
233
|
|
|
'Ğ' => 'G', |
234
|
|
|
'Ġ' => 'G', |
235
|
|
|
'Ģ' => 'G', |
236
|
|
|
'Ґ' => 'G', |
237
|
|
|
'ĝ' => 'g', |
238
|
|
|
'ğ' => 'g', |
239
|
|
|
'ġ' => 'g', |
240
|
|
|
'ģ' => 'g', |
241
|
|
|
'ґ' => 'g', |
242
|
|
|
'Ĥ' => 'H', |
243
|
|
|
'Ħ' => 'H', |
244
|
|
|
'ĥ' => 'h', |
245
|
|
|
'ħ' => 'h', |
246
|
|
|
'І' => 'I', |
247
|
|
|
'Ì' => 'I', |
248
|
|
|
'Í' => 'I', |
249
|
|
|
'Î' => 'I', |
250
|
|
|
'Ї' => 'Yi', |
251
|
|
|
'Ï' => 'I', |
252
|
|
|
'Ĩ' => 'I', |
253
|
|
|
'Ī' => 'I', |
254
|
|
|
'Ĭ' => 'I', |
255
|
|
|
'Ǐ' => 'I', |
256
|
|
|
'Į' => 'I', |
257
|
|
|
'İ' => 'I', |
258
|
|
|
'і' => 'i', |
259
|
|
|
'ì' => 'i', |
260
|
|
|
'í' => 'i', |
261
|
|
|
'î' => 'i', |
262
|
|
|
'ï' => 'i', |
263
|
|
|
'ї' => 'yi', |
264
|
|
|
'ĩ' => 'i', |
265
|
|
|
'ī' => 'i', |
266
|
|
|
'ĭ' => 'i', |
267
|
|
|
'ǐ' => 'i', |
268
|
|
|
'į' => 'i', |
269
|
|
|
'ı' => 'i', |
270
|
|
|
'Ĵ' => 'J', |
271
|
|
|
'ĵ' => 'j', |
272
|
|
|
'Ķ' => 'K', |
273
|
|
|
'ķ' => 'k', |
274
|
|
|
'Ĺ' => 'L', |
275
|
|
|
'Ļ' => 'L', |
276
|
|
|
'Ľ' => 'L', |
277
|
|
|
'Ŀ' => 'L', |
278
|
|
|
'Ł' => 'L', |
279
|
|
|
'ĺ' => 'l', |
280
|
|
|
'ļ' => 'l', |
281
|
|
|
'ľ' => 'l', |
282
|
|
|
'ŀ' => 'l', |
283
|
|
|
'ł' => 'l', |
284
|
|
|
'Ñ' => 'N', |
285
|
|
|
'Ń' => 'N', |
286
|
|
|
'Ņ' => 'N', |
287
|
|
|
'Ň' => 'N', |
288
|
|
|
'ñ' => 'n', |
289
|
|
|
'ń' => 'n', |
290
|
|
|
'ņ' => 'n', |
291
|
|
|
'ň' => 'n', |
292
|
|
|
'ʼn' => 'n', |
293
|
|
|
'Ò' => 'O', |
294
|
|
|
'Ó' => 'O', |
295
|
|
|
'Ô' => 'O', |
296
|
|
|
'Õ' => 'O', |
297
|
|
|
'Ō' => 'O', |
298
|
|
|
'Ŏ' => 'O', |
299
|
|
|
'Ǒ' => 'O', |
300
|
|
|
'Ő' => 'O', |
301
|
|
|
'Ơ' => 'O', |
302
|
|
|
'Ø' => 'O', |
303
|
|
|
'Ǿ' => 'O', |
304
|
|
|
'ò' => 'o', |
305
|
|
|
'ó' => 'o', |
306
|
|
|
'ô' => 'o', |
307
|
|
|
'õ' => 'o', |
308
|
|
|
'ō' => 'o', |
309
|
|
|
'ŏ' => 'o', |
310
|
|
|
'ǒ' => 'o', |
311
|
|
|
'ő' => 'o', |
312
|
|
|
'ơ' => 'o', |
313
|
|
|
'ø' => 'o', |
314
|
|
|
'ǿ' => 'o', |
315
|
|
|
'º' => 'o', |
316
|
|
|
'Ŕ' => 'R', |
317
|
|
|
'Ŗ' => 'R', |
318
|
|
|
'Ř' => 'R', |
319
|
|
|
'ŕ' => 'r', |
320
|
|
|
'ŗ' => 'r', |
321
|
|
|
'ř' => 'r', |
322
|
|
|
'Ś' => 'S', |
323
|
|
|
'Ŝ' => 'S', |
324
|
|
|
'Ş' => 'S', |
325
|
|
|
'Ș' => 'S', |
326
|
|
|
'Š' => 'S', |
327
|
|
|
'ẞ' => 'SS', |
328
|
|
|
'ś' => 's', |
329
|
|
|
'ŝ' => 's', |
330
|
|
|
'ş' => 's', |
331
|
|
|
'ș' => 's', |
332
|
|
|
'š' => 's', |
333
|
|
|
'ſ' => 's', |
334
|
|
|
'Ţ' => 'T', |
335
|
|
|
'Ț' => 'T', |
336
|
|
|
'Ť' => 'T', |
337
|
|
|
'Ŧ' => 'T', |
338
|
|
|
'ţ' => 't', |
339
|
|
|
'ț' => 't', |
340
|
|
|
'ť' => 't', |
341
|
|
|
'ŧ' => 't', |
342
|
|
|
'Ù' => 'U', |
343
|
|
|
'Ú' => 'U', |
344
|
|
|
'Û' => 'U', |
345
|
|
|
'Ũ' => 'U', |
346
|
|
|
'Ū' => 'U', |
347
|
|
|
'Ŭ' => 'U', |
348
|
|
|
'Ů' => 'U', |
349
|
|
|
'Ű' => 'U', |
350
|
|
|
'Ų' => 'U', |
351
|
|
|
'Ư' => 'U', |
352
|
|
|
'Ǔ' => 'U', |
353
|
|
|
'Ǖ' => 'U', |
354
|
|
|
'Ǘ' => 'U', |
355
|
|
|
'Ǚ' => 'U', |
356
|
|
|
'Ǜ' => 'U', |
357
|
|
|
'ù' => 'u', |
358
|
|
|
'ú' => 'u', |
359
|
|
|
'û' => 'u', |
360
|
|
|
'ũ' => 'u', |
361
|
|
|
'ū' => 'u', |
362
|
|
|
'ŭ' => 'u', |
363
|
|
|
'ů' => 'u', |
364
|
|
|
'ű' => 'u', |
365
|
|
|
'ų' => 'u', |
366
|
|
|
'ư' => 'u', |
367
|
|
|
'ǔ' => 'u', |
368
|
|
|
'ǖ' => 'u', |
369
|
|
|
'ǘ' => 'u', |
370
|
|
|
'ǚ' => 'u', |
371
|
|
|
'ǜ' => 'u', |
372
|
|
|
'Ý' => 'Y', |
373
|
|
|
'Ÿ' => 'Y', |
374
|
|
|
'Ŷ' => 'Y', |
375
|
|
|
'ý' => 'y', |
376
|
|
|
'ÿ' => 'y', |
377
|
|
|
'ŷ' => 'y', |
378
|
|
|
'Ŵ' => 'W', |
379
|
|
|
'ŵ' => 'w', |
380
|
|
|
'Ź' => 'Z', |
381
|
|
|
'Ż' => 'Z', |
382
|
|
|
'Ž' => 'Z', |
383
|
|
|
'ź' => 'z', |
384
|
|
|
'ż' => 'z', |
385
|
|
|
'ž' => 'z', |
386
|
|
|
'Æ' => 'AE', |
387
|
|
|
'Ǽ' => 'AE', |
388
|
|
|
'ß' => 'ss', |
389
|
|
|
'IJ' => 'IJ', |
390
|
|
|
'ij' => 'ij', |
391
|
|
|
'Œ' => 'OE', |
392
|
|
|
'ƒ' => 'f', |
393
|
|
|
'Þ' => 'TH', |
394
|
|
|
'þ' => 'th', |
395
|
|
|
'Є' => 'Ye', |
396
|
|
|
'є' => 'ye', |
397
|
|
|
]; |
398
|
|
|
|
399
|
|
|
/** |
400
|
|
|
* Method cache array. |
401
|
|
|
* |
402
|
|
|
* @var array |
403
|
|
|
*/ |
404
|
|
|
protected static $_cache = []; |
405
|
|
|
|
406
|
|
|
/** |
407
|
|
|
* The initial state of Inflector so reset() works. |
408
|
|
|
* |
409
|
|
|
* @var array |
410
|
|
|
*/ |
411
|
|
|
protected static $_initialState = []; |
412
|
|
|
|
413
|
|
|
/** |
414
|
|
|
* Cache inflected values, and return if already available |
415
|
|
|
* |
416
|
|
|
* @param string $type Inflection type |
417
|
|
|
* @param string $key Original value |
418
|
|
|
* @param string|bool $value Inflected value |
419
|
|
|
* @return string|bool Inflected value on cache hit or false on cache miss. |
420
|
|
|
*/ |
421
|
|
|
protected static function _cache($type, $key, $value = false) |
422
|
|
|
{ |
423
|
|
|
$key = '_' . $key; |
424
|
|
|
$type = '_' . $type; |
425
|
|
|
if ($value !== false) { |
426
|
|
|
static::$_cache[$type][$key] = $value; |
427
|
|
|
return $value; |
428
|
|
|
} |
429
|
|
|
if (!isset(static::$_cache[$type][$key])) { |
430
|
|
|
return false; |
431
|
|
|
} |
432
|
|
|
return static::$_cache[$type][$key]; |
433
|
|
|
} |
434
|
|
|
|
435
|
|
|
/** |
436
|
|
|
* Clears Inflectors inflected value caches. And resets the inflection |
437
|
|
|
* rules to the initial values. |
438
|
|
|
* |
439
|
|
|
* @return void |
440
|
|
|
*/ |
441
|
|
|
public static function reset() |
442
|
|
|
{ |
443
|
|
|
if (empty(static::$_initialState)) { |
444
|
|
|
static::$_initialState = get_class_vars(__CLASS__); |
445
|
|
|
return; |
446
|
|
|
} |
447
|
|
|
foreach (static::$_initialState as $key => $val) { |
448
|
|
|
if ($key !== '_initialState') { |
449
|
|
|
static::${$key} = $val; |
450
|
|
|
} |
451
|
|
|
} |
452
|
|
|
} |
453
|
|
|
|
454
|
|
|
/** |
455
|
|
|
* Adds custom inflection $rules, of either 'plural', 'singular', |
456
|
|
|
* 'uninflected', 'irregular' or 'transliteration' $type. |
457
|
|
|
* |
458
|
|
|
* ### Usage: |
459
|
|
|
* |
460
|
|
|
* ``` |
461
|
|
|
* Inflector::rules('plural', ['/^(inflect)or$/i' => '\1ables']); |
462
|
|
|
* Inflector::rules('irregular', ['red' => 'redlings']); |
463
|
|
|
* Inflector::rules('uninflected', ['dontinflectme']); |
464
|
|
|
* Inflector::rules('transliteration', ['/å/' => 'aa']); |
465
|
|
|
* ``` |
466
|
|
|
* |
467
|
|
|
* @param string $type The type of inflection, either 'plural', 'singular', |
468
|
|
|
* 'uninflected' or 'transliteration'. |
469
|
|
|
* @param array $rules Array of rules to be added. |
470
|
|
|
* @param bool $reset If true, will unset default inflections for all |
471
|
|
|
* new rules that are being defined in $rules. |
472
|
|
|
* @return void |
473
|
|
|
*/ |
474
|
|
|
public static function rules($type, $rules, $reset = false) |
475
|
|
|
{ |
476
|
|
|
$var = '_' . $type; |
477
|
|
|
|
478
|
|
|
if ($reset) { |
479
|
|
|
static::${$var} = $rules; |
480
|
|
|
} elseif ($type === 'uninflected') { |
481
|
|
|
static::$_uninflected = array_merge( |
482
|
|
|
$rules, |
483
|
|
|
static::$_uninflected |
484
|
|
|
); |
485
|
|
|
} else { |
486
|
|
|
static::${$var} = $rules + static::${$var}; |
487
|
|
|
} |
488
|
|
|
|
489
|
|
|
static::$_cache = []; |
490
|
|
|
} |
491
|
|
|
|
492
|
|
|
/** |
493
|
|
|
* Return $word in plural form. |
494
|
|
|
* |
495
|
|
|
* @param string $word Word in singular |
496
|
|
|
* @return string Word in plural |
497
|
|
|
* @link http://book.cakephp.org/3.0/en/core-libraries/inflector.html#creating-plural-singular-forms |
498
|
|
|
*/ |
499
|
|
|
public static function pluralize($word) |
500
|
|
|
{ |
501
|
|
|
if (isset(static::$_cache['pluralize'][$word])) { |
502
|
|
|
return static::$_cache['pluralize'][$word]; |
503
|
|
|
} |
504
|
|
|
|
505
|
|
|
if (!isset(static::$_cache['irregular']['pluralize'])) { |
506
|
|
|
static::$_cache['irregular']['pluralize'] = '(?:' . implode('|', array_keys(static::$_irregular)) . ')'; |
507
|
|
|
} |
508
|
|
|
|
509
|
|
View Code Duplication |
if (preg_match('/(.*?(?:\\b|_))(' . static::$_cache['irregular']['pluralize'] . ')$/i', $word, $regs)) { |
510
|
|
|
static::$_cache['pluralize'][$word] = $regs[1] . substr($regs[2], 0, 1) . |
511
|
|
|
substr(static::$_irregular[strtolower($regs[2])], 1); |
512
|
|
|
return static::$_cache['pluralize'][$word]; |
513
|
|
|
} |
514
|
|
|
|
515
|
|
View Code Duplication |
if (!isset(static::$_cache['uninflected'])) { |
516
|
|
|
static::$_cache['uninflected'] = '(?:' . implode('|', static::$_uninflected) . ')'; |
517
|
|
|
} |
518
|
|
|
|
519
|
|
View Code Duplication |
if (preg_match('/^(' . static::$_cache['uninflected'] . ')$/i', $word, $regs)) { |
520
|
|
|
static::$_cache['pluralize'][$word] = $word; |
521
|
|
|
return $word; |
522
|
|
|
} |
523
|
|
|
|
524
|
|
View Code Duplication |
foreach (static::$_plural as $rule => $replacement) { |
525
|
|
|
if (preg_match($rule, $word)) { |
526
|
|
|
static::$_cache['pluralize'][$word] = preg_replace($rule, $replacement, $word); |
527
|
|
|
return static::$_cache['pluralize'][$word]; |
528
|
|
|
} |
529
|
|
|
} |
530
|
|
|
} |
531
|
|
|
|
532
|
|
|
/** |
533
|
|
|
* Return $word in singular form. |
534
|
|
|
* |
535
|
|
|
* @param string $word Word in plural |
536
|
|
|
* @return string Word in singular |
537
|
|
|
* @link http://book.cakephp.org/3.0/en/core-libraries/inflector.html#creating-plural-singular-forms |
538
|
|
|
*/ |
539
|
|
|
public static function singularize($word) |
540
|
|
|
{ |
541
|
|
|
if (isset(static::$_cache['singularize'][$word])) { |
542
|
|
|
return static::$_cache['singularize'][$word]; |
543
|
|
|
} |
544
|
|
|
|
545
|
|
View Code Duplication |
if (!isset(static::$_cache['irregular']['singular'])) { |
546
|
|
|
static::$_cache['irregular']['singular'] = '(?:' . implode('|', static::$_irregular) . ')'; |
547
|
|
|
} |
548
|
|
|
|
549
|
|
View Code Duplication |
if (preg_match('/(.*?(?:\\b|_))(' . static::$_cache['irregular']['singular'] . ')$/i', $word, $regs)) { |
550
|
|
|
static::$_cache['singularize'][$word] = $regs[1] . substr($regs[2], 0, 1) . |
551
|
|
|
substr(array_search(strtolower($regs[2]), static::$_irregular), 1); |
552
|
|
|
return static::$_cache['singularize'][$word]; |
553
|
|
|
} |
554
|
|
|
|
555
|
|
View Code Duplication |
if (!isset(static::$_cache['uninflected'])) { |
556
|
|
|
static::$_cache['uninflected'] = '(?:' . implode('|', static::$_uninflected) . ')'; |
557
|
|
|
} |
558
|
|
|
|
559
|
|
View Code Duplication |
if (preg_match('/^(' . static::$_cache['uninflected'] . ')$/i', $word, $regs)) { |
560
|
|
|
static::$_cache['pluralize'][$word] = $word; |
561
|
|
|
return $word; |
562
|
|
|
} |
563
|
|
|
|
564
|
|
View Code Duplication |
foreach (static::$_singular as $rule => $replacement) { |
565
|
|
|
if (preg_match($rule, $word)) { |
566
|
|
|
static::$_cache['singularize'][$word] = preg_replace($rule, $replacement, $word); |
567
|
|
|
return static::$_cache['singularize'][$word]; |
568
|
|
|
} |
569
|
|
|
} |
570
|
|
|
static::$_cache['singularize'][$word] = $word; |
571
|
|
|
return $word; |
572
|
|
|
} |
573
|
|
|
|
574
|
|
|
/** |
575
|
|
|
* Returns the input lower_case_delimited_string as a CamelCasedString. |
576
|
|
|
* |
577
|
|
|
* @param string $string String to camelize |
578
|
|
|
* @param string $delimiter the delimiter in the input string |
579
|
|
|
* @return string CamelizedStringLikeThis. |
580
|
|
|
* @link http://book.cakephp.org/3.0/en/core-libraries/inflector.html#creating-camelcase-and-under-scored-forms |
581
|
|
|
*/ |
582
|
|
|
public static function camelize($string, $delimiter = '_') |
583
|
|
|
{ |
584
|
|
|
$cacheKey = __FUNCTION__ . $delimiter; |
585
|
|
|
|
586
|
|
|
$result = static::_cache($cacheKey, $string); |
587
|
|
|
|
588
|
|
|
if ($result === false) { |
589
|
|
|
$result = str_replace(' ', '', static::humanize($string, $delimiter)); |
590
|
|
|
static::_cache($cacheKey, $string, $result); |
591
|
|
|
} |
592
|
|
|
|
593
|
|
|
return $result; |
594
|
|
|
} |
595
|
|
|
|
596
|
|
|
/** |
597
|
|
|
* Returns the input CamelCasedString as an underscored_string. |
598
|
|
|
* |
599
|
|
|
* Also replaces dashes with underscores |
600
|
|
|
* |
601
|
|
|
* @param string $string CamelCasedString to be "underscorized" |
602
|
|
|
* @return string underscore_version of the input string |
603
|
|
|
* @link http://book.cakephp.org/3.0/en/core-libraries/inflector.html#creating-camelcase-and-under-scored-forms |
604
|
|
|
*/ |
605
|
|
|
public static function underscore($string) |
606
|
|
|
{ |
607
|
|
|
return static::delimit(str_replace('-', '_', $string), '_'); |
608
|
|
|
} |
609
|
|
|
|
610
|
|
|
/** |
611
|
|
|
* Returns the input CamelCasedString as an dashed-string. |
612
|
|
|
* |
613
|
|
|
* Also replaces underscores with dashes |
614
|
|
|
* |
615
|
|
|
* @param string $string The string to dasherize. |
616
|
|
|
* @return string Dashed version of the input string |
617
|
|
|
*/ |
618
|
|
|
public static function dasherize($string) |
619
|
|
|
{ |
620
|
|
|
return static::delimit(str_replace('_', '-', $string), '-'); |
621
|
|
|
} |
622
|
|
|
|
623
|
|
|
/** |
624
|
|
|
* Returns the input lower_case_delimited_string as 'A Human Readable String'. |
625
|
|
|
* (Underscores are replaced by spaces and capitalized following words.) |
626
|
|
|
* |
627
|
|
|
* @param string $string String to be humanized |
628
|
|
|
* @param string $delimiter the character to replace with a space |
629
|
|
|
* @return string Human-readable string |
630
|
|
|
* @link http://book.cakephp.org/3.0/en/core-libraries/inflector.html#creating-human-readable-forms |
631
|
|
|
*/ |
632
|
|
|
public static function humanize($string, $delimiter = '_') |
633
|
|
|
{ |
634
|
|
|
$cacheKey = __FUNCTION__ . $delimiter; |
635
|
|
|
|
636
|
|
|
$result = static::_cache($cacheKey, $string); |
637
|
|
|
|
638
|
|
|
if ($result === false) { |
639
|
|
|
$result = explode(' ', str_replace($delimiter, ' ', $string)); |
640
|
|
|
foreach ($result as &$word) { |
641
|
|
|
$word = mb_strtoupper(mb_substr($word, 0, 1)) . mb_substr($word, 1); |
642
|
|
|
} |
643
|
|
|
$result = implode(' ', $result); |
644
|
|
|
static::_cache($cacheKey, $string, $result); |
645
|
|
|
} |
646
|
|
|
|
647
|
|
|
return $result; |
648
|
|
|
} |
649
|
|
|
|
650
|
|
|
/** |
651
|
|
|
* Expects a CamelCasedInputString, and produces a lower_case_delimited_string |
652
|
|
|
* |
653
|
|
|
* @param string $string String to delimit |
654
|
|
|
* @param string $delimiter the character to use as a delimiter |
655
|
|
|
* @return string delimited string |
656
|
|
|
*/ |
657
|
|
|
public static function delimit($string, $delimiter = '_') |
658
|
|
|
{ |
659
|
|
|
$cacheKey = __FUNCTION__ . $delimiter; |
660
|
|
|
|
661
|
|
|
$result = static::_cache($cacheKey, $string); |
662
|
|
|
|
663
|
|
|
if ($result === false) { |
664
|
|
|
$result = mb_strtolower(preg_replace('/(?<=\\w)([A-Z])/', $delimiter . '\\1', $string)); |
665
|
|
|
static::_cache($cacheKey, $string, $result); |
666
|
|
|
} |
667
|
|
|
|
668
|
|
|
return $result; |
669
|
|
|
} |
670
|
|
|
|
671
|
|
|
/** |
672
|
|
|
* Returns corresponding table name for given model $className. ("people" for the model class "Person"). |
673
|
|
|
* |
674
|
|
|
* @param string $className Name of class to get database table name for |
675
|
|
|
* @return string Name of the database table for given class |
676
|
|
|
* @link http://book.cakephp.org/3.0/en/core-libraries/inflector.html#creating-table-and-class-name-forms |
677
|
|
|
*/ |
678
|
|
|
public static function tableize($className) |
679
|
|
|
{ |
680
|
|
|
$result = static::_cache(__FUNCTION__, $className); |
681
|
|
|
|
682
|
|
|
if ($result === false) { |
683
|
|
|
$result = static::pluralize(static::underscore($className)); |
684
|
|
|
static::_cache(__FUNCTION__, $className, $result); |
685
|
|
|
} |
686
|
|
|
|
687
|
|
|
return $result; |
688
|
|
|
} |
689
|
|
|
|
690
|
|
|
/** |
691
|
|
|
* Returns Cake model class name ("Person" for the database table "people".) for given database table. |
692
|
|
|
* |
693
|
|
|
* @param string $tableName Name of database table to get class name for |
694
|
|
|
* @return string Class name |
695
|
|
|
* @link http://book.cakephp.org/3.0/en/core-libraries/inflector.html#creating-table-and-class-name-forms |
696
|
|
|
*/ |
697
|
|
|
public static function classify($tableName) |
698
|
|
|
{ |
699
|
|
|
$result = static::_cache(__FUNCTION__, $tableName); |
700
|
|
|
|
701
|
|
|
if ($result === false) { |
702
|
|
|
$result = static::camelize(static::singularize($tableName)); |
703
|
|
|
static::_cache(__FUNCTION__, $tableName, $result); |
704
|
|
|
} |
705
|
|
|
|
706
|
|
|
return $result; |
707
|
|
|
} |
708
|
|
|
|
709
|
|
|
/** |
710
|
|
|
* Returns camelBacked version of an underscored string. |
711
|
|
|
* |
712
|
|
|
* @param string $string String to convert. |
713
|
|
|
* @return string in variable form |
714
|
|
|
* @link http://book.cakephp.org/3.0/en/core-libraries/inflector.html#creating-variable-names |
715
|
|
|
*/ |
716
|
|
|
public static function variable($string) |
717
|
|
|
{ |
718
|
|
|
$result = static::_cache(__FUNCTION__, $string); |
719
|
|
|
|
720
|
|
|
if ($result === false) { |
721
|
|
|
$camelized = static::camelize(static::underscore($string)); |
722
|
|
|
$replace = strtolower(substr($camelized, 0, 1)); |
723
|
|
|
$result = $replace . substr($camelized, 1); |
724
|
|
|
static::_cache(__FUNCTION__, $string, $result); |
725
|
|
|
} |
726
|
|
|
|
727
|
|
|
return $result; |
728
|
|
|
} |
729
|
|
|
|
730
|
|
|
/** |
731
|
|
|
* Returns a string with all spaces converted to dashes (by default), accented |
732
|
|
|
* characters converted to non-accented characters, and non word characters removed. |
733
|
|
|
* |
734
|
|
|
* @param string $string the string you want to slug |
735
|
|
|
* @param string $replacement will replace keys in map |
736
|
|
|
* @return string |
737
|
|
|
* @link http://book.cakephp.org/3.0/en/core-libraries/inflector.html#creating-url-safe-strings |
738
|
|
|
*/ |
739
|
|
|
public static function slug($string, $replacement = '-') |
740
|
|
|
{ |
741
|
|
|
$quotedReplacement = preg_quote($replacement, '/'); |
742
|
|
|
|
743
|
|
|
$map = [ |
744
|
|
|
'/[^\s\p{Zs}\p{Ll}\p{Lm}\p{Lo}\p{Lt}\p{Lu}\p{Nd}]/mu' => ' ', |
745
|
|
|
'/[\s\p{Zs}]+/mu' => $replacement, |
746
|
|
|
sprintf('/^[%s]+|[%s]+$/', $quotedReplacement, $quotedReplacement) => '', |
747
|
|
|
]; |
748
|
|
|
|
749
|
|
|
$string = str_replace( |
750
|
|
|
array_keys(static::$_transliteration), |
751
|
|
|
array_values(static::$_transliteration), |
752
|
|
|
$string |
753
|
|
|
); |
754
|
|
|
return preg_replace(array_keys($map), array_values($map), $string); |
755
|
|
|
} |
756
|
|
|
} |
757
|
|
|
|