/
OrmCacheShell.php
119 lines (105 loc) · 3.31 KB
/
OrmCacheShell.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
<?php
/**
* CakePHP(tm) : Rapid Development Framework (https://cakephp.org)
* Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
*
* Licensed under The MIT License
* For full copyright and license information, please see the LICENSE.txt
* Redistributions of files must retain the above copyright notice.
*
* @copyright Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
* @link https://cakephp.org CakePHP(tm) Project
* @since 3.0.0
* @license https://opensource.org/licenses/mit-license.php MIT License
*/
namespace Cake\Shell;
use Cake\Console\Shell;
use Cake\ORM\OrmCache;
use RuntimeException;
/**
* ORM Cache Shell.
*
* Provides a CLI interface to the ORM metadata caching features.
* This tool is intended to be used by deployment scripts so that you
* can prevent thundering herd effects on the metadata cache when new
* versions of your application are deployed, or when migrations
* requiring updated metadata are required.
*/
class OrmCacheShell extends Shell
{
/**
* ORM Cache
*
* @var \Cake\ORM\OrmCache
*/
protected $_ormCache;
/**
* Build metadata.
*
* @param string|null $name The name of the table to build cache data for.
* @return bool
*/
public function build($name = null)
{
$cache = $this->_getOrmCache();
$tables = $cache->build($name);
foreach ($tables as $table) {
$this->verbose(sprintf('Cached "%s"', $table));
}
$this->out('<success>Cache build complete</success>');
return true;
}
/**
* Clear metadata.
*
* @param string|null $name The name of the table to clear cache data for.
* @return bool
*/
public function clear($name = null)
{
$cache = $this->_getOrmCache();
$tables = $cache->clear($name);
foreach ($tables as $table) {
$this->verbose(sprintf('Cleared "%s"', $table));
}
$this->out('<success>Cache clear complete</success>');
return true;
}
/**
* Gets the ORM Cache instance
*
* @return \Cake\ORM\OrmCache
*/
protected function _getOrmCache()
{
try {
return new OrmCache($this->params['connection']);
} catch (RuntimeException $e) {
$this->abort($e->getMessage());
}
}
/**
* Get the option parser for this shell.
*
* @return \Cake\Console\ConsoleOptionParser
*/
public function getOptionParser()
{
$parser = parent::getOptionParser();
$parser->addSubcommand('clear', [
'help' => 'Clear all metadata caches for the connection. If a ' .
'table name is provided, only that table will be removed.',
])->addSubcommand('build', [
'help' => 'Build all metadata caches for the connection. If a ' .
'table name is provided, only that table will be cached.',
])->addOption('connection', [
'help' => 'The connection to build/clear metadata cache data for.',
'short' => 'c',
'default' => 'default',
])->addArgument('name', [
'help' => 'A specific table you want to clear/refresh cached data for.',
'optional' => true,
]);
return $parser;
}
}