PHP include_once

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');
?>

輸出：

我們使用 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 將只包含 FIRST_FUNCTION.php 一次以避免拋出錯誤。因此，在這種情況下，有必要在 PHP 程式碼中使用 include_once() 函數而不是 include() 函數。

PHP include 函數雖然與 require 函數非常相似，但我們確實發現它們之間有一些不同之處，如下所示：

• 只要發生錯誤，include 函數就會拋出警告 (E_WARNING)，而 require 函數則不會。
• 即使在包含函數期間遇到錯誤，腳本也會繼續執行，但在使用所需函數執行時發生錯誤（E_COMPILE_ERROR）時，執行會停止。
• 例如：require 語句可用於在 CMS、框架或 PHP 函數編碼的情況下執行，在這些情況下我們必須將金鑰檔案包含到其流程中。假設如果其中一個關鍵文件不存在，這有助於維護應用程式的完整性和安全性。
• 同樣，透過包含該文件，我們可以節省大量時間，因為我們始終可以為所有網頁建立並包含標準頁腳、頁首或選單文件。然後我們可以在需要的時候只更新頭檔。

使用 PHP include_once 的優點

• 由於這個 include_once 在找不到特定檔案時會拋出警告而不是致命錯誤，因此執行不會中斷並且仍然順利進行。
• 最適合處理需要重複使用某些函數和變數的情況。
• 它有助於避免重新分配變數值、重新定義某些函數等問題。
• 在我們必須定期呼叫某些函數的情況下很有用。

結論

PHP include Once 用於包含任何腳本並確保其僅執行一次，從而防止因重複調用相同腳本而可能導致的任何錯誤。這基本上用於需要將通用程式碼用於程式碼執行所需的任何類型的聲明或設定檔的情況。

以上是PHP include_once的詳細內容。更多資訊請關注PHP中文網其他相關文章！