在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://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