(PHP 4, PHP 5)
require_once 语句和 require 语句完全相同,唯一区别是 PHP 会检查该文件是否已经被包含过,如果是则不会再次包含。
参见下面 include_once 的文档来理解 _once 的含义,并理解与没有 _once 时候有什么不同。
include_once 语句在脚本执行期间包含并运行指定文件。此行为和 include 语句类似,唯一区别是如果该文件中已经被包含过,则不会再次包含。如同此语句名字暗示的那样,只会包含一次。
include_once可以用于在脚本执行期间同一个文件有可能被包含超过一次的情况下,想确保它只被包含一次以避免函数重定义,变量重新赋值等问题。
Note:
在 PHP 4中,_once 的行为在不区分大小写字母的操作系统(例如 Windows)中有所不同,例如:
Example #1 include_once 在 PHP 4 运行于不区分大小写的操作系统中
<?php
include_once "a.php" ; // 这将包含 a.php
include_once "A.php" ; // 这将再次包含 a.php!(仅 PHP 4)
?>此行为在 PHP 5 中改了,例如在 Windows 中路径先被规格化,因此 C:/PROGRA~1/A.php 和 C:/Program Files/a.php 的实现一样,文件只会被包含一次。