PHP require_once 关键词

定义和用法

require_once 关键字用于从另一个文件中嵌入 PHP 代码。如果找不到该文件,将抛出一个致命错误,并且程序会停止。如果该文件之前已经被包含过,那么这个语句将不会再次包含它。

相关页面

参考手册:require 关键词

参考手册:include 关键词

参考手册:include_once 关键词

教程:PHP 包含文件

实例

使用 require_once 将页脚添加到页面中:

<!DOCTYPE html>
<html>
<body>

<h1>Welcome to my home page!</h1>
<p>Some text.</p>
<p>Some more text.</p>
<?php require_once 'footer.php';?>

</body>
</html>

在这个例子中,require_once 'footer.php'; 语句将尝试包含名为 footer.php 的文件。如果该文件存在并且可访问,它的内容将被嵌入到当前页面的这个位置。如果 footer.php 文件不存在,将抛出一个致命错误,并且脚本执行将停止。与 require 不同的是,如果 footer.php 已经在当前脚本或包含链中被包含过,require_once 将确保它不会被再次包含,从而避免了重复的代码和潜在的冲突。这通常用于将常见元素(如页眉、页脚或侧边栏)包含到多个页面中,以实现代码重用和更易于维护的网站结构。