menu_get_item

Versions
4.7 – 5: menu_get_item($mid, $path = NULL, $reset = FALSE)
6 – 7: menu_get_item($path = NULL, $router_item = NULL)

Get a router item.

Parameters

$path The path, for example node/5. The function will find the corresponding node/% item and return that.

$router_item Internal use only.

Return value

The router item, an associate array corresponding to one row in the menu_router table. The value of key map holds the loaded objects. The value of key access is TRUE if the current user can access this page. The values for key title, page_arguments, access_arguments will be filled in based on the database values and the objects loaded.

▸ 14 functions call menu_get_item()

▾ 14 functions call menu_get_item()

menu_execute_active_handler in includes/menu.inc: Execute the page callback associated with the current path
menu_get_active_breadcrumb in includes/menu.inc: Get the breadcrumb for the current page, as determined by the active trail.
menu_get_object in includes/menu.inc: Get a loaded object from a router item.
menu_local_tasks in includes/menu.inc: Collects the local tasks (tabs) for a given level.
menu_reset_item in modules/menu/menu.module: Reset a system-defined menu item.
menu_set_active_trail in includes/menu.inc: Sets or gets the active trail (path to root menu root) of the current page.
menu_set_item in includes/menu.inc: Replaces the statically cached item for a given path.
menu_tree_page_data in includes/menu.inc: Get the data structure representing a named menu tree, based on the current page.
menu_valid_path in includes/menu.inc: Validates the path of a menu link being created or edited.
node_add_page in modules/node/node.pages.inc
path_admin_form_validate in modules/path/path.admin.inc: Verify that a new URL alias is valid
system_admin_menu_block_page in modules/system/system.admin.inc: Provide a single block from the administration menu as a page. This function is often a destination for these blocks. For example, 'admin/content/types' needs to have a destination to be valid in the Drupal menu system, but too much...
system_logging_overview in modules/system/system.admin.inc: Menu callback; Menu page for the various logging options.
system_settings_overview in modules/system/system.admin.inc: Menu callback; displays a module's settings page.

Code

includes/menu.inc, line 301

<?php
function menu_get_item($path = NULL, $router_item = NULL) {
  static $router_items;
  if (!isset($path)) {
    $path = $_GET['q'];
  }
  if (isset($router_item)) {
    $router_items[$path] = $router_item;
  }
  if (!isset($router_items[$path])) {
    $original_map = arg(NULL, $path);
    $parts = array_slice($original_map, 0, MENU_MAX_PARTS);
    list($ancestors, $placeholders) = menu_get_ancestors($parts);

    if ($router_item = db_fetch_array(db_query_range('SELECT * FROM {menu_router} WHERE path IN ('. implode (',', $placeholders) .') ORDER BY fit DESC', $ancestors, 0, 1))) {
      $map = _menu_translate($router_item, $original_map);
      if ($map === FALSE) {
        $router_items[$path] = FALSE;
        return FALSE;
      }
      if ($router_item['access']) {
        $router_item['map'] = $map;
        $router_item['page_arguments'] = array_merge(menu_unserialize($router_item['page_arguments'], $map), array_slice($map, $router_item['number_parts']));
      }
    }
    $router_items[$path] = $router_item;
  }
  return $router_items[$path];
}
?>