pictcode / lib / Cake / Utility / Inflector.php @ 635eef61
履歴 | 表示 | アノテート | ダウンロード (18.194 KB)
1 | 635eef61 | spyder1211 | <?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 | * @package Cake.Utility
|
||
13 | * @since CakePHP(tm) v 0.2.9
|
||
14 | * @license http://www.opensource.org/licenses/mit-license.php MIT License
|
||
15 | */
|
||
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 | * @package Cake.Utility
|
||
24 | * @link http://book.cakephp.org/2.0/en/core-utility-libraries/inflector.html
|
||
25 | */
|
||
26 | class Inflector { |
||
27 | |||
28 | /**
|
||
29 | * Plural inflector rules
|
||
30 | *
|
||
31 | * @var array
|
||
32 | */
|
||
33 | protected static $_plural = array( |
||
34 | 'rules' => array( |
||
35 | '/(s)tatus$/i' => '\1tatuses', |
||
36 | '/(quiz)$/i' => '\1zes', |
||
37 | '/^(ox)$/i' => '\1\2en', |
||
38 | '/([m|l])ouse$/i' => '\1ice', |
||
39 | '/(matr|vert|ind)(ix|ex)$/i' => '\1ices', |
||
40 | '/(x|ch|ss|sh)$/i' => '\1es', |
||
41 | '/([^aeiouy]|qu)y$/i' => '\1ies', |
||
42 | '/(hive)$/i' => '\1s', |
||
43 | '/(?:([^f])fe|([lre])f)$/i' => '\1\2ves', |
||
44 | '/sis$/i' => 'ses', |
||
45 | '/([ti])um$/i' => '\1a', |
||
46 | '/(p)erson$/i' => '\1eople', |
||
47 | '/(?<!u)(m)an$/i' => '\1en', |
||
48 | '/(c)hild$/i' => '\1hildren', |
||
49 | '/(buffal|tomat)o$/i' => '\1\2oes', |
||
50 | '/(alumn|bacill|cact|foc|fung|nucle|radi|stimul|syllab|termin)us$/i' => '\1i', |
||
51 | '/us$/i' => 'uses', |
||
52 | '/(alias)$/i' => '\1es', |
||
53 | '/(ax|cris|test)is$/i' => '\1es', |
||
54 | '/s$/' => 's', |
||
55 | '/^$/' => '', |
||
56 | '/$/' => 's', |
||
57 | ), |
||
58 | 'uninflected' => array( |
||
59 | '.*[nrlm]ese',
|
||
60 | '.*data',
|
||
61 | '.*deer',
|
||
62 | '.*fish',
|
||
63 | '.*measles',
|
||
64 | '.*ois',
|
||
65 | '.*pox',
|
||
66 | '.*sheep',
|
||
67 | 'people',
|
||
68 | 'feedback',
|
||
69 | 'stadia'
|
||
70 | ), |
||
71 | 'irregular' => array( |
||
72 | 'atlas' => 'atlases', |
||
73 | 'beef' => 'beefs', |
||
74 | 'brief' => 'briefs', |
||
75 | 'brother' => 'brothers', |
||
76 | 'cafe' => 'cafes', |
||
77 | 'child' => 'children', |
||
78 | 'cookie' => 'cookies', |
||
79 | 'corpus' => 'corpuses', |
||
80 | 'cow' => 'cows', |
||
81 | 'criterion' => 'criteria', |
||
82 | 'ganglion' => 'ganglions', |
||
83 | 'genie' => 'genies', |
||
84 | 'genus' => 'genera', |
||
85 | 'graffito' => 'graffiti', |
||
86 | 'hoof' => 'hoofs', |
||
87 | 'loaf' => 'loaves', |
||
88 | 'man' => 'men', |
||
89 | 'money' => 'monies', |
||
90 | 'mongoose' => 'mongooses', |
||
91 | 'move' => 'moves', |
||
92 | 'mythos' => 'mythoi', |
||
93 | 'niche' => 'niches', |
||
94 | 'numen' => 'numina', |
||
95 | 'occiput' => 'occiputs', |
||
96 | 'octopus' => 'octopuses', |
||
97 | 'opus' => 'opuses', |
||
98 | 'ox' => 'oxen', |
||
99 | 'penis' => 'penises', |
||
100 | 'person' => 'people', |
||
101 | 'sex' => 'sexes', |
||
102 | 'soliloquy' => 'soliloquies', |
||
103 | 'testis' => 'testes', |
||
104 | 'trilby' => 'trilbys', |
||
105 | 'turf' => 'turfs', |
||
106 | 'potato' => 'potatoes', |
||
107 | 'hero' => 'heroes', |
||
108 | 'tooth' => 'teeth', |
||
109 | 'goose' => 'geese', |
||
110 | 'foot' => 'feet', |
||
111 | 'sieve' => 'sieves' |
||
112 | ) |
||
113 | ); |
||
114 | |||
115 | /**
|
||
116 | * Singular inflector rules
|
||
117 | *
|
||
118 | * @var array
|
||
119 | */
|
||
120 | protected static $_singular = array( |
||
121 | 'rules' => array( |
||
122 | '/(s)tatuses$/i' => '\1\2tatus', |
||
123 | '/^(.*)(menu)s$/i' => '\1\2', |
||
124 | '/(quiz)zes$/i' => '\\1', |
||
125 | '/(matr)ices$/i' => '\1ix', |
||
126 | '/(vert|ind)ices$/i' => '\1ex', |
||
127 | '/^(ox)en/i' => '\1', |
||
128 | '/(alias)(es)*$/i' => '\1', |
||
129 | '/(alumn|bacill|cact|foc|fung|nucle|radi|stimul|syllab|termin|viri?)i$/i' => '\1us', |
||
130 | '/([ftw]ax)es/i' => '\1', |
||
131 | '/(cris|ax|test)es$/i' => '\1is', |
||
132 | '/(shoe)s$/i' => '\1', |
||
133 | '/(o)es$/i' => '\1', |
||
134 | '/ouses$/' => 'ouse', |
||
135 | '/([^a])uses$/' => '\1us', |
||
136 | '/([m|l])ice$/i' => '\1ouse', |
||
137 | '/(x|ch|ss|sh)es$/i' => '\1', |
||
138 | '/(m)ovies$/i' => '\1\2ovie', |
||
139 | '/(s)eries$/i' => '\1\2eries', |
||
140 | '/([^aeiouy]|qu)ies$/i' => '\1y', |
||
141 | '/(tive)s$/i' => '\1', |
||
142 | '/(hive)s$/i' => '\1', |
||
143 | '/(drive)s$/i' => '\1', |
||
144 | '/([le])ves$/i' => '\1f', |
||
145 | '/([^rfoa])ves$/i' => '\1fe', |
||
146 | '/(^analy)ses$/i' => '\1sis', |
||
147 | '/(analy|diagno|^ba|(p)arenthe|(p)rogno|(s)ynop|(t)he)ses$/i' => '\1\2sis', |
||
148 | '/([ti])a$/i' => '\1um', |
||
149 | '/(p)eople$/i' => '\1\2erson', |
||
150 | '/(m)en$/i' => '\1an', |
||
151 | '/(c)hildren$/i' => '\1\2hild', |
||
152 | '/(n)ews$/i' => '\1\2ews', |
||
153 | '/eaus$/' => 'eau', |
||
154 | '/^(.*us)$/' => '\\1', |
||
155 | '/s$/i' => '' |
||
156 | ), |
||
157 | 'uninflected' => array( |
||
158 | '.*data',
|
||
159 | '.*[nrlm]ese', '.*deer', '.*fish', '.*measles', '.*ois', '.*pox', '.*sheep', '.*ss', 'feedback' |
||
160 | ), |
||
161 | 'irregular' => array( |
||
162 | 'foes' => 'foe', |
||
163 | ) |
||
164 | ); |
||
165 | |||
166 | /**
|
||
167 | * Words that should not be inflected
|
||
168 | *
|
||
169 | * @var array
|
||
170 | */
|
||
171 | protected static $_uninflected = array( |
||
172 | 'Amoyese', 'bison', 'Borghese', 'bream', 'breeches', 'britches', 'buffalo', 'cantus', |
||
173 | 'carp', 'chassis', 'clippers', 'cod', 'coitus', 'Congoese', 'contretemps', 'corps', |
||
174 | 'debris', 'diabetes', 'djinn', 'eland', 'elk', 'equipment', 'Faroese', 'flounder', |
||
175 | 'Foochowese', 'gallows', 'Genevese', 'Genoese', 'Gilbertese', 'graffiti', |
||
176 | 'headquarters', 'herpes', 'hijinks', 'Hottentotese', 'information', 'innings', |
||
177 | 'jackanapes', 'Kiplingese', 'Kongoese', 'Lucchese', 'mackerel', 'Maltese', '.*?media', |
||
178 | 'mews', 'moose', 'mumps', 'Nankingese', 'news', 'nexus', 'Niasese', |
||
179 | 'Pekingese', 'Piedmontese', 'pincers', 'Pistoiese', 'pliers', 'Portuguese', |
||
180 | 'proceedings', 'rabies', 'research', 'rice', 'rhinoceros', 'salmon', 'Sarawakese', 'scissors', |
||
181 | 'sea[- ]bass', 'series', 'Shavese', 'shears', 'siemens', 'species', 'swine', 'testes', |
||
182 | 'trousers', 'trout', 'tuna', 'Vermontese', 'Wenchowese', 'whiting', 'wildebeest', |
||
183 | 'Yengeese'
|
||
184 | ); |
||
185 | |||
186 | /**
|
||
187 | * Default map of accented and special characters to ASCII characters
|
||
188 | *
|
||
189 | * @var array
|
||
190 | */
|
||
191 | protected static $_transliteration = array( |
||
192 | '/À|Á|Â|Ã|Å|Ǻ|Ā|Ă|Ą|Ǎ/' => 'A', |
||
193 | '/Æ|Ǽ/' => 'AE', |
||
194 | '/Ä/' => 'Ae', |
||
195 | '/Ç|Ć|Ĉ|Ċ|Č/' => 'C', |
||
196 | '/Ð|Ď|Đ/' => 'D', |
||
197 | '/È|É|Ê|Ë|Ē|Ĕ|Ė|Ę|Ě/' => 'E', |
||
198 | '/Ĝ|Ğ|Ġ|Ģ|Ґ/' => 'G', |
||
199 | '/Ĥ|Ħ/' => 'H', |
||
200 | '/Ì|Í|Î|Ï|Ĩ|Ī|Ĭ|Ǐ|Į|İ|І/' => 'I', |
||
201 | '/IJ/' => 'IJ', |
||
202 | '/Ĵ/' => 'J', |
||
203 | '/Ķ/' => 'K', |
||
204 | '/Ĺ|Ļ|Ľ|Ŀ|Ł/' => 'L', |
||
205 | '/Ñ|Ń|Ņ|Ň/' => 'N', |
||
206 | '/Ò|Ó|Ô|Õ|Ō|Ŏ|Ǒ|Ő|Ơ|Ø|Ǿ/' => 'O', |
||
207 | '/Œ/' => 'OE', |
||
208 | '/Ö/' => 'Oe', |
||
209 | '/Ŕ|Ŗ|Ř/' => 'R', |
||
210 | '/Ś|Ŝ|Ş|Ș|Š/' => 'S', |
||
211 | '/ẞ/' => 'SS', |
||
212 | '/Ţ|Ț|Ť|Ŧ/' => 'T', |
||
213 | '/Þ/' => 'TH', |
||
214 | '/Ù|Ú|Û|Ũ|Ū|Ŭ|Ů|Ű|Ų|Ư|Ǔ|Ǖ|Ǘ|Ǚ|Ǜ/' => 'U', |
||
215 | '/Ü/' => 'Ue', |
||
216 | '/Ŵ/' => 'W', |
||
217 | '/Ý|Ÿ|Ŷ/' => 'Y', |
||
218 | '/Є/' => 'Ye', |
||
219 | '/Ї/' => 'Yi', |
||
220 | '/Ź|Ż|Ž/' => 'Z', |
||
221 | '/à|á|â|ã|å|ǻ|ā|ă|ą|ǎ|ª/' => 'a', |
||
222 | '/ä|æ|ǽ/' => 'ae', |
||
223 | '/ç|ć|ĉ|ċ|č/' => 'c', |
||
224 | '/ð|ď|đ/' => 'd', |
||
225 | '/è|é|ê|ë|ē|ĕ|ė|ę|ě/' => 'e', |
||
226 | '/ƒ/' => 'f', |
||
227 | '/ĝ|ğ|ġ|ģ|ґ/' => 'g', |
||
228 | '/ĥ|ħ/' => 'h', |
||
229 | '/ì|í|î|ï|ĩ|ī|ĭ|ǐ|į|ı|і/' => 'i', |
||
230 | '/ij/' => 'ij', |
||
231 | '/ĵ/' => 'j', |
||
232 | '/ķ/' => 'k', |
||
233 | '/ĺ|ļ|ľ|ŀ|ł/' => 'l', |
||
234 | '/ñ|ń|ņ|ň|ʼn/' => 'n', |
||
235 | '/ò|ó|ô|õ|ō|ŏ|ǒ|ő|ơ|ø|ǿ|º/' => 'o', |
||
236 | '/ö|œ/' => 'oe', |
||
237 | '/ŕ|ŗ|ř/' => 'r', |
||
238 | '/ś|ŝ|ş|ș|š|ſ/' => 's', |
||
239 | '/ß/' => 'ss', |
||
240 | '/ţ|ț|ť|ŧ/' => 't', |
||
241 | '/þ/' => 'th', |
||
242 | '/ù|ú|û|ũ|ū|ŭ|ů|ű|ų|ư|ǔ|ǖ|ǘ|ǚ|ǜ/' => 'u', |
||
243 | '/ü/' => 'ue', |
||
244 | '/ŵ/' => 'w', |
||
245 | '/ý|ÿ|ŷ/' => 'y', |
||
246 | '/є/' => 'ye', |
||
247 | '/ї/' => 'yi', |
||
248 | '/ź|ż|ž/' => 'z', |
||
249 | ); |
||
250 | |||
251 | /**
|
||
252 | * Method cache array.
|
||
253 | *
|
||
254 | * @var array
|
||
255 | */
|
||
256 | protected static $_cache = array(); |
||
257 | |||
258 | /**
|
||
259 | * The initial state of Inflector so reset() works.
|
||
260 | *
|
||
261 | * @var array
|
||
262 | */
|
||
263 | protected static $_initialState = array(); |
||
264 | |||
265 | /**
|
||
266 | * Cache inflected values, and return if already available
|
||
267 | *
|
||
268 | * @param string $type Inflection type
|
||
269 | * @param string $key Original value
|
||
270 | * @param string $value Inflected value
|
||
271 | * @return string Inflected value, from cache
|
||
272 | */
|
||
273 | protected static function _cache($type, $key, $value = false) { |
||
274 | $key = '_' . $key; |
||
275 | $type = '_' . $type; |
||
276 | if ($value !== false) { |
||
277 | static::$_cache[$type][$key] = $value; |
||
278 | return $value; |
||
279 | } |
||
280 | if (!isset(static::$_cache[$type][$key])) { |
||
281 | return false; |
||
282 | } |
||
283 | return static::$_cache[$type][$key]; |
||
284 | } |
||
285 | |||
286 | /**
|
||
287 | * Clears Inflectors inflected value caches. And resets the inflection
|
||
288 | * rules to the initial values.
|
||
289 | *
|
||
290 | * @return void
|
||
291 | */
|
||
292 | public static function reset() { |
||
293 | if (empty(static::$_initialState)) { |
||
294 | static::$_initialState = get_class_vars('Inflector'); |
||
295 | return;
|
||
296 | } |
||
297 | foreach (static::$_initialState as $key => $val) { |
||
298 | if ($key !== '_initialState') { |
||
299 | static::${$key} = $val; |
||
300 | } |
||
301 | } |
||
302 | } |
||
303 | |||
304 | /**
|
||
305 | * Adds custom inflection $rules, of either 'plural', 'singular' or 'transliteration' $type.
|
||
306 | *
|
||
307 | * ### Usage:
|
||
308 | *
|
||
309 | * ```
|
||
310 | * Inflector::rules('plural', array('/^(inflect)or$/i' => '\1ables'));
|
||
311 | * Inflector::rules('plural', array(
|
||
312 | * 'rules' => array('/^(inflect)ors$/i' => '\1ables'),
|
||
313 | * 'uninflected' => array('dontinflectme'),
|
||
314 | * 'irregular' => array('red' => 'redlings')
|
||
315 | * ));
|
||
316 | * Inflector::rules('transliteration', array('/å/' => 'aa'));
|
||
317 | * ```
|
||
318 | *
|
||
319 | * @param string $type The type of inflection, either 'plural', 'singular' or 'transliteration'
|
||
320 | * @param array $rules Array of rules to be added.
|
||
321 | * @param bool $reset If true, will unset default inflections for all
|
||
322 | * new rules that are being defined in $rules.
|
||
323 | * @return void
|
||
324 | */
|
||
325 | public static function rules($type, $rules, $reset = false) { |
||
326 | $var = '_' . $type; |
||
327 | |||
328 | switch ($type) { |
||
329 | case 'transliteration': |
||
330 | if ($reset) { |
||
331 | static::$_transliteration = $rules; |
||
332 | } else {
|
||
333 | static::$_transliteration = $rules + static::$_transliteration; |
||
334 | } |
||
335 | break;
|
||
336 | |||
337 | default:
|
||
338 | foreach ($rules as $rule => $pattern) { |
||
339 | if (is_array($pattern)) { |
||
340 | if ($reset) { |
||
341 | static::${$var}[$rule] = $pattern; |
||
342 | } else {
|
||
343 | if ($rule === 'uninflected') { |
||
344 | static::${$var}[$rule] = array_merge($pattern, static::${$var}[$rule]); |
||
345 | } else {
|
||
346 | static::${$var}[$rule] = $pattern + static::${$var}[$rule]; |
||
347 | } |
||
348 | } |
||
349 | unset($rules[$rule], static::${$var}['cache' . ucfirst($rule)]); |
||
350 | if (isset(static::${$var}['merged'][$rule])) { |
||
351 | unset(static::${$var}['merged'][$rule]); |
||
352 | } |
||
353 | if ($type === 'plural') { |
||
354 | static::$_cache['pluralize'] = static::$_cache['tableize'] = array(); |
||
355 | } elseif ($type === 'singular') { |
||
356 | static::$_cache['singularize'] = array(); |
||
357 | } |
||
358 | } |
||
359 | } |
||
360 | static::${$var}['rules'] = $rules + static::${$var}['rules']; |
||
361 | } |
||
362 | } |
||
363 | |||
364 | /**
|
||
365 | * Return $word in plural form.
|
||
366 | *
|
||
367 | * @param string $word Word in singular
|
||
368 | * @return string Word in plural
|
||
369 | * @link http://book.cakephp.org/2.0/en/core-utility-libraries/inflector.html#Inflector::pluralize
|
||
370 | */
|
||
371 | public static function pluralize($word) { |
||
372 | if (isset(static::$_cache['pluralize'][$word])) { |
||
373 | return static::$_cache['pluralize'][$word]; |
||
374 | } |
||
375 | |||
376 | if (!isset(static::$_plural['merged']['irregular'])) { |
||
377 | static::$_plural['merged']['irregular'] = static::$_plural['irregular']; |
||
378 | } |
||
379 | |||
380 | if (!isset(static::$_plural['merged']['uninflected'])) { |
||
381 | static::$_plural['merged']['uninflected'] = array_merge(static::$_plural['uninflected'], static::$_uninflected); |
||
382 | } |
||
383 | |||
384 | if (!isset(static::$_plural['cacheUninflected']) || !isset(static::$_plural['cacheIrregular'])) { |
||
385 | static::$_plural['cacheUninflected'] = '(?:' . implode('|', static::$_plural['merged']['uninflected']) . ')'; |
||
386 | static::$_plural['cacheIrregular'] = '(?:' . implode('|', array_keys(static::$_plural['merged']['irregular'])) . ')'; |
||
387 | } |
||
388 | |||
389 | if (preg_match('/(.*?(?:\\b|_))(' . static::$_plural['cacheIrregular'] . ')$/i', $word, $regs)) { |
||
390 | static::$_cache['pluralize'][$word] = $regs[1] . |
||
391 | substr($regs[2], 0, 1) . |
||
392 | substr(static::$_plural['merged']['irregular'][strtolower($regs[2])], 1); |
||
393 | return static::$_cache['pluralize'][$word]; |
||
394 | } |
||
395 | |||
396 | if (preg_match('/^(' . static::$_plural['cacheUninflected'] . ')$/i', $word, $regs)) { |
||
397 | static::$_cache['pluralize'][$word] = $word; |
||
398 | return $word; |
||
399 | } |
||
400 | |||
401 | foreach (static::$_plural['rules'] as $rule => $replacement) { |
||
402 | if (preg_match($rule, $word)) { |
||
403 | static::$_cache['pluralize'][$word] = preg_replace($rule, $replacement, $word); |
||
404 | return static::$_cache['pluralize'][$word]; |
||
405 | } |
||
406 | } |
||
407 | } |
||
408 | |||
409 | /**
|
||
410 | * Return $word in singular form.
|
||
411 | *
|
||
412 | * @param string $word Word in plural
|
||
413 | * @return string Word in singular
|
||
414 | * @link http://book.cakephp.org/2.0/en/core-utility-libraries/inflector.html#Inflector::singularize
|
||
415 | */
|
||
416 | public static function singularize($word) { |
||
417 | if (isset(static::$_cache['singularize'][$word])) { |
||
418 | return static::$_cache['singularize'][$word]; |
||
419 | } |
||
420 | |||
421 | if (!isset(static::$_singular['merged']['uninflected'])) { |
||
422 | static::$_singular['merged']['uninflected'] = array_merge( |
||
423 | static::$_singular['uninflected'], |
||
424 | static::$_uninflected |
||
425 | ); |
||
426 | } |
||
427 | |||
428 | if (!isset(static::$_singular['merged']['irregular'])) { |
||
429 | static::$_singular['merged']['irregular'] = array_merge( |
||
430 | static::$_singular['irregular'], |
||
431 | array_flip(static::$_plural['irregular']) |
||
432 | ); |
||
433 | } |
||
434 | |||
435 | if (!isset(static::$_singular['cacheUninflected']) || !isset(static::$_singular['cacheIrregular'])) { |
||
436 | static::$_singular['cacheUninflected'] = '(?:' . implode('|', static::$_singular['merged']['uninflected']) . ')'; |
||
437 | static::$_singular['cacheIrregular'] = '(?:' . implode('|', array_keys(static::$_singular['merged']['irregular'])) . ')'; |
||
438 | } |
||
439 | |||
440 | if (preg_match('/(.*?(?:\\b|_))(' . static::$_singular['cacheIrregular'] . ')$/i', $word, $regs)) { |
||
441 | static::$_cache['singularize'][$word] = $regs[1] . |
||
442 | substr($regs[2], 0, 1) . |
||
443 | substr(static::$_singular['merged']['irregular'][strtolower($regs[2])], 1); |
||
444 | return static::$_cache['singularize'][$word]; |
||
445 | } |
||
446 | |||
447 | if (preg_match('/^(' . static::$_singular['cacheUninflected'] . ')$/i', $word, $regs)) { |
||
448 | static::$_cache['singularize'][$word] = $word; |
||
449 | return $word; |
||
450 | } |
||
451 | |||
452 | foreach (static::$_singular['rules'] as $rule => $replacement) { |
||
453 | if (preg_match($rule, $word)) { |
||
454 | static::$_cache['singularize'][$word] = preg_replace($rule, $replacement, $word); |
||
455 | return static::$_cache['singularize'][$word]; |
||
456 | } |
||
457 | } |
||
458 | static::$_cache['singularize'][$word] = $word; |
||
459 | return $word; |
||
460 | } |
||
461 | |||
462 | /**
|
||
463 | * Returns the given lower_case_and_underscored_word as a CamelCased word.
|
||
464 | *
|
||
465 | * @param string $lowerCaseAndUnderscoredWord Word to camelize
|
||
466 | * @return string Camelized word. LikeThis.
|
||
467 | * @link http://book.cakephp.org/2.0/en/core-utility-libraries/inflector.html#Inflector::camelize
|
||
468 | */
|
||
469 | public static function camelize($lowerCaseAndUnderscoredWord) { |
||
470 | if (!($result = static::_cache(__FUNCTION__, $lowerCaseAndUnderscoredWord))) { |
||
471 | $result = str_replace(' ', '', Inflector::humanize($lowerCaseAndUnderscoredWord)); |
||
472 | static::_cache(__FUNCTION__, $lowerCaseAndUnderscoredWord, $result); |
||
473 | } |
||
474 | return $result; |
||
475 | } |
||
476 | |||
477 | /**
|
||
478 | * Returns the given camelCasedWord as an underscored_word.
|
||
479 | *
|
||
480 | * @param string $camelCasedWord Camel-cased word to be "underscorized"
|
||
481 | * @return string Underscore-syntaxed version of the $camelCasedWord
|
||
482 | * @link http://book.cakephp.org/2.0/en/core-utility-libraries/inflector.html#Inflector::underscore
|
||
483 | */
|
||
484 | public static function underscore($camelCasedWord) { |
||
485 | if (!($result = static::_cache(__FUNCTION__, $camelCasedWord))) { |
||
486 | $underscoredWord = preg_replace('/(?<=\\w)([A-Z])/', '_\\1', $camelCasedWord); |
||
487 | $result = mb_strtolower($underscoredWord); |
||
488 | static::_cache(__FUNCTION__, $camelCasedWord, $result); |
||
489 | } |
||
490 | return $result; |
||
491 | } |
||
492 | |||
493 | /**
|
||
494 | * Returns the given underscored_word_group as a Human Readable Word Group.
|
||
495 | * (Underscores are replaced by spaces and capitalized following words.)
|
||
496 | *
|
||
497 | * @param string $lowerCaseAndUnderscoredWord String to be made more readable
|
||
498 | * @return string Human-readable string
|
||
499 | * @link http://book.cakephp.org/2.0/en/core-utility-libraries/inflector.html#Inflector::humanize
|
||
500 | */
|
||
501 | public static function humanize($lowerCaseAndUnderscoredWord) { |
||
502 | if (!($result = static::_cache(__FUNCTION__, $lowerCaseAndUnderscoredWord))) { |
||
503 | $result = explode(' ', str_replace('_', ' ', $lowerCaseAndUnderscoredWord)); |
||
504 | foreach ($result as &$word) { |
||
505 | $word = mb_strtoupper(mb_substr($word, 0, 1)) . mb_substr($word, 1); |
||
506 | } |
||
507 | $result = implode(' ', $result); |
||
508 | static::_cache(__FUNCTION__, $lowerCaseAndUnderscoredWord, $result); |
||
509 | } |
||
510 | return $result; |
||
511 | } |
||
512 | |||
513 | /**
|
||
514 | * Returns corresponding table name for given model $className. ("people" for the model class "Person").
|
||
515 | *
|
||
516 | * @param string $className Name of class to get database table name for
|
||
517 | * @return string Name of the database table for given class
|
||
518 | * @link http://book.cakephp.org/2.0/en/core-utility-libraries/inflector.html#Inflector::tableize
|
||
519 | */
|
||
520 | public static function tableize($className) { |
||
521 | if (!($result = static::_cache(__FUNCTION__, $className))) { |
||
522 | $result = Inflector::pluralize(Inflector::underscore($className)); |
||
523 | static::_cache(__FUNCTION__, $className, $result); |
||
524 | } |
||
525 | return $result; |
||
526 | } |
||
527 | |||
528 | /**
|
||
529 | * Returns Cake model class name ("Person" for the database table "people".) for given database table.
|
||
530 | *
|
||
531 | * @param string $tableName Name of database table to get class name for
|
||
532 | * @return string Class name
|
||
533 | * @link http://book.cakephp.org/2.0/en/core-utility-libraries/inflector.html#Inflector::classify
|
||
534 | */
|
||
535 | public static function classify($tableName) { |
||
536 | if (!($result = static::_cache(__FUNCTION__, $tableName))) { |
||
537 | $result = Inflector::camelize(Inflector::singularize($tableName)); |
||
538 | static::_cache(__FUNCTION__, $tableName, $result); |
||
539 | } |
||
540 | return $result; |
||
541 | } |
||
542 | |||
543 | /**
|
||
544 | * Returns camelBacked version of an underscored string.
|
||
545 | *
|
||
546 | * @param string $string String to convert.
|
||
547 | * @return string in variable form
|
||
548 | * @link http://book.cakephp.org/2.0/en/core-utility-libraries/inflector.html#Inflector::variable
|
||
549 | */
|
||
550 | public static function variable($string) { |
||
551 | if (!($result = static::_cache(__FUNCTION__, $string))) { |
||
552 | $camelized = Inflector::camelize(Inflector::underscore($string)); |
||
553 | $replace = strtolower(substr($camelized, 0, 1)); |
||
554 | $result = preg_replace('/\\w/', $replace, $camelized, 1); |
||
555 | static::_cache(__FUNCTION__, $string, $result); |
||
556 | } |
||
557 | return $result; |
||
558 | } |
||
559 | |||
560 | /**
|
||
561 | * Returns a string with all spaces converted to underscores (by default), accented
|
||
562 | * characters converted to non-accented characters, and non word characters removed.
|
||
563 | *
|
||
564 | * @param string $string the string you want to slug
|
||
565 | * @param string $replacement will replace keys in map
|
||
566 | * @return string
|
||
567 | * @link http://book.cakephp.org/2.0/en/core-utility-libraries/inflector.html#Inflector::slug
|
||
568 | */
|
||
569 | public static function slug($string, $replacement = '_') { |
||
570 | $quotedReplacement = preg_quote($replacement, '/'); |
||
571 | |||
572 | $merge = array( |
||
573 | '/[^\s\p{Zs}\p{Ll}\p{Lm}\p{Lo}\p{Lt}\p{Lu}\p{Nd}]/mu' => ' ', |
||
574 | '/[\s\p{Zs}]+/mu' => $replacement, |
||
575 | sprintf('/^[%s]+|[%s]+$/', $quotedReplacement, $quotedReplacement) => '', |
||
576 | ); |
||
577 | |||
578 | $map = static::$_transliteration + $merge; |
||
579 | return preg_replace(array_keys($map), array_values($map), $string); |
||
580 | } |
||
581 | |||
582 | } |
||
583 | |||
584 | // Store the initial state
|
||
585 | Inflector::reset(); |