friendica/src/Console/Lock.php

186 lines
4.2 KiB
PHP
Raw Normal View History

2019-08-13 21:20:41 +02:00
<?php
namespace Friendica\Console;
use Asika\SimpleConsole\CommandArgsException;
use Friendica\App;
use Friendica\Core\Lock\ILock;
use RuntimeException;
/**
2020-01-19 07:05:23 +01:00
* tool to access the locks from the CLI
2019-08-13 21:20:41 +02:00
*
* With this script you can access the locks of your node from the CLI.
* You can read current locks and set/remove locks.
*
* @author Philipp Holzer <admin@philipp.info>, Hypolite Petovan <hypolite@mrpetovan.com>
*/
class Lock extends \Asika\SimpleConsole\Console
{
protected $helpOptions = ['h', 'help', '?'];
/**
* @var App\Mode
*/
private $appMode;
/**
* @var ILock
*/
private $lock;
protected function getHelp()
{
$help = <<<HELP
2019-08-15 14:22:29 +02:00
console lock - Manage node locks
2019-08-13 21:20:41 +02:00
Synopsis
bin/console lock list [<prefix>] [-h|--help|-?] [-v]
bin/console lock set <lock> [<timeout> [<ttl>]] [-h|--help|-?] [-v]
bin/console lock del <lock> [-h|--help|-?] [-v]
bin/console lock clear [-h|--help|-?] [-v]
Description
bin/console lock list [<prefix>]
List all locks, optionally filtered by a prefix
bin/console lock set <lock> [<timeout> [<ttl>]]
Sets manually a lock, optionally with the provided TTL (time to live) with a default of five minutes.
bin/console lock del <lock>
Deletes a lock.
bin/console lock clear
Clears all locks
Options
-h|--help|-? Show help information
-v Show more debug information.
HELP;
return $help;
}
public function __construct(App\Mode $appMode, ILock $lock, array $argv = null)
{
parent::__construct($argv);
$this->appMode = $appMode;
$this->lock = $lock;
}
protected function doExecute()
{
if ($this->getOption('v')) {
$this->out('Executable: ' . $this->executable);
$this->out('Class: ' . __CLASS__);
$this->out('Arguments: ' . var_export($this->args, true));
$this->out('Options: ' . var_export($this->options, true));
}
if (!$this->appMode->has(App\Mode::DBCONFIGAVAILABLE)) {
$this->out('Database isn\'t ready or populated yet, database cache won\'t be available');
}
if ($this->getOption('v')) {
$this->out('Lock Driver Name: ' . $this->lock->getName());
$this->out('Lock Driver Class: ' . get_class($this->lock));
}
switch ($this->getArgument(0)) {
case 'list':
$this->executeList();
break;
case 'set':
$this->executeSet();
break;
case 'del':
$this->executeDel();
break;
case 'clear':
$this->executeClear();
break;
}
if (count($this->args) == 0) {
$this->out($this->getHelp());
return 0;
}
return 0;
}
private function executeList()
{
$prefix = $this->getArgument(1, '');
$keys = $this->lock->getLocks($prefix);
if (empty($prefix)) {
$this->out('Listing all Locks:');
} else {
$this->out('Listing all Locks starting with "' . $prefix . '":');
}
$count = 0;
foreach ($keys as $key) {
$this->out($key);
$count++;
}
$this->out($count . ' locks found');
}
private function executeDel()
{
if (count($this->args) >= 2) {
2019-08-15 14:22:29 +02:00
$lock = $this->getArgument(1);
2019-08-13 21:20:41 +02:00
if ($this->lock->release($lock, true)) {
2019-08-13 21:20:41 +02:00
$this->out(sprintf('Lock \'%s\' released.', $lock));
} else {
$this->out(sprintf('Couldn\'t release Lock \'%s\'', $lock));
}
} else {
throw new CommandArgsException('Too few arguments for del.');
}
}
private function executeSet()
{
if (count($this->args) >= 2) {
2019-08-15 14:22:29 +02:00
$lock = $this->getArgument(1);
2019-08-13 21:20:41 +02:00
$timeout = intval($this->getArgument(2, false));
2019-08-15 14:22:29 +02:00
$ttl = intval($this->getArgument(3, false));
2019-08-13 21:20:41 +02:00
2019-08-15 14:22:29 +02:00
if ($this->lock->isLocked($lock)) {
2019-08-13 21:20:41 +02:00
throw new RuntimeException(sprintf('\'%s\' is already set.', $lock));
}
if (!empty($ttl) && !empty($timeout)) {
$result = $this->lock->acquire($lock, $timeout, $ttl);
2019-08-13 21:20:41 +02:00
} elseif (!empty($timeout)) {
$result = $this->lock->acquire($lock, $timeout);
2019-08-13 21:20:41 +02:00
} else {
$result = $this->lock->acquire($lock);
2019-08-13 21:20:41 +02:00
}
if ($result) {
$this->out(sprintf('Lock \'%s\' acquired.', $lock));
} else {
2019-08-15 14:22:29 +02:00
throw new RuntimeException(sprintf('Unable to lock \'%s\'.', $lock));
2019-08-13 21:20:41 +02:00
}
} else {
throw new CommandArgsException('Too few arguments for set.');
}
}
private function executeClear()
{
$result = $this->lock->releaseAll(true);
if ($result) {
2019-08-15 14:22:29 +02:00
$this->out('Locks successfully cleared.');
2019-08-13 21:20:41 +02:00
} else {
2019-08-15 14:22:29 +02:00
throw new RuntimeException('Unable to clear the locks.');
2019-08-13 21:20:41 +02:00
}
}
}