介绍

正如include语句一样，include_once也会传输并评估另一个文件中编写的脚本，两者的区别在于，include_once可以防止重新加载同一文件（如果已完成）。顾名思义，即使试图再次发出包含指令，文件也将仅包含一次。

include_once语句通常用于设置全局变量，启用库或预期在应用程序执行开始时进行的任何此类活动。

除此之外，include_once语句的行为类似于include语句。

include_once示例

在以下示例中，testscript.php位于Apache服务器的文档根文件夹中。它使用include_once语句插入test.php---

示例

<?php
echo "calling include_once statement\n";
$result=include_once "test.php---";
?>
//test.php---
<?php
echo "This file is included once\n";
?>

输出结果

如果给出testscript.php的URL，这将在浏览器中产生以下结果：

calling include_once statement

该文件包含一次

警告包含失败

如果找不到文件参数og include_once语句，则解析器会发出警告

示例

<?php
echo "inside main script<br />";
$var1=100;
echo "now calling nosuchfile.php script";
include_once "nosuchfile.php";
echo "returns from nosuchfile.php";
?>

输出结果

这将产生以下结果。请注意，程序不会在警告时终止-

inside main script
now calling nosuchfile.php script
PHP Warning: include_once(nosuchfile.php): failed to open stream: No such file or directory in line 5
PHP Warning: include_once(): Failed opening 'nosuchfile.php' for inclusion (include_path='C:\xampp\php\PEAR') in line 5
returns from nosuchfile.php

再次调用include_once

下一个示例包括带有include_once语句的test.php---。请注意，不再包含相同的文件

示例

//main script
<?php
echo "inside main script<br>";
echo "now including test.php--- script<br>";
include_once "test.php---";
echo "now including again test.php--- script<br>";
?>
//test.php--- included
<?php
echo "This file is included once";
?>

输出结果

这将在浏览器中产生以下结果-

inside main script<br />now including test.php--- script<br />

该文件包含一次

现在包括再次test.php---脚本