完全搞明白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/*');

測試代碼：https://github.com/zhangyue0503/dev-blog/blob/master/php/201911/source/%E5%BD%BB%E5%BA%95%E6%90%9E%E6%98%8E%E7%99%BDPHP%E4%B8%AD%E7%9A%84include%E5%92%8Crequire.php

參考文檔：
https://www.php.net/manual/zh/function.require.php
https://www.php.net/manual/zh/function.include.php
https://www.php.net/manual/zh/function.require-once.php
https://www.php.net/manual/zh/function.include-once.php

關注公衆號：【硬核項目經理】獲取最新文章

添加微信/QQ好友：【xiaoyuezigonggong/149844827】免費得PHP、項目管理學習資料

知乎、公衆號、抖音、頭條搜索【硬核項目經理】

B站ID：482780532