
本文介绍如何使用 php 的include或 require 语句,在不依赖javaScript 的情况下,实现跨多个页面的共享导航栏。通过将导航栏代码片段提取到单独的文件中,并在需要它的页面中使用 PHP 引入,可以避免重复编写和维护导航栏代码,提高开发效率。
在构建网站时,通常需要在多个页面上显示相同的导航栏。如果每个页面都包含完整的导航栏代码,那么当需要修改导航栏时,就必须修改所有页面,这非常繁琐且容易出错。使用 javascript 可以解决这个问题,但有时我们希望网站在禁用 JavaScript 的环境下也能正常工作。本文介绍一种使用 PHP 的 include 或 require 语句来实现跨页面共享导航栏的方法,无需编写任何 JavaScript 代码。
实现原理
核心思想是将导航栏的 html 代码片段提取到一个单独的文件中(例如 navbar.php),然后在需要显示导航栏的页面中使用 PHP 的 include 或 require 语句将该文件包含进来。这样,当需要修改导航栏时,只需修改 navbar.php 文件,所有包含该文件的页面都会自动更新。
具体步骤
-
创建导航栏文件: 创建一个名为 navbar.php 的文件,并将导航栏的 HTML 代码放入其中。
立即学习“PHP 免费学习笔记(深入)”;
<!-- navbar.php --> <nav> <ul> <li><a href="index.php"> 首页 </a></li> <li><a href="about.php"> 关于我们 </a></li> <li><a href="contact.php"> 联系我们 </a></li> </ul> </nav> -
在需要显示导航栏的页面中引入导航栏文件: 在需要显示导航栏的每个页面中,使用 include 或 require 语句引入 navbar.php 文件。
<!-- index.php --> <!DOCTYPE html> <html> <head> <title> 首页 </title> </head> <body> <?php include 'navbar.php'; ?> <h1> 欢迎来到首页 </h1> <p> 这是首页的内容。</p> </body> </html><!-- about.php --> <!DOCTYPE html> <html> <head> <title> 关于我们 </title> </head> <body> <?php include 'navbar.php'; ?> <h1> 关于我们 </h1> <p> 这是关于我们的内容。</p> </body> </html>
include 和 require 的 区别
include 和 require 都可以用于包含文件,但它们在处理错误的方式上有所不同:
- include: 如果包含的文件不存在或发生错误,include 会发出一个警告 (warning),但脚本会继续执行。
- require: 如果包含的文件不存在或发生错误,require 会发出一个致命错误 (fatal Error),脚本会停止执行。
一般来说,如果被包含的文件是程序运行所必需的,应该使用 require;如果被包含的文件不是必需的,可以使用 include。在本例中,导航栏通常是网站的重要组成部分,因此建议使用 require。
示例代码
以下是一个完整的示例,展示了如何使用 PHP 实现跨页面共享导航栏:
navbar.php:
<nav> <ul> <li><a href="index.php"> 首页 </a></li> <li><a href="about.php">about</a></li> <li><a href="contact.php">contact</a></li> </ul> </nav>
index.php:
<!DOCTYPE html> <html> <head> <title> 首页 </title> </head> <body> <?php require 'navbar.php'; ?> <h1>Welcome to the homepage</h1> <p>This is the content of the homepage.</p> </body> </html>
about.php:
<!DOCTYPE html> <html> <head> <title> 关于我们 </title> </head> <body> <?php require 'navbar.php'; ?> <h1>About Us</h1> <p>This is the content of the about page.</p> </body> </html>
注意事项
- 确保 PHP 环境已经正确配置。
- navbar.php 文件和包含它的页面需要在同一个服务器上。
- 如果 navbar.php 文件不在当前目录下,需要提供正确的路径。例如 <?php include ‘includes/navbar.php’; ?>。
- 为了代码的可维护性,建议将导航栏的 HTML 代码格式化,并添加适当的注释。
总结
通过使用 PHP 的 include 或 require 语句,可以轻松实现跨多个页面的共享导航栏,而无需编写任何 JavaScript 代码。这种方法不仅可以提高开发效率,还可以使网站在禁用 JavaScript 的环境下也能正常工作。这种方法同样适用于页脚、侧边栏等需要在多个页面上共享的内容。


