介绍
正如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---
echo "This file is included once\n";
?>
输出结果
如果给出testscript.php的URL,这将在浏览器中产生以下结果:calling include_once statement
该文件包含一次
警告包含失败
如果找不到文件参数og include_once语句,则解析器会发出警告
示例<?php
echo "inside main script
";
$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
echo "inside main script
";
echo "now including test.php--- script
";
include_once "test.php---";
echo "now including again test.php--- script
";
?>
//test.php--- included
echo "This file is included once";
?>
输出结果
这将在浏览器中产生以下结果-inside main script
now including test.php--- script
该文件包含一次
现在包括再次test.php---脚本