|
1
|
|
|
<?php |
|
2
|
|
|
/** |
|
3
|
|
|
* Licensed under The GPL-3.0 License |
|
4
|
|
|
* For full copyright and license information, please see the LICENSE.txt |
|
5
|
|
|
* Redistributions of files must retain the above copyright notice. |
|
6
|
|
|
* |
|
7
|
|
|
* @since 2.0.0 |
|
8
|
|
|
* @author Christopher Castro <[email protected]> |
|
9
|
|
|
* @link http://www.quickappscms.org |
|
10
|
|
|
* @license http://opensource.org/licenses/gpl-3.0.html GPL-3.0 License |
|
11
|
|
|
*/ |
|
12
|
|
|
|
|
13
|
|
|
use Cake\Cache\Cache; |
|
14
|
|
|
use Cake\Core\Configure; |
|
15
|
|
|
use Cake\Datasource\ConnectionManager; |
|
16
|
|
|
use Cake\Error\Debugger; |
|
17
|
|
|
use Cake\Error\FatalErrorException; |
|
18
|
|
|
use Cake\Event\EventManager; |
|
19
|
|
|
use Cake\Filesystem\File; |
|
20
|
|
|
use Cake\Filesystem\Folder; |
|
21
|
|
|
use Cake\I18n\I18n; |
|
22
|
|
|
use Cake\ORM\Entity; |
|
23
|
|
|
use Cake\ORM\TableRegistry; |
|
24
|
|
|
use Cake\Routing\Router; |
|
25
|
|
|
use Cake\Utility\Inflector; |
|
26
|
|
|
use CMS\Core\Plugin; |
|
27
|
|
|
|
|
28
|
|
|
if (!function_exists('snapshot')) { |
|
29
|
|
|
/** |
|
30
|
|
|
* Stores some bootstrap-handy information into a persistent file. |
|
31
|
|
|
* |
|
32
|
|
|
* Information is stored in `TMP/snapshot.php` file, it contains |
|
33
|
|
|
* useful information such as enabled languages, content types slugs, installed |
|
34
|
|
|
* plugins, etc. |
|
35
|
|
|
* |
|
36
|
|
|
* You can read this information using `Configure::read()` as follow: |
|
37
|
|
|
* |
|
38
|
|
|
* ```php |
|
39
|
|
|
* Configure::read('QuickApps.<option>'); |
|
40
|
|
|
* ``` |
|
41
|
|
|
* |
|
42
|
|
|
* Or using the `quickapps()` global function: |
|
43
|
|
|
* |
|
44
|
|
|
* ```php |
|
45
|
|
|
* quickapps('<option>'); |
|
46
|
|
|
* ``` |
|
47
|
|
|
* |
|
48
|
|
|
* @return void |
|
49
|
|
|
*/ |
|
50
|
|
|
function snapshot() |
|
51
|
|
|
{ |
|
52
|
|
|
if (Cache::config('default')) { |
|
53
|
|
|
Cache::clear(false, 'default'); |
|
54
|
|
|
} |
|
55
|
|
|
|
|
56
|
|
|
if (Cache::config('_cake_core_')) { |
|
57
|
|
|
Cache::clear(false, '_cake_core_'); |
|
58
|
|
|
} |
|
59
|
|
|
|
|
60
|
|
|
if (Cache::config('_cake_model_')) { |
|
61
|
|
|
Cache::clear(false, '_cake_model_'); |
|
62
|
|
|
} |
|
63
|
|
|
|
|
64
|
|
|
$versionPath = QUICKAPPS_CORE . 'VERSION.txt'; |
|
65
|
|
|
$snapshot = [ |
|
66
|
|
|
'version' => null, |
|
67
|
|
|
'content_types' => [], |
|
68
|
|
|
'plugins' => [], |
|
69
|
|
|
'options' => [], |
|
70
|
|
|
'languages' => [], |
|
71
|
|
|
'aspects' => [], |
|
72
|
|
|
]; |
|
73
|
|
|
|
|
74
|
|
|
if (is_readable($versionPath)) { |
|
75
|
|
|
$versionFile = file($versionPath); |
|
76
|
|
|
$snapshot['version'] = trim(array_pop($versionFile)); |
|
77
|
|
|
} else { |
|
78
|
|
|
die(sprintf('Missing file: %s', $versionPath)); |
|
79
|
|
|
} |
|
80
|
|
|
|
|
81
|
|
|
if (ConnectionManager::config('default')) { |
|
82
|
|
|
if (!TableRegistry::exists('SnapshotPlugins')) { |
|
83
|
|
|
$PluginTable = TableRegistry::get('SnapshotPlugins', ['table' => 'plugins']); |
|
84
|
|
|
} else { |
|
85
|
|
|
$PluginTable = TableRegistry::get('SnapshotPlugins'); |
|
86
|
|
|
} |
|
87
|
|
|
|
|
88
|
|
|
if (!TableRegistry::exists('SnapshotContentTypes')) { |
|
89
|
|
|
$ContentTypesTable = TableRegistry::get('SnapshotContentTypes', ['table' => 'content_types']); |
|
90
|
|
|
} else { |
|
91
|
|
|
$ContentTypesTable = TableRegistry::get('SnapshotContentTypes'); |
|
92
|
|
|
} |
|
93
|
|
|
|
|
94
|
|
|
if (!TableRegistry::exists('SnapshotLanguages')) { |
|
95
|
|
|
$LanguagesTable = TableRegistry::get('SnapshotLanguages', ['table' => 'languages']); |
|
96
|
|
|
} else { |
|
97
|
|
|
$LanguagesTable = TableRegistry::get('SnapshotLanguages'); |
|
98
|
|
|
} |
|
99
|
|
|
|
|
100
|
|
|
if (!TableRegistry::exists('SnapshotOptions')) { |
|
101
|
|
|
$OptionsTable = TableRegistry::get('SnapshotOptions', ['table' => 'options']); |
|
102
|
|
|
} else { |
|
103
|
|
|
$OptionsTable = TableRegistry::get('SnapshotOptions'); |
|
104
|
|
|
} |
|
105
|
|
|
|
|
106
|
|
|
$PluginTable->schema(['value' => 'serialized']); |
|
107
|
|
|
$OptionsTable->schema(['value' => 'serialized']); |
|
108
|
|
|
|
|
109
|
|
|
$plugins = $PluginTable->find() |
|
110
|
|
|
->select(['name', 'package', 'status']) |
|
111
|
|
|
->order([ |
|
112
|
|
|
'ordering' => 'ASC', |
|
113
|
|
|
'name' => 'ASC', |
|
114
|
|
|
]) |
|
115
|
|
|
->all(); |
|
116
|
|
|
$contentTypes = $ContentTypesTable->find() |
|
117
|
|
|
->select(['slug']) |
|
118
|
|
|
->all(); |
|
119
|
|
|
$languages = $LanguagesTable->find() |
|
120
|
|
|
->where(['status' => 1]) |
|
121
|
|
|
->order(['ordering' => 'ASC']) |
|
122
|
|
|
->all(); |
|
123
|
|
|
$options = $OptionsTable->find() |
|
124
|
|
|
->select(['name', 'value']) |
|
125
|
|
|
->where(['autoload' => 1]) |
|
126
|
|
|
->all(); |
|
127
|
|
|
|
|
128
|
|
|
foreach ($contentTypes as $contentType) { |
|
129
|
|
|
$snapshot['content_types'][] = $contentType->slug; |
|
130
|
|
|
} |
|
131
|
|
|
|
|
132
|
|
|
foreach ($options as $option) { |
|
133
|
|
|
$snapshot['options'][$option->name] = $option->value; |
|
134
|
|
|
} |
|
135
|
|
|
|
|
136
|
|
|
foreach ($languages as $language) { |
|
137
|
|
|
list($languageCode, $countryCode) = localeSplit($language->code); |
|
138
|
|
|
$snapshot['languages'][$language->code] = [ |
|
139
|
|
|
'name' => $language->name, |
|
140
|
|
|
'locale' => $language->code, |
|
141
|
|
|
'code' => $languageCode, |
|
142
|
|
|
'country' => $countryCode, |
|
143
|
|
|
'direction' => $language->direction, |
|
144
|
|
|
'icon' => $language->icon, |
|
145
|
|
|
]; |
|
146
|
|
|
} |
|
147
|
|
|
} else { |
|
148
|
|
|
$plugins = []; |
|
149
|
|
|
foreach (Plugin::scan() as $plugin => $path) { |
|
150
|
|
|
$plugins[] = new Entity([ |
|
151
|
|
|
'name' => $plugin, |
|
152
|
|
|
'status' => true, |
|
153
|
|
|
'package' => 'quickapps-plugins', |
|
154
|
|
|
]); |
|
155
|
|
|
} |
|
156
|
|
|
} |
|
157
|
|
|
|
|
158
|
|
|
$folder = new Folder(QUICKAPPS_CORE . 'src/Aspect/'); |
|
159
|
|
|
foreach ($folder->read(false, false, true)[1] as $classFile) { |
|
160
|
|
|
$className = basename(preg_replace('/\.php$/', '', $classFile)); |
|
161
|
|
|
if (!in_array($className, ['AppAspect', 'Aspect'])) { |
|
162
|
|
|
$snapshot['aspects'][] = "CMS\\Aspect\\{$className}"; |
|
163
|
|
|
} |
|
164
|
|
|
} |
|
165
|
|
|
|
|
166
|
|
|
foreach ($plugins as $plugin) { |
|
167
|
|
|
$pluginPath = false; |
|
168
|
|
|
|
|
169
|
|
|
if (isset(Plugin::scan()[$plugin->name])) { |
|
170
|
|
|
$pluginPath = Plugin::scan()[$plugin->name]; |
|
171
|
|
|
} |
|
172
|
|
|
|
|
173
|
|
|
if ($pluginPath === false) { |
|
174
|
|
|
Debugger::log(sprintf('Plugin "%s" was found in DB but QuickAppsCMS was unable to locate its root directory.', $plugin->name)); |
|
175
|
|
|
continue; |
|
176
|
|
|
} |
|
177
|
|
|
|
|
178
|
|
|
if (!Plugin::validateJson("{$pluginPath}/composer.json")) { |
|
179
|
|
|
Debugger::log(sprintf('Plugin "%s" has a corrupt "composer.json" file (%s).', $plugin->name, "{$pluginPath}/composer.json")); |
|
180
|
|
|
continue; |
|
181
|
|
|
} |
|
182
|
|
|
|
|
183
|
|
|
$aspectsPath = "{$pluginPath}/src/Aspect/"; |
|
184
|
|
|
$eventsPath = "{$pluginPath}/src/Event/"; |
|
185
|
|
|
$fieldsPath = "{$pluginPath}/src/Field/"; |
|
186
|
|
|
$helpFiles = glob($pluginPath . '/src/Template/Element/Help/help*.ctp'); |
|
187
|
|
|
$isTheme = str_ends_with($plugin->name, 'Theme'); |
|
188
|
|
|
$status = (bool)$plugin->status; |
|
189
|
|
|
$humanName = ''; |
|
190
|
|
|
$aspects = []; |
|
191
|
|
|
$eventListeners = []; |
|
192
|
|
|
$fields = []; |
|
193
|
|
|
|
|
194
|
|
|
$subspaces = [ |
|
195
|
|
|
$aspectsPath => 'Aspect', |
|
196
|
|
|
$eventsPath => 'Event', |
|
197
|
|
|
$fieldsPath => 'Field', |
|
198
|
|
|
]; |
|
199
|
|
|
$varnames = [ |
|
200
|
|
|
$aspectsPath => 'aspects', |
|
201
|
|
|
$eventsPath => 'eventListeners', |
|
202
|
|
|
$fieldsPath => 'fields', |
|
203
|
|
|
]; |
|
204
|
|
|
foreach ([$aspectsPath, $eventsPath, $fieldsPath] as $path) { |
|
205
|
|
|
if (is_dir($path)) { |
|
206
|
|
|
$Folder = new Folder($path); |
|
207
|
|
|
foreach ($Folder->read(false, false, true)[1] as $classFile) { |
|
208
|
|
|
$className = basename(preg_replace('/\.php$/', '', $classFile)); |
|
209
|
|
|
$subspace = $subspaces[$path]; |
|
210
|
|
|
$varname = $varnames[$path]; |
|
211
|
|
|
$namespace = "{$plugin->name}\\{$subspace}\\"; |
|
212
|
|
|
${$varname}[] = $namespace . $className; |
|
213
|
|
|
} |
|
214
|
|
|
} |
|
215
|
|
|
} |
|
216
|
|
|
|
|
217
|
|
|
if (is_readable("{$pluginPath}composer.json")) { |
|
218
|
|
|
$json = (array)json_decode(file_get_contents("{$pluginPath}composer.json"), true); |
|
219
|
|
|
if (!empty($json['extra']['human-name'])) { |
|
220
|
|
|
$humanName = $json['extra']['human-name']; |
|
221
|
|
|
} |
|
222
|
|
|
} |
|
223
|
|
|
|
|
224
|
|
|
if (empty($humanName)) { |
|
225
|
|
|
$humanName = (string)Inflector::humanize((string)Inflector::underscore($plugin->name)); |
|
226
|
|
|
if ($isTheme) { |
|
227
|
|
|
$humanName = trim(str_replace_last('Theme', '', $humanName)); |
|
228
|
|
|
} |
|
229
|
|
|
} |
|
230
|
|
|
|
|
231
|
|
|
$snapshot['plugins'][$plugin->name] = [ |
|
232
|
|
|
'name' => $plugin->name, |
|
233
|
|
|
'humanName' => $humanName, |
|
234
|
|
|
'package' => $plugin->package, |
|
235
|
|
|
'isTheme' => $isTheme, |
|
236
|
|
|
'hasHelp' => !empty($helpFiles), |
|
237
|
|
|
'hasSettings' => is_readable($pluginPath . '/src/Template/Element/settings.ctp'), |
|
238
|
|
|
'aspects' => $aspects, |
|
239
|
|
|
'eventListeners' => $eventListeners, |
|
240
|
|
|
'fields' => $fields, |
|
241
|
|
|
'status' => $status, |
|
242
|
|
|
'path' => $pluginPath, |
|
243
|
|
|
]; |
|
244
|
|
|
|
|
245
|
|
|
if ($status) { |
|
246
|
|
|
$snapshot['aspects'] = array_merge($snapshot['aspects'], $aspects); |
|
247
|
|
|
} |
|
248
|
|
|
} |
|
249
|
|
|
|
|
250
|
|
|
Configure::write('QuickApps', $snapshot); |
|
251
|
|
|
if (!Configure::dump('snapshot', 'QuickApps', ['QuickApps'])) { |
|
252
|
|
|
die('QuickAppsCMS was unable to create a snapshot file, check that PHP have permission to write to the "/tmp" directory.'); |
|
253
|
|
|
} |
|
254
|
|
|
} |
|
255
|
|
|
} |
|
256
|
|
|
|
|
257
|
|
|
if (!function_exists('normalizePath')) { |
|
258
|
|
|
/** |
|
259
|
|
|
* Normalizes the given file system path, makes sure that all DIRECTORY_SEPARATOR |
|
260
|
|
|
* are the same, so you won't get a mix of "/" and "\" in your paths. |
|
261
|
|
|
* |
|
262
|
|
|
* ### Example: |
|
263
|
|
|
* |
|
264
|
|
|
* ```php |
|
265
|
|
|
* normalizePath('/some/path\to/some\\thing\about.zip'); |
|
266
|
|
|
* // output: /some/path/to/some/thing/about.zip |
|
267
|
|
|
* ``` |
|
268
|
|
|
* |
|
269
|
|
|
* You can indicate which "directory separator" symbol to use using the second |
|
270
|
|
|
* argument: |
|
271
|
|
|
* |
|
272
|
|
|
* ```php |
|
273
|
|
|
* normalizePath('/some/path\to//some\thing\about.zip', '\'); |
|
274
|
|
|
* // output: \some\path\to\some\thing\about.zip |
|
275
|
|
|
* ``` |
|
276
|
|
|
* |
|
277
|
|
|
* By defaults uses DIRECTORY_SEPARATOR as symbol. |
|
278
|
|
|
* |
|
279
|
|
|
* @param string $path The path to normalize |
|
280
|
|
|
* @param string $ds Directory separator character, defaults to DIRECTORY_SEPARATOR |
|
281
|
|
|
* @return string Normalized $path |
|
282
|
|
|
*/ |
|
283
|
|
|
function normalizePath($path, $ds = DIRECTORY_SEPARATOR) |
|
284
|
|
|
{ |
|
285
|
|
|
$path = str_replace(['/', '\\', "{$ds}{$ds}"], $ds, $path); |
|
286
|
|
|
return str_replace("{$ds}{$ds}", $ds, $path); |
|
287
|
|
|
} |
|
288
|
|
|
} |
|
289
|
|
|
|
|
290
|
|
|
if (!function_exists('quickapps')) { |
|
291
|
|
|
/** |
|
292
|
|
|
* Shortcut for reading QuickApps's snapshot configuration. |
|
293
|
|
|
* |
|
294
|
|
|
* For example, `quickapps('variables');` maps to |
|
295
|
|
|
* `Configure::read('QuickApps.variables');`. If this function is used with |
|
296
|
|
|
* no arguments, `quickapps()`, the entire snapshot will be returned. |
|
297
|
|
|
* |
|
298
|
|
|
* @param string $key The key to read from snapshot, or null to read the whole |
|
299
|
|
|
* snapshot's info |
|
300
|
|
|
* @return mixed |
|
301
|
|
|
*/ |
|
302
|
|
|
function quickapps($key = null) |
|
303
|
|
|
{ |
|
304
|
|
|
if ($key !== null) { |
|
305
|
|
|
return Configure::read("QuickApps.{$key}"); |
|
306
|
|
|
} |
|
307
|
|
|
return Configure::read('QuickApps'); |
|
308
|
|
|
} |
|
309
|
|
|
} |
|
310
|
|
|
|
|
311
|
|
|
if (!function_exists('option')) { |
|
312
|
|
|
/** |
|
313
|
|
|
* Shortcut for getting an option value from "options" DB table. |
|
314
|
|
|
* |
|
315
|
|
|
* The second arguments, $default, is used as default value to return if no |
|
316
|
|
|
* value is found. If not value is found and not default values was given this |
|
317
|
|
|
* function will return `false`. |
|
318
|
|
|
* |
|
319
|
|
|
* ### Example: |
|
320
|
|
|
* |
|
321
|
|
|
* ```php |
|
322
|
|
|
* option('site_slogan'); |
|
323
|
|
|
* ``` |
|
324
|
|
|
* |
|
325
|
|
|
* @param string $name Name of the option to retrieve. e.g. `front_theme`, |
|
326
|
|
|
* `default_language`, `site_slogan`, etc |
|
327
|
|
|
* @param mixed $default The default value to return if no value is found |
|
328
|
|
|
* @return mixed Current value for the specified option. If the specified option |
|
329
|
|
|
* does not exist, returns boolean FALSE |
|
330
|
|
|
*/ |
|
331
|
|
|
function option($name, $default = false) |
|
332
|
|
|
{ |
|
333
|
|
|
if (Configure::check("QuickApps.options.{$name}")) { |
|
334
|
|
|
return Configure::read("QuickApps.options.{$name}"); |
|
335
|
|
|
} |
|
336
|
|
|
|
|
337
|
|
|
if (ConnectionManager::config('default')) { |
|
338
|
|
|
$option = TableRegistry::get('Options') |
|
339
|
|
|
->find() |
|
340
|
|
|
->where(['Options.name' => $name]) |
|
341
|
|
|
->first(); |
|
342
|
|
|
if ($option) { |
|
343
|
|
|
return $option->value; |
|
344
|
|
|
} |
|
345
|
|
|
} |
|
346
|
|
|
|
|
347
|
|
|
return $default; |
|
348
|
|
|
} |
|
349
|
|
|
} |
|
350
|
|
|
|
|
351
|
|
|
if (!function_exists('plugin')) { |
|
352
|
|
|
/** |
|
353
|
|
|
* Shortcut for "Plugin::get()". |
|
354
|
|
|
* |
|
355
|
|
|
* ### Example: |
|
356
|
|
|
* |
|
357
|
|
|
* ```php |
|
358
|
|
|
* $specialSetting = plugin('MyPlugin')->settings['special_setting']; |
|
359
|
|
|
* ``` |
|
360
|
|
|
* |
|
361
|
|
|
* @param string $plugin Plugin name to get, or null to get a collection of |
|
362
|
|
|
* all plugin objects |
|
363
|
|
|
* @return \CMS\Core\Package\PluginPackage|\Cake\Collection\Collection |
|
364
|
|
|
* @throws \Cake\Error\FatalErrorException When requested plugin was not found |
|
365
|
|
|
* @see \CMS\Core\Plugin::get() |
|
366
|
|
|
*/ |
|
367
|
|
|
function plugin($plugin = null) |
|
368
|
|
|
{ |
|
369
|
|
|
return Plugin::get($plugin); |
|
370
|
|
|
} |
|
371
|
|
|
} |
|
372
|
|
|
|
|
373
|
|
|
if (!function_exists('theme')) { |
|
374
|
|
|
/** |
|
375
|
|
|
* Gets the given (or in use) theme as a package object. |
|
376
|
|
|
* |
|
377
|
|
|
* ### Example: |
|
378
|
|
|
* |
|
379
|
|
|
* ```php |
|
380
|
|
|
* // current theme |
|
381
|
|
|
* $bgColor = theme()->settings['background_color']; |
|
382
|
|
|
* |
|
383
|
|
|
* // specific theme |
|
384
|
|
|
* $bgColor = theme('BlueTheme')->settings['background_color']; |
|
385
|
|
|
* ``` |
|
386
|
|
|
* |
|
387
|
|
|
* @param string|null $name Name of the theme to get, or null to get the theme |
|
388
|
|
|
* being used in current request |
|
389
|
|
|
* @return \CMS\Core\Package\PluginPackage |
|
390
|
|
|
* @throws \Cake\Error\FatalErrorException When theme could not be found |
|
391
|
|
|
*/ |
|
392
|
|
|
function theme($name = null) |
|
393
|
|
|
{ |
|
394
|
|
|
if ($name === null) { |
|
395
|
|
|
$option = Router::getRequest()->isAdmin() ? 'back_theme' : 'front_theme'; |
|
396
|
|
|
$name = option($option); |
|
397
|
|
|
} |
|
398
|
|
|
|
|
399
|
|
|
$theme = Plugin::get() |
|
400
|
|
|
->filter(function ($plugin) use ($name) { |
|
401
|
|
|
return $plugin->isTheme && $plugin->name == $name; |
|
402
|
|
|
}) |
|
403
|
|
|
->first(); |
|
404
|
|
|
|
|
405
|
|
|
if ($theme) { |
|
406
|
|
|
return $theme; |
|
407
|
|
|
} |
|
408
|
|
|
|
|
409
|
|
|
throw new FatalErrorException(__d('cms', 'Theme "{0}" was not found', $name)); |
|
410
|
|
|
} |
|
411
|
|
|
} |
|
412
|
|
|
|
|
413
|
|
|
if (!function_exists('listeners')) { |
|
414
|
|
|
/** |
|
415
|
|
|
* Returns a list of all registered event listeners within the provided event |
|
416
|
|
|
* manager, or within the global manager if not provided. |
|
417
|
|
|
* |
|
418
|
|
|
* @param \Cake\Event\EventManager\null $manager Event manager instance, or null |
|
419
|
|
|
* to use global manager instance. |
|
420
|
|
|
* @return array |
|
421
|
|
|
*/ |
|
422
|
|
|
function listeners(EventManager $manager = null) |
|
423
|
|
|
{ |
|
424
|
|
|
if ($manager === null) { |
|
425
|
|
|
$manager = EventManager::instance(); |
|
426
|
|
|
} |
|
427
|
|
|
$class = new \ReflectionClass($manager); |
|
428
|
|
|
$property = $class->getProperty('_listeners'); |
|
429
|
|
|
$property->setAccessible(true); |
|
430
|
|
|
$listeners = array_keys($property->getValue($manager)); |
|
431
|
|
|
return $listeners; |
|
432
|
|
|
} |
|
433
|
|
|
} |
|
434
|
|
|
|
|
435
|
|
|
if (!function_exists('packageSplit')) { |
|
436
|
|
|
/** |
|
437
|
|
|
* Splits a composer package syntax into its vendor and package name. |
|
438
|
|
|
* |
|
439
|
|
|
* Commonly used like `list($vendor, $package) = packageSplit($name);` |
|
440
|
|
|
* |
|
441
|
|
|
* ### Example: |
|
442
|
|
|
* |
|
443
|
|
|
* ```php |
|
444
|
|
|
* list($vendor, $package) = packageSplit('some-vendor/this-package', true); |
|
445
|
|
|
* echo "{$vendor} : {$package}"; |
|
446
|
|
|
* // prints: SomeVendor : ThisPackage |
|
447
|
|
|
* ``` |
|
448
|
|
|
* |
|
449
|
|
|
* @param string $name Package name. e.g. author-name/package-name |
|
450
|
|
|
* @param bool $camelize Set to true to Camelize each part |
|
451
|
|
|
* @return array Array with 2 indexes. 0 => vendor name, 1 => package name. |
|
452
|
|
|
*/ |
|
453
|
|
|
function packageSplit($name, $camelize = false) |
|
454
|
|
|
{ |
|
455
|
|
|
$pos = strrpos($name, '/'); |
|
456
|
|
|
if ($pos === false) { |
|
457
|
|
|
$parts = ['', $name]; |
|
458
|
|
|
} else { |
|
459
|
|
|
$parts = [substr($name, 0, $pos), substr($name, $pos + 1)]; |
|
460
|
|
|
} |
|
461
|
|
|
if ($camelize) { |
|
462
|
|
|
$parts[0] = Inflector::camelize(str_replace('-', '_', $parts[0])); |
|
463
|
|
|
if (!empty($parts[1])) { |
|
464
|
|
|
$parts[1] = Inflector::camelize(str_replace('-', '_', $parts[1])); |
|
465
|
|
|
} |
|
466
|
|
|
} |
|
467
|
|
|
return $parts; |
|
468
|
|
|
} |
|
469
|
|
|
} |
|
470
|
|
|
|
|
471
|
|
|
if (!function_exists('normalizeLocale')) { |
|
472
|
|
|
/** |
|
473
|
|
|
* Normalizes the given locale code. |
|
474
|
|
|
* |
|
475
|
|
|
* @param string $locale The locale code to normalize. e.g. `en-US` |
|
476
|
|
|
* @return string Normalized code. e.g. `en_US` |
|
477
|
|
|
*/ |
|
478
|
|
|
function normalizeLocale($locale) |
|
479
|
|
|
{ |
|
480
|
|
|
list($language, $region) = localeSplit($locale); |
|
481
|
|
|
return !empty($region) ? "{$language}_{$region}" : $language; |
|
482
|
|
|
} |
|
483
|
|
|
} |
|
484
|
|
|
|
|
485
|
|
|
if (!function_exists('aspects')) { |
|
486
|
|
|
/** |
|
487
|
|
|
* Gets a list of all active aspect classes. |
|
488
|
|
|
* |
|
489
|
|
|
* @return array |
|
490
|
|
|
*/ |
|
491
|
|
|
function aspects() |
|
492
|
|
|
{ |
|
493
|
|
|
return quickapps('aspects'); |
|
494
|
|
|
} |
|
495
|
|
|
} |
|
496
|
|
|
|
|
497
|
|
|
if (!function_exists('localeSplit')) { |
|
498
|
|
|
/** |
|
499
|
|
|
* Parses and splits the given locale code and returns its parts: language and |
|
500
|
|
|
* regional codes. |
|
501
|
|
|
* |
|
502
|
|
|
* ### Example: |
|
503
|
|
|
* |
|
504
|
|
|
* ```php |
|
505
|
|
|
* list($language, $region) = localeSplit('en_NZ'); |
|
506
|
|
|
* ``` |
|
507
|
|
|
* |
|
508
|
|
|
* IMPORTANT: Note that region code may be an empty string. |
|
509
|
|
|
* |
|
510
|
|
|
* @param string $localeId Locale code. e.g. "en_NZ" (or "en-NZ") for |
|
511
|
|
|
* "English New Zealand" |
|
512
|
|
|
* @return array Array with 2 indexes. 0 => language code, 1 => country code. |
|
513
|
|
|
*/ |
|
514
|
|
|
function localeSplit($localeId) |
|
515
|
|
|
{ |
|
516
|
|
|
$localeId = str_replace('-', '_', $localeId); |
|
517
|
|
|
$parts = explode('_', $localeId); |
|
518
|
|
|
$country = isset($parts[1]) ? strtoupper($parts[1]) : ''; |
|
519
|
|
|
$language = strtolower($parts[0]); |
|
520
|
|
|
return [$language, $country]; |
|
521
|
|
|
} |
|
522
|
|
|
} |
|
523
|
|
|
|
|
524
|
|
|
if (!function_exists('array_move')) { |
|
525
|
|
|
/** |
|
526
|
|
|
* Moves up or down the given element by index from a list array of elements. |
|
527
|
|
|
* |
|
528
|
|
|
* If item could not be moved, the original list will be returned. Valid values |
|
529
|
|
|
* for $direction are `up` or `down`. |
|
530
|
|
|
* |
|
531
|
|
|
* ### Example: |
|
532
|
|
|
* |
|
533
|
|
|
* ```php |
|
534
|
|
|
* array_move(['a', 'b', 'c'], 1, 'up'); |
|
535
|
|
|
* // returns: ['a', 'c', 'b'] |
|
536
|
|
|
* ``` |
|
537
|
|
|
* |
|
538
|
|
|
* @param array $list Numeric indexed array list of elements |
|
539
|
|
|
* @param int $index The index position of the element you want to move |
|
540
|
|
|
* @param string $direction Direction, 'up' or 'down' |
|
541
|
|
|
* @return array Reordered original list. |
|
542
|
|
|
*/ |
|
543
|
|
|
function array_move(array $list, $index, $direction) |
|
544
|
|
|
{ |
|
545
|
|
|
$maxIndex = count($list) - 1; |
|
546
|
|
|
if ($direction == 'down') { |
|
547
|
|
|
if (0 < $index && $index <= $maxIndex) { |
|
548
|
|
|
$item = $list[$index]; |
|
549
|
|
|
$list[$index] = $list[$index - 1]; |
|
550
|
|
|
$list[$index - 1] = $item; |
|
551
|
|
|
} |
|
552
|
|
|
} elseif ($direction == 'up') { |
|
553
|
|
|
if ($index >= 0 && $maxIndex > $index) { |
|
554
|
|
|
$item = $list[$index]; |
|
555
|
|
|
$list[$index] = $list[$index + 1]; |
|
556
|
|
|
$list[$index + 1] = $item; |
|
557
|
|
|
return $list; |
|
558
|
|
|
} |
|
559
|
|
|
} |
|
560
|
|
|
|
|
561
|
|
|
return $list; |
|
562
|
|
|
} |
|
563
|
|
|
} |
|
564
|
|
|
|
|
565
|
|
|
if (!function_exists('php_eval')) { |
|
566
|
|
|
/** |
|
567
|
|
|
* Evaluate a string of PHP code. |
|
568
|
|
|
* |
|
569
|
|
|
* This is a wrapper around PHP's eval(). It uses output buffering to capture both |
|
570
|
|
|
* returned and printed text. Unlike eval(), we require code to be surrounded by |
|
571
|
|
|
* <?php ?> tags; in other words, we evaluate the code as if it were a stand-alone |
|
572
|
|
|
* PHP file. |
|
573
|
|
|
* |
|
574
|
|
|
* Using this wrapper also ensures that the PHP code which is evaluated can not |
|
575
|
|
|
* overwrite any variables in the calling code, unlike a regular eval() call. |
|
576
|
|
|
* |
|
577
|
|
|
* ### Usage: |
|
578
|
|
|
* |
|
579
|
|
|
* ```php |
|
580
|
|
|
* echo php_eval('<?php return "Hello {$world}!"; ?>', ['world' => 'WORLD']); |
|
581
|
|
|
* // output: Hello WORLD |
|
582
|
|
|
* ``` |
|
583
|
|
|
* |
|
584
|
|
|
* @param string $code The code to evaluate |
|
585
|
|
|
* @param array $args Array of arguments as `key` => `value` pairs, evaluated |
|
586
|
|
|
* code can access this variables |
|
587
|
|
|
* @return string |
|
588
|
|
|
*/ |
|
589
|
|
|
function php_eval($code, $args = []) |
|
590
|
|
|
{ |
|
591
|
|
|
ob_start(); |
|
592
|
|
|
extract($args); |
|
593
|
|
|
print eval('?>' . $code); |
|
594
|
|
|
$output = ob_get_contents(); |
|
595
|
|
|
ob_end_clean(); |
|
596
|
|
|
return $output; |
|
597
|
|
|
} |
|
598
|
|
|
} |
|
599
|
|
|
|
|
600
|
|
|
if (!function_exists('get_this_class_methods')) { |
|
601
|
|
|
/** |
|
602
|
|
|
* Return only the methods for the given object. It will strip out inherited |
|
603
|
|
|
* methods. |
|
604
|
|
|
* |
|
605
|
|
|
* @param string $class Class name |
|
606
|
|
|
* @return array List of methods |
|
607
|
|
|
*/ |
|
608
|
|
|
function get_this_class_methods($class) |
|
609
|
|
|
{ |
|
610
|
|
|
$primary = get_class_methods($class); |
|
611
|
|
|
|
|
612
|
|
|
if ($parent = get_parent_class($class)) { |
|
613
|
|
|
$secondary = get_class_methods($parent); |
|
614
|
|
|
$methods = array_diff($primary, $secondary); |
|
615
|
|
|
} else { |
|
616
|
|
|
$methods = $primary; |
|
617
|
|
|
} |
|
618
|
|
|
|
|
619
|
|
|
return $methods; |
|
620
|
|
|
} |
|
621
|
|
|
} |
|
622
|
|
|
|
|
623
|
|
View Code Duplication |
if (!function_exists('str_replace_once')) { |
|
624
|
|
|
/** |
|
625
|
|
|
* Replace the first occurrence only. |
|
626
|
|
|
* |
|
627
|
|
|
* ### Example: |
|
628
|
|
|
* |
|
629
|
|
|
* ```php |
|
630
|
|
|
* echo str_replace_once('A', 'a', 'AAABBBCCC'); |
|
631
|
|
|
* // out: aAABBBCCC |
|
632
|
|
|
* ``` |
|
633
|
|
|
* |
|
634
|
|
|
* @param string|array $search The value being searched for |
|
635
|
|
|
* @param string $replace The replacement value that replaces found search value |
|
636
|
|
|
* @param string $subject The string being searched and replaced on |
|
637
|
|
|
* @return string A string with the replaced value |
|
638
|
|
|
*/ |
|
639
|
|
|
function str_replace_once($search, $replace, $subject) |
|
640
|
|
|
{ |
|
641
|
|
|
if (!is_array($search)) { |
|
642
|
|
|
$search = [$search]; |
|
643
|
|
|
} |
|
644
|
|
|
|
|
645
|
|
|
foreach ($search as $s) { |
|
646
|
|
|
if ($s !== '' && strpos($subject, $s) !== false) { |
|
647
|
|
|
return substr_replace($subject, $replace, strpos($subject, $s), strlen($s)); |
|
648
|
|
|
} |
|
649
|
|
|
} |
|
650
|
|
|
|
|
651
|
|
|
return $subject; |
|
652
|
|
|
} |
|
653
|
|
|
} |
|
654
|
|
|
|
|
655
|
|
View Code Duplication |
if (!function_exists('str_replace_last')) { |
|
656
|
|
|
/** |
|
657
|
|
|
* Replace the last occurrence only. |
|
658
|
|
|
* |
|
659
|
|
|
* ### Example: |
|
660
|
|
|
* |
|
661
|
|
|
* ```php |
|
662
|
|
|
* echo str_replace_once('A', 'a', 'AAABBBCCC'); |
|
663
|
|
|
* // out: AAaBBBCCC |
|
664
|
|
|
* ``` |
|
665
|
|
|
* |
|
666
|
|
|
* @param string|array $search The value being searched for |
|
667
|
|
|
* @param string $replace The replacement value that replaces found search value |
|
668
|
|
|
* @param string $subject The string being searched and replaced on |
|
669
|
|
|
* @return string A string with the replaced value |
|
670
|
|
|
*/ |
|
671
|
|
|
function str_replace_last($search, $replace, $subject) |
|
672
|
|
|
{ |
|
673
|
|
|
if (!is_array($search)) { |
|
674
|
|
|
$search = [$search]; |
|
675
|
|
|
} |
|
676
|
|
|
|
|
677
|
|
|
foreach ($search as $s) { |
|
678
|
|
|
if ($s !== '' && strrpos($subject, $s) !== false) { |
|
679
|
|
|
$subject = substr_replace($subject, $replace, strrpos($subject, $s), strlen($s)); |
|
680
|
|
|
} |
|
681
|
|
|
} |
|
682
|
|
|
|
|
683
|
|
|
return $subject; |
|
684
|
|
|
} |
|
685
|
|
|
} |
|
686
|
|
|
|
|
687
|
|
|
if (!function_exists('str_starts_with')) { |
|
688
|
|
|
/** |
|
689
|
|
|
* Check if $haystack string starts with $needle string. |
|
690
|
|
|
* |
|
691
|
|
|
* ### Example: |
|
692
|
|
|
* |
|
693
|
|
|
* ```php |
|
694
|
|
|
* str_starts_with('lorem ipsum', 'lo'); // true |
|
695
|
|
|
* str_starts_with('lorem ipsum', 'ipsum'); // false |
|
696
|
|
|
* ``` |
|
697
|
|
|
* |
|
698
|
|
|
* @param string $haystack The string to search in |
|
699
|
|
|
* @param string $needle The string to look for |
|
700
|
|
|
* @return bool |
|
701
|
|
|
*/ |
|
702
|
|
|
function str_starts_with($haystack, $needle) |
|
703
|
|
|
{ |
|
704
|
|
|
return |
|
705
|
|
|
$needle === '' || |
|
706
|
|
|
strpos($haystack, $needle) === 0; |
|
707
|
|
|
} |
|
708
|
|
|
} |
|
709
|
|
|
|
|
710
|
|
|
if (!function_exists('str_ends_with')) { |
|
711
|
|
|
/** |
|
712
|
|
|
* Check if $haystack string ends with $needle string. |
|
713
|
|
|
* |
|
714
|
|
|
* ### Example: |
|
715
|
|
|
* |
|
716
|
|
|
* ```php |
|
717
|
|
|
* str_ends_with('lorem ipsum', 'm'); // true |
|
718
|
|
|
* str_ends_with('dolorem sit amet', 'at'); // false |
|
719
|
|
|
* ``` |
|
720
|
|
|
* |
|
721
|
|
|
* @param string $haystack The string to search in |
|
722
|
|
|
* @param string $needle The string to look for |
|
723
|
|
|
* @return bool |
|
724
|
|
|
*/ |
|
725
|
|
|
function str_ends_with($haystack, $needle) |
|
726
|
|
|
{ |
|
727
|
|
|
return |
|
728
|
|
|
$needle === '' || |
|
729
|
|
|
substr($haystack, - strlen($needle)) === $needle; |
|
730
|
|
|
} |
|
731
|
|
|
} |
|
732
|
|
|
|