presets = [ 'scheduled' => ['scheduled', 'reset_subdef_flag', 'set_writemeta_flag'], 'repair' => ['missing_only', 'prune', 'reset_subdef_flag', 'set_writemeta_flag'], 'all' => ['all', 'reset_subdef_flag', 'set_writemeta_flag'] ]; $this->setDescription('Build subviews'); $this->addOption('databox', null, InputOption::VALUE_REQUIRED, 'Mandatory : The id (or dbname or viewname) of the databox'); $this->addOption('mode', null, InputOption::VALUE_REQUIRED, 'preset working mode : ' . implode('|', array_keys($this->presets))); $this->addOption('record_type', null, InputOption::VALUE_REQUIRED|InputOption::VALUE_IS_ARRAY, 'Type(s) of records(s) to (re)build ex. "image,video", dafault=ALL'); $this->addOption('min_record', null, InputOption::VALUE_OPTIONAL, 'Min record id'); $this->addOption('max_record', null, InputOption::VALUE_OPTIONAL, 'Max record id'); $this->addOption('partition', null, InputOption::VALUE_REQUIRED, 'n/N : work only on records belonging to partition \'n\''); $this->addOption('reverse', null, InputOption::VALUE_NONE, 'Build records from the last to the oldest'); $this->addOption('name', null, InputOption::VALUE_REQUIRED|InputOption::VALUE_IS_ARRAY, 'Name(s) of sub-definition(s) to (re)build, ex. "thumbnail,preview", default=ALL'); $this->addOption('all', null, InputOption::VALUE_NONE, 'Enforce listing of all records'); $this->addOption('scheduled', null, InputOption::VALUE_NONE, 'Only records flagged with \"jeton\" subdef'); $this->addOption('with_substituted', null, InputOption::VALUE_NONE, 'Regenerate subdefs for substituted records as well'); $this->addOption('substituted_only', null, InputOption::VALUE_NONE, 'Regenerate subdefs for substituted records only'); $this->addOption('missing_only', null, InputOption::VALUE_NONE, 'Regenerate only missing subdefs'); $this->addOption('prune', null, InputOption::VALUE_NONE, 'Delete subdefs not in structure anymore'); $this->addOption('reset_subdef_flag', null, InputOption::VALUE_NONE, 'Reset "make-subdef" flag (should only be used when working on all subdefs, that is NO --name filter)'); $this->addOption('set_writemeta_flag', null, InputOption::VALUE_NONE, 'Set "write-metadata" flag (should only be used when working on all subdefs, that is NO --name filter)'); $this->addOption('dry', null, InputOption::VALUE_NONE, 'dry run, list but don\'t act'); $this->addOption('show_sql', null, InputOption::VALUE_NONE, 'show sql pre-selecting records'); $this->setHelp("" . "Record filters :\n" . " --record_type=image,video : Select records of those types ('image','video','audio','document','flash')\n" . " --min_record=100 : Select records with record_id >= 100\n" . " --max_record=500 : Select records with record_id <= 500\n" . " --partition=2/5 : Split databox records in 5 buckets, select records in bucket #2\n" . " --scheduled : Select records flagged as \"make subdef\"\n" . " --missing_only : Select only records with a missing and/or unknown subdef name\n" . " --all : Select all records\n" . "Subdef filters :\n" . " --name=thumbnail,preview : (re)build only thumbnail and preview\n" . " --with_substituted : (re)build substituted subdefs also (normally ignored)\n" . " --substituted_only : rebuild substituted subdefs from document (= remove substitution)\n" . "Actions :\n" . " --prune : remove unknown subdefs\n" . " --reset_subdef_flag : reset the \"make subdef\" scheduling flag (= mark record as done)\n" . " --set_writemeta_flag : raise the \"write meta\" flag (= mark subdefs as missing metadata)\n" . "Preset modes :\n" . " --mode=scheduled : Create subdefs for records flagged \"make subdef\", same as \"subview creation\" task\n" . " (= --scheduled --reset_subdef_flag --set_writemeta_flag)\n" . " --mode=repair : Create only missing subdefs, prune obsolete subdefs\n" . " (= --missing_only --prune --reset_subdef_flag --set_writemeta_flag)\n" . " --mode=all : Re-creates all subdefs\n" . " (= --all --reset_subdef_flag --set_writemeta_flag\n" ); } /** * merge options so one can mix csv-option and/or multiple options * ex. with keepUnique = false : --opt=a,b --opt=c --opt=b ==> [a,b,c,b] * ex. with keepUnique = true : --opt=a,b --opt=c --opt=b ==> [a,b,c] * * @param InputInterface $input * @param string $optionName * @param int $option * @return array */ private function getOptionAsArray(InputInterface $input, $optionName, $option) { $ret = []; foreach($input->getOption($optionName) as $v0) { foreach(explode(',', $v0) as $v) { $v = trim($v); if($option & self::OPTION_ALL_VALUES || !in_array($v, $ret)) { $ret[] = $v; } } } return $ret; } /** * print a string if verbosity >= verbose (-v) * @param string $s */ private function verbose($s) { if($this->output->getVerbosity() >= OutputInterface::VERBOSITY_VERBOSE) { $this->output->write($s); } } /** * sanity check the cmd line options * * @param InputInterface $input * @param OutputInterface $output * @return bool */ protected function sanitizeArgs(InputInterface $input, OutputInterface $output) { $argsOK = true; // find the databox / collection by id or by name $this->databox = null; if(($d = $input->getOption('databox')) !== null) { $d = trim($d); foreach ($this->container->getDataboxes() as $db) { if ($db->get_sbas_id() == (int)$d || $db->get_viewname() == $d || $db->get_dbname() == $d) { $this->databox = $db; $this->connection = $db->get_connection(); break; } } if ($this->databox == null) { $output->writeln(sprintf("Unknown databox \"%s\"", $input->getOption('databox'))); $argsOK = false; } } else { $output->writeln(sprintf("Missing mandatory options --databox")); $argsOK = false; } // get options $this->mode = $input->getOption('mode'); $this->show_sql = $input->getOption('show_sql') ? true : false; $this->dry = $input->getOption('dry') ? true : false; $this->recmin = $input->getOption('min_record'); $this->recmax = $input->getOption('max_record'); $this->substituted_only = $input->getOption('substituted_only') ? true : false; $this->with_substituted = $input->getOption('with_substituted') ? true : false; $this->missing_only = $input->getOption('missing_only') ? true : false; $this->prune = $input->getOption('prune') ? true : false; $this->all = $input->getOption('all') ? true : false; $this->scheduled = $input->getOption('scheduled') ? true : false; $this->reverse = $input->getOption('reverse') ? true : false; $this->reset_subdef_flag = $input->getOption('reset_subdef_flag') ? true : false; $this->set_writemeta_flag = $input->getOption('set_writemeta_flag') ? true : false; $types = $this->getOptionAsArray($input, 'record_type', self::OPTION_DISTINT_VALUES); $names = $this->getOptionAsArray($input, 'name', self::OPTION_DISTINT_VALUES); if ($this->with_substituted && $this->substituted_only) { $output->writeln("--substituted_only and --with_substituted are mutually exclusive"); $argsOK = false; } if($this->mode) { if($this->substituted_only || $this->with_substituted || $this->missing_only || $this->prune || $this->all || $this->reset_subdef_flag || $this->set_writemeta_flag) { $output->writeln("--mode and (--substituted_only, --with_substituted, --missing_only, --prune, --all, --reset_subdef_flag, --set_writemeta_flag) are mutually exclusive"); $argsOK = false; } if(!in_array($this->mode, array_keys($this->presets))) { $output->writeln(sprintf("invalid --mode \"%s\"", $this->mode)); $argsOK = false; } else { $output->writeln(sprintf("mode \"%s\" ==> --%s", $this->mode, implode(' --', $this->presets[$this->mode]))); foreach($this->presets[$this->mode] as $toset) { $this->{$toset} = true; } } } if($this->prune && !empty($names)) { $output->writeln("--prune and --name are mutually exclusive"); $argsOK = false; } $n = ($this->scheduled?1:0) + ($this->missing_only?1:0) + ($this->all?1:0); if($n != 1) { $output->writeln("set one an only one option --scheduled, --missing_only, --all"); $argsOK = false; } // validate types and subdefs $this->subdefsTodoByType = []; $this->subdefsByType = []; if($this->databox !== null) { /** @var SubdefGroup $sg */ foreach ($this->databox->get_subdef_structure() as $sg) { if (empty($types) || in_array($sg->getName(), $types)) { $all = []; $todo = []; /** @var databox_subdef $sd */ foreach ($sg as $sd) { $all[] = $sd->get_name(); if (empty($names) || in_array($sd->get_name(), $names)) { $todo[] = $sd->get_name(); } } asort($all); $this->subdefsByType[$sg->getName()] = $all; asort($todo); $this->subdefsTodoByType[$sg->getName()] = $todo; } } foreach ($types as $t) { if (!array_key_exists($t, $this->subdefsTodoByType)) { $output->writeln(sprintf("unknown type \"%s\"", $t)); $argsOK = false; } } } // validate partition $this->partitionIndex = $this->partitionCount = null; if( ($arg = $input->getOption('partition')) !== null) { $arg = explode('/', $arg); if(count($arg) == 2 && ($arg0 = (int)trim($arg[0]))>0 && ($arg1 = (int)trim($arg[1]))>1 && $arg0<=$arg1 ) { $this->partitionIndex = $arg0; $this->partitionCount = $arg1; } else { $output->writeln(sprintf('partition must be n/N')); $argsOK = false; } } // warning about changing jeton when not working on all subdefs if(!empty($names) && ($this->reset_subdef_flag || $this->set_writemeta_flag)) { $output->writeln("changing record flag(s) but working on a subset of subdefs"); } return $argsOK; } /** * {@inheritdoc} */ protected function doExecute(InputInterface $input, OutputInterface $output) { if(!$this->sanitizeArgs($input, $output)) { return -1; } $this->input = $input; $this->output = $output; $sql = $this->getSQL(); if($this->show_sql) { $this->output->writeln($sql); } $sqlCount = sprintf('SELECT COUNT(*) FROM (%s) AS c', $sql); $totalRecords = (int)$this->connection->executeQuery($sqlCount)->fetchColumn(); if ($totalRecords === 0) { return 0; } $progress = null; if($output->getVerbosity() < OutputInterface::VERBOSITY_VERBOSE) { $progress = new ProgressBar($output, $totalRecords); $progress->start(); $progress->display(); } $stmt = $this->connection->executeQuery($sql); while( ($row = $stmt->fetch(\PDO::FETCH_ASSOC)) ) { $type = $row['type']; $msg = sprintf(' record %s (%s) : ', $row['record_id'], $type); try { $record = $this->databox->get_record($row['record_id']); $subdefNamesToDo = array_flip($this->subdefsTodoByType[$type]); // do all subdefs ? /** @var media_subdef $subdef */ $subdefsDeleted = []; foreach ($record->get_subdefs() as $subdef) { $name = $subdef->get_name(); if($name == "document") { continue; } if(!in_array($name, $this->subdefsByType[$type])) { // this existing subdef is unknown in structure if($this->prune) { if(!$this->dry) { $subdef->delete(); } $subdefsDeleted[] = $name; $msg .= sprintf(" \"%s\" deleted,", $name); } continue; } if($this->missing_only) { unset($subdefNamesToDo[$name]); continue; } if($subdef->is_substituted()) { if(!$this->with_substituted && !$this->substituted_only) { unset($subdefNamesToDo[$name]); continue; } } else { if($this->substituted_only) { unset($subdefNamesToDo[$name]); continue; } } // here an existing subdef must be (re)done if(!$this->dry) { $subdef->remove_file(); $subdef->set_substituted(false); } } $subdefNamesToDo = array_keys($subdefNamesToDo); if(!empty($subdefNamesToDo)) { if(!$this->dry) { /** @var SubdefGenerator $subdefGenerator */ $subdefGenerator = $this->container['subdef.generator']; $subdefGenerator->generateSubdefs($record, $subdefNamesToDo); } $msg .= sprintf(" [\"%s\"] built", implode('","', $subdefNamesToDo)); } else { // $msg .= " nothing to build"; } unset($record); if($this->reset_subdef_flag || $this->set_writemeta_flag) { // subdef created, ask to rewrite metadata $sql = 'UPDATE record' . ' SET jeton=(jeton & ~(:flag_and)) | :flag_or' . ' WHERE record_id=:record_id'; if($this->reset_subdef_flag) { $msg .= ", jeton[\"make_subdef\"]=0"; } if($this->set_writemeta_flag) { $msg .= ", jeton[\"write_met_subdef\"]=1"; } if(!$this->dry) { $this->connection->executeUpdate($sql, [ ':record_id' => $row['record_id'], ':flag_and' => ($this->reset_subdef_flag ? PhraseaTokens::MAKE_SUBDEF : 0), ':flag_or' => ($this->set_writemeta_flag ? PhraseaTokens::WRITE_META_SUBDEF : 0) ]); } } } catch(\Exception $e) { $this->output->write("failed\n"); } if($progress) { $progress->advance(); $this->output->write($msg); } else { $this->output->writeln($msg); } } unset($stmt); if($progress) { $progress->finish(); $output->writeln(''); } return 0; } /** * @return string */ protected function getSQL() { $sql = "SELECT r.`record_id`, r.`type`, GROUP_CONCAT(s.`name` ORDER BY `name`) AS `exists`,\n" . " CASE r.`type`\n"; foreach($this->subdefsByType as $type=>$names) { $sql .= " WHEN " . $this->connection->quote($type) . " THEN " . $this->connection->quote(join(',', $names)) . "\n"; } $sql .= " END\n" . " AS `waited`\n" . "FROM `record` AS r LEFT JOIN `subdef` AS s USING(`record_id`)\n" . "WHERE r.`parent_record_id`=0"; $recordTypes = array_keys($this->subdefsTodoByType); $types = array_map(function($v) {return $this->connection->quote($v);}, $recordTypes); if(!empty($types)) { $sql .= " AND r.`type` IN(" . implode(',', $types) . ")\n"; } if ($this->recmin !== null) { $sql .= " AND (r.`record_id` >= " . (int)($this->recmin) . ")\n"; } if ($this->recmax) { $sql .= " AND (r.`record_id` <= " . (int)($this->recmax) . ")\n"; } if($this->partitionCount !== null && $this->partitionIndex !== null) { $sql .= " AND MOD(r.`record_id`, " . $this->partitionCount . ")=" . ($this->partitionIndex-1) . "\n"; } if($this->scheduled) { $sql .= " AND r.`jeton` & " . PhraseaTokens::MAKE_SUBDEF; } $sql .= " AND s.`name` != 'document'\n" . "GROUP BY r.`record_id`"; if(!$this->scheduled && !$this->all) { $sql .= "\nHAVING `exists` != `waited`"; } $sql .= "\nORDER BY r.`record_id` " . ($this->reverse ? "DESC" : "ASC"); return $sql; } }