PHP include 和 require 语句

最新推荐文章于 2025-05-04 21:21:45 发布

her_boy

最新推荐文章于 2025-05-04 21:21:45 发布

阅读量302

点赞数

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/her_boy/article/details/89034573

本文详细介绍了PHP中include与require语句的使用方法及其区别，包括语法、应用场景及错误处理方式。通过实例展示了如何有效利用这些语句来提高代码复用性和维护性。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

PHP include 和 require 语句

在 PHP 中，您可以在服务器执行 PHP 文件之前在该文件中插入一个文件的内容。
include 和 require 语句用于在执行流中插入写在其他文件中的有用的代码。
include 和 require 除了处理错误的方式不同之外，在其他方面都是相同的：

require 生成一个致命错误（E_COMPILE_ERROR），在错误发生后脚本会停止执行。
include生成一个警告（E_WARNING），在错误发生后脚本会继续执行。

因此，如果您希望继续执行，并向用户输出结果，即使包含文件已丢失，那么请使用 include。否则，在框架、CMS 或者复杂的 PHP 应用程序编程中，请始终使用 require 向执行流引用关键文件。这有助于提高应用程序的安全性和完整性，在某个关键文件意外丢失的情况下。
包含文件省去了大量的工作。这意味着您可以为所有网页创建标准页头、页脚或者菜单文件。然后，在页头需要更新时，您只需更新这个页头包含文件即可。

语法

include 'filename';
 或者
 require 'filename';

提示：对于 include，在执行文件时每次都要进行读取和评估；而对于 require，文件只处理一次。

PHP include 和 require 语句

基础实例

假设您有一个标准的页头文件，名为 “header.php”。如需在页面中引用这个页头文件，请使用 include/require：

<html>
 <body>

 <?php include 'header.php'; ?>
 <h1>Welcome to my home page!</h1>
 <p>Some text.</p>

 </body>
 </html>

实例 2

假设我们有一个在所有页面中使用的标准菜单文件。
“menu.php”:

echo '<a href="/default.php">Home</a>
 <a href="/tutorials.php">Tutorials</a>
 <a href="/references.php">References</a>
 <a href="/examples.php">Examples</a> 
 <a href="/about.php">About Us</a> 
 <a href="/contact.php">Contact Us</a>';

网站中的所有页面均应引用该菜单文件。以下是具体的做法：

<html>
<body>

<div class="leftmenu">
<?php include 'menu.php'; ?>
</div>

<h1>Welcome to my home page.</h1>
<p>Some text.</p>

</body>
</html>

实例 3

假设我们有一个定义变量的包含文件（“vars.php”）：

<?php
 $color='red';
 $car='BMW';
 ?>

这些变量可用在调用文件中：

<html>
<body>

<h1>Welcome to my home page.</h1>
<?php include 'vars.php';
echo "I have a $color $car"; // I have a red BMW
?>

</body>
</html>

一、使用语法和简介

1、include()
语法：include(/path/to/filename)
include()语句将在其被调用的位置处包含一个文件。包含一个文件与在该语句所在位置复制制定文件的数据具有相同内容的效果。
使用include()时可以忽略括号。

可以根据条件来执行include()语句。在条件语句中使用include()有个怪现象，它必须包围在语句块大括号中，或者用其他语句包围符括起来。

2、include_once()
语法：include_once(filename)

include_once() 语句在脚本执行期间包含并运行指定文件。此行为和 include() 语句类似，唯一区别是include_once()会先判断一下这个文件在之前是否已经被包含过，如已经包含，则忽略本次包含。
include_once() 应该用于嵌套包含的情况下，想确保它只被包含一次以避免函数重定义，变量重新赋值等问题。

小结：include_once()函数的作用与include相同，不过它会首先验证是否已经包含了该文件。如果已经包含，则不再执行include_once。否则，则必须包含该文件。除了这一点与include完全相同。

3、require()
语法：require(filename)
require()在很大程度上与include相同，都是将一个模板文件包含到require调用坐在的位置。
require和include之间有两点重要的区别。首先，无论require的位置如何，制定文件都将包含到出现require的脚本中。例如，即使require放在计算结果为假的if语句中，依然会包含指定文件。
第二个重要的区别是：require出错时，脚本将停止运行，而在使用include的情况下，脚本将继续执行。

4、require_once()
语法：require_once(filename)
require_once() 语句在脚本执行期间包含并运行指定文件。此行为和 require() 语句类似，唯一区别是require_once()会先判断一下这个文件在之前是否已经被包含过，如已经包含，则忽略本次包含。
require_once() 应该用于嵌套包含的情况下，想确保它只被包含一次以避免函数重定义，变量重新赋值等问题。

小结：随着网站越来越大，可能会出现重复包含某些文件。这也许不是问题，但又是修改了所包含文件的变量后，却由于后面再次包含原来的文件而被覆盖，可能不希望出现这种情况。还可能出现另一个问题，即所包含文件中函数名的冲突。使用require_once就可以解决这些问题。
require_once函数确保文件只包含一次。在遇到require_once后，后面再试图包含相同的文件时将被忽略。

二、区别总结

1、include()与require()语句区别。
两者区别：这两种结构除了在如何处理失败之外完全一样。
include() 产生一个警告，脚本会继续运行。
require() 则导致一个致命错误，脚本会停止运行。

换句话说，如果想在遇到丢失文件或遇到错误时停止处理页面就用 require()。如果想在遇到错误时继续处理页面就用 include()。
注意在 PHP 4.3.5 之前，包含文件中的语法错误不会导致程序停止，但从此版本之后会。

2、include_once()、require_once()与include()、require()的区别
include_once()和require_once()一样，应该用于在脚本执行期间同一个文件有可能被包含超过一次的情况下，想确保它只被包含一次以避免函数重定义，变量重新赋值等问题。这就是include_once()和require_once()与include() 和require()的主要区别。