/
usr
/
share
/
phpmyadmin
/
libraries
/
classes
/
/usr/share/phpmyadmin/libraries/classes
mkdir
upload
Name
Size
Mode
Actions
Charsets/
-
0755
rm
Command/
-
0755
rm
Config/
-
0755
rm
Controllers/
-
0755
rm
Database/
-
0755
rm
Dbal/
-
0755
rm
Display/
-
0755
rm
Engines/
-
0755
rm
Exceptions/
-
0755
rm
Export/
-
0755
rm
Gis/
-
0755
rm
Html/
-
0755
rm
Import/
-
0755
rm
Navigation/
-
0755
rm
Plugins/
-
0755
rm
Properties/
-
0755
rm
Providers/
-
0755
rm
Query/
-
0755
rm
Server/
-
0755
rm
Setup/
-
0755
rm
Table/
-
0755
rm
Twig/
-
0755
rm
Utils/
-
0755
rm
Advisor.php
12517
0644
edit
dl
rm
Bookmark.php
10944
0644
edit
dl
rm
BrowseForeigners.php
11083
0644
edit
dl
rm
Charsets.php
7267
0644
edit
dl
rm
CheckUserPrivileges.php
12230
0644
edit
dl
rm
Config.php
46456
0644
edit
dl
rm
Console.php
3460
0644
edit
dl
rm
Core.php
43344
0644
edit
dl
rm
CreateAddField.php
17993
0644
edit
dl
rm
DatabaseInterface.php
76802
0644
edit
dl
rm
DbTableExists.php
3287
0644
edit
dl
rm
Encoding.php
8715
0644
edit
dl
rm
Error.php
14304
0644
edit
dl
rm
ErrorHandler.php
17557
0644
edit
dl
rm
ErrorReport.php
9364
0644
edit
dl
rm
Export.php
47351
0644
edit
dl
rm
File.php
21786
0644
edit
dl
rm
FileListing.php
2923
0644
edit
dl
rm
Font.php
5718
0644
edit
dl
rm
Footer.php
10794
0644
edit
dl
rm
Git.php
18381
0644
edit
dl
rm
Header.php
21967
0644
edit
dl
rm
Import.php
58840
0644
edit
dl
rm
Index.php
15428
0644
edit
dl
rm
IndexColumn.php
4331
0644
edit
dl
rm
InsertEdit.php
133309
0644
edit
dl
rm
InternalRelations.php
17730
0644
edit
dl
rm
IpAllowDeny.php
9997
0644
edit
dl
rm
Language.php
4568
0644
edit
dl
rm
LanguageManager.php
24532
0644
edit
dl
rm
Linter.php
5374
0644
edit
dl
rm
ListAbstract.php
1814
0644
edit
dl
rm
ListDatabase.php
4402
0644
edit
dl
rm
Logging.php
2781
0644
edit
dl
rm
Menu.php
21812
0644
edit
dl
rm
Message.php
19547
0644
edit
dl
rm
Mime.php
916
0644
edit
dl
rm
Normalization.php
42475
0644
edit
dl
rm
OpenDocument.php
8617
0644
edit
dl
rm
Operations.php
38748
0644
edit
dl
rm
OutputBuffering.php
4074
0644
edit
dl
rm
ParseAnalyze.php
2429
0644
edit
dl
rm
Partition.php
7340
0644
edit
dl
rm
Pdf.php
4449
0644
edit
dl
rm
Plugins.php
25783
0644
edit
dl
rm
Profiling.php
2317
0644
edit
dl
rm
RecentFavoriteTable.php
12297
0644
edit
dl
rm
Relation.php
79247
0644
edit
dl
rm
RelationCleanup.php
15051
0644
edit
dl
rm
Replication.php
4843
0644
edit
dl
rm
ReplicationGui.php
22038
0644
edit
dl
rm
ReplicationInfo.php
4943
0644
edit
dl
rm
Response.php
16864
0644
edit
dl
rm
Routing.php
5845
0644
edit
dl
rm
Sanitize.php
12418
0644
edit
dl
rm
SavedSearches.php
12221
0644
edit
dl
rm
Scripts.php
3726
0644
edit
dl
rm
Session.php
8198
0644
edit
dl
rm
Sql.php
68272
0644
edit
dl
rm
SqlQueryForm.php
7286
0644
edit
dl
rm
StorageEngine.php
12828
0644
edit
dl
rm
SubPartition.php
3398
0644
edit
dl
rm
SystemDatabase.php
3748
0644
edit
dl
rm
Table.php
97961
0644
edit
dl
rm
TablePartitionDefinition.php
6664
0644
edit
dl
rm
Template.php
3962
0644
edit
dl
rm
Theme.php
8969
0644
edit
dl
rm
ThemeManager.php
9815
0644
edit
dl
rm
Tracker.php
30497
0644
edit
dl
rm
Tracking.php
38141
0644
edit
dl
rm
Transformations.php
16685
0644
edit
dl
rm
TwoFactor.php
6968
0644
edit
dl
rm
Types.php
25805
0644
edit
dl
rm
Url.php
8973
0644
edit
dl
rm
UserPassword.php
7284
0644
edit
dl
rm
UserPreferences.php
8657
0644
edit
dl
rm
Util.php
104768
0644
edit
dl
rm
Version.php
533
0644
edit
dl
rm
VersionInformation.php
7319
0644
edit
dl
rm
ZipExtension.php
11017
0644
edit
dl
rm
Edit:
/usr/share/phpmyadmin/libraries/classes/Normalization.php
(42475B)
<?php declare(strict_types=1); namespace PhpMyAdmin; use PhpMyAdmin\Charsets\Charset; use PhpMyAdmin\Charsets\Collation; use PhpMyAdmin\Html\Generator; use function array_merge; use function array_pop; use function array_unique; use function count; use function explode; use function htmlspecialchars; use function implode; use function in_array; use function intval; use function is_array; use function json_encode; use function mb_strtoupper; use function sort; use function sprintf; use function str_replace; use function trim; /** * Set of functions used for normalization */ class Normalization { /** * DatabaseInterface instance * * @var DatabaseInterface */ private $dbi; /** @var Relation */ private $relation; /** @var Transformations */ private $transformations; /** @var Template */ public $template; /** * @param DatabaseInterface $dbi DatabaseInterface instance * @param Relation $relation Relation instance * @param Transformations $transformations Transformations instance * @param Template $template Template instance */ public function __construct( DatabaseInterface $dbi, Relation $relation, Transformations $transformations, Template $template ) { $this->dbi = $dbi; $this->relation = $relation; $this->transformations = $transformations; $this->template = $template; } /** * build the html for columns of $colTypeCategory category * in form of given $listType in a table * * @param string $db current database * @param string $table current table * @param string $colTypeCategory supported all|Numeric|String|Spatial * |Date and time using the _pgettext() format * @param string $listType type of list to build, supported dropdown|checkbox * * @return string HTML for list of columns in form of given list types */ public function getHtmlForColumnsList( $db, $table, $colTypeCategory = 'all', $listType = 'dropdown' ) { $columnTypeList = []; if ($colTypeCategory !== 'all') { $types = $this->dbi->types->getColumns(); $columnTypeList = $types[$colTypeCategory]; if (! is_array($columnTypeList)) { $columnTypeList = []; } } $this->dbi->selectDb($db); $columns = $this->dbi->getColumns( $db, $table, null, true ); $type = ''; $selectColHtml = ''; foreach ($columns as $column => $def) { if (isset($def['Type'])) { $extractedColumnSpec = Util::extractColumnSpec($def['Type']); $type = $extractedColumnSpec['type']; } if (! empty($columnTypeList) && ! in_array(mb_strtoupper($type), $columnTypeList) ) { continue; } if ($listType === 'checkbox') { $selectColHtml .= '<input type="checkbox" value="' . htmlspecialchars($column) . '">' . htmlspecialchars($column) . ' [ ' . htmlspecialchars($def['Type']) . ' ]<br>'; } else { $selectColHtml .= '<option value="' . htmlspecialchars($column) . '' . '">' . htmlspecialchars($column) . ' [ ' . htmlspecialchars($def['Type']) . ' ]' . '</option>'; } } return $selectColHtml; } /** * get the html of the form to add the new column to given table * * @param int $numFields number of columns to add * @param string $db current database * @param string $table current table * @param array $columnMeta array containing default values for the fields * * @return string HTML */ public function getHtmlForCreateNewColumn( $numFields, $db, $table, array $columnMeta = [] ) { $cfgRelation = $this->relation->getRelationsParam(); $contentCells = []; $availableMime = []; $mimeMap = []; if ($cfgRelation['mimework'] && $GLOBALS['cfg']['BrowseMIME']) { $mimeMap = $this->transformations->getMime($db, $table); $availableMimeTypes = $this->transformations->getAvailableMimeTypes(); if ($availableMimeTypes !== null) { $availableMime = $availableMimeTypes; } } $commentsMap = $this->relation->getComments($db, $table); for ($columnNumber = 0; $columnNumber < $numFields; $columnNumber++) { $contentCells[$columnNumber] = [ 'column_number' => $columnNumber, 'column_meta' => $columnMeta, 'type_upper' => '', 'length_values_input_size' => 8, 'length' => '', 'extracted_columnspec' => [], 'submit_attribute' => null, 'comments_map' => $commentsMap, 'fields_meta' => null, 'is_backup' => true, 'move_columns' => [], 'cfg_relation' => $cfgRelation, 'available_mime' => $availableMime, 'mime_map' => $mimeMap, ]; } $charsets = Charsets::getCharsets($this->dbi, $GLOBALS['cfg']['Server']['DisableIS']); $collations = Charsets::getCollations($this->dbi, $GLOBALS['cfg']['Server']['DisableIS']); $charsetsList = []; /** @var Charset $charset */ foreach ($charsets as $charset) { $collationsList = []; /** @var Collation $collation */ foreach ($collations[$charset->getName()] as $collation) { $collationsList[] = [ 'name' => $collation->getName(), 'description' => $collation->getDescription(), ]; } $charsetsList[] = [ 'name' => $charset->getName(), 'description' => $charset->getDescription(), 'collations' => $collationsList, ]; } return $this->template->render('columns_definitions/table_fields_definitions', [ 'is_backup' => true, 'fields_meta' => null, 'mimework' => $cfgRelation['mimework'], 'content_cells' => $contentCells, 'change_column' => $_POST['change_column'] ?? $_GET['change_column'] ?? null, 'is_virtual_columns_supported' => Util::isVirtualColumnsSupported(), 'browse_mime' => $GLOBALS['cfg']['BrowseMIME'], 'server_type' => Util::getServerType(), 'server_version' => $this->dbi->getVersion(), 'max_rows' => intval($GLOBALS['cfg']['MaxRows']), 'char_editing' => $GLOBALS['cfg']['CharEditing'], 'attribute_types' => $this->dbi->types->getAttributes(), 'privs_available' => $GLOBALS['col_priv'] && $GLOBALS['is_reload_priv'], 'max_length' => $this->dbi->getVersion() >= 50503 ? 1024 : 255, 'charsets' => $charsetsList, ]); } /** * build the html for step 1.1 of normalization * * @param string $db current database * @param string $table current table * @param string $normalizedTo up to which step normalization will go, * possible values 1nf|2nf|3nf * * @return string HTML for step 1.1 */ public function getHtmlFor1NFStep1($db, $table, $normalizedTo) { $step = 1; $stepTxt = __('Make all columns atomic'); $html = "<h3 class='text-center'>" . __('First step of normalization (1NF)') . '</h3>'; $html .= "<div id='mainContent' data-normalizeto='" . $normalizedTo . "'>" . '<fieldset>' . '<legend>' . __('Step 1.') . $step . ' ' . $stepTxt . '</legend>' . '<h4>' . __( 'Do you have any column which can be split into more than' . ' one column? ' . 'For example: address can be split into street, city, country and zip.' ) . "<br>(<a class='central_columns_dialog' data-maxrows='25' " . "data-pick=false href='#'> " . __( 'Show me the central list of columns that are not already in this table' ) . ' </a>)</h4>' . "<p class='cm-em'>" . __( 'Select a column which can be split into more ' . 'than one (on select of \'no such column\', it\'ll move to next step).' ) . '</p>' . "<div id='extra'>" . "<select id='selectNonAtomicCol' name='makeAtomic'>" . '<option selected="selected" disabled="disabled">' . __('Select one…') . '</option>' . "<option value='no_such_col'>" . __('No such column') . '</option>' . $this->getHtmlForColumnsList( $db, $table, _pgettext('string types', 'String') ) . '</select>' . '<span>' . __('split into ') . "</span><input id='numField' type='number' value='2'>" . '<input type="submit" class="btn btn-primary" id="splitGo" value="' . __('Go') . '"></div>' . "<div id='newCols'></div>" . "</fieldset><fieldset class='tblFooters'>" . '</fieldset>' . '</div>'; return $html; } /** * build the html contents of various html elements in step 1.2 * * @param string $db current database * @param string $table current table * * @return string[] HTML contents for step 1.2 */ public function getHtmlContentsFor1NFStep2($db, $table) { $step = 2; $stepTxt = __('Have a primary key'); $primary = Index::getPrimary($table, $db); $hasPrimaryKey = '0'; $legendText = __('Step 1.') . $step . ' ' . $stepTxt; $extra = ''; if ($primary !== false) { $headText = __('Primary key already exists.'); $subText = __('Taking you to next step…'); $hasPrimaryKey = '1'; } else { $headText = __( 'There is no primary key; please add one.<br>' . 'Hint: A primary key is a column ' . '(or combination of columns) that uniquely identify all rows.' ); $subText = '<a href="#" id="createPrimaryKey">' . Generator::getIcon( 'b_index_add', __( 'Add a primary key on existing column(s)' ) ) . '</a>'; $extra = __( "If it's not possible to make existing " . 'column combinations as primary key' ) . '<br>' . '<a href="#" id="addNewPrimary">' . __('+ Add a new primary key column') . '</a>'; } return [ 'legendText' => $legendText, 'headText' => $headText, 'subText' => $subText, 'hasPrimaryKey' => $hasPrimaryKey, 'extra' => $extra, ]; } /** * build the html contents of various html elements in step 1.4 * * @param string $db current database * @param string $table current table * * @return string[] HTML contents for step 1.4 */ public function getHtmlContentsFor1NFStep4($db, $table) { $step = 4; $stepTxt = __('Remove redundant columns'); $legendText = __('Step 1.') . $step . ' ' . $stepTxt; $headText = __( 'Do you have a group of columns which on combining gives an existing' . ' column? For example, if you have first_name, last_name and' . ' full_name then combining first_name and last_name gives full_name' . ' which is redundant.' ); $subText = __( 'Check the columns which are redundant and click on remove. ' . "If no redundant column, click on 'No redundant column'" ); $extra = $this->getHtmlForColumnsList($db, $table, 'all', 'checkbox') . '<br>' . '<input class="btn btn-secondary" type="submit" id="removeRedundant" value="' . __('Remove selected') . '">' . '<input class="btn btn-secondary" type="submit" value="' . __('No redundant column') . '" onclick="goToFinish1NF();">'; return [ 'legendText' => $legendText, 'headText' => $headText, 'subText' => $subText, 'extra' => $extra, ]; } /** * build the html contents of various html elements in step 1.3 * * @param string $db current database * @param string $table current table * * @return string[] HTML contents for step 1.3 */ public function getHtmlContentsFor1NFStep3($db, $table) { $step = 3; $stepTxt = __('Move repeating groups'); $legendText = __('Step 1.') . $step . ' ' . $stepTxt; $headText = __( 'Do you have a group of two or more columns that are closely ' . 'related and are all repeating the same attribute? For example, ' . 'a table that holds data on books might have columns such as book_id, ' . 'author1, author2, author3 and so on which form a ' . 'repeating group. In this case a new table (book_id, author) should ' . 'be created.' ); $subText = __( 'Check the columns which form a repeating group. ' . "If no such group, click on 'No repeating group'" ); $extra = $this->getHtmlForColumnsList($db, $table, 'all', 'checkbox') . '<br>' . '<input class="btn btn-secondary" type="submit" id="moveRepeatingGroup" value="' . __('Done') . '">' . '<input class="btn btn-secondary" type="submit" value="' . __('No repeating group') . '" onclick="goToStep4();">'; $primary = Index::getPrimary($table, $db); $primarycols = $primary === false ? [] : $primary->getColumns(); $pk = []; foreach ($primarycols as $col) { $pk[] = $col->getName(); } return [ 'legendText' => $legendText, 'headText' => $headText, 'subText' => $subText, 'extra' => $extra, 'primary_key' => json_encode($pk), ]; } /** * build html contents for 2NF step 2.1 * * @param string $db current database * @param string $table current table * * @return string[] HTML contents for 2NF step 2.1 */ public function getHtmlFor2NFstep1($db, $table) { $legendText = __('Step 2.') . '1 ' . __('Find partial dependencies'); $primary = Index::getPrimary($table, $db); $primarycols = $primary === false ? [] : $primary->getColumns(); $pk = []; $subText = ''; $selectPkForm = ''; $extra = ''; foreach ($primarycols as $col) { $pk[] = $col->getName(); $selectPkForm .= '<input type="checkbox" name="pd" value="' . htmlspecialchars($col->getName()) . '">' . htmlspecialchars($col->getName()); } $key = implode(', ', $pk); if (count($primarycols) > 1) { $this->dbi->selectDb($db); $columns = (array) $this->dbi->getColumnNames( $db, $table ); if (count($pk) == count($columns)) { $headText = sprintf( __( 'No partial dependencies possible as ' . 'no non-primary column exists since primary key ( %1$s ) ' . 'is composed of all the columns in the table.' ), htmlspecialchars($key) ) . '<br>'; $extra = '<h3>' . __('Table is already in second normal form.') . '</h3>'; } else { $headText = sprintf( __( 'The primary key ( %1$s ) consists of more than one column ' . 'so we need to find the partial dependencies.' ), htmlspecialchars($key) ) . '<br>' . __( 'Please answer the following question(s) ' . 'carefully to obtain a correct normalization.' ) . '<br><a href="#" id="showPossiblePd">' . __( '+ Show me the possible partial dependencies ' . 'based on data in the table' ) . '</a>'; $subText = __( 'For each column below, ' . 'please select the <b>minimal set</b> of columns among given set ' . 'whose values combined together are sufficient' . ' to determine the value of the column.' ); $cnt = 0; foreach ($columns as $column) { if (in_array($column, $pk)) { continue; } $cnt++; $extra .= '<b>' . sprintf( __('\'%1$s\' depends on:'), htmlspecialchars($column) ) . '</b><br>'; $extra .= '<form id="pk_' . $cnt . '" data-colname="' . htmlspecialchars($column) . '" class="smallIndent">' . $selectPkForm . '</form><br><br>'; } } } else { $headText = sprintf( __( 'No partial dependencies possible as the primary key' . ' ( %1$s ) has just one column.' ), htmlspecialchars($key) ) . '<br>'; $extra = '<h3>' . __('Table is already in second normal form.') . '</h3>'; } return [ 'legendText' => $legendText, 'headText' => $headText, 'subText' => $subText, 'extra' => $extra, 'primary_key' => $key, ]; } /** * build the html for showing the tables to have in order to put current table in 2NF * * @param array $partialDependencies array containing all the dependencies * @param string $table current table * * @return string HTML */ public function getHtmlForNewTables2NF(array $partialDependencies, $table) { $html = '<p><b>' . sprintf( __( 'In order to put the ' . 'original table \'%1$s\' into Second normal form we need ' . 'to create the following tables:' ), htmlspecialchars($table) ) . '</b></p>'; $tableName = $table; $i = 1; foreach ($partialDependencies as $key => $dependents) { $html .= '<p><input type="text" name="' . htmlspecialchars($key) . '" value="' . htmlspecialchars($tableName) . '">' . '( <u>' . htmlspecialchars($key) . '</u>' . (count($dependents) > 0 ? ', ' : '') . htmlspecialchars(implode(', ', $dependents)) . ' )'; $i++; $tableName = 'table' . $i; } return $html; } /** * create/alter the tables needed for 2NF * * @param array $partialDependencies array containing all the partial dependencies * @param object $tablesName name of new tables * @param string $table current table * @param string $db current database * * @return array */ public function createNewTablesFor2NF(array $partialDependencies, $tablesName, $table, $db) { $dropCols = false; $nonPKCols = []; $queries = []; $error = false; $headText = '<h3>' . sprintf( __('The second step of normalization is complete for table \'%1$s\'.'), htmlspecialchars($table) ) . '</h3>'; if (count((array) $partialDependencies) === 1) { return [ 'legendText' => __('End of step'), 'headText' => $headText, 'queryError' => $error, ]; } $message = ''; $this->dbi->selectDb($db); foreach ($partialDependencies as $key => $dependents) { if ($tablesName->$key != $table) { $backquotedKey = implode(', ', Util::backquote(explode(', ', $key))); $queries[] = 'CREATE TABLE ' . Util::backquote($tablesName->$key) . ' SELECT DISTINCT ' . $backquotedKey . (count($dependents) > 0 ? ', ' : '') . implode(',', Util::backquote($dependents)) . ' FROM ' . Util::backquote($table) . ';'; $queries[] = 'ALTER TABLE ' . Util::backquote($tablesName->$key) . ' ADD PRIMARY KEY(' . $backquotedKey . ');'; $nonPKCols = array_merge($nonPKCols, $dependents); } else { $dropCols = true; } } if ($dropCols) { $query = 'ALTER TABLE ' . Util::backquote($table); foreach ($nonPKCols as $col) { $query .= ' DROP ' . Util::backquote($col) . ','; } $query = trim($query, ', '); $query .= ';'; $queries[] = $query; } else { $queries[] = 'DROP TABLE ' . Util::backquote($table); } foreach ($queries as $query) { if (! $this->dbi->tryQuery($query)) { $message = Message::error(__('Error in processing!')); $message->addMessage( Message::rawError( (string) $this->dbi->getError() ), '<br><br>' ); $error = true; break; } } return [ 'legendText' => __('End of step'), 'headText' => $headText, 'queryError' => $error, 'extra' => $message, ]; } /** * build the html for showing the new tables to have in order * to put given tables in 3NF * * @param object $dependencies containing all the dependencies * @param array $tables tables formed after 2NF and need to convert to 3NF * @param string $db current database * * @return array containing html and the list of new tables */ public function getHtmlForNewTables3NF($dependencies, array $tables, $db) { $html = ''; $i = 1; $newTables = []; foreach ($tables as $table => $arrDependson) { if (count(array_unique($arrDependson)) === 1) { continue; } $primary = Index::getPrimary($table, $db); $primarycols = $primary === false ? [] : $primary->getColumns(); $pk = []; foreach ($primarycols as $col) { $pk[] = $col->getName(); } $html .= '<p><b>' . sprintf( __( 'In order to put the ' . 'original table \'%1$s\' into Third normal form we need ' . 'to create the following tables:' ), htmlspecialchars($table) ) . '</b></p>'; $tableName = $table; $columnList = []; foreach ($arrDependson as $key) { $dependents = $dependencies->$key; if ($key == $table) { $key = implode(', ', $pk); } $tmpTableCols = array_merge(explode(', ', $key), $dependents); sort($tmpTableCols); if (in_array($tmpTableCols, $columnList)) { continue; } $columnList[] = $tmpTableCols; $html .= '<p><input type="text" name="' . htmlspecialchars($tableName) . '" value="' . htmlspecialchars($tableName) . '">' . '( <u>' . htmlspecialchars($key) . '</u>' . (count($dependents) > 0 ? ', ' : '') . htmlspecialchars(implode(', ', $dependents)) . ' )'; $newTables[$table][$tableName] = [ 'pk' => $key, 'nonpk' => implode(', ', $dependents), ]; $i++; $tableName = 'table' . $i; } } return [ 'html' => $html, 'newTables' => $newTables, 'success' => true, ]; } /** * create new tables or alter existing to get 3NF * * @param array $newTables list of new tables to be created * @param string $db current database * * @return array */ public function createNewTablesFor3NF(array $newTables, $db) { $queries = []; $dropCols = false; $error = false; $headText = '<h3>' . __('The third step of normalization is complete.') . '</h3>'; if (count($newTables) === 0) { return [ 'legendText' => __('End of step'), 'headText' => $headText, 'queryError' => $error, ]; } $message = ''; $this->dbi->selectDb($db); foreach ($newTables as $originalTable => $tablesList) { foreach ($tablesList as $table => $cols) { if ($table != $originalTable) { $quotedPk = implode( ', ', Util::backquote(explode(', ', $cols['pk'])) ); $quotedNonpk = implode( ', ', Util::backquote(explode(', ', $cols['nonpk'])) ); $queries[] = 'CREATE TABLE ' . Util::backquote($table) . ' SELECT DISTINCT ' . $quotedPk . ', ' . $quotedNonpk . ' FROM ' . Util::backquote($originalTable) . ';'; $queries[] = 'ALTER TABLE ' . Util::backquote($table) . ' ADD PRIMARY KEY(' . $quotedPk . ');'; } else { $dropCols = $cols; } } if ($dropCols) { $columns = (array) $this->dbi->getColumnNames( $db, $originalTable ); $colPresent = array_merge( explode(', ', $dropCols['pk']), explode(', ', $dropCols['nonpk']) ); $query = 'ALTER TABLE ' . Util::backquote($originalTable); foreach ($columns as $col) { if (in_array($col, $colPresent)) { continue; } $query .= ' DROP ' . Util::backquote($col) . ','; } $query = trim($query, ', '); $query .= ';'; $queries[] = $query; } else { $queries[] = 'DROP TABLE ' . Util::backquote($originalTable); } $dropCols = false; } foreach ($queries as $query) { if (! $this->dbi->tryQuery($query)) { $message = Message::error(__('Error in processing!')); $message->addMessage( Message::rawError( (string) $this->dbi->getError() ), '<br><br>' ); $error = true; break; } } return [ 'legendText' => __('End of step'), 'headText' => $headText, 'queryError' => $error, 'extra' => $message, ]; } /** * move the repeating group of columns to a new table * * @param string $repeatingColumns comma separated list of repeating group columns * @param string $primaryColumns comma separated list of column in primary key * of $table * @param string $newTable name of the new table to be created * @param string $newColumn name of the new column in the new table * @param string $table current table * @param string $db current database * * @return array */ public function moveRepeatingGroup( $repeatingColumns, $primaryColumns, $newTable, $newColumn, $table, $db ) { $repeatingColumnsArr = (array) Util::backquote( explode(', ', $repeatingColumns) ); $primaryColumns = implode( ',', Util::backquote(explode(',', $primaryColumns)) ); $query1 = 'CREATE TABLE ' . Util::backquote($newTable); $query2 = 'ALTER TABLE ' . Util::backquote($table); $message = Message::success( sprintf( __('Selected repeating group has been moved to the table \'%s\''), htmlspecialchars($table) ) ); $first = true; $error = false; foreach ($repeatingColumnsArr as $repeatingColumn) { if (! $first) { $query1 .= ' UNION '; } $first = false; $query1 .= ' SELECT ' . $primaryColumns . ',' . $repeatingColumn . ' as ' . Util::backquote($newColumn) . ' FROM ' . Util::backquote($table); $query2 .= ' DROP ' . $repeatingColumn . ','; } $query2 = trim($query2, ','); $queries = [ $query1, $query2, ]; $this->dbi->selectDb($db); foreach ($queries as $query) { if (! $this->dbi->tryQuery($query)) { $message = Message::error(__('Error in processing!')); $message->addMessage( Message::rawError( (string) $this->dbi->getError() ), '<br><br>' ); $error = true; break; } } return [ 'queryError' => $error, 'message' => $message, ]; } /** * build html for 3NF step 1 to find the transitive dependencies * * @param string $db current database * @param array $tables tables formed after 2NF and need to process for 3NF * * @return string[] */ public function getHtmlFor3NFstep1($db, array $tables) { $legendText = __('Step 3.') . '1 ' . __('Find transitive dependencies'); $extra = ''; $headText = __( 'Please answer the following question(s) ' . 'carefully to obtain a correct normalization.' ); $subText = __( 'For each column below, ' . 'please select the <b>minimal set</b> of columns among given set ' . 'whose values combined together are sufficient' . ' to determine the value of the column.<br>' . 'Note: A column may have no transitive dependency, ' . 'in that case you don\'t have to select any.' ); $cnt = 0; foreach ($tables as $table) { $primary = Index::getPrimary($table, $db); $primarycols = $primary === false ? [] : $primary->getColumns(); $selectTdForm = ''; $pk = []; foreach ($primarycols as $col) { $pk[] = $col->getName(); } $this->dbi->selectDb($db); $columns = (array) $this->dbi->getColumnNames( $db, $table ); if (count($columns) - count($pk) <= 1) { continue; } foreach ($columns as $column) { if (in_array($column, $pk)) { continue; } $selectTdForm .= '<input type="checkbox" name="pd" value="' . htmlspecialchars($column) . '">' . '<span>' . htmlspecialchars($column) . '</span>'; } foreach ($columns as $column) { if (in_array($column, $pk)) { continue; } $cnt++; $extra .= '<b>' . sprintf( __('\'%1$s\' depends on:'), htmlspecialchars($column) ) . '</b><br>'; $extra .= '<form id="td_' . $cnt . '" data-colname="' . htmlspecialchars($column) . '" data-tablename="' . htmlspecialchars($table) . '" class="smallIndent">' . $selectTdForm . '</form><br><br>'; } } if ($extra == '') { $headText = __( 'No Transitive dependencies possible as the table ' . "doesn't have any non primary key columns" ); $subText = ''; $extra = '<h3>' . __('Table is already in Third normal form!') . '</h3>'; } return [ 'legendText' => $legendText, 'headText' => $headText, 'subText' => $subText, 'extra' => $extra, ]; } /** * get html for options to normalize table * * @return string HTML */ public function getHtmlForNormalizeTable() { $htmlOutput = '<form method="post" action="' . Url::getFromRoute('/normalization') . '" name="normalize" ' . 'id="normalizeTable" ' . '>' . Url::getHiddenInputs($GLOBALS['db'], $GLOBALS['table']) . '<input type="hidden" name="step1" value="1">'; $htmlOutput .= '<fieldset>'; $htmlOutput .= '<legend>' . __('Improve table structure (Normalization):') . '</legend>'; $htmlOutput .= '<h3>' . __('Select up to what step you want to normalize') . '</h3>'; $htmlOutput .= '<div><input type="radio" name="normalizeTo" id="normalizeToRadio1" value="1nf" checked>'; $htmlOutput .= ' <label for="normalizeToRadio1">'; $htmlOutput .= __('First step of normalization (1NF)'); $htmlOutput .= '</label></div>'; $htmlOutput .= '<div><input type="radio" name="normalizeTo" id="normalizeToRadio2" value="2nf">'; $htmlOutput .= ' <label for="normalizeToRadio2">'; $htmlOutput .= __('Second step of normalization (1NF+2NF)'); $htmlOutput .= '</label></div>'; $htmlOutput .= '<div><input type="radio" name="normalizeTo" id="normalizeToRadio3" value="3nf">'; $htmlOutput .= ' <label for="normalizeToRadio3">'; $htmlOutput .= __('Third step of normalization (1NF+2NF+3NF)'); $htmlOutput .= '</label></div>'; $htmlOutput .= '</fieldset><fieldset class="tblFooters">' . "<span class='floatleft'>" . __( 'Hint: Please follow the procedure carefully in order ' . 'to obtain correct normalization' ) . '</span>' . '<input class="btn btn-primary" type="submit" name="submit_normalize" value="' . __('Go') . '">' . '</fieldset>' . '</form>' . '</div>'; return $htmlOutput; } /** * find all the possible partial dependencies based on data in the table. * * @param string $table current table * @param string $db current database * * @return string HTML containing the list of all the possible partial dependencies */ public function findPartialDependencies($table, $db) { $dependencyList = []; $this->dbi->selectDb($db); $columns = (array) $this->dbi->getColumnNames( $db, $table ); $columns = (array) Util::backquote($columns); $totalRowsRes = $this->dbi->fetchResult( 'SELECT COUNT(*) FROM (SELECT * FROM ' . Util::backquote($table) . ' LIMIT 500) as dt;' ); $totalRows = $totalRowsRes[0]; $primary = Index::getPrimary($table, $db); $primarycols = $primary === false ? [] : $primary->getColumns(); $pk = []; foreach ($primarycols as $col) { $pk[] = Util::backquote($col->getName()); } $partialKeys = $this->getAllCombinationPartialKeys($pk); $distinctValCount = $this->findDistinctValuesCount( array_unique( array_merge($columns, $partialKeys) ), $table ); foreach ($columns as $column) { if (in_array($column, $pk)) { continue; } foreach ($partialKeys as $partialKey) { if (! $partialKey || ! $this->checkPartialDependency( $partialKey, $column, $table, $distinctValCount[$partialKey], $distinctValCount[$column], $totalRows ) ) { continue; } $dependencyList[$partialKey][] = $column; } } $html = __( 'This list is based on a subset of the table\'s data ' . 'and is not necessarily accurate. ' ) . '<div class="dependencies_box">'; foreach ($dependencyList as $dependon => $colList) { $html .= '<span class="displayblock">' . '<input type="button" class="btn btn-secondary pickPd" value="' . __('Pick') . '">' . '<span class="determinants">' . htmlspecialchars(str_replace('`', '', (string) $dependon)) . '</span> -> ' . '<span class="dependents">' . htmlspecialchars(str_replace('`', '', implode(', ', $colList))) . '</span>' . '</span>'; } if (empty($dependencyList)) { $html .= '<p class="displayblock desc">' . __('No partial dependencies found!') . '</p>'; } $html .= '</div>'; return $html; } /** * check whether a particular column is dependent on given subset of primary key * * @param string $partialKey the partial key, subset of primary key, * each column in key supposed to be backquoted * @param string $column backquoted column on whose dependency being checked * @param string $table current table * @param int $pkCnt distinct value count for given partial key * @param int $colCnt distinct value count for given column * @param int $totalRows total distinct rows count of the table * * @return bool TRUE if $column is dependent on $partialKey, False otherwise */ private function checkPartialDependency( $partialKey, $column, $table, $pkCnt, $colCnt, $totalRows ) { $query = 'SELECT ' . 'COUNT(DISTINCT ' . $partialKey . ',' . $column . ') as pkColCnt ' . 'FROM (SELECT * FROM ' . Util::backquote($table) . ' LIMIT 500) as dt;'; $res = $this->dbi->fetchResult($query, null, null); $pkColCnt = $res[0]; if ($pkCnt && $pkCnt == $colCnt && $colCnt == $pkColCnt) { return true; } return $totalRows && $totalRows == $pkCnt; } /** * function to get distinct values count of all the column in the array $columns * * @param array $columns array of backquoted columns whose distinct values * need to be counted. * @param string $table table to which these columns belong * * @return array associative array containing the count */ private function findDistinctValuesCount(array $columns, $table) { $result = []; $query = 'SELECT '; foreach ($columns as $column) { if (! $column) { continue; } //each column is already backquoted $query .= 'COUNT(DISTINCT ' . $column . ') as \'' . $column . '_cnt\', '; } $query = trim($query, ', '); $query .= ' FROM (SELECT * FROM ' . Util::backquote($table) . ' LIMIT 500) as dt;'; $res = $this->dbi->fetchResult($query, null, null); foreach ($columns as $column) { if (! $column) { continue; } $result[$column] = $res[0][$column . '_cnt'] ?? null; } return $result; } /** * find all the possible partial keys * * @param array $primaryKey array containing all the column present in primary key * * @return array containing all the possible partial keys(subset of primary key) */ private function getAllCombinationPartialKeys(array $primaryKey) { $results = ['']; foreach ($primaryKey as $element) { foreach ($results as $combination) { $results[] = trim($element . ',' . $combination, ','); } } array_pop($results); //remove key which consist of all primary key columns return $results; } }
Save
cmd:
run