| 類型 | 特徵 | 示例 |
|---|---|---|
| 絕對路徑 | 以 `/` (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 所在目錄
include_path (php.ini 或 set_include_path()) 中的每個目錄拼接查找require 語句的文件所在目錄 拼接查找; 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 的文件目錄)
| 場景 | __DIR__ | getcwd() |
|---|---|---|
| 含義 | 當前文件所在目錄 (編譯時常量) | 當前工作目錄 (運行時,受 chdir 影響) |
| 被包含文件中 | 指向被包含文件目錄 | 指向入口腳本目錄 (未 chdir 時) |
| 推薦用途 | 構建包含路徑 | CLI 腳本、需感知運行目錄時 |
<?php
// config/bootstrap.php
define('APP_ROOT', __DIR__ . '/../');
// 業務文件
require APP_ROOT . 'lib/Database.php';
require APP_ROOT . 'model/User.php';
// composer.json
{
"autoload": {
"psr-4": {
"App\\": "src/"
}
}
}
// 只需在入口引入
require __DIR__ . '/vendor/autoload.php';
// 之後直接使用類,無需 require
use App\Model\User;
$user = new User();
<?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.php | PHP 5.2 兼容寫法 |
PHP 包含路徑解析規則看似複雜,核心只需記住:
include_path,行為不可預測,**嚴禁使用**require