setTable($table); if (! is_array($tables)) { return; } $this->setTables($tables); } protected function setProperties(): ExportPluginProperties { // create the export plugin property item $exportPluginProperties = new ExportPluginProperties(); $exportPluginProperties->setText('XML'); $exportPluginProperties->setExtension('xml'); $exportPluginProperties->setMimeType('text/xml'); $exportPluginProperties->setOptionsText(__('Options')); // create the root group that will be the options field for // $exportPluginProperties // this will be shown as "Format specific options" $exportSpecificOptions = new OptionsPropertyRootGroup('Format Specific Options'); // general options main group $generalOptions = new OptionsPropertyMainGroup('general_opts'); // create primary items and add them to the group $leaf = new HiddenPropertyItem('structure_or_data'); $generalOptions->addProperty($leaf); // add the main group to the root group $exportSpecificOptions->addProperty($generalOptions); // export structure main group $structure = new OptionsPropertyMainGroup( 'structure', __('Object creation options (all are recommended)') ); // create primary items and add them to the group $leaf = new BoolPropertyItem( 'export_events', __('Events') ); $structure->addProperty($leaf); $leaf = new BoolPropertyItem( 'export_functions', __('Functions') ); $structure->addProperty($leaf); $leaf = new BoolPropertyItem( 'export_procedures', __('Procedures') ); $structure->addProperty($leaf); $leaf = new BoolPropertyItem( 'export_tables', __('Tables') ); $structure->addProperty($leaf); $leaf = new BoolPropertyItem( 'export_triggers', __('Triggers') ); $structure->addProperty($leaf); $leaf = new BoolPropertyItem( 'export_views', __('Views') ); $structure->addProperty($leaf); $exportSpecificOptions->addProperty($structure); // data main group $data = new OptionsPropertyMainGroup( 'data', __('Data dump options') ); // create primary items and add them to the group $leaf = new BoolPropertyItem( 'export_contents', __('Export contents') ); $data->addProperty($leaf); $exportSpecificOptions->addProperty($data); // set the options for the export plugin property item $exportPluginProperties->setOptions($exportSpecificOptions); return $exportPluginProperties; } /** * Generates output for SQL defintions of routines * * @param string $db Database name * @param string $type Item type to be used in XML output * @param string $dbitype Item type used in DBI queries * * @return string XML with definitions */ private function exportRoutinesDefinition($db, $type, $dbitype) { global $dbi; // Export routines $routines = $dbi->getProceduresOrFunctions($db, $dbitype); return $this->exportDefinitions($db, $type, $dbitype, $routines); } /** * Generates output for SQL defintions * * @param string $db Database name * @param string $type Item type to be used in XML output * @param string $dbitype Item type used in DBI queries * @param array $names Names of items to export * * @return string XML with definitions */ private function exportDefinitions($db, $type, $dbitype, array $names) { global $crlf, $dbi; $head = ''; if ($names) { foreach ($names as $name) { $head .= ' ' . $crlf; // Do some formatting $sql = $dbi->getDefinition($db, $dbitype, $name); $sql = htmlspecialchars(rtrim($sql)); $sql = str_replace("\n", "\n ", $sql); $head .= ' ' . $sql . $crlf; $head .= ' ' . $crlf; } } return $head; } /** * Outputs export header. It is the first method to be called, so all * the required variables are initialized here. */ public function exportHeader(): bool { $this->initSpecificVariables(); global $crlf, $cfg, $db, $dbi; $table = $this->getTable(); $tables = $this->getTables(); $export_struct = isset($GLOBALS['xml_export_functions']) || isset($GLOBALS['xml_export_procedures']) || isset($GLOBALS['xml_export_tables']) || isset($GLOBALS['xml_export_triggers']) || isset($GLOBALS['xml_export_views']); $export_data = isset($GLOBALS['xml_export_contents']); if ($GLOBALS['output_charset_conversion']) { $charset = $GLOBALS['charset']; } else { $charset = 'utf-8'; } $head = '' . $crlf . '' . $crlf . $crlf; $head .= '' . $crlf; if ($export_struct) { $result = $dbi->fetchResult( 'SELECT `DEFAULT_CHARACTER_SET_NAME`, `DEFAULT_COLLATION_NAME`' . ' FROM `information_schema`.`SCHEMATA` WHERE `SCHEMA_NAME`' . ' = \'' . $dbi->escapeString($db) . '\' LIMIT 1' ); $db_collation = $result[0]['DEFAULT_COLLATION_NAME']; $db_charset = $result[0]['DEFAULT_CHARACTER_SET_NAME']; $head .= ' ' . $crlf; $head .= ' ' . $crlf; $head .= ' ' . $crlf; if (count($tables) === 0) { $tables[] = $table; } foreach ($tables as $table) { // Export tables and views $result = $dbi->fetchResult( 'SHOW CREATE TABLE ' . Util::backquote($db) . '.' . Util::backquote($table), 0 ); $tbl = (string) $result[$table][1]; $is_view = $dbi->getTable($db, $table) ->isView(); if ($is_view) { $type = 'view'; } else { $type = 'table'; } if ($is_view && ! isset($GLOBALS['xml_export_views'])) { continue; } if (! $is_view && ! isset($GLOBALS['xml_export_tables'])) { continue; } $head .= ' ' . $crlf; $tbl = ' ' . htmlspecialchars($tbl); $tbl = str_replace("\n", "\n ", $tbl); $head .= $tbl . ';' . $crlf; $head .= ' ' . $crlf; if (! isset($GLOBALS['xml_export_triggers']) || ! $GLOBALS['xml_export_triggers']) { continue; } // Export triggers $triggers = $dbi->getTriggers($db, $table); if (! $triggers) { continue; } foreach ($triggers as $trigger) { $code = $trigger['create']; $head .= ' ' . $crlf; // Do some formatting $code = mb_substr(rtrim($code), 0, -3); $code = ' ' . htmlspecialchars($code); $code = str_replace("\n", "\n ", $code); $head .= $code . $crlf; $head .= ' ' . $crlf; } unset($trigger, $triggers); } if (isset($GLOBALS['xml_export_functions']) && $GLOBALS['xml_export_functions']) { $head .= $this->exportRoutinesDefinition($db, 'function', 'FUNCTION'); } if (isset($GLOBALS['xml_export_procedures']) && $GLOBALS['xml_export_procedures']) { $head .= $this->exportRoutinesDefinition($db, 'procedure', 'PROCEDURE'); } if (isset($GLOBALS['xml_export_events']) && $GLOBALS['xml_export_events']) { // Export events $events = $dbi->fetchResult( 'SELECT EVENT_NAME FROM information_schema.EVENTS ' . "WHERE EVENT_SCHEMA='" . $dbi->escapeString($db) . "'" ); $head .= $this->exportDefinitions($db, 'event', 'EVENT', $events); } unset($result); $head .= ' ' . $crlf; $head .= ' ' . $crlf; if ($export_data) { $head .= $crlf; } } return $this->export->outputHandler($head); } /** * Outputs export footer */ public function exportFooter(): bool { $foot = ''; return $this->export->outputHandler($foot); } /** * Outputs database header * * @param string $db Database name * @param string $dbAlias Aliases of db */ public function exportDBHeader($db, $dbAlias = ''): bool { global $crlf; if (empty($dbAlias)) { $dbAlias = $db; } if (isset($GLOBALS['xml_export_contents']) && $GLOBALS['xml_export_contents']) { $head = ' ' . $crlf . ' ' . $crlf; return $this->export->outputHandler($head); } return true; } /** * Outputs database footer * * @param string $db Database name */ public function exportDBFooter($db): bool { global $crlf; if (isset($GLOBALS['xml_export_contents']) && $GLOBALS['xml_export_contents']) { return $this->export->outputHandler(' ' . $crlf); } return true; } /** * Outputs CREATE DATABASE statement * * @param string $db Database name * @param string $exportType 'server', 'database', 'table' * @param string $dbAlias Aliases of db */ public function exportDBCreate($db, $exportType, $dbAlias = ''): bool { return true; } /** * Outputs the content of a table in XML format * * @param string $db database name * @param string $table table name * @param string $crlf the end of line sequence * @param string $errorUrl the url to go back in case of error * @param string $sqlQuery SQL query for obtaining data * @param array $aliases Aliases of db/table/columns */ public function exportData( $db, $table, $crlf, $errorUrl, $sqlQuery, array $aliases = [] ): bool { global $dbi; // Do not export data for merge tables if ($dbi->getTable($db, $table)->isMerge()) { return true; } $db_alias = $db; $table_alias = $table; $this->initAlias($aliases, $db_alias, $table_alias); if (isset($GLOBALS['xml_export_contents']) && $GLOBALS['xml_export_contents']) { $result = $dbi->query($sqlQuery, DatabaseInterface::CONNECT_USER, DatabaseInterface::QUERY_UNBUFFERED); $columns_cnt = $result->numFields(); $columns = []; foreach ($result->getFieldNames() as $column) { $columns[] = stripslashes($column); } $buffer = ' ' . $crlf; if (! $this->export->outputHandler($buffer)) { return false; } while ($record = $result->fetchRow()) { $buffer = ' ' . $crlf; for ($i = 0; $i < $columns_cnt; $i++) { $col_as = $columns[$i]; if (! empty($aliases[$db]['tables'][$table]['columns'][$col_as])) { $col_as = $aliases[$db]['tables'][$table]['columns'][$col_as]; } // If a cell is NULL, still export it to preserve // the XML structure if (! isset($record[$i])) { $record[$i] = 'NULL'; } $buffer .= ' ' . htmlspecialchars((string) $record[$i]) . '' . $crlf; } $buffer .= '
' . $crlf; if (! $this->export->outputHandler($buffer)) { return false; } } } return true; } /* ~~~~~~~~~~~~~~~~~~~~ Getters and Setters ~~~~~~~~~~~~~~~~~~~~ */ /** * Gets the table name * * @return string */ private function getTable() { return $this->table; } /** * Sets the table name * * @param string $table table name */ private function setTable($table): void { $this->table = $table; } /** * Gets the table names * * @return array */ private function getTables() { return $this->tables; } /** * Sets the table names * * @param array $tables table names */ private function setTables(array $tables): void { $this->tables = $tables; } public function isAvailable(): bool { global $db; // Can't do server export. return isset($db) && strlen($db) > 0; } }