[] [--admin] arsse.php user remove arsse.php user show arsse.php user set arsse.php user unset arsse.php user set-pass [] [--fever] arsse.php user unset-pass [--fever] arsse.php user auth [--fever] arsse.php token list arsse.php token create [] arsse.php token revoke [] arsse.php import [] [-f|--flat] [-r|--replace] arsse.php export [] [-f|--flat] arsse.php daemon arsse.php feed refresh-all arsse.php feed refresh arsse.php conf save-defaults [] arsse.php --version arsse.php -h|--help The Arsse command-line interface can be used to perform various administrative tasks such as starting the newsfeed refresh service, managing users, and importing or exporting data. See the manual page for more details: man 1 arsse USAGE_TEXT; protected function usage($prog): string { $prog = basename($prog); return str_replace("arsse.php", $prog, self::USAGE); } protected function command($args): string { $out = []; foreach ($args as $k => $v) { if (preg_match("/^[a-z]/", $k) && $v === true) { $out[] = $k; } } return implode(" ", $out); } /** @codeCoverageIgnore */ protected function loadConf(): bool { $conf = file_exists(BASE."config.php") ? new Conf(BASE."config.php") : new Conf; Arsse::load($conf); return true; } protected function resolveFile($file, string $mode): string { // TODO: checking read/write permissions on the provided path may be useful $stdinOrStdout = in_array($mode, ["r", "r+"]) ? "php://input" : "php://output"; return ($file === "-" ? null : $file) ?? $stdinOrStdout; } public function dispatch(array $argv = null): int { $argv = $argv ?? $_SERVER['argv']; $argv0 = array_shift($argv); $args = \Docopt::handle($this->usage($argv0), [ 'argv' => $argv, 'help' => false, ]); try { $cmd = $this->command($args); if ($cmd && !in_array($cmd, ["", "conf save-defaults"])) { // only certain commands don't require configuration to be loaded $this->loadConf(); } switch ($cmd) { case "": if ($args['--version']) { echo Arsse::VERSION.\PHP_EOL; } elseif ($args['--help'] || $args['-h']) { echo $this->usage($argv0).\PHP_EOL; } return 0; case "daemon": Arsse::$obj->get(Service::class)->watch(true); return 0; case "feed refresh": return (int) !Arsse::$db->feedUpdate((int) $args[''], true); case "feed refresh-all": Arsse::$obj->get(Service::class)->watch(false); return 0; case "conf save-defaults": $file = $this->resolveFile($args[''], "w"); return (int) !Arsse::$obj->get(Conf::class)->exportFile($file, true); case "export": $u = $args['']; $file = $this->resolveFile($args[''], "w"); return (int) !Arsse::$obj->get(OPML::class)->exportFile($file, $u, ($args['--flat'] || $args['-f'])); case "import": $u = $args['']; $file = $this->resolveFile($args[''], "r"); return (int) !Arsse::$obj->get(OPML::class)->importFile($file, $u, ($args['--flat'] || $args['-f']), ($args['--replace'] || $args['-r'])); case "token list": case "list token": // command reconstruction yields this order for "token list" command return $this->tokenList($args['']); case "token create": echo Arsse::$obj->get(Miniflux::class)->tokenGenerate($args[''], $args['']).\PHP_EOL; return 0; case "token revoke": Arsse::$db->tokenRevoke($args[''], "miniflux.login", $args['']); return 0; case "user add": $out = $this->userAddOrSetPassword("add", $args[""], $args[""]); if ($args['--admin']) { Arsse::$user->propertiesSet($args[""], ['admin' => true]); } return $out; case "user set-pass": if ($args['--fever']) { $passwd = Arsse::$obj->get(Fever::class)->register($args[""], $args[""]); if (is_null($args[""])) { echo $passwd.\PHP_EOL; } return 0; } else { return $this->userAddOrSetPassword("passwordSet", $args[""], $args[""], $args["--oldpass"]); } // no break case "user unset-pass": if ($args['--fever']) { Arsse::$obj->get(Fever::class)->unregister($args[""]); } else { Arsse::$user->passwordUnset($args[""], $args["--oldpass"]); } return 0; case "user remove": return (int) !Arsse::$user->remove($args[""]); case "user show": return $this->userShowProperties($args[""]); case "user set": return (int) !Arsse::$user->propertiesSet($args[""], [$args[""] => $args[""]]); case "user unset": return (int) !Arsse::$user->propertiesSet($args[""], [$args[""] => null]); case "user auth": return $this->userAuthenticate($args[""], $args[""], $args["--fever"]); case "user list": case "user": return $this->userList(); default: throw new Exception("constantUnknown", $cmd); // @codeCoverageIgnore } } catch (AbstractException $e) { $this->logError($e->getMessage()); return $e->getCode(); } } // @codeCoverageIgnore /** @codeCoverageIgnore */ protected function logError(string $msg): void { fwrite(STDERR, $msg.\PHP_EOL); } protected function userAddOrSetPassword(string $method, string $user, string $password = null, string $oldpass = null): int { $passwd = Arsse::$user->$method(...array_slice(func_get_args(), 1)); if (is_null($password)) { echo $passwd.\PHP_EOL; } return 0; } protected function userList(): int { $list = Arsse::$user->list(); if ($list) { echo implode(\PHP_EOL, $list).\PHP_EOL; } return 0; } protected function userAuthenticate(string $user, string $password, bool $fever = false): int { $result = $fever ? Arsse::$obj->get(Fever::class)->authenticate($user, $password) : Arsse::$user->auth($user, $password); if ($result) { echo Arsse::$lang->msg("CLI.Auth.Success").\PHP_EOL; return 0; } else { echo Arsse::$lang->msg("CLI.Auth.Failure").\PHP_EOL; return 1; } } protected function userShowProperties(string $user): int { $data = Arsse::$user->propertiesGet($user); $len = array_reduce(array_keys($data), function($carry, $item) { return max($carry, strlen($item)); }, 0) + 2; foreach ($data as $k => $v) { echo str_pad($k, $len, " "); echo var_export($v, true).\PHP_EOL; } return 0; } protected function tokenList(string $user): int { $list = Arsse::$obj->get(Miniflux::class)->tokenList($user); usort($list, function($v1, $v2) { return $v1['label'] <=> $v2['label']; }); foreach ($list as $t) { echo $t['id']." ".$t['label'].\PHP_EOL; } return 0; } }