Viewing file: relation.lib.php (53.89 KB) -rw-rw-rw- Select action/file-type: (+) | (+) | (+) | Code (+) | Session (+) | (+) | SDB (+) | (+) | (+) | (+) | (+) | (+) |
<?php /* vim: set expandtab sw=4 ts=4 sts=4: */ /** * Set of functions used with the relation and pdf feature * * @package PhpMyAdmin */ if (! defined('PHPMYADMIN')) { exit; }
/** * Executes a query as controluser if possible, otherwise as normal user * * @param string $sql the query to execute * @param boolean $show_error whether to display SQL error messages or not * @param int $options query options * * @return integer the result set, or false if no result set * * @access public * */ function PMA_queryAsControlUser($sql, $show_error = true, $options = 0) { // Avoid caching of the number of rows affected; for example, this function // is called for tracking purposes but we want to display the correct number // of rows affected by the original query, not by the query generated for // tracking. $cache_affected_rows = false;
if ($show_error) { $result = $GLOBALS['dbi']->query( $sql, $GLOBALS['controllink'], $options, $cache_affected_rows ); } else { $result = @$GLOBALS['dbi']->tryQuery( $sql, $GLOBALS['controllink'], $options, $cache_affected_rows ); } // end if... else...
if ($result) { return $result; } else { return false; } } // end of the "PMA_queryAsControlUser()" function
/** * Returns current relation parameters * * @return array $cfgRelation */ function PMA_getRelationsParam() { // avoid breakage if pmadb got unconfigured after login if (! defined('TESTSUITE') && empty($GLOBALS['cfg']['Server']['pmadb'])) { unset($_SESSION['relation'][$GLOBALS['server']]); } if (empty($_SESSION['relation'][$GLOBALS['server']])) { $_SESSION['relation'][$GLOBALS['server']] = PMA_checkRelationsParam(); }
// just for BC but needs to be before PMA_getRelationsParamDiagnostic() // which uses it $GLOBALS['cfgRelation'] = $_SESSION['relation'][$GLOBALS['server']];
return $_SESSION['relation'][$GLOBALS['server']]; }
/** * prints out diagnostic info for pma relation feature * * @param array $cfgRelation Relation configuration * * @return string */ function PMA_getRelationsParamDiagnostic($cfgRelation) { $retval = '';
$messages = array(); $messages['error'] = '<font color="red"><strong>' . __('not OK') . '</strong></font>' . ' [ <a href="%s" target="documentation">' . __('Documentation') . '</a> ]';
$messages['ok'] = '<font color="green"><strong>' . _pgettext('Correctly working', 'OK') . '</strong></font>';
$messages['enabled'] = '<font color="green">' . __('Enabled') . '</font>'; $messages['disabled'] = '<font color="red">' . __('Disabled') . '</font>';
if (false === $GLOBALS['cfg']['Server']['pmadb']) { $retval .= 'PMA Database ... ' . sprintf($messages['error'], 'pmadb') . '<br />' . "\n" . __('General relation features') . ' <font color="green">' . __('Disabled') . '</font>' . "\n"; } else { $retval .= '<table>' . "\n"; $retval .= PMA_getDiagMessageForParameter( 'pmadb', $GLOBALS['cfg']['Server']['pmadb'], $messages, 'pmadb' ); $retval .= PMA_getDiagMessageForParameter( 'relation', isset($cfgRelation['relation']), $messages, 'relation' ); $retval .= PMA_getDiagMessageForFeature( __('General relation features'), 'relwork', $messages ); $retval .= PMA_getDiagMessageForParameter( 'table_info', isset($cfgRelation['table_info']), $messages, 'table_info' ); $retval .= PMA_getDiagMessageForFeature( __('Display Features'), 'displaywork', $messages ); $retval .= PMA_getDiagMessageForParameter( 'table_coords', isset($cfgRelation['table_coords']), $messages, 'table_coords' ); $retval .= PMA_getDiagMessageForParameter( 'pdf_pages', isset($cfgRelation['pdf_pages']), $messages, 'pdf_pages' ); $retval .= PMA_getDiagMessageForFeature( __('Creation of PDFs'), 'pdfwork', $messages ); $retval .= PMA_getDiagMessageForParameter( 'column_info', isset($cfgRelation['column_info']), $messages, 'column_info' ); $retval .= PMA_getDiagMessageForFeature( __('Displaying Column Comments'), 'commwork', $messages, false ); $retval .= PMA_getDiagMessageForFeature( __('Browser transformation'), 'mimework', $messages ); if ($cfgRelation['commwork'] && ! $cfgRelation['mimework']) { $retval .= '<tr><td colspan=2 class="left">'; $retval .= __('Please see the documentation on how to update your column_comments table.'); $retval .= '</td></tr>'; } $retval .= PMA_getDiagMessageForParameter( 'bookmarktable', isset($cfgRelation['bookmark']), $messages, 'bookmark' ); $retval .= PMA_getDiagMessageForFeature( __('Bookmarked SQL query'), 'bookmarkwork', $messages ); $retval .= PMA_getDiagMessageForParameter( 'history', isset($cfgRelation['history']), $messages, 'history' ); $retval .= PMA_getDiagMessageForFeature( __('SQL history'), 'historywork', $messages ); $retval .= PMA_getDiagMessageForParameter( 'designer_coords', isset($cfgRelation['designer_coords']), $messages, 'designer_coords' ); $retval .= PMA_getDiagMessageForFeature( __('Designer'), 'designerwork', $messages ); $retval .= PMA_getDiagMessageForParameter( 'recent', isset($cfgRelation['recent']), $messages, 'recent' ); $retval .= PMA_getDiagMessageForFeature( __('Persistent recently used tables'), 'recentwork', $messages ); $retval .= PMA_getDiagMessageForParameter( 'table_uiprefs', isset($cfgRelation['table_uiprefs']), $messages, 'table_uiprefs' ); $retval .= PMA_getDiagMessageForFeature( __('Persistent tables\' UI preferences'), 'uiprefswork', $messages ); $retval .= PMA_getDiagMessageForParameter( 'tracking', isset($cfgRelation['tracking']), $messages, 'tracking' ); $retval .= PMA_getDiagMessageForFeature( __('Tracking'), 'trackingwork', $messages ); $retval .= PMA_getDiagMessageForParameter( 'userconfig', isset($cfgRelation['userconfig']), $messages, 'userconfig' ); $retval .= PMA_getDiagMessageForFeature( __('User preferences'), 'userconfigwork', $messages ); $retval .= PMA_getDiagMessageForParameter( 'users', isset($cfgRelation['users']), $messages, 'users' ); $retval .= PMA_getDiagMessageForParameter( 'usergroups', isset($cfgRelation['usergroups']), $messages, 'usergroups' ); $retval .= PMA_getDiagMessageForFeature( __('Configurable menus'), 'menuswork', $messages ); $retval .= PMA_getDiagMessageForParameter( 'navigationhiding', isset($cfgRelation['navigationhiding']), $messages, 'navigationhiding' ); $retval .= PMA_getDiagMessageForFeature( __('Hide/show navigation items'), 'navwork', $messages ); $retval .= PMA_getDiagMessageForParameter( 'savedsearches', isset($cfgRelation['savedsearches']), $messages, 'savedsearches' ); $retval .= PMA_getDiagMessageForFeature( __('Saving Query-By-Example searches'), 'savedsearcheswork', $messages ); $retval .= '</table>' . "\n";
$retval .= '<p>' . __('Quick steps to setup advanced features:') . '</p>'; $retval .= '<ul>'; $retval .= '<li>'; $retval .= __( 'Create the needed tables with the ' . '<code>examples/create_tables.sql</code>.' ); $retval .= ' ' . PMA_Util::showDocu('setup', 'linked-tables'); $retval .= '</li>'; $retval .= '<li>'; $retval .= __('Create a pma user and give access to these tables.'); $retval .= ' ' . PMA_Util::showDocu('config', 'cfg_Servers_controluser'); $retval .= '</li>'; $retval .= '<li>'; $retval .= __( 'Enable advanced features in configuration file ' . '(<code>config.inc.php</code>), for example by ' . 'starting from <code>config.sample.inc.php</code>.' ); $retval .= ' ' . PMA_Util::showDocu('setup', 'quick-install'); $retval .= '</li>'; $retval .= '<li>'; $retval .= __( 'Re-login to phpMyAdmin to load the updated configuration file.' ); $retval .= '</li>'; $retval .= '</ul>'; }
return $retval; }
/** * prints out one diagnostic message for a feature * * @param string $feature_name feature name in a message string * @param string $relation_parameter the $GLOBALS['cfgRelation'] parameter to check * @param array $messages utility messages * @param boolean $skip_line whether to skip a line after the message * * @return string */ function PMA_getDiagMessageForFeature($feature_name, $relation_parameter, $messages, $skip_line = true ) { $retval = ' <tr><td colspan=2 class="right">' . $feature_name . ': '; if ($GLOBALS['cfgRelation'][$relation_parameter]) { $retval .= $messages['enabled']; } else { $retval .= $messages['disabled']; } $retval .= '</td></tr>'; if ($skip_line) { $retval .= '<tr><td> </td></tr>'; } return $retval; }
/** * prints out one diagnostic message for a configuration parameter * * @param string $parameter config parameter name to display * @param boolean $relationParameterSet whether this parameter is set * @param array $messages utility messages * @param string $docAnchor anchor in documentation * * @return string */ function PMA_getDiagMessageForParameter($parameter, $relationParameterSet, $messages, $docAnchor ) { $retval = '<tr><th class="left">'; $retval .= '$cfg[\'Servers\'][$i][\'' . $parameter . '\'] ... '; $retval .= '</th><td class="right">'; if ($relationParameterSet) { $retval .= $messages['ok']; } else { $retval .= sprintf( $messages['error'], PMA_Util::getDocuLink('config', 'cfg_Servers_' . $docAnchor) ); } $retval .= '</td></tr>' . "\n"; return $retval; }
/** * Defines the relation parameters for the current user * just a copy of the functions used for relations ;-) * but added some stuff to check what will work * * @access protected * @return array the relation parameters for the current user */ function PMA_checkRelationsParam() { $cfgRelation = array(); $cfgRelation['relwork'] = false; $cfgRelation['displaywork'] = false; $cfgRelation['bookmarkwork'] = false; $cfgRelation['pdfwork'] = false; $cfgRelation['commwork'] = false; $cfgRelation['mimework'] = false; $cfgRelation['historywork'] = false; $cfgRelation['recentwork'] = false; $cfgRelation['uiprefswork'] = false; $cfgRelation['trackingwork'] = false; $cfgRelation['designerwork'] = false; $cfgRelation['userconfigwork'] = false; $cfgRelation['menuswork'] = false; $cfgRelation['navwork'] = false; $cfgRelation['allworks'] = false; $cfgRelation['savedsearcheswork'] = false; $cfgRelation['user'] = null; $cfgRelation['db'] = null;
if ($GLOBALS['server'] == 0 || empty($GLOBALS['cfg']['Server']['pmadb']) || ! $GLOBALS['dbi']->selectDb($GLOBALS['cfg']['Server']['pmadb'], $GLOBALS['controllink']) ) { // No server selected -> no bookmark table // we return the array with the falses in it, // to avoid some 'Unitialized string offset' errors later $GLOBALS['cfg']['Server']['pmadb'] = false; return $cfgRelation; }
$cfgRelation['user'] = $GLOBALS['cfg']['Server']['user']; $cfgRelation['db'] = $GLOBALS['cfg']['Server']['pmadb'];
// Now I just check if all tables that i need are present so I can for // example enable relations but not pdf... // I was thinking of checking if they have all required columns but I // fear it might be too slow
$tab_query = 'SHOW TABLES FROM ' . PMA_Util::backquote( $GLOBALS['cfg']['Server']['pmadb'] ); $tab_rs = PMA_queryAsControlUser( $tab_query, false, PMA_DatabaseInterface::QUERY_STORE );
if (! $tab_rs) { // query failed ... ? //$GLOBALS['cfg']['Server']['pmadb'] = false; return $cfgRelation; }
while ($curr_table = @$GLOBALS['dbi']->fetchRow($tab_rs)) { if ($curr_table[0] == $GLOBALS['cfg']['Server']['bookmarktable']) { $cfgRelation['bookmark'] = $curr_table[0]; } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['relation']) { $cfgRelation['relation'] = $curr_table[0]; } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['table_info']) { $cfgRelation['table_info'] = $curr_table[0]; } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['table_coords']) { $cfgRelation['table_coords'] = $curr_table[0]; } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['designer_coords']) { $cfgRelation['designer_coords'] = $curr_table[0]; } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['column_info']) { $cfgRelation['column_info'] = $curr_table[0]; } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['pdf_pages']) { $cfgRelation['pdf_pages'] = $curr_table[0]; } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['history']) { $cfgRelation['history'] = $curr_table[0]; } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['recent']) { $cfgRelation['recent'] = $curr_table[0]; } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['table_uiprefs']) { $cfgRelation['table_uiprefs'] = $curr_table[0]; } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['tracking']) { $cfgRelation['tracking'] = $curr_table[0]; } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['userconfig']) { $cfgRelation['userconfig'] = $curr_table[0]; } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['users']) { $cfgRelation['users'] = $curr_table[0]; } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['usergroups']) { $cfgRelation['usergroups'] = $curr_table[0]; } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['navigationhiding']) { $cfgRelation['navigationhiding'] = $curr_table[0]; } elseif ($curr_table[0] == $GLOBALS['cfg']['Server']['savedsearches']) { $cfgRelation['savedsearches'] = $curr_table[0]; } } // end while $GLOBALS['dbi']->freeResult($tab_rs);
if (isset($cfgRelation['relation'])) { $cfgRelation['relwork'] = true; if (isset($cfgRelation['table_info'])) { $cfgRelation['displaywork'] = true; } }
if (isset($cfgRelation['table_coords']) && isset($cfgRelation['pdf_pages'])) { $cfgRelation['pdfwork'] = true; }
if (isset($cfgRelation['column_info'])) { $cfgRelation['commwork'] = true; $cfgRelation['mimework'] = true; }
if (isset($cfgRelation['history'])) { $cfgRelation['historywork'] = true; }
if (isset($cfgRelation['recent'])) { $cfgRelation['recentwork'] = true; }
if (isset($cfgRelation['table_uiprefs'])) { $cfgRelation['uiprefswork'] = true; }
if (isset($cfgRelation['tracking'])) { $cfgRelation['trackingwork'] = true; }
if (isset($cfgRelation['userconfig'])) { $cfgRelation['userconfigwork'] = true; }
// we do not absolutely need that the internal relations or the PDF // schema feature be activated if (isset($cfgRelation['designer_coords'])) { $cfgRelation['designerwork'] = true; }
if (isset($cfgRelation['bookmark'])) { $cfgRelation['bookmarkwork'] = true; }
if (isset($cfgRelation['users']) && isset($cfgRelation['usergroups'])) { $cfgRelation['menuswork'] = true; }
if (isset($cfgRelation['navigationhiding'])) { $cfgRelation['navwork'] = true; }
if (isset($cfgRelation['savedsearches'])) { $cfgRelation['savedsearcheswork'] = true; }
if ($cfgRelation['relwork'] && $cfgRelation['displaywork'] && $cfgRelation['pdfwork'] && $cfgRelation['commwork'] && $cfgRelation['mimework'] && $cfgRelation['historywork'] && $cfgRelation['recentwork'] && $cfgRelation['uiprefswork'] && $cfgRelation['trackingwork'] && $cfgRelation['userconfigwork'] && $cfgRelation['bookmarkwork'] && $cfgRelation['designerwork'] && $cfgRelation['menuswork'] && $cfgRelation['navwork'] && $cfgRelation['savedsearcheswork'] ) { $cfgRelation['allworks'] = true; }
return $cfgRelation; } // end of the 'PMA_getRelationsParam()' function
/** * Gets all Relations to foreign tables for a given table or * optionally a given column in a table * * @param string $db the name of the db to check for * @param string $table the name of the table to check for * @param string $column the name of the column to check for * @param string $source the source for foreign key information * * @return array db,table,column * * @access public */ function PMA_getForeigners($db, $table, $column = '', $source = 'both') { $cfgRelation = PMA_getRelationsParam(); $foreign = array();
if ($cfgRelation['relwork'] && ($source == 'both' || $source == 'internal')) { $rel_query = ' SELECT `master_field`, `foreign_db`, `foreign_table`, `foreign_field` FROM ' . PMA_Util::backquote($cfgRelation['db']) . '.' . PMA_Util::backquote($cfgRelation['relation']) . ' WHERE `master_db` = \'' . PMA_Util::sqlAddSlashes($db) . '\' AND `master_table` = \'' . PMA_Util::sqlAddSlashes($table) . '\' '; if (strlen($column)) { $rel_query .= ' AND `master_field` = ' . '\'' . PMA_Util::sqlAddSlashes($column) . '\''; } $foreign = $GLOBALS['dbi']->fetchResult( $rel_query, 'master_field', null, $GLOBALS['controllink'] ); }
if (($source == 'both' || $source == 'foreign') && strlen($table)) {
$showCreateTableQuery = 'SHOW CREATE TABLE ' . PMA_Util::backquote($db) . '.' . PMA_Util::backquote($table); $show_create_table = $GLOBALS['dbi']->fetchValue( $showCreateTableQuery, 0, 1 ); $analyzed_sql = PMA_SQP_analyze(PMA_SQP_parse($show_create_table));
foreach ($analyzed_sql[0]['foreign_keys'] as $one_key) { // The analyzer may return more than one column name in the // index list or the ref_index_list; if this happens, // the current logic just discards the whole index; having // more than one index field is currently unsupported (see FAQ 3.6) if (count($one_key['index_list']) == 1) { foreach ($one_key['index_list'] as $i => $field) { // If a foreign key is defined in the 'internal' source (pmadb) // and as a native foreign key, we won't get it twice // if $source='both' because we use $field as key
// The parser looks for a CONSTRAINT clause just before // the FOREIGN KEY clause. It finds it (as output from // SHOW CREATE TABLE) in MySQL 4.0.13, but not in older // versions like 3.23.58. // In those cases, the FOREIGN KEY parsing will put numbers // like -1, 0, 1... instead of the constraint number.
if (isset($one_key['constraint'])) { $foreign[$field]['constraint'] = $one_key['constraint']; }
if (isset($one_key['ref_db_name'])) { $foreign[$field]['foreign_db'] = $one_key['ref_db_name']; } else { $foreign[$field]['foreign_db'] = $db; } $foreign[$field]['foreign_table'] = $one_key['ref_table_name']; $foreign[$field]['foreign_field'] = $one_key['ref_index_list'][$i]; if (isset($one_key['on_delete'])) { $foreign[$field]['on_delete'] = $one_key['on_delete']; } if (isset($one_key['on_update'])) { $foreign[$field]['on_update'] = $one_key['on_update']; } } } } }
/** * Emulating relations for some information_schema and data_dictionary tables */ $isInformationSchema = strtolower($db) == 'information_schema'; $is_data_dictionary = PMA_DRIZZLE && strtolower($db) == 'data_dictionary'; if (($isInformationSchema || $is_data_dictionary) && ($source == 'internal' || $source == 'both') ) { if ($isInformationSchema) { $relations_key = 'information_schema_relations'; include_once './libraries/information_schema_relations.lib.php'; } else { $relations_key = 'data_dictionary_relations'; include_once './libraries/data_dictionary_relations.lib.php'; } if (isset($GLOBALS[$relations_key][$table])) { foreach ($GLOBALS[$relations_key][$table] as $field => $relations) { if ((! strlen($column) || $column == $field) && (! isset($foreign[$field]) || ! strlen($foreign[$field])) ) { $foreign[$field] = $relations; } } } }
return $foreign; } // end of the 'PMA_getForeigners()' function
/** * Gets the display field of a table * * @param string $db the name of the db to check for * @param string $table the name of the table to check for * * @return string field name * * @access public */ function PMA_getDisplayField($db, $table) { $cfgRelation = PMA_getRelationsParam();
/** * Try to fetch the display field from DB. */ if ($cfgRelation['displaywork']) { $disp_query = ' SELECT `display_field` FROM ' . PMA_Util::backquote($cfgRelation['db']) . '.' . PMA_Util::backquote($cfgRelation['table_info']) . ' WHERE `db_name` = \'' . PMA_Util::sqlAddSlashes($db) . '\' AND `table_name` = \'' . PMA_Util::sqlAddSlashes($table) . '\'';
$row = $GLOBALS['dbi']->fetchSingleRow( $disp_query, 'ASSOC', $GLOBALS['controllink'] ); if (isset($row['display_field'])) { return $row['display_field']; } }
/** * Emulating the display field for some information_schema tables. */ if ($db == 'information_schema') { switch ($table) { case 'CHARACTER_SETS': return 'DESCRIPTION'; case 'TABLES': return 'TABLE_COMMENT'; } }
/** * No Luck... */ return false;
} // end of the 'PMA_getDisplayField()' function
/** * Gets the comments for all columns of a table or the db itself * * @param string $db the name of the db to check for * @param string $table the name of the table to check for * * @return array [column_name] = comment * * @access public */ function PMA_getComments($db, $table = '') { $comments = array();
if ($table != '') { // MySQL native column comments $columns = $GLOBALS['dbi']->getColumns($db, $table, null, true); if ($columns) { foreach ($columns as $column) { if (! empty($column['Comment'])) { $comments[$column['Field']] = $column['Comment']; } } } } else { $comments[] = PMA_getDbComment($db); }
return $comments; } // end of the 'PMA_getComments()' function
/** * Gets the comment for a db * * @param string $db the name of the db to check for * * @return string comment * * @access public */ function PMA_getDbComment($db) { $cfgRelation = PMA_getRelationsParam(); $comment = '';
if ($cfgRelation['commwork']) { // pmadb internal db comment $com_qry = " SELECT `comment` FROM " . PMA_Util::backquote($cfgRelation['db']) . "." . PMA_Util::backquote($cfgRelation['column_info']) . " WHERE db_name = '" . PMA_Util::sqlAddSlashes($db) . "' AND table_name = '' AND column_name = '(db_comment)'"; $com_rs = PMA_queryAsControlUser( $com_qry, true, PMA_DatabaseInterface::QUERY_STORE );
if ($com_rs && $GLOBALS['dbi']->numRows($com_rs) > 0) { $row = $GLOBALS['dbi']->fetchAssoc($com_rs); $comment = $row['comment']; } $GLOBALS['dbi']->freeResult($com_rs); }
return $comment; } // end of the 'PMA_getDbComment()' function
/** * Gets the comment for a db * * @access public * * @return string comment */ function PMA_getDbComments() { $cfgRelation = PMA_getRelationsParam(); $comments = array();
if ($cfgRelation['commwork']) { // pmadb internal db comment $com_qry = " SELECT `db_name`, `comment` FROM " . PMA_Util::backquote($cfgRelation['db']) . "." . PMA_Util::backquote($cfgRelation['column_info']) . " WHERE `column_name` = '(db_comment)'"; $com_rs = PMA_queryAsControlUser( $com_qry, true, PMA_DatabaseInterface::QUERY_STORE );
if ($com_rs && $GLOBALS['dbi']->numRows($com_rs) > 0) { while ($row = $GLOBALS['dbi']->fetchAssoc($com_rs)) { $comments[$row['db_name']] = $row['comment']; } } $GLOBALS['dbi']->freeResult($com_rs); }
return $comments; } // end of the 'PMA_getDbComments()' function
/** * Set a database comment to a certain value. * * @param string $db the name of the db * @param string $comment the value of the column * * @return boolean true, if comment-query was made. * * @access public */ function PMA_setDbComment($db, $comment = '') { $cfgRelation = PMA_getRelationsParam();
if (! $cfgRelation['commwork']) { return false; }
if (strlen($comment)) { $upd_query = 'INSERT INTO ' . PMA_Util::backquote($cfgRelation['db']) . '.' . PMA_Util::backquote($cfgRelation['column_info']) . ' (`db_name`, `table_name`, `column_name`, `comment`)' . ' VALUES (\'' . PMA_Util::sqlAddSlashes($db) . "', '', '(db_comment)', '" . PMA_Util::sqlAddSlashes($comment) . "') " . ' ON DUPLICATE KEY UPDATE ' . "`comment` = '" . PMA_Util::sqlAddSlashes($comment) . "'"; } else { $upd_query = 'DELETE FROM ' . PMA_Util::backquote($cfgRelation['db']) . '.' . PMA_Util::backquote($cfgRelation['column_info']) . ' WHERE `db_name` = \'' . PMA_Util::sqlAddSlashes($db) . '\' AND `table_name` = \'\' AND `column_name` = \'(db_comment)\''; }
if (isset($upd_query)) { return PMA_queryAsControlUser($upd_query); }
return false; } // end of 'PMA_setDbComment()' function
/** * Set a SQL history entry * * @param string $db the name of the db * @param string $table the name of the table * @param string $username the username * @param string $sqlquery the sql query * * @return void * * @access public */ function PMA_setHistory($db, $table, $username, $sqlquery) { // Prevent to run this automatically on Footer class destroying in testsuite if (defined('TESTSUITE') || strlen($sqlquery) > $GLOBALS['cfg']['MaxCharactersInDisplayedSQL'] ) { return; }
$cfgRelation = PMA_getRelationsParam();
if (! isset($_SESSION['sql_history'])) { $_SESSION['sql_history'] = array(); }
$key = md5($sqlquery . $db . $table);
if (isset($_SESSION['sql_history'][$key])) { unset($_SESSION['sql_history'][$key]); }
$_SESSION['sql_history'][$key] = array( 'db' => $db, 'table' => $table, 'sqlquery' => $sqlquery, );
if (count($_SESSION['sql_history']) > $GLOBALS['cfg']['QueryHistoryMax']) { // history should not exceed a maximum count array_shift($_SESSION['sql_history']); }
if (! $cfgRelation['historywork'] || ! $GLOBALS['cfg']['QueryHistoryDB']) { return; }
PMA_queryAsControlUser( 'INSERT INTO ' . PMA_Util::backquote($cfgRelation['db']) . '.' . PMA_Util::backquote($cfgRelation['history']) . ' (`username`, `db`, `table`, `timevalue`, `sqlquery`) VALUES (\'' . PMA_Util::sqlAddSlashes($username) . '\', \'' . PMA_Util::sqlAddSlashes($db) . '\', \'' . PMA_Util::sqlAddSlashes($table) . '\', NOW(), \'' . PMA_Util::sqlAddSlashes($sqlquery) . '\')' ); } // end of 'PMA_setHistory()' function
/** * Gets a SQL history entry * * @param string $username the username * * @return array list of history items * * @access public */ function PMA_getHistory($username) { $cfgRelation = PMA_getRelationsParam();
/** * if db-based history is disabled but there exists a session-based * history, use it */ if (! $GLOBALS['cfg']['QueryHistoryDB'] && isset($_SESSION['sql_history'])) { return array_reverse($_SESSION['sql_history']); }
if (! $cfgRelation['historywork']) { return false; }
$hist_query = ' SELECT `db`, `table`, `sqlquery` FROM ' . PMA_Util::backquote($cfgRelation['db']) . '.' . PMA_Util::backquote($cfgRelation['history']) . ' WHERE `username` = \'' . PMA_Util::sqlAddSlashes($username) . '\' ORDER BY `id` DESC';
return $GLOBALS['dbi']->fetchResult( $hist_query, null, null, $GLOBALS['controllink'] ); } // end of 'PMA_getHistory()' function
/** * purges SQL history * * deletes entries that exceeds $cfg['QueryHistoryMax'], oldest first, for the * given user * * @param string $username the username * * @return void * * @access public */ function PMA_purgeHistory($username) { $cfgRelation = PMA_getRelationsParam(); if (! $GLOBALS['cfg']['QueryHistoryDB'] || ! $cfgRelation['historywork']) { return; }
if (! $cfgRelation['historywork']) { return; }
$search_query = ' SELECT `timevalue` FROM ' . PMA_Util::backquote($cfgRelation['db']) . '.' . PMA_Util::backquote($cfgRelation['history']) . ' WHERE `username` = \'' . PMA_Util::sqlAddSlashes($username) . '\' ORDER BY `timevalue` DESC LIMIT ' . $GLOBALS['cfg']['QueryHistoryMax'] . ', 1';
if ($max_time = $GLOBALS['dbi']->fetchValue($search_query, 0, 0, $GLOBALS['controllink'])) { PMA_queryAsControlUser( 'DELETE FROM ' . PMA_Util::backquote($cfgRelation['db']) . '.' . PMA_Util::backquote($cfgRelation['history']) . ' WHERE `username` = \'' . PMA_Util::sqlAddSlashes($username) . '\' AND `timevalue` <= \'' . $max_time . '\'' ); } } // end of 'PMA_purgeHistory()' function
/** * Prepares the dropdown for one mode * * @param array $foreign the keys and values for foreigns * @param string $data the current data of the dropdown * @param string $mode the needed mode * * @return array the <option value=""><option>s * * @access protected */ function PMA_buildForeignDropdown($foreign, $data, $mode) { $reloptions = array();
// id-only is a special mode used when no foreign display column // is available if ($mode == 'id-content' || $mode == 'id-only') { // sort for id-content if ($GLOBALS['cfg']['NaturalOrder']) { uksort($foreign, 'strnatcasecmp'); } else { ksort($foreign); } } elseif ($mode == 'content-id') { // sort for content-id if ($GLOBALS['cfg']['NaturalOrder']) { natcasesort($foreign); } else { asort($foreign); } }
foreach ($foreign as $key => $value) { if ($GLOBALS['PMA_String']->strlen($value) <= $GLOBALS['cfg']['LimitChars'] ) { $vtitle = ''; $value = htmlspecialchars($value); } else { $vtitle = htmlspecialchars($value); $value = htmlspecialchars( substr($value, 0, $GLOBALS['cfg']['LimitChars']) . '...' ); }
$reloption = '<option value="' . htmlspecialchars($key) . '"'; if ($vtitle != '') { $reloption .= ' title="' . $vtitle . '"'; }
if ((string) $key == (string) $data) { $reloption .= ' selected="selected"'; }
if ($mode == 'content-id') { $reloptions[] = $reloption . '>' . $value . ' - ' . htmlspecialchars($key) . '</option>'; } elseif ($mode == 'id-content') { $reloptions[] = $reloption . '>' . htmlspecialchars($key) . ' - ' . $value . '</option>'; } elseif ($mode == 'id-only') { $reloptions[] = $reloption . '>' . htmlspecialchars($key) . '</option>'; } } // end foreach
return $reloptions; } // end of 'PMA_buildForeignDropdown' function
/** * Outputs dropdown with values of foreign fields * * @param array $disp_row array of the displayed row * @param string $foreign_field the foreign field * @param string $foreign_display the foreign field to display * @param string $data the current data of the dropdown (field in row) * @param int $max maximum number of items in the dropdown * * @return string the <option value=""><option>s * * @access public */ function PMA_foreignDropdown($disp_row, $foreign_field, $foreign_display, $data, $max = null ) { if (null === $max) { $max = $GLOBALS['cfg']['ForeignKeyMaxLimit']; }
$foreign = array();
// collect the data foreach ($disp_row as $relrow) { $key = $relrow[$foreign_field];
// if the display field has been defined for this foreign table if ($foreign_display) { $value = $relrow[$foreign_display]; } else { $value = ''; } // end if ($foreign_display)
$foreign[$key] = $value; } // end foreach
// put the dropdown sections in correct order $top = array(); $bottom = array(); if ($foreign_display) { if (PMA_isValid($GLOBALS['cfg']['ForeignKeyDropdownOrder'], 'array')) { if (PMA_isValid($GLOBALS['cfg']['ForeignKeyDropdownOrder'][0])) { $top = PMA_buildForeignDropdown( $foreign, $data, $GLOBALS['cfg']['ForeignKeyDropdownOrder'][0] ); } if (PMA_isValid($GLOBALS['cfg']['ForeignKeyDropdownOrder'][1])) { $bottom = PMA_buildForeignDropdown( $foreign, $data, $GLOBALS['cfg']['ForeignKeyDropdownOrder'][1] ); } } else { $top = PMA_buildForeignDropdown($foreign, $data, 'id-content'); $bottom = PMA_buildForeignDropdown($foreign, $data, 'content-id'); } } else { $top = PMA_buildForeignDropdown($foreign, $data, 'id-only'); }
// beginning of dropdown $ret = '<option value=""> </option>'; $top_count = count($top); if ($max == -1 || $top_count < $max) { $ret .= implode('', $top); if ($foreign_display && $top_count > 0) { // this empty option is to visually mark the beginning of the // second series of values (bottom) $ret .= '<option value=""> </option>'; } } if ($foreign_display) { $ret .= implode('', $bottom); }
return $ret; } // end of 'PMA_foreignDropdown()' function
/** * Gets foreign keys in preparation for a drop-down selector * * @param array $foreigners array of the foreign keys * @param string $field the foreign field name * @param bool $override_total whether to override the total * @param string $foreign_filter a possible filter * @param string $foreign_limit a possible LIMIT clause * * @return array data about the foreign keys * * @access public */
function PMA_getForeignData( $foreigners, $field, $override_total, $foreign_filter, $foreign_limit ) { // we always show the foreign field in the drop-down; if a display // field is defined, we show it besides the foreign field $foreign_link = false; if ($foreigners && isset($foreigners[$field])) { $foreigner = $foreigners[$field]; $foreign_db = $foreigner['foreign_db']; $foreign_table = $foreigner['foreign_table']; $foreign_field = $foreigner['foreign_field'];
// Count number of rows in the foreign table. Currently we do // not use a drop-down if more than ForeignKeyMaxLimit rows in the // foreign table, // for speed reasons and because we need a better interface for this. // // We could also do the SELECT anyway, with a LIMIT, and ensure that // the current value of the field is one of the choices.
$the_total = PMA_Table::countRecords($foreign_db, $foreign_table, true);
if ($override_total == true || $the_total < $GLOBALS['cfg']['ForeignKeyMaxLimit'] ) { // foreign_display can be false if no display field defined: $foreign_display = PMA_getDisplayField($foreign_db, $foreign_table);
$f_query_main = 'SELECT ' . PMA_Util::backquote($foreign_field) . ( ($foreign_display == false) ? '' : ', ' . PMA_Util::backquote($foreign_display) ); $f_query_from = ' FROM ' . PMA_Util::backquote($foreign_db) . '.' . PMA_Util::backquote($foreign_table); $f_query_filter = empty($foreign_filter) ? '' : ' WHERE ' . PMA_Util::backquote($foreign_field) . ' LIKE "%' . PMA_Util::sqlAddSlashes($foreign_filter, true) . '%"' . ( ($foreign_display == false) ? '' : ' OR ' . PMA_Util::backquote($foreign_display) . ' LIKE "%' . PMA_Util::sqlAddSlashes($foreign_filter, true) . '%"' ); $f_query_order = ($foreign_display == false) ? '' :' ORDER BY ' . PMA_Util::backquote($foreign_table) . '.' . PMA_Util::backquote($foreign_display); $f_query_limit = isset($foreign_limit) ? $foreign_limit : '';
if (!empty($foreign_filter)) { $res = $GLOBALS['dbi']->query( 'SELECT COUNT(*)' . $f_query_from . $f_query_filter ); if ($res) { $the_total = $GLOBALS['dbi']->fetchValue($res); @$GLOBALS['dbi']->freeResult($res); } else { $the_total = 0; } }
$disp = $GLOBALS['dbi']->query( $f_query_main . $f_query_from . $f_query_filter . $f_query_order . $f_query_limit ); if ($disp && $GLOBALS['dbi']->numRows($disp) > 0) { // If a resultset has been created, pre-cache it in the $disp_row // array. This helps us from not needing to use mysql_data_seek by // accessing a pre-cached PHP array. Usually those resultsets are // not that big, so a performance hit should not be expected. $disp_row = array(); while ($single_disp_row = @$GLOBALS['dbi']->fetchAssoc($disp)) { $disp_row[] = $single_disp_row; } @$GLOBALS['dbi']->freeResult($disp); } } else { $disp_row = null; $foreign_link = true; } } // end if $foreigners
$foreignData = array(); $foreignData['foreign_link'] = $foreign_link; $foreignData['the_total'] = isset($the_total) ? $the_total : null; $foreignData['foreign_display'] = ( isset($foreign_display) ? $foreign_display : null ); $foreignData['disp_row'] = isset($disp_row) ? $disp_row : null; $foreignData['foreign_field'] = isset($foreign_field) ? $foreign_field : null; return $foreignData; } // end of 'PMA_getForeignData()' function
/** * Finds all related tables * * @param array $all_tables All the involved tables * @param string $master The master table to form the LEFT JOIN clause * * @return string LEFT JOIN * @access private */ function PMA_getRelatives($all_tables, $master) { $fromclause = ''; $emerg = '';
// The list of tables that we still couldn't connect $remaining_tables = $all_tables; unset($remaining_tables[$master]); // The list of allready connected tables $known_tables = array(); $known_tables[$master] = $master; $run = 0; while (count($remaining_tables) > 0) { // Whether to go from master to foreign or vice versa if ($run % 2 == 0) { $from = 'master'; $to = 'foreign'; } else { $from = 'foreign'; $to = 'master'; } $in_know = '(\'' . implode('\', \'', $known_tables) . '\')'; $in_left = '(\'' . implode('\', \'', $remaining_tables) . '\')'; $rel_query = 'SELECT *' . ' FROM ' . PMA_Util::backquote($GLOBALS['cfgRelation']['db']) . '.' . PMA_Util::backquote($GLOBALS['cfgRelation']['relation']) . ' WHERE ' . $from . '_db = \'' . PMA_Util::sqlAddSlashes($GLOBALS['db']) . '\'' . ' AND ' . $to . '_db = \'' . PMA_Util::sqlAddSlashes($GLOBALS['db']) . '\'' . ' AND ' . $from . '_table IN ' . $in_know . ' AND ' . $to . '_table IN ' . $in_left; $relations = @$GLOBALS['dbi']->query($rel_query, $GLOBALS['controllink']); while ($row = $GLOBALS['dbi']->fetchAssoc($relations)) { $found_table = $row[$to . '_table']; if (isset($remaining_tables[$found_table])) { $fromclause .= "\n" . ' LEFT JOIN ' . PMA_Util::backquote($GLOBALS['db']) . '.' . PMA_Util::backquote($row[$to . '_table']) . ' ON ' . PMA_Util::backquote($row[$from . '_table']) . '.' . PMA_Util::backquote($row[$from . '_field']) . ' = ' . PMA_Util::backquote($row[$to . '_table']) . '.' . PMA_Util::backquote($row[$to . '_field']) . ' '; $known_tables[$found_table] = $found_table; unset($remaining_tables[$found_table]); } } // end while $run++; if ($run > 5) { foreach ($remaining_tables as $table) { $emerg .= ', ' . PMA_Util::backquote($table); unset($remaining_tables[$table]); } } } // end while $fromclause = $emerg . $fromclause; return $fromclause; } // end of the "PMA_getRelatives()" function
/** * Rename a field in relation tables * * usually called after a column in a table was renamed * * @param string $db database name * @param string $table table name * @param string $field old field name * @param string $new_name new field name * * @return void */ function PMA_REL_renameField($db, $table, $field, $new_name) { $cfgRelation = PMA_getRelationsParam();
if ($cfgRelation['displaywork']) { $table_query = 'UPDATE ' . PMA_Util::backquote($cfgRelation['db']) . '.' . PMA_Util::backquote($cfgRelation['table_info']) . ' SET display_field = \'' . PMA_Util::sqlAddSlashes($new_name) . '\'' . ' WHERE db_name = \'' . PMA_Util::sqlAddSlashes($db) . '\'' . ' AND table_name = \'' . PMA_Util::sqlAddSlashes($table) . '\'' . ' AND display_field = \'' . PMA_Util::sqlAddSlashes($field) . '\''; PMA_queryAsControlUser($table_query); }
if ($cfgRelation['relwork']) { $table_query = 'UPDATE ' . PMA_Util::backquote($cfgRelation['db']) . '.' . PMA_Util::backquote($cfgRelation['relation']) . ' SET master_field = \'' . PMA_Util::sqlAddSlashes($new_name) . '\'' . ' WHERE master_db = \'' . PMA_Util::sqlAddSlashes($db) . '\'' . ' AND master_table = \'' . PMA_Util::sqlAddSlashes($table) . '\'' . ' AND master_field = \'' . PMA_Util::sqlAddSlashes($field) . '\''; PMA_queryAsControlUser($table_query);
$table_query = 'UPDATE ' . PMA_Util::backquote($cfgRelation['db']) . '.' . PMA_Util::backquote($cfgRelation['relation']) . ' SET foreign_field = \'' . PMA_Util::sqlAddSlashes($new_name) . '\'' . ' WHERE foreign_db = \'' . PMA_Util::sqlAddSlashes($db) . '\'' . ' AND foreign_table = \'' . PMA_Util::sqlAddSlashes($table) . '\'' . ' AND foreign_field = \'' . PMA_Util::sqlAddSlashes($field) . '\''; PMA_queryAsControlUser($table_query);
} // end if relwork }
/** * Performs SQL query used for renaming table. * * @param string $table Relation table to use * @param string $source_db Source database name * @param string $target_db Target database name * @param string $source_table Source table name * @param string $target_table Target table name * @param string $db_field Name of database field * @param string $table_field Name of table field * * @return void */ function PMA_REL_renameSingleTable($table, $source_db, $target_db, $source_table, $target_table, $db_field, $table_field ) { $query = 'UPDATE ' . PMA_Util::backquote($GLOBALS['cfgRelation']['db']) . '.' . PMA_Util::backquote($GLOBALS['cfgRelation'][$table]) . ' SET ' . $db_field . ' = \'' . PMA_Util::sqlAddSlashes($target_db) . '\', ' . $table_field . ' = \'' . PMA_Util::sqlAddSlashes($target_table) . '\'' . ' WHERE ' . $db_field . ' = \'' . PMA_Util::sqlAddSlashes($source_db) . '\'' . ' AND ' . $table_field . ' = \'' . PMA_Util::sqlAddSlashes($source_table) . '\''; PMA_queryAsControlUser($query); }
/** * Rename a table in relation tables * * usually called after table has been moved * * @param string $source_db Source database name * @param string $target_db Target database name * @param string $source_table Source table name * @param string $target_table Target table name * * @return void */ function PMA_REL_renameTable($source_db, $target_db, $source_table, $target_table) { // Move old entries from PMA-DBs to new table if ($GLOBALS['cfgRelation']['commwork']) { PMA_REL_renameSingleTable( 'column_info', $source_db, $target_db, $source_table, $target_table, 'db_name', 'table_name' ); }
// updating bookmarks is not possible since only a single table is // moved, and not the whole DB.
if ($GLOBALS['cfgRelation']['displaywork']) { PMA_REL_renameSingleTable( 'table_info', $source_db, $target_db, $source_table, $target_table, 'db_name', 'table_name' ); }
if ($GLOBALS['cfgRelation']['relwork']) { PMA_REL_renameSingleTable( 'relation', $source_db, $target_db, $source_table, $target_table, 'foreign_db', 'foreign_table' );
PMA_REL_renameSingleTable( 'relation', $source_db, $target_db, $source_table, $target_table, 'master_db', 'master_table' ); }
/** * @todo Can't get moving PDFs the right way. The page numbers * always get screwed up independently from duplication because the * numbers do not seem to be stored on a per-database basis. Would * the author of pdf support please have a look at it? */
if ($GLOBALS['cfgRelation']['pdfwork']) { PMA_REL_renameSingleTable( 'table_coords', $source_db, $target_db, $source_table, $target_table, 'db_name', 'table_name' ); }
if ($GLOBALS['cfgRelation']['designerwork']) { PMA_REL_renameSingleTable( 'designer_coords', $source_db, $target_db, $source_table, $target_table, 'db_name', 'table_name' ); } }
/** * Create a PDF page * * @param string $newpage name of the new PDF page * @param array $cfgRelation Relation configuration * @param string $db database name * * @return string $pdf_page_number */ function PMA_REL_createPage($newpage, $cfgRelation, $db) { if (! isset($newpage) || $newpage == '') { $newpage = __('no description'); } $ins_query = 'INSERT INTO ' . PMA_Util::backquote($GLOBALS['cfgRelation']['db']) . '.' . PMA_Util::backquote($cfgRelation['pdf_pages']) . ' (db_name, page_descr)' . ' VALUES (\'' . PMA_Util::sqlAddSlashes($db) . '\', \'' . PMA_Util::sqlAddSlashes($newpage) . '\')'; PMA_queryAsControlUser($ins_query, false);
return $GLOBALS['dbi']->insertId( isset($GLOBALS['controllink']) ? $GLOBALS['controllink'] : '' ); }
/** * Get child table references for a table column. * * @param string $db name of master table db. * @param string $table name of master table. * @param string $column name of master table column. * * @return array $child_references */ function PMA_getChildReferences($db, $table, $column) { $child_references = array(); $i=0; $rel_query = 'SELECT `column_name`,' . ' `table_name`,' . '`table_schema`' . ' FROM `information_schema`.`key_column_usage`' . ' WHERE `referenced_column_name` = \'' . PMA_Util::sqlAddSlashes($column) . '\'' . ' AND `referenced_table_name` = \'' . PMA_Util::sqlAddSlashes($table) . '\'' . ' AND `referenced_table_schema` = \'' . PMA_Util::sqlAddSlashes($db) . '\'';
$result = $GLOBALS['dbi']->tryQuery($rel_query, $GLOBALS['controllink']); if ($result == true) { while (($row = $GLOBALS['dbi']->fetchAssoc($result))) { $child_references[$i++] = $row; } } return $child_references; }
/** * Check child table references and foreign key for a table column. * * @param string $db name of master table db. * @param string $table name of master table. * @param string $column name of master table column. * * @return array $column_status telling about references if foreign key. */ function PMA_checkChildForeignReferences($db, $table, $column) { $column_status = array(); $column_status['isEditable'] = false; $column_status['isReferenced'] = false; $column_status['isForeignKey'] = false; $column_status['references'] = array(); $foreigners = PMA_getForeigners($db, $table, $column); $child_references = PMA_getChildReferences($db, $table, $column);
if (sizeof($child_references, 0) > 0 || (! empty($foreigners[$column]) && sizeof($foreigners[$column], 0) > 0) ) { if (sizeof($child_references, 0) > 0) { $column_status['isReferenced'] = true; foreach ($child_references as $row => $columns) { array_push( $column_status['references'], PMA_Util::backquote($columns['table_schema']) . '.' . PMA_Util::backquote($columns['table_name']) ); } }
if (!empty($foreigners[$column]) && sizeof($foreigners[$column], 0) > 0) { $column_status['isForeignKey'] = true; } } else { $column_status['isEditable'] = true; }
return $column_status; } ?>
|