PHP include_once-php教程-PHP中文網

PHP include_once

WBOY

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

原創

620 人瀏覽過

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 函數編碼的情況下執行，在這些情況下我們必須將金鑰檔案包含到其流程中。假設如果其中一個關鍵文件不存在，這有助於維護應用程式的完整性和安全性。
同樣，透過包含該文件，我們可以節省大量時間，因為我們始終可以為所有網頁建立並包含標準頁腳、頁首或選單文件。然後我們可以在需要的時候只更新頭檔。