%PDF- %PDF-
Direktori : /var/www/projetos/admin.iigd.com.br/libraries/classes/Navigation/ |
Current File : /var/www/projetos/admin.iigd.com.br/libraries/classes/Navigation/NavigationTree.php |
<?php /** * Functionality for the navigation tree */ declare(strict_types=1); namespace PhpMyAdmin\Navigation; use PhpMyAdmin\CheckUserPrivileges; use PhpMyAdmin\DatabaseInterface; use PhpMyAdmin\Html\Generator; use PhpMyAdmin\Navigation\Nodes\Node; use PhpMyAdmin\Navigation\Nodes\NodeDatabase; use PhpMyAdmin\Navigation\Nodes\NodeTable; use PhpMyAdmin\Navigation\Nodes\NodeTableContainer; use PhpMyAdmin\Navigation\Nodes\NodeViewContainer; use PhpMyAdmin\RecentFavoriteTable; use PhpMyAdmin\ResponseRenderer; use PhpMyAdmin\Template; use PhpMyAdmin\Url; use PhpMyAdmin\Util; use function __; use function _ngettext; use function array_intersect_key; use function array_key_exists; use function array_keys; use function array_merge; use function array_shift; use function base64_decode; use function count; use function explode; use function floor; use function get_class; use function htmlspecialchars; use function in_array; use function is_array; use function is_bool; use function is_object; use function mb_strlen; use function mb_strpos; use function mb_substr; use function method_exists; use function sort; use function sprintf; use function strcasecmp; use function strlen; use function strnatcasecmp; use function strrpos; use function strstr; use function substr; use function trigger_error; use function trim; use function usort; use const E_USER_WARNING; /** * Displays a collapsible of database objects in the navigation frame */ class NavigationTree { private const SPECIAL_NODE_NAMES = ['tables', 'views', 'functions', 'procedures', 'events']; /** @var Node Reference to the root node of the tree */ private $tree; /** * @var array The actual paths to all expanded nodes in the tree * This does not include nodes created after the grouping * of nodes has been performed */ private $aPath = []; /** * @var array The virtual paths to all expanded nodes in the tree * This includes nodes created after the grouping of * nodes has been performed */ private $vPath = []; /** * @var int Position in the list of databases, * used for pagination */ private $pos; /** * @var string[] The names of the type of items that are being paginated on * the second level of the navigation tree. These may be * tables, views, functions, procedures or events. */ private $pos2Name = []; /** * @var int[] The positions of nodes in the lists of tables, views, * routines or events used for pagination */ private $pos2Value = []; /** * @var string[] The names of the type of items that are being paginated * on the second level of the navigation tree. * These may be columns or indexes */ private $pos3Name = []; /** * @var int[] The positions of nodes in the lists of columns or indexes * used for pagination */ private $pos3Value = []; /** * @var string The search clause to use in SQL queries for * fetching databases * Used by the asynchronous fast filter */ private $searchClause = ''; /** * @var string The search clause to use in SQL queries for * fetching nodes * Used by the asynchronous fast filter */ private $searchClause2 = ''; /** * @var bool Whether a warning was raised for large item groups * which can affect performance. */ private $largeGroupWarning = false; /** @var Template */ private $template; /** @var DatabaseInterface */ private $dbi; /** * @param Template $template Template instance * @param DatabaseInterface $dbi DatabaseInterface instance */ public function __construct($template, DatabaseInterface $dbi) { $this->template = $template; $this->dbi = $dbi; $checkUserPrivileges = new CheckUserPrivileges($this->dbi); $checkUserPrivileges->getPrivileges(); // Save the position at which we are in the database list if (isset($_POST['pos'])) { $this->pos = (int) $_POST['pos']; } elseif (isset($_GET['pos'])) { $this->pos = (int) $_GET['pos']; } if (! isset($this->pos)) { $this->pos = $this->getNavigationDbPos(); } // Get the active node if (isset($_POST['aPath'])) { $this->aPath[0] = $this->parsePath($_POST['aPath']); $this->pos2Name[0] = $_POST['pos2_name'] ?? ''; $this->pos2Value[0] = (int) ($_POST['pos2_value'] ?? 0); if (isset($_POST['pos3_name'])) { $this->pos3Name[0] = $_POST['pos3_name'] ?? ''; $this->pos3Value[0] = (int) $_POST['pos3_value']; } } else { if (isset($_POST['n0_aPath'])) { $count = 0; while (isset($_POST['n' . $count . '_aPath'])) { $this->aPath[$count] = $this->parsePath($_POST['n' . $count . '_aPath']); if (isset($_POST['n' . $count . '_pos2_name'])) { $this->pos2Name[$count] = $_POST['n' . $count . '_pos2_name']; $this->pos2Value[$count] = (int) $_POST['n' . $count . '_pos2_value']; } if (isset($_POST['n' . $count . '_pos3_name'])) { $this->pos3Name[$count] = $_POST['n' . $count . '_pos3_name']; $this->pos3Value[$count] = (int) $_POST['n' . $count . '_pos3_value']; } $count++; } } } if (isset($_POST['vPath'])) { $this->vPath[0] = $this->parsePath($_POST['vPath']); } else { if (isset($_POST['n0_vPath'])) { $count = 0; while (isset($_POST['n' . $count . '_vPath'])) { $this->vPath[$count] = $this->parsePath($_POST['n' . $count . '_vPath']); $count++; } } } if (isset($_POST['searchClause'])) { $this->searchClause = $_POST['searchClause']; } if (isset($_POST['searchClause2'])) { $this->searchClause2 = $_POST['searchClause2']; } // Initialize the tree by creating a root node $node = NodeFactory::getInstance('NodeDatabaseContainer', 'root'); $this->tree = $node; if (! $GLOBALS['cfg']['NavigationTreeEnableGrouping'] || ! $GLOBALS['cfg']['ShowDatabasesNavigationAsTree']) { return; } $this->tree->separator = $GLOBALS['cfg']['NavigationTreeDbSeparator']; $this->tree->separatorDepth = 10000; } /** * Returns the database position for the page selector */ private function getNavigationDbPos(): int { $retval = 0; if (strlen($GLOBALS['db'] ?? '') === 0) { return $retval; } /* * @todo describe a scenario where this code is executed */ if (! $GLOBALS['cfg']['Server']['DisableIS']) { $dbSeparator = $this->dbi->escapeString($GLOBALS['cfg']['NavigationTreeDbSeparator']); $query = 'SELECT (COUNT(DB_first_level) DIV %d) * %d '; $query .= 'from ( '; $query .= ' SELECT distinct SUBSTRING_INDEX(SCHEMA_NAME, '; $query .= " '%s', 1) "; $query .= ' DB_first_level '; $query .= ' FROM INFORMATION_SCHEMA.SCHEMATA '; $query .= " WHERE `SCHEMA_NAME` < '%s' "; $query .= ') t '; return (int) $this->dbi->fetchValue( sprintf( $query, (int) $GLOBALS['cfg']['FirstLevelNavigationItems'], (int) $GLOBALS['cfg']['FirstLevelNavigationItems'], $dbSeparator, $this->dbi->escapeString($GLOBALS['db']) ) ); } $prefixMap = []; if ($GLOBALS['dbs_to_test'] === false) { $handle = $this->dbi->tryQuery('SHOW DATABASES'); if ($handle !== false) { while ($database = $handle->fetchValue()) { if (strcasecmp($database, $GLOBALS['db']) >= 0) { break; } $prefix = strstr($database, $GLOBALS['cfg']['NavigationTreeDbSeparator'], true); if ($prefix === false) { $prefix = $database; } $prefixMap[$prefix] = 1; } } } else { $databases = []; foreach ($GLOBALS['dbs_to_test'] as $db) { $query = "SHOW DATABASES LIKE '" . $db . "'"; $handle = $this->dbi->tryQuery($query); if ($handle === false) { continue; } $databases = array_merge($databases, $handle->fetchAllColumn()); } sort($databases); foreach ($databases as $database) { if (strcasecmp($database, $GLOBALS['db']) >= 0) { break; } $prefix = strstr($database, $GLOBALS['cfg']['NavigationTreeDbSeparator'], true); if ($prefix === false) { $prefix = $database; } $prefixMap[$prefix] = 1; } } $navItems = (int) $GLOBALS['cfg']['FirstLevelNavigationItems']; return (int) floor(count($prefixMap) / $navItems) * $navItems; } /** * Converts an encoded path to a node in string format to an array * * @param string $string The path to parse * * @return array */ private function parsePath($string): array { $path = explode('.', $string); foreach ($path as $key => $value) { $path[$key] = base64_decode($value); } return $path; } /** * Generates the tree structure so that it can be rendered later * * @return Node|bool The active node or false in case of failure, or true: (@see buildPathPart()) */ private function buildPath() { $retval = $this->tree; // Add all databases unconditionally $data = $this->tree->getData('databases', $this->pos, $this->searchClause); $hiddenCounts = $this->tree->getNavigationHidingData(); foreach ($data as $db) { /** @var NodeDatabase $node */ $node = NodeFactory::getInstance('NodeDatabase', $db); if (isset($hiddenCounts[$db])) { $node->setHiddenCount($hiddenCounts[$db]); } $this->tree->addChild($node); } // Whether build other parts of the tree depends // on whether we have any paths in $this->aPath foreach ($this->aPath as $key => $path) { $retval = $this->buildPathPart( $path, $this->pos2Name[$key] ?? '', $this->pos2Value[$key] ?? 0, $this->pos3Name[$key] ?? '', $this->pos3Value[$key] ?? 0 ); } return $retval; } /** * Builds a branch of the tree * * @param array $path A paths pointing to the branch * of the tree that needs to be built * @param string $type2 The type of item being paginated on * the second level of the tree * @param int $pos2 The position for the pagination of * the branch at the second level of the tree * @param string $type3 The type of item being paginated on * the third level of the tree * @param int $pos3 The position for the pagination of * the branch at the third level of the tree * * @return Node|bool The active node or false in case of failure, true if the path contains <= 1 items */ private function buildPathPart(array $path, string $type2, int $pos2, string $type3, int $pos3) { if (count($path) <= 1) { return true; } array_shift($path); // remove 'root' /** @var NodeDatabase|null $db */ $db = $this->tree->getChild($path[0]); if ($db === null) { return false; } $retval = $db; $containers = $this->addDbContainers($db, $type2, $pos2); array_shift($path); // remove db if ((count($path) <= 0 || ! array_key_exists($path[0], $containers)) && count($containers) != 1) { return $retval; } if (count($containers) === 1) { $container = array_shift($containers); } else { $container = $db->getChild($path[0], true); if ($container === null) { return false; } } $retval = $container; if (count($container->children) <= 1) { $dbData = $db->getData($container->realName, $pos2, $this->searchClause2); foreach ($dbData as $item) { switch ($container->realName) { case 'events': $node = NodeFactory::getInstance('NodeEvent', $item); break; case 'functions': $node = NodeFactory::getInstance('NodeFunction', $item); break; case 'procedures': $node = NodeFactory::getInstance('NodeProcedure', $item); break; case 'tables': $node = NodeFactory::getInstance('NodeTable', $item); break; case 'views': $node = NodeFactory::getInstance('NodeView', $item); break; default: break; } if (! isset($node)) { continue; } if ($type2 == $container->realName) { $node->pos2 = $pos2; } $container->addChild($node); } } if (count($path) > 1 && $path[0] !== 'tables') { return false; } array_shift($path); // remove container if (count($path) <= 0) { return $retval; } /** @var NodeTable|null $table */ $table = $container->getChild($path[0], true); if ($table === null) { if (! $db->getPresence('tables', $path[0])) { return false; } $node = NodeFactory::getInstance('NodeTable', $path[0]); if ($type2 == $container->realName) { $node->pos2 = $pos2; } $container->addChild($node); $table = $container->getChild($path[0], true); } $retval = $table ?? false; $containers = $this->addTableContainers($table, $pos2, $type3, $pos3); array_shift($path); // remove table if (count($path) <= 0 || ! array_key_exists($path[0], $containers)) { return $retval; } $container = $table->getChild($path[0], true); $retval = $container ?? false; $tableData = $table->getData($container->realName, $pos3); foreach ($tableData as $item) { switch ($container->realName) { case 'indexes': $node = NodeFactory::getInstance('NodeIndex', $item); break; case 'columns': $node = NodeFactory::getInstance('NodeColumn', $item); break; case 'triggers': $node = NodeFactory::getInstance('NodeTrigger', $item); break; default: break; } if (! isset($node)) { continue; } $node->pos2 = $container->parent->pos2; if ($type3 == $container->realName) { $node->pos3 = $pos3; } $container->addChild($node); } return $retval; } /** * Adds containers to a node that is a table * * References to existing children are returned * if this function is called twice on the same node * * @param NodeTable $table The table node, new containers will be * attached to this node * @param int $pos2 The position for the pagination of * the branch at the second level of the tree * @param string $type3 The type of item being paginated on * the third level of the tree * @param int $pos3 The position for the pagination of * the branch at the third level of the tree * * @return array An array of new nodes */ private function addTableContainers(NodeTable $table, int $pos2, string $type3, int $pos3): array { $retval = []; if ($table->hasChildren(true) == 0) { if ($table->getPresence('columns')) { $retval['columns'] = NodeFactory::getInstance('NodeColumnContainer'); } if ($table->getPresence('indexes')) { $retval['indexes'] = NodeFactory::getInstance('NodeIndexContainer'); } if ($table->getPresence('triggers')) { $retval['triggers'] = NodeFactory::getInstance('NodeTriggerContainer'); } // Add all new Nodes to the tree foreach ($retval as $node) { $node->pos2 = $pos2; if ($type3 == $node->realName) { $node->pos3 = $pos3; } $table->addChild($node); } } else { foreach ($table->children as $node) { if ($type3 == $node->realName) { $node->pos3 = $pos3; } $retval[$node->realName] = $node; } } return $retval; } /** * Adds containers to a node that is a database * * References to existing children are returned * if this function is called twice on the same node * * @param NodeDatabase $db The database node, new containers will be * attached to this node * @param string $type The type of item being paginated on * the second level of the tree * @param int $pos2 The position for the pagination of * the branch at the second level of the tree * * @return array An array of new nodes */ private function addDbContainers(NodeDatabase $db, string $type, int $pos2): array { // Get items to hide $hidden = $db->getHiddenItems('group'); if (! $GLOBALS['cfg']['NavigationTreeShowTables'] && ! in_array('tables', $hidden)) { $hidden[] = 'tables'; } if (! $GLOBALS['cfg']['NavigationTreeShowViews'] && ! in_array('views', $hidden)) { $hidden[] = 'views'; } if (! $GLOBALS['cfg']['NavigationTreeShowFunctions'] && ! in_array('functions', $hidden)) { $hidden[] = 'functions'; } if (! $GLOBALS['cfg']['NavigationTreeShowProcedures'] && ! in_array('procedures', $hidden)) { $hidden[] = 'procedures'; } if (! $GLOBALS['cfg']['NavigationTreeShowEvents'] && ! in_array('events', $hidden)) { $hidden[] = 'events'; } $retval = []; if ($db->hasChildren(true) == 0) { if (! in_array('tables', $hidden) && $db->getPresence('tables')) { $retval['tables'] = NodeFactory::getInstance('NodeTableContainer'); } if (! in_array('views', $hidden) && $db->getPresence('views')) { $retval['views'] = NodeFactory::getInstance('NodeViewContainer'); } if (! in_array('functions', $hidden) && $db->getPresence('functions')) { $retval['functions'] = NodeFactory::getInstance('NodeFunctionContainer'); } if (! in_array('procedures', $hidden) && $db->getPresence('procedures')) { $retval['procedures'] = NodeFactory::getInstance('NodeProcedureContainer'); } if (! in_array('events', $hidden) && $db->getPresence('events')) { $retval['events'] = NodeFactory::getInstance('NodeEventContainer'); } // Add all new Nodes to the tree foreach ($retval as $node) { if ($type == $node->realName) { $node->pos2 = $pos2; } $db->addChild($node); } } else { foreach ($db->children as $node) { if ($type == $node->realName) { $node->pos2 = $pos2; } $retval[$node->realName] = $node; } } return $retval; } /** * Recursively groups tree nodes given a separator * * @param Node $node The node to group or null * to group the whole tree. If * passed as an argument, $node * must be of type CONTAINER */ public function groupTree(?Node $node = null): void { if ($node === null) { $node = $this->tree; } $this->groupNode($node); foreach ($node->children as $child) { $this->groupTree($child); } } /** * Recursively groups tree nodes given a separator * * @param Node $node The node to group */ public function groupNode($node): void { if ($node->type != Node::CONTAINER || ! $GLOBALS['cfg']['NavigationTreeEnableExpansion']) { return; } $separators = []; if (is_array($node->separator)) { $separators = $node->separator; } else { if (strlen($node->separator)) { $separators[] = $node->separator; } } $prefixes = []; if ($node->separatorDepth > 0) { foreach ($node->children as $child) { $prefixPos = false; foreach ($separators as $separator) { $sepPos = mb_strpos((string) $child->name, $separator); if ( $sepPos == false || $sepPos == mb_strlen($child->name) || $sepPos == 0 || ($prefixPos !== false && $sepPos >= $prefixPos) ) { continue; } $prefixPos = $sepPos; } if ($prefixPos !== false) { $prefix = mb_substr($child->name, 0, $prefixPos); if (! isset($prefixes[$prefix])) { $prefixes[$prefix] = 1; } else { $prefixes[$prefix]++; } } //Bug #4375: Check if prefix is the name of a DB, to create a group. foreach ($node->children as $otherChild) { if (! array_key_exists($otherChild->name, $prefixes)) { continue; } $prefixes[$otherChild->name]++; } } //Check if prefix is the name of a DB, to create a group. foreach ($node->children as $child) { if (! array_key_exists($child->name, $prefixes)) { continue; } $prefixes[$child->name]++; } } // It is not a group if it has only one item foreach ($prefixes as $key => $value) { if ($value > 1) { continue; } unset($prefixes[$key]); } $numChildren = count($node->children); // rfe #1634 Don't group if there's only one group and no other items if (count($prefixes) === 1) { $keys = array_keys($prefixes); $key = $keys[0]; if ($prefixes[$key] == $numChildren - 1) { unset($prefixes[$key]); } } if (! count($prefixes)) { return; } /** @var Node[] $groups */ $groups = []; foreach ($prefixes as $key => $value) { // warn about large groups if ($value > 500 && ! $this->largeGroupWarning) { trigger_error( __( 'There are large item groups in navigation panel which ' . 'may affect the performance. Consider disabling item ' . 'grouping in the navigation panel.' ), E_USER_WARNING ); $this->largeGroupWarning = true; } $newChildren = []; foreach ($separators as $separator) { $separatorLength = strlen($separator); // FIXME: this could be more efficient foreach ($node->children as $child) { $keySeparatorLength = mb_strlen((string) $key) + $separatorLength; $nameSubstring = mb_substr((string) $child->name, 0, $keySeparatorLength); if (($nameSubstring != $key . $separator && $child->name != $key) || $child->type != Node::OBJECT) { continue; } $class = get_class($child); $className = substr($class, strrpos($class, '\\') + 1); unset($class); /** @var NodeDatabase $newChild */ $newChild = NodeFactory::getInstance( $className, mb_substr( $child->name, $keySeparatorLength ) ); if ($child instanceof NodeDatabase && $child->getHiddenCount() > 0) { $newChild->setHiddenCount($child->getHiddenCount()); } $newChild->realName = $child->realName; $newChild->icon = $child->icon; $newChild->links = $child->links; $newChild->pos2 = $child->pos2; $newChild->pos3 = $child->pos3; foreach ($child->children as $elm) { $newChild->addChild($elm); } $newChildren[] = [ 'node' => $newChild, 'replaces_name' => $child->name, ]; } } if (count($newChildren) === 0) { continue; } // If the current node is a standard group (not NodeTableContainer, etc.) // and the new group contains all of the current node's children, combine them $class = get_class($node); if (count($newChildren) === $numChildren && substr($class, strrpos($class, '\\') + 1) === 'Node') { $node->name .= $separators[0] . htmlspecialchars((string) $key); $node->realName .= $separators[0] . htmlspecialchars((string) $key); $node->separatorDepth--; foreach ($newChildren as $newChild) { $node->removeChild($newChild['replaces_name']); $node->addChild($newChild['node']); } } else { $groups[$key] = new Node( htmlspecialchars((string) $key), Node::CONTAINER, true ); $groups[$key]->separator = $node->separator; $groups[$key]->separatorDepth = $node->separatorDepth - 1; $groups[$key]->icon = ['image' => 'b_group', 'title' => __('Groups')]; $groups[$key]->pos2 = $node->pos2; $groups[$key]->pos3 = $node->pos3; if ($node instanceof NodeTableContainer || $node instanceof NodeViewContainer) { $groups[$key]->links = [ 'text' => [ 'route' => $node->links['text']['route'], 'params' => array_merge($node->links['text']['params'], ['tbl_group' => $key]), ], 'icon' => [ 'route' => $node->links['icon']['route'], 'params' => array_merge($node->links['icon']['params'], ['tbl_group' => $key]), ], ]; } foreach ($newChildren as $newChild) { $node->removeChild($newChild['replaces_name']); $groups[$key]->addChild($newChild['node']); } } } foreach ($groups as $group) { if (count($group->children) === 0) { continue; } $node->addChild($group); $this->groupNode($group); $group->classes = 'navGroup'; } } /** * Renders a state of the tree, used in light mode when * either JavaScript and/or Ajax are disabled * * @return string HTML code for the navigation tree */ public function renderState(): string { $this->buildPath(); $quickWarp = $this->quickWarp(); $fastFilter = $this->fastFilterHtml($this->tree); $controls = ''; if ($GLOBALS['cfg']['NavigationTreeEnableExpansion']) { $controls = $this->controls(); } $pageSelector = $this->getPageSelector($this->tree); $this->groupTree(); $children = $this->tree->children; usort($children, [ self::class, 'sortNode', ]); $this->setVisibility(); $nodes = $this->renderNodes($children); return $this->template->render('navigation/tree/state', [ 'quick_warp' => $quickWarp, 'fast_filter' => $fastFilter, 'controls' => $controls, 'page_selector' => $pageSelector, 'nodes' => $nodes, ]); } /** * Renders a part of the tree, used for Ajax requests in light mode * * @return string|false HTML code for the navigation tree */ public function renderPath() { $node = $this->buildPath(); if (! is_bool($node)) { $this->groupTree(); $listContent = $this->fastFilterHtml($node); $listContent .= $this->getPageSelector($node); $children = $node->children; usort($children, [ self::class, 'sortNode', ]); $listContent .= $this->renderNodes($children, false); if (! $GLOBALS['cfg']['ShowDatabasesNavigationAsTree']) { $parents = $node->parents(true); $parentName = $parents[0]->realName; } } $hasSearchClause = ! empty($this->searchClause) || ! empty($this->searchClause2); if ($hasSearchClause && ! is_bool($node)) { $results = 0; if (! empty($this->searchClause2)) { if (is_object($node->realParent())) { $results = $node->realParent() ->getPresence($node->realName, $this->searchClause2); } } else { $results = $this->tree->getPresence('databases', $this->searchClause); } $results = sprintf( _ngettext( '%s result found', '%s results found', $results ), $results ); ResponseRenderer::getInstance() ->addJSON('results', $results); } if ($node !== false) { return $this->template->render('navigation/tree/path', [ 'has_search_results' => ! empty($this->searchClause) || ! empty($this->searchClause2), 'list_content' => $listContent ?? '', 'is_tree' => $GLOBALS['cfg']['ShowDatabasesNavigationAsTree'], 'parent_name' => $parentName ?? '', ]); } return false; } /** * Renders the parameters that are required on the client * side to know which page(s) we will be requesting data from * * @param Node $node The node to create the pagination parameters for * * @return array<string, string> */ private function getPaginationParamsHtml(Node $node): array { $renderDetails = []; $paths = $node->getPaths(); if (isset($paths['aPath_clean'][2])) { $renderDetails['position'] = 'pos2_nav'; $renderDetails['data_name'] = (string) $paths['aPath_clean'][2]; $renderDetails['data_value'] = (string) $node->pos2; } if (isset($paths['aPath_clean'][4])) { $renderDetails['position'] = 'pos3_nav'; $renderDetails['data_name'] = (string) $paths['aPath_clean'][4]; $renderDetails['data_value'] = (string) $node->pos3; } return $renderDetails; } /** * Finds whether given tree matches this tree. * * @param array $tree Tree to check * @param array $paths Paths to check */ private function findTreeMatch(array $tree, array $paths): bool { $match = false; foreach ($tree as $path) { $match = true; foreach ($paths as $key => $part) { if (! isset($path[$key]) || $part != $path[$key]) { $match = false; break; } } if ($match) { break; } } return $match; } /** * @param Node[] $children */ private function renderNodes(array $children, bool $hasFirstClass = true): string { $nodes = ''; for ($i = 0, $nbChildren = count($children); $i < $nbChildren; $i++) { if ($i === 0) { $nodes .= $this->renderNode($children[0], $hasFirstClass ? 'first' : ''); } elseif ($i + 1 !== $nbChildren) { $nodes .= $this->renderNode($children[$i]); } else { $nodes .= $this->renderNode($children[$i], 'last'); } } return $nodes; } /** * Renders a single node or a branch of the tree * * @param Node $node The node to render * @param string $class An additional class for the list item * * @return string HTML code for the tree node or branch */ private function renderNode(Node $node, string $class = ''): string { $controlButtons = ''; $paths = $node->getPaths(); $nodeIsContainer = $node->type === Node::CONTAINER; $liClasses = ''; // Whether to show the node in the tree (true for all nodes but root) // If false, the node's children will still be shown, but as children of the node's parent $showNode = $node->hasSiblings() || count($node->parents(false, true)) > 0; // Don't show the 'Tables' node under each database unless it has 'Views', etc. as a sibling if ($node instanceof NodeTableContainer && ! $node->hasSiblings()) { $showNode = false; } if ($showNode) { $response = ResponseRenderer::getInstance(); if ($nodeIsContainer && count($node->children) === 0 && ! $response->isAjax()) { return ''; } $liClasses = trim($class . ' ' . $node->classes); $sterile = ['events', 'triggers', 'functions', 'procedures', 'views', 'columns', 'indexes']; $parentName = ''; $parents = $node->parents(false, true); if (count($parents)) { $parentName = $parents[0]->realName; } // if node name itself is in sterile, then allow $nodeIsGroup = $node->isGroup || (! in_array($parentName, $sterile) && ! $node->isNew) || (in_array($node->realName, $sterile) && ! empty($node->children)); if ($nodeIsGroup) { $match = $this->findTreeMatch($this->vPath, $paths['vPath_clean']); $linkClasses = $node->getCssClasses($match); if ($GLOBALS['cfg']['ShowDatabasesNavigationAsTree'] || $parentName !== 'root') { $nodeIcon = $node->getIcon($match); } } $paginationParams = $this->getPaginationParamsHtml($node); $haveAjax = [ 'functions', 'procedures', 'events', 'triggers', 'indexes', ]; $parent = $node->parents(false, true); $isNewView = $parent[0]->realName === 'views' && $node->isNew === true; $linkHasAjaxClass = $parent[0]->type == Node::CONTAINER && (in_array($parent[0]->realName, $haveAjax) || $isNewView); if (! $node->isGroup) { $args = []; $parents = $node->parents(true); foreach ($parents as $parent) { if (! isset($parent->urlParamName)) { continue; } $args[$parent->urlParamName] = $parent->realName; } $iconLinks = []; $iconLinks[] = [ 'route' => $node->links['icon']['route'], 'params' => array_merge( $node->links['icon']['params'], array_intersect_key($args, $node->links['icon']['params']) ), 'is_ajax' => $linkHasAjaxClass, 'image' => $node->icon['image'], 'title' => $node->icon['title'], ]; if (isset($node->links['second_icon'], $node->secondIcon)) { $iconLinks[] = [ 'route' => $node->links['second_icon']['route'], 'params' => array_merge( $node->links['second_icon']['params'], array_intersect_key($args, $node->links['second_icon']['params']) ), 'is_ajax' => $linkHasAjaxClass, 'image' => $node->secondIcon['image'], 'title' => $node->secondIcon['title'], ]; } $textLink = [ 'route' => $node->links['text']['route'], 'params' => array_merge( $node->links['text']['params'], array_intersect_key($args, $node->links['text']['params']) ), 'is_ajax' => $linkHasAjaxClass, 'title' => $node->links['title'] ?? $node->title ?? '', ]; } $controlButtons .= $node->getHtmlForControlButtons(); $wrap = true; } else { $node->visible = true; $wrap = false; $paginationParams = $this->getPaginationParamsHtml($node); } $children = $node->children; usort($children, [self::class, 'sortNode']); $buffer = ''; $extraClass = ''; for ($i = 0, $nbChildren = count($children); $i < $nbChildren; $i++) { if ($i + 1 == $nbChildren) { $extraClass = ' last'; } $buffer .= $this->renderNode($children[$i], $children[$i]->classes . $extraClass); } if (! empty($buffer)) { $recursiveHtml = $this->fastFilterHtml($node); $recursiveHtml .= $this->getPageSelector($node); $recursiveHtml .= $buffer; } return $this->template->render('navigation/tree/node', [ 'node' => $node, 'class' => $class, 'show_node' => $showNode, 'has_siblings' => $node->hasSiblings(), 'li_classes' => $liClasses, 'control_buttons' => $controlButtons, 'node_is_container' => $nodeIsContainer, 'has_second_icon' => isset($node->secondIcon), 'recursive' => ['html' => $recursiveHtml ?? '', 'has_wrapper' => $wrap, 'is_hidden' => ! $node->visible], 'icon_links' => $iconLinks ?? [], 'text_link' => $textLink ?? [], 'pagination_params' => $paginationParams, 'node_is_group' => $nodeIsGroup ?? false, 'link_classes' => $linkClasses ?? '', 'paths' => ['a_path' => $paths['aPath'] ?? '', 'v_path' => $paths['vPath'] ?? '', 'pos' => $this->pos], 'node_icon' => $nodeIcon ?? '', ]); } /** * Renders a database select box like the pre-4.0 navigation panel * * @return string HTML code */ public function renderDbSelect(): string { $this->buildPath(); $quickWarp = $this->quickWarp(); $this->tree->isGroup = false; // Provide for pagination in database select $listNavigator = Generator::getListNavigator( $this->tree->getPresence('databases', ''), $this->pos, ['server' => $GLOBALS['server']], Url::getFromRoute('/navigation'), 'frame_navigation', $GLOBALS['cfg']['FirstLevelNavigationItems'], 'pos', ['dbselector'] ); $children = $this->tree->children; $selected = $GLOBALS['db']; $options = []; foreach ($children as $node) { if ($node->isNew) { continue; } $paths = $node->getPaths(); if (! isset($node->links['text'])) { continue; } $title = $node->links['title'] ?? ''; $options[] = [ 'title' => $title, 'name' => $node->realName, 'data' => [ 'apath' => $paths['aPath'], 'vpath' => $paths['vPath'], 'pos' => $this->pos, ], 'isSelected' => $node->realName === $selected, ]; } $children = $this->tree->children; usort($children, [ self::class, 'sortNode', ]); $this->setVisibility(); $nodes = $this->renderNodes($children); $databaseUrl = Util::getScriptNameForOption($GLOBALS['cfg']['DefaultTabDatabase'], 'database'); return $this->template->render('navigation/tree/database_select', [ 'quick_warp' => $quickWarp, 'list_navigator' => $listNavigator, 'server' => $GLOBALS['server'], 'options' => $options, 'nodes' => $nodes, 'database_url' => $databaseUrl, ]); } /** * Makes some nodes visible based on the which node is active */ private function setVisibility(): void { foreach ($this->vPath as $path) { $node = $this->tree; foreach ($path as $value) { $child = $node->getChild($value); if ($child === null) { continue; } $child->visible = true; $node = $child; } } } /** * Generates the HTML code for displaying the fast filter for tables * * @param Node $node The node for which to generate the fast filter html * * @return string LI element used for the fast filter */ private function fastFilterHtml(Node $node): string { $filterDbMin = (int) $GLOBALS['cfg']['NavigationTreeDisplayDbFilterMinimum']; $filterItemMin = (int) $GLOBALS['cfg']['NavigationTreeDisplayItemFilterMinimum']; $urlParams = []; $isRootNode = $node === $this->tree && $this->tree->getPresence() >= $filterDbMin; if ($isRootNode) { $urlParams = ['pos' => 0]; } else { $nodeIsContainer = $node->type === Node::CONTAINER; $nodeIsSpecial = in_array($node->realName, self::SPECIAL_NODE_NAMES, true); /** @var Node $realParent */ $realParent = $node->realParent(); if ( ($nodeIsContainer && $nodeIsSpecial) && method_exists($realParent, 'getPresence') && $realParent->getPresence($node->realName) >= $filterItemMin ) { $paths = $node->getPaths(); $urlParams = [ 'pos' => $this->pos, 'aPath' => $paths['aPath'], 'vPath' => $paths['vPath'], 'pos2_name' => $node->realName, 'pos2_value' => 0, ]; } } return $this->template->render('navigation/tree/fast_filter', [ 'url_params' => $urlParams, 'is_root_node' => $isRootNode, ]); } /** * Creates the code for displaying the controls * at the top of the navigation tree * * @return string HTML code for the controls */ private function controls(): string { // always iconic $showIcon = true; $showText = false; $collapseAll = Generator::getNavigationLink( '#', $showText, __('Collapse all'), $showIcon, 's_collapseall', 'pma_navigation_collapse' ); $syncImage = 's_unlink'; $title = __('Link with main panel'); if ($GLOBALS['cfg']['NavigationLinkWithMainPanel']) { $syncImage = 's_link'; $title = __('Unlink from main panel'); } $unlink = Generator::getNavigationLink('#', $showText, $title, $showIcon, $syncImage, 'pma_navigation_sync'); return $this->template->render('navigation/tree/controls', [ 'collapse_all' => $collapseAll, 'unlink' => $unlink, ]); } /** * Generates the HTML code for displaying the list pagination * * @param Node $node The node for whose children the page * selector will be created */ private function getPageSelector(Node $node): string { $retval = ''; if ($node === $this->tree) { $retval .= Generator::getListNavigator( $this->tree->getPresence('databases', $this->searchClause), $this->pos, ['server' => $GLOBALS['server']], Url::getFromRoute('/navigation'), 'frame_navigation', $GLOBALS['cfg']['FirstLevelNavigationItems'], 'pos', ['dbselector'] ); } else { if ($node->type == Node::CONTAINER && ! $node->isGroup) { $paths = $node->getPaths(); $level = isset($paths['aPath_clean'][4]) ? 3 : 2; $urlParams = [ 'aPath' => $paths['aPath'], 'vPath' => $paths['vPath'], 'pos' => $this->pos, 'server' => $GLOBALS['server'], 'pos2_name' => $paths['aPath_clean'][2], ]; if ($level == 3) { $pos = $node->pos3; $urlParams['pos2_value'] = $node->pos2; $urlParams['pos3_name'] = $paths['aPath_clean'][4]; } else { $pos = $node->pos2; } /** @var Node $realParent */ $realParent = $node->realParent(); $num = $realParent->getPresence($node->realName, $this->searchClause2); $retval .= Generator::getListNavigator( $num, $pos, $urlParams, Url::getFromRoute('/navigation'), 'frame_navigation', $GLOBALS['cfg']['MaxNavigationItems'], 'pos' . $level . '_value' ); } } return $retval; } /** * Called by usort() for sorting the nodes in a container * * @param Node $a The first element used in the comparison * @param Node $b The second element used in the comparison * * @return int See strnatcmp() and strcmp() */ public static function sortNode(Node $a, Node $b): int { if ($a->isNew) { return -1; } if ($b->isNew) { return 1; } if ($GLOBALS['cfg']['NaturalOrder']) { return strnatcasecmp($a->name, $b->name); } return strcasecmp($a->name, $b->name); } /** * Display quick warp links, contain Recents and Favorites * * @return string HTML code */ private function quickWarp(): string { $renderDetails = []; if ($GLOBALS['cfg']['NumRecentTables'] > 0) { $renderDetails['recent'] = RecentFavoriteTable::getInstance('recent')->getHtml(); } if ($GLOBALS['cfg']['NumFavoriteTables'] > 0) { $renderDetails['favorite'] = RecentFavoriteTable::getInstance('favorite')->getHtml(); } return $this->template->render('navigation/tree/quick_warp', $renderDetails); } }