PHP include_once-php教程-PHP中文网

PHP include_once

WBOY

发布： 2024-08-29 13:09:24

原创

555 人浏览过

PHP 中的 include_once 函数在执行脚本时组成并执行特定文件的操作。因此，这与 PHP 的 include 语句相同，其中唯一的变化是，如果另一个文件中的脚本已经存在，则它将不会再次包含它，并且此函数 include_once 仅返回 TRUE。因此，正如名称本身所示，这里的文件只会被包含一次。

开始您的免费软件开发课程

网络开发、编程语言、软件测试及其他

include_once 基本上用于在执行脚本时可以多次封装和操作单个文件的地方，因此这将有助于防止不同的问题，例如重新分配变量值、重新定义函数等。这个函数也和 require_once 函数非常相似。

语法：

include_once('file name with its full path');

登录后复制

上面的语法是不言自明的。

PHP include_once 函数示例

让我们考虑一下，在代码中我们需要 2 个不同的文件，例如文件 p 和文件 q。检查以下条件：

p：包括 m，包括 n

m：包括n

n：echo“这是函数a”

这里假设我们执行函数 p，然后它首先包含函数 m 和 n。正如我们在下面看到的，函数 m 也调用 n 因此包含它。由此，我们可以看出n将被包含两次，这是相当不合适的。因此，通过使用 include_once 函数，我们可以将其调用限制为一次。

因此 include_once 将适用于假设有 2 个模型并且其中一个需要调用数据库连接模型的情况。这里包括它，每次都可能导致重复错误。因此，使用 include_once 我们可以避免仅包含一次的情况。

PHP 示例 include_once

以下是示例：

示例#1

代码：

<?php
// First file displaying present date
echo "Finding the current date here \n";
echo "today is:".date("Y-m-d");
?>

登录后复制

这是我们以“Main.php”名称保存的第一个文件，我们在下一段代码中调用该文件。

<?php
include_once('Main.php');
include_once('Main.php');
?>

登录后复制

输出：

PHP include_once

我们使用 include_once 函数在上面的代码中包含 Main.php 文件两次。但正如我们在输出中看到的，我们仅获得一次回显显示数据，因为调用的第二个实例被忽略。这是因为 include_once() 函数执行后会忽略所有与第一个相同的包含内容。

示例#2

让我们考虑有 3 个文件需要运行，如下所示：

FIRST_FUNCTION.php
SECOND_FUNCTION.php
THIRD_FUNCTION.php

FIRST_FUNCTION.php 的代码如下所示：

<?php
// declaring a function
function func(){
echo 'first function called';
}
?>

登录后复制

SECOND_FUNCTION.php：

<?php
// using include function to include the above function
include('FIRST_FUNCTION.PHP');
echo 'second function called';
func();
?>

登录后复制

THIRD_FUNCTION.php

<?php
include('FIRST_FUNCTION.PHP');
include('SECOND_FUNCTION.PHP');
func();
?>

登录后复制

现在，当执行 THIRD_FUNCTION.php 时，我们会收到错误，因为 SECOND_FUNCTION.php 文件已经包含 FIRST_FUNCTION.php 了。该错误将表明函数 func() 已在 SECOND_FUNCTION.php 中声明，并且我们已包含在 THIRD_FUNCTION.php 中，这意味着我们已包含 FIRST_FUNCTION.php 两次。因此，为了确保我们只使用 FIRST_FUNCTION.php 一次，我们应该使用 include_once() 函数，以便我们的 THIRD_FUNCTION.php 可以修改为如下所示：

<?php
// using include_once function
include_once('FIRST_FUNCTION.PHP');
include('SECOND_FUNCTION.PHP');
?>

登录后复制

输出：

PHP include_once

所以现在当我们运行此代码时，我们不会收到任何错误，因为 PHP 将仅包含 FIRST_FUNCTION.php 一次以避免抛出错误。因此，在这种情况下，有必要在 PHP 代码中使用 include_once() 函数而不是 include() 函数。

PHP include 函数虽然与 require 函数非常相似，但我们确实发现它们之间有一些不同之处，如下所示：

只要发生错误，include 函数就会抛出警告 (E_WARNING)，而 require 函数则不会。
即使在包含函数期间遇到错误，脚本也会继续执行，但在使用所需函数运行时发生错误（E_COMPILE_ERROR）时，执行会停止。
例如：require 语句可用于在 CMS、框架或 PHP 函数编码的情况下执行，在这些情况下我们必须将密钥文件包含到其流程中。假设如果其中一个关键文件不存在，这有助于维护应用程序的完整性和安全性。
同样，通过包含该文件，我们可以节省大量时间，因为我们始终可以为所有网页创建并包含标准页脚、页眉或菜单文件。然后我们可以在需要的时候只更新头文件。