萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP require/include 路徑解析機制深度解析:相對、絕對、未確定路徑三大類型

路徑分類定義

類型特徵示例
絕對路徑以 `/` (Linux) 或 `C:/` (Windows) 開頭`/var/www/html/lib/config.php`、`C:\www\config.php`
相對路徑以 `.` 或 `..` 開頭`./lib/config.php`、`../config.php`
未確定路徑不以 `.` `/` 盤符開頭`lib/config.php`、`config.php`

核心結論

相對路徑與絕對路徑:直接解析,不查找 include_path
未確定路徑:優先查找 include_path,失敗後再按「執行腳本所在目錄」解析

相對路徑:參考目錄永遠是「入口腳本目錄」

假設入口:https://site.com/app/test/a.php (物理路徑 /var/www/app/test/a.php)

<?php
// a.php
require './b/b.php';  // → /var/www/app/test/b/b.php

// b.php
require './c.php';    // → /var/www/app/test/c.php  (不是 b.php 所在目錄!)
require '../c.php';   // → /var/www/app/c.php
?>

絕對路徑:最安全、最明確

<?php
// 推薦:使用 __DIR__ (PHP 5.3+) 或 dirname(__FILE__)
require __DIR__ . '/../config.php';  // 當前文件目錄為基準,絕對可靠

// __DIR__ 編譯時確定,不受包含關系影響
// b.php 中 __DIR__ 總是 b.php 所在目錄

未確定路徑:解析順序

  1. 遍歷 include_path (php.ini 或 set_include_path()) 中的每個目錄拼接查找
  2. 若未找到,用 執行 require 語句的文件所在目錄 拼接查找
  3. 仍未找到 → 警告/致命錯誤
; php.ini
include_path = ".:/usr/share/php:/var/www/common_lib"

// require 'tools.php';
// 1. ./tools.php (入口腳本目錄)
// 2. /usr/share/php/tools.php
// 3. /var/www/common_lib/tools.php
// 4. /var/www/app/test/tools.php (執行 require 的文件目錄)

dirname(__FILE__) vs getcwd()

場景__DIR__getcwd()
含義當前文件所在目錄 (編譯時常量)當前工作目錄 (運行時,受 chdir 影響)
被包含文件中指向被包含文件目錄指向入口腳本目錄 (未 chdir 時)
推薦用途構建包含路徑CLI 腳本、需感知運行目錄時

最佳實踐方案

方案 A:統一使用 __DIR__ 構建絕對路徑 (推薦)

<?php
// config/bootstrap.php
define('APP_ROOT', __DIR__ . '/../');

// 業務文件
require APP_ROOT . 'lib/Database.php';
require APP_ROOT . 'model/User.php';

方案 B:Composer PSR-4 自動加載 (現代標準)

// composer.json
{
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}

// 只需在入口引入
require __DIR__ . '/vendor/autoload.php';

// 之後直接使用類,無需 require
use App\Model\User;
$user = new User();

方案 C:自動預加載文件定義 import() 函數

<?php
// auto_prepend_file.php (配置 php.ini: auto_prepend_file = /path/auto_prepend_file.php)
function import(string $path): void {
    $old = getcwd();
    chdir(dirname(__FILE__));  // 切換到當前文件目錄作為參考
    require_once $path;
    chdir($old);  // 恢復
}

// 業務代碼直接使用
import('lib/Database.php');
import('../config.php');  // 相對 import.php 所在目錄

常見坑點

代碼實際解析路徑說明
require 'config.php'按 include_path → 入口目錄未確定路徑,不可控
require './config.php'入口腳本目錄/config.php相對路徑,參考入口
require __DIR__ . '/config.php'當前文件目錄/config.php絕對路徑,確定可控
require dirname(__FILE__) . '/../config.php'當前文件父目錄/config.phpPHP 5.2 兼容寫法

總結

PHP 包含路徑解析規則看似複雜,核心只需記住:

  1. 永遠使用 `__DIR__` 構建絕對路徑 (或 Composer 自動加載)
  2. 相對路徑參考的是入口腳本目錄,非當前文件目錄
  3. 未確定路徑會查找 include_path,行為不可預測,**嚴禁使用**
  4. 現代 PHP 專案**全面採用 PSR-4 + Composer**,徹底消除手動 require
copyright © 萬盛學電腦網 all rights reserved