PHP中include和require的使用詳解

在PHP中,有兩種包含外部文件的方式,分別是include和require。他們之間有什麼不同呢?

如果文件不存在或發生瞭錯誤,require產生E_COMPILE_ERROR級別的錯誤,程序停止運行。而include隻產生警告,腳本會繼續執行。

這就是它們最主要的區別,其他方面require基本等同於include。

  • 被包含文件先按參數給出的路徑尋找,如果沒有給出目錄(隻有文件名)時則按照 include_path 指定的目錄尋找。如果在 include_path 下沒找到該文件則 include 最後才在調用腳本文件所在的目錄和當前工作目錄下尋找
  • 如果定義瞭路徑不管是絕對路徑還是當前目錄的相對路徑 include_path 都會被完全忽略
  • include_path 在php.ini中定義
  • 當一個文件被包含時,其中所包含的代碼繼承瞭 include 所在行的變量范圍。從該處開始,調用文件在該行處可用的任何變量在被調用的文件中也都可用。不過所有在包含文件中定義的函數和類都具有全局作用域

除瞭普通的require和include之外,還有require_once和include_once,他們的作用是:

  • 如果該文件中已經被包含過,則不會再次包含。如同此語句名字暗示的那樣,隻會包含一次
  • 可以用於在腳本執行期間同一個文件有可能被包含超過一次的情況下,想確保它隻被包含一次以避免函數重定義,變量重新賦值等問題

我們來看些例子:

// a.php 不存在
include "a.php"; // warning
// require "a.php"; // error

echo 111; // 使用include時111會輸出

// file1.php 中隻有一行代碼echo 'file1';
require_once 'includeandrequire/file1.php'; // file1
require_once 'includeandrequire/file1.php'; // noting

include_once 'includeandrequire/file1.php'; // noting
include_once 'includeandrequire/file1.php'; // noting

require 'includeandrequire/file1.php'; // file1
require 'includeandrequire/file1.php'; // file1

require 'includeandrequire/file1.php'; // file1
require 'includeandrequire/file1.php'; // file1

我們可以看出當第一個_once加載成功後,後面不管是require_once還是include_once,都不會再加載這個文件瞭。而不帶_once的則會重復加載文件。

file2.php

<?php

echo 'file2:' . $a, PHP_EOL;
echo 'file2:' . $b, PHP_EOL;
$b = "file2";

myFile.php

<?php

$a = 'myFile';
$b = 'youFile';
require_once 'includeandrequire/file2.php';
echo $a, PHP_EOL;
echo $b, PHP_EOL;

// 輸出結果
// file2:myFile
// file2:youFile
// myFile
// file2

file3.php
<?php

$c = 'file3';

myFile.php
<?php
function test(){
    require_once 'includeandrequire/file3.php';
    echo $c, PHP_EOL; // file3
}
test();
echo $c, PHP_EOL; // empty

被包含文件中可以獲取到父文件中的變量,父文件也可以獲得包含文件中的變量,但是,需要註意_once的一個特殊情況。

function foo(){
    require_once 'includeandrequire/file3.php';
    return $c;
}

for($a=1;$a<=5;$a++){
    echo foo(), PHP_EOL;
}

// file3
// empty
// empty
// empty
// empty

使用_once並循環加載時,隻有第一次會輸出file3.php中的內容,這是為什麼呢?因為現在的變量范圍作用域在方法中,第一次加載完成後,後面的的文件不會再被加載瞭,這時後面四次循環並沒有$c被定義,$c默認就是空值瞭。

如果兩個方法中同時用_once加載瞭一個文件,第二個方法還會加載嗎?

function test1(){
    require_once 'includeandrequire/file1.php';
}
function test2(){
    require_once 'includeandrequire/file1.php';
}
test1(); // file1
test2(); // empty

抱歉,隻有第一個方法會加載成功,第二個方法不會再次加載瞭。

那麼,我們在日常的開發中,使用哪個更好呢?

  • 從效率來說,_once需要驗證是否已經加載過文件,效率會低一些,但是並不是絕對的,甚至是我們肉眼不可見的降低,所以可以忽略它的效率問題。而它帶來的好處則比不帶_once的多得多
  • 本著錯誤提前的原則,使用require_once更好。因為將PHP報錯級別調整為不顯示警告後,include的警告信息會不可見,會帶來不可預知的錯誤
  • 在方法中使用時,不應該用_once來加載文件,特別是這個文件需要在多個類或者方法中使用時,使用_once可能會導致後面的方法中無法載相同的文件
  • 使用require或include時,最好不要用括號,雖然的確可以這麼使用,如 include (‘xxx.php’); 它們是表達式關鍵字,不是系統方法,所以直接用 include ‘xxx.php’ 即可

include和require的文件如果有return,可以用變量接收retun回來的數據,另外它們還可以加載非PHP文件以及遠程文件(遠程加載需要確定php.ini中的allow_url_include為On),如:

file4.php
<?php

return 'file4';

file4.txt
可以吧

myFile.php
<?php
$v = require 'includeandrequire/file4.php';
echo $v, PHP_EOL; // file4

include 'includeandrequire/file4.txt';
// 可以吧

include 'https://www.baidu.com/index.html';
// 百度首頁的html代碼

這下我們對於include和require的瞭解就非常深入瞭吧,這兩個加載文件的方式並不復雜,但也很容易出現一些坑,特別是_once在方法中使用的時候一定要特別註意。最後,給一個小福利,封裝一個一次性加載目錄中所有文件的方法:

function include_all_once ($pattern) {
    foreach (glob($pattern) as $file) { 
        require $file;
    }
}

include_all_once('includeandrequire/*');

測試代碼:github.com/zhangyue050…

以上就是PHP中include和require的使用詳解的詳細內容,更多關於PHP include和require的使用的資料請關註WalkonNet其它相關文章!