当前位置：首页 > PHP

php 实现菜单树

2026-02-16 06:40:47PHP

PHP 实现菜单树的方法

在 PHP 中实现菜单树通常涉及递归或迭代的方式处理层级数据，以下是一种常见的实现方法。

数据库设计

创建一个表存储菜单数据，通常包含以下字段：

id：菜单项的唯一标识
parent_id：父菜单项的 ID，顶级菜单的 parent_id 为 0 或 NULL
name：菜单名称
url：菜单链接
sort：排序字段（可选）

CREATE TABLE `menu` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `parent_id` int(11) DEFAULT NULL,
  `name` varchar(50) NOT NULL,
  `url` varchar(255) DEFAULT NULL,
  `sort` int(11) DEFAULT 0,
  PRIMARY KEY (`id`)
);

递归实现菜单树

从数据库获取所有菜单数据后，使用递归函数构建树形结构：

function buildTree(array $elements, $parentId = 0) {
    $branch = array();

    foreach ($elements as $element) {
        if ($element['parent_id'] == $parentId) {
            $children = buildTree($elements, $element['id']);
            if ($children) {
                $element['children'] = $children;
            }
            $branch[] = $element;
        }
    }

    return $branch;
}

// 从数据库获取所有菜单数据
$menuItems = $db->query("SELECT * FROM menu ORDER BY sort ASC")->fetchAll(PDO::FETCH_ASSOC);

// 构建菜单树
$menuTree = buildTree($menuItems);

迭代实现菜单树

对于大数据量，递归可能导致性能问题，可以使用引用方式迭代构建：

php 实现菜单树

function buildTreeIterative(array $elements) {
    $tree = array();
    $references = array();

    foreach ($elements as &$element) {
        $references[$element['id']] = &$element;
        $element['children'] = array();
    }

    foreach ($elements as &$element) {
        if ($element['parent_id'] && isset($references[$element['parent_id']])) {
            $references[$element['parent_id']]['children'][] = &$element;
        } else {
            $tree[] = &$element;
        }
    }

    return $tree;
}

$menuTree = buildTreeIterative($menuItems);

渲染菜单树

构建好的树形结构可以通过递归函数渲染为 HTML：

function renderMenu($menuTree) {
    $html = '<ul>';

    foreach ($menuTree as $item) {
        $html .= '<li>';
        $html .= '<a href="' . htmlspecialchars($item['url']) . '">';
        $html .= htmlspecialchars($item['name']);
        $html .= '</a>';

        if (!empty($item['children'])) {
            $html .= renderMenu($item['children']);
        }

        $html .= '</li>';
    }

    $html .= '</ul>';
    return $html;
}

echo renderMenu($menuTree);

使用缓存优化

对于不经常变动的菜单，可以考虑使用缓存：

php 实现菜单树

function getMenuTree() {
    $cacheKey = 'menu_tree';
    $menuTree = apc_fetch($cacheKey);

    if ($menuTree === false) {
        $menuItems = $db->query("SELECT * FROM menu ORDER BY sort ASC")->fetchAll(PDO::FETCH_ASSOC);
        $menuTree = buildTree($menuItems);
        apc_store($cacheKey, $menuTree, 3600); // 缓存1小时
    }

    return $menuTree;
}

使用 ORM 实现

如果使用 Laravel 等框架，可以利用其 ORM 和关系功能：

// Menu 模型
class Menu extends Model {
    public function children() {
        return $this->hasMany(Menu::class, 'parent_id')->orderBy('sort');
    }

    public static function tree() {
        return static::with('children')->whereNull('parent_id')->orderBy('sort')->get();
    }
}

// 使用
$menuTree = Menu::tree();

前端交互增强

可以结合 JavaScript 实现动态效果：

<ul class="menu">
    <?php foreach ($menuTree as $item): ?>
    <li>
        <a href="<?= htmlspecialchars($item['url']) ?>">
            <?= htmlspecialchars($item['name']) ?>
        </a>
        <?php if (!empty($item['children'])): ?>
        <ul>
            <?php foreach ($item['children'] as $child): ?>
            <li>
                <a href="<?= htmlspecialchars($child['url']) ?>">
                    <?= htmlspecialchars($child['name']) ?>
                </a>
            </li>
            <?php endforeach ?>
        </ul>
        <?php endif ?>
    </li>
    <?php endforeach ?>
</ul>

<script>
$(document).ready(function() {
    $('.menu li').has('ul').addClass('has-submenu');
    $('.menu li.has-submenu > a').click(function(e) {
        e.preventDefault();
        $(this).parent().toggleClass('open');
    });
});
</script>