如何在 PHP 包含文件中动态排除当前页面对应的导航项-php教程-PHP中文网

如何在 PHP 包含文件中动态排除当前页面对应的导航项

本文介绍如何通过 PHP 动态控制 include() 的执行时机，实现在侧边栏（如 aside.php）中自动隐藏当前页面对应的导航链接，无需额外语言或框架，纯 PHP 即可实现。

本文介绍如何通过 php 动态控制 `include()` 的执行时机，实现在侧边栏（如 `aside.php`）中自动隐藏当前页面对应的导航链接，无需额外语言或框架，纯 php 即可实现。

在构建多页面网站时，常使用统一加载侧边栏导航，以保证结构一致性和维护便利性。但若侧边栏中包含指向当前页面的链接（例如在 privacy.php 中仍显示“隐私政策”按钮），不仅冗余，还可能引发 UX 问题（如重复点击、视觉混淆）。理想方案是：让 aside.php 智能识别当前请求路径，并跳过渲染与之匹配的菜单项。

最简洁可靠的实现方式，是在 包含动作前进行条件判断，而非在 aside.php 内部做逻辑处理——这样既保持 aside.php 的纯粹性（专注展示），又提升主页面的可控性与可读性。

✅ 推荐方案：在 include 外层加路由过滤逻辑

将原本简单的 include 替换为带路径判断的条件语句：

<?php // 解析当前请求路径（去除查询参数和锚点，仅保留基础 URI）
$uriPath = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
$currentPage = trim($uriPath, '/'); // 如 '/contact' → 'contact'；'/' → 空字符串，可设为 'home'

// 定义需在对应页面中隐藏的导航项（键名即页面标识符）
$excludeOnPages = [
    'privacy' => ['privacy'],
    'contact' => ['contact'],
    'about-us' => ['about-us'],
    ''        => ['home'] // 首页可映射为 'home'
];

// 获取当前页面标识（支持 .php 后缀自动剥离）
$baseName = pathinfo($currentPage, PATHINFO_FILENAME) ?: $currentPage;

// 若当前页面有定义需排除的项，则不包含整个 aside.php
if (!isset($excludeOnPages[$baseName])) {
    include('aside.php');
}
?>

? 说明：此写法比原始答案中 explode('?', ...) 更健壮——它使用 parse_url() 正确分离路径与查询参数，并通过 pathinfo() 兼容 contact.php 和 contact/ 等常见 URL 形式。

btpanel phpsite 宝塔面板PHP网站
宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

? 进阶建议：让 aside.php 本身支持上下文感知（更灵活）

若未来需在侧边栏内做更细粒度控制（例如仅隐藏某一项，而非整个 sidebar），可在 include 时传入变量：

<?php $currentPage = pathinfo($_SERVER['REQUEST_URI'], PATHINFO_FILENAME) ?: 'home';
include('aside.php');
?>

然后在 aside.php 开头声明接收变量（PHP 变量作用域允许）：

<?php // aside.php —— 支持上下文感知的侧边栏
if (!isset($currentPage)) {
    $currentPage = 'unknown';
}

$navItems = [
    ['id' => 'home',     'label' => '首页',      'url' => '/'],
    ['id' => 'contact',  'label' => '联系我们',  'url' => '/contact.php'],
    ['id' => 'privacy',  'label' => '隐私政策',  'url' => '/privacy.php'],
    ['id' => 'about-us', 'label' => '关于我们',  'url' => '/about-us.php']
];
?>

<aside><nav><ul>
<?php foreach ($navItems as $item): ?><?php if ($item['id'] !== $currentPage): ?><li><a href="<?=%20htmlspecialchars(%24item['url'])%20?>">= htmlspecialchars($item['label']) ?></a></li>
                <?php endif; ?><?php endforeach; ?>
</ul></nav></aside>

✅ 优势：

单一 aside.php 文件适配所有页面；
自动转义输出，防止 XSS；
易扩展（增删菜单项只需修改 $navItems 数组）；
逻辑清晰，符合关注点分离原则。

⚠️ 注意事项

永远校验并过滤 $_SERVER['REQUEST_URI']：不可直接拼接进 HTML 或 SQL，务必使用 htmlspecialchars()、parse_url() 等函数防御注入；
避免硬编码路径数组：生产环境建议将导航配置抽离为 JSON 或配置类；
注意重写规则影响：若使用 Apache mod_rewrite 或 Nginx 伪静态，确保 REQUEST_URI 反映的是用户实际访问路径；
缓存兼容性：该方案基于 PHP 运行时判断，与 OPcache、页面级缓存兼容，无需特殊配置。

通过以上任一方式，你都能用原生 PHP 实现“智能侧边栏”——无需 JavaScript、无需额外框架，轻量、安全、可维护。