nextcloud/core/command/base.php

160 lines
4.3 KiB
PHP
Raw Normal View History

<?php
/**
* @author Joas Schilling <nickvergessen@owncloud.com>
*
2016-01-12 17:02:16 +03:00
* @copyright Copyright (c) 2016, ownCloud, Inc.
* @license AGPL-3.0
*
* This code is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License, version 3,
* as published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License, version 3,
* along with this program. If not, see <http://www.gnu.org/licenses/>
*
*/
namespace OC\Core\Command;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Input\InputOption;
use Symfony\Component\Console\Output\OutputInterface;
class Base extends Command {
2015-07-17 10:25:19 +03:00
const OUTPUT_FORMAT_PLAIN = 'plain';
const OUTPUT_FORMAT_JSON = 'json';
const OUTPUT_FORMAT_JSON_PRETTY = 'json_pretty';
protected $defaultOutputFormat = self::OUTPUT_FORMAT_PLAIN;
/** @var boolean */
private $php_pcntl_signal = false;
/** @var boolean */
private $interrupted = false;
protected function configure() {
$this
->addOption(
'output',
null,
InputOption::VALUE_OPTIONAL,
2015-04-09 15:42:44 +03:00
'Output format (plain, json or json_pretty, default is plain)',
$this->defaultOutputFormat
)
;
}
2015-04-09 15:44:30 +03:00
/**
* @param InputInterface $input
* @param OutputInterface $output
* @param array $items
2015-04-30 17:59:25 +03:00
* @param string $prefix
2015-04-09 15:44:30 +03:00
*/
2015-04-30 16:42:18 +03:00
protected function writeArrayInOutputFormat(InputInterface $input, OutputInterface $output, $items, $prefix = ' - ') {
2015-04-09 15:42:44 +03:00
switch ($input->getOption('output')) {
2015-07-17 10:25:19 +03:00
case self::OUTPUT_FORMAT_JSON:
2015-04-09 15:42:44 +03:00
$output->writeln(json_encode($items));
break;
2015-07-17 10:25:19 +03:00
case self::OUTPUT_FORMAT_JSON_PRETTY:
2015-04-09 15:42:44 +03:00
$output->writeln(json_encode($items, JSON_PRETTY_PRINT));
break;
default:
foreach ($items as $key => $item) {
2015-04-30 16:42:18 +03:00
if (is_array($item)) {
$output->writeln($prefix . $key . ':');
$this->writeArrayInOutputFormat($input, $output, $item, ' ' . $prefix);
continue;
}
if (!is_int($key)) {
$value = $this->valueToString($item);
if (!is_null($value)) {
2015-04-30 16:42:18 +03:00
$output->writeln($prefix . $key . ': ' . $value);
} else {
2015-04-30 16:42:18 +03:00
$output->writeln($prefix . $key);
}
} else {
2015-04-30 16:42:18 +03:00
$output->writeln($prefix . $this->valueToString($item));
}
}
break;
}
}
2015-05-08 18:13:46 +03:00
/**
* @param InputInterface $input
* @param OutputInterface $output
* @param mixed $item
*/
protected function writeMixedInOutputFormat(InputInterface $input, OutputInterface $output, $item) {
if (is_array($item)) {
$this->writeArrayInOutputFormat($input, $output, $item, '');
return;
}
switch ($input->getOption('output')) {
2015-07-17 10:25:19 +03:00
case self::OUTPUT_FORMAT_JSON:
2015-05-08 18:13:46 +03:00
$output->writeln(json_encode($item));
break;
2015-07-17 10:25:19 +03:00
case self::OUTPUT_FORMAT_JSON_PRETTY:
2015-05-08 18:13:46 +03:00
$output->writeln(json_encode($item, JSON_PRETTY_PRINT));
break;
default:
$output->writeln($this->valueToString($item, false));
break;
}
}
protected function valueToString($value, $returnNull = true) {
if ($value === false) {
return 'false';
} else if ($value === true) {
return 'true';
} else if ($value === null) {
2015-05-08 18:13:46 +03:00
return ($returnNull) ? null : 'null';
} else {
return $value;
}
}
/**
* @return bool
*/
protected function hasBeenInterrupted() {
// return always false if pcntl_signal functions are not accessible
if ($this->php_pcntl_signal) {
pcntl_signal_dispatch();
return $this->interrupted;
} else {
return false;
}
}
/**
* Changes the status of the command to "interrupted" if ctrl-c has been pressed
*
* Gives a chance to the command to properly terminate what it's doing
*/
protected function cancelOperation() {
$this->interrupted = true;
}
public function run(InputInterface $input, OutputInterface $output) {
// check if the php pcntl_signal functions are accessible
$this->php_pcntl_signal = function_exists('pcntl_signal');
if ($this->php_pcntl_signal) {
// Collect interrupts and notify the running command
pcntl_signal(SIGTERM, [$this, 'cancelOperation']);
pcntl_signal(SIGINT, [$this, 'cancelOperation']);
}
return parent::run($input, $output);
}
}