1
|
|
|
<?php |
2
|
|
|
namespace App\Shell; |
3
|
|
|
|
4
|
|
|
use Cake\Cache\Cache; |
5
|
|
|
use Cake\Console\ConsoleOptionParser; |
6
|
|
|
use Cake\Console\Shell; |
7
|
|
|
use Cake\Utility\Inflector; |
8
|
|
|
|
9
|
|
|
class MaintenanceShell extends Shell |
10
|
|
|
{ |
11
|
|
|
/** |
12
|
|
|
* The setting key to modify. |
13
|
|
|
* |
14
|
|
|
* @var string |
15
|
|
|
*/ |
16
|
|
|
protected $settingKey = 'Site.maintenance'; |
17
|
|
|
|
18
|
|
|
/** |
19
|
|
|
* Initialize method. |
20
|
|
|
* |
21
|
|
|
* @return void |
22
|
|
|
*/ |
23
|
|
|
public function initialize() |
24
|
|
|
{ |
25
|
|
|
parent::initialize(); |
26
|
|
|
$this->loadModel('Settings'); |
27
|
|
|
} |
28
|
|
|
|
29
|
|
|
/** |
30
|
|
|
* Display help for this console. |
31
|
|
|
* |
32
|
|
|
* @return ConsoleOptionParser |
33
|
|
|
*/ |
34
|
|
|
public function getOptionParser() |
35
|
|
|
{ |
36
|
|
|
$parser = parent::getOptionParser(); |
37
|
|
|
$parser->description( |
38
|
|
|
'This shell is used with the maintenance mode in the application.' |
39
|
|
|
)->addSubcommand('down', [ |
40
|
|
|
'help' => 'Put the website in maintenance mode.' |
41
|
|
|
])->addSubcommand('up', [ |
42
|
|
|
'help' => 'Remove the website from the maintenance mode.' |
43
|
|
|
]); |
44
|
|
|
|
45
|
|
|
return $parser; |
46
|
|
|
} |
47
|
|
|
|
48
|
|
|
/** |
49
|
|
|
* Put the application in maintenance mode. |
50
|
|
|
* |
51
|
|
|
* @return bool |
52
|
|
|
*/ |
53
|
|
|
public function down() |
54
|
|
|
{ |
55
|
|
|
return $this->handleMaintenance('down', '1'); |
56
|
|
|
} |
57
|
|
|
|
58
|
|
|
/** |
59
|
|
|
* Remove the application from the maintenance mode. |
60
|
|
|
* |
61
|
|
|
* @return bool |
62
|
|
|
*/ |
63
|
|
|
public function up() |
64
|
|
|
{ |
65
|
|
|
return $this->handleMaintenance('up', '0'); |
66
|
|
|
} |
67
|
|
|
|
68
|
|
|
/** |
69
|
|
|
* Handle the maintenance. |
70
|
|
|
* |
71
|
|
|
* @param string $type The type of the maintenance; up, down. |
72
|
|
|
* @param string $value The value of the setting key. |
73
|
|
|
* |
74
|
|
|
* @return bool |
75
|
|
|
*/ |
76
|
|
|
protected function handleMaintenance($type, $value) |
77
|
|
|
{ |
78
|
|
|
$setting = $this->Settings->find() |
|
|
|
|
79
|
|
|
->where(['name' => $this->settingKey]) |
80
|
|
|
->first(); |
81
|
|
|
|
82
|
|
|
if ($this->checkKey($setting) === false) { |
83
|
|
|
return false; |
84
|
|
|
} |
85
|
|
|
|
86
|
|
|
$data = [ |
87
|
|
|
'value_int' => null, |
88
|
|
|
'value_str' => null, |
89
|
|
|
'value_bool' => $value |
90
|
|
|
]; |
91
|
|
|
|
92
|
|
|
$this->Settings->patchEntity($setting, $data); |
|
|
|
|
93
|
|
|
|
94
|
|
|
if ($this->Settings->save($setting)) { |
|
|
|
|
95
|
|
|
Cache::clear(false, 'database'); |
96
|
|
|
$this->out('<success>The</success> "<info>maintenance ' . $type . '</info>" <success>command has been executed successfully !</success>', 2); |
97
|
|
|
|
98
|
|
|
return true; |
99
|
|
|
} else { |
100
|
|
|
$this->out('<error>The</error> "<info>maintenance ' . $type . '</info>" <error>has failed while saving the setting key !</error>', 2); |
101
|
|
|
|
102
|
|
|
return false; |
103
|
|
|
} |
104
|
|
|
} |
105
|
|
|
|
106
|
|
|
/** |
107
|
|
|
* Check if the setting key exist in the database. |
108
|
|
|
* |
109
|
|
|
* @param null|App\Model\Entity\Setting $setting The setting to check. |
110
|
|
|
* |
111
|
|
|
* @return bool |
112
|
|
|
*/ |
113
|
|
|
protected function checkKey($setting) |
114
|
|
|
{ |
115
|
|
|
if (is_null($setting)) { |
116
|
|
|
$msg = sprintf( |
117
|
|
|
'The setting key "%s" can not be found in the database, ' . |
118
|
|
|
'please add it to use this command shell.', |
119
|
|
|
$this->settingKey |
120
|
|
|
); |
121
|
|
|
$this->error($msg); |
|
|
|
|
122
|
|
|
|
123
|
|
|
return false; |
124
|
|
|
} |
125
|
|
|
|
126
|
|
|
return true; |
127
|
|
|
} |
128
|
|
|
} |
129
|
|
|
|
Since your code implements the magic getter
_get
, this function will be called for any read access on an undefined variable. You can add the@property
annotation to your class or interface to document the existence of this variable.If the property has read access only, you can use the @property-read annotation instead.
Of course, you may also just have mistyped another name, in which case you should fix the error.
See also the PhpDoc documentation for @property.