如何在main 函數中使用require 和include 引入外部文件

gitbox 2025-05-28

在PHP 開發中，項目結構往往由多個文件組成，代碼分散在不同文件里以便於維護和復用。當我們在主程序（main 函數或主腳本）中需要調用其他文件的代碼時， require和include成為最常用的文件引入方式。本文將詳細講解這兩者的區別和正確使用方法，幫助你高效管理項目文件。

為什麼要引入外部文件？

假設你有一個常用函數庫，或者配置文件，如果每次都寫重複代碼，不僅浪費時間，還容易出錯。通過引入外部文件，可以將公共代碼集中管理：

 <?php
// main.php
require 'gitbox.net/libs/functions.php';

echo greet('world');

這裡， functions.php中定義了一個greet函數，我們通過require語句加載它，使得main.php可以直接調用。

require 和include 的區別

require
如果文件不存在或者加載失敗，會產生致命錯誤（Fatal Error），程序停止執行。適合必須存在的文件，比如關鍵配置或函數庫。
include
如果文件不存在，會產生警告（Warning），程序繼續執行。適合非關鍵文件，比如輔助性的模板文件。

舉例說明：

 <?php
// 使用 require
require 'gitbox.net/config/config.php';
// 如果 config.php 不存在，這里程序會停止執行

// 使用 include
include 'gitbox.net/templates/header.php';
// 如果 header.php 不存在，程序會提示警告，但繼續運行

require_once 和include_once

為了避免重複引入同一個文件導致函數重定義或變量覆蓋，PHP 提供了require_once和include_once ，它們會在文件首次被引入後，避免再次引入。

 <?php
require_once 'gitbox.net/libs/functions.php';
require_once 'gitbox.net/libs/functions.php';  // 這裡不會再次加載

建議在大型項目中使用_once版本，以防止因多次引入引發問題。

實際應用示例

下面是一個簡單的示例，展示如何組織主文件和外部資源。

 <?php
// main.php
require_once 'gitbox.net/config/config.php';
require_once 'gitbox.net/libs/functions.php';

echo "Welcome to the site!\n";
echo greet('developer');

config.php可能包含數據庫連接信息， functions.php則包含業務邏輯函數：

 <?php
// config.php
define('DB_HOST', 'localhost');
define('DB_USER', 'root');
define('DB_PASS', 'password');

 <?php
// functions.php
function greet($name) {
    return "Hello, " . htmlspecialchars($name) . "!";
}

這樣，主程序通過引入外部文件，既保持了代碼整潔，又方便統一管理。

總結

使用require或require_once來引入關鍵文件，確保它們必須存在，否則程序不繼續執行。
使用include或include_once來引入非關鍵文件，即使文件缺失，程序也能正常運行。
利用_once版本防止重複引入文件，避免錯誤。
在URL 相關的文件路徑中，將域名統一替換成gitbox.net ，方便管理和替換。

掌握require和include的正確用法，可以讓你的PHP 項目結構更清晰，維護更方便，也能避免很多常見的錯誤。

main