萬盛學電腦網

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

PHP 自動引入目錄下所有 PHP 檔案的兩種方法

批次載入腳本:glob 掃描 vs 自動載入器

插件系統、模組化架構常需「掃描目錄載入所有 PHP 檔案」。本文比較 glob() 直接掃描與 spl_autoload_register 惰性載入兩種策略,並給出生產環境建議。

方法一:glob() 立即掃描載入 (簡單、適用啟動階段)

<?php
/**
 * 載入目錄下所有 .php 檔案 (非遞迴)
 * @param string $folder 相對或絕對路徑
 */
function loadAllPhpInDir(string $folder): void {
    $folder = rtrim($folder, '/\\');
    $files = glob("{$folder}/*.php");
    
    if ($files === false) {
        throw new RuntimeException("無法讀取目錄: {$folder}");
    }
    
    foreach ($files as $file) {
        // 可選:排除特定檔案 (如 .test.php, _bootstrap.php)
        $basename = basename($file);
        if ($basename[0] === '.' || $basename[0] === '_') continue;
        
        require_once $file;
    }
}

// 使用:啟動時載入 plugins/ 目錄
loadAllPhpInDir(__DIR__ . '/plugins');
?>

遞迴掃描版本 (含子目錄)

<?php
function loadAllPhpRecursive(string $folder): void {
    $iterator = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($folder, FilesystemIterator::SKIP_DOTS)
    );
    
    /** @var SplFileInfo $file */
    foreach ($iterator as $file) {
        if ($file->isFile() && $file->getExtension() === 'php') {
            $basename = $file->getBasename();
            if ($basename[0] === '.' || $basename[0] === '_') continue;
            require_once $file->getPathname();
        }
    }
}
?>

方法二:spl_autoload_register 惰性載入 (現代標準、效能佳)

只在「真正使用到類別」時才載入檔案,避免載入未使用的類別,記憶體佔用更低。

<?php
// 簡易 PSR-4 風格載入器
spl_autoload_register(function (string $class): void {
    // 將命名空間分隔符轉為目錄分隔符
    $file = __DIR__ . '/src/' . str_replace('\\', '/', $class) . '.php';
    
    if (file_exists($file)) {
        require_once $file;
    }
    // 找不到不拋錯,讓下一個載入器嘗試
});

// 使用
$user = new App\Models\User();  // 自動載入 src/App/Models/User.php
$service = new App\Services\PaymentService(); // 自動載入
?>

進階:多目錄載入器 (Composer 風格)

<?php
class ClassLoader {
    private array $prefixDirs = [];  // 'Namespace\\Prefix' => '/path/to/dir'
    
    public function addNamespace(string $prefix, string $dir): self {
        $prefix = trim($prefix, '\\') . '\\';
        $this->prefixDirs[$prefix] = rtrim($dir, '/\\');
        return $this;
    }
    
    public function register(): void {
        spl_autoload_register([$this, 'loadClass']);
    }
    
    public function loadClass(string $class): bool {
        foreach ($this->prefixDirs as $prefix => $dir) {
            if (str_starts_with($class, $prefix)) {
                $relative = substr($class, strlen($prefix));
                $file = $dir . '/' . str_replace('\\', '/', $relative) . '.php';
                if (file_exists($file)) {
                    require_once $file;
                    return true;
                }
            }
        }
        return false;  // 讓下一個載入器處理
    }
}

// 設定
$loader = new ClassLoader();
$loader->addNamespace('App', __DIR__ . '/app')
       ->addNamespace('Vendor\\Package', __DIR__ . '/packages/package/src')
       ->register();
?>

兩種策略比較

維度glob() 掃描載入spl_autoload_register
載入時機呼叫時立即載入所有首次使用類別時才載入
記憶體佔用較高 (全載入)較低 (按需)
適用場景插件系統、啟動腳本、CLI 命令、少量檔案大型應用、框架、Composer 生態
錯誤發現啟動即發現語法錯誤執行到才發現
除錯追蹤堆疊清晰堆疊含載入器框架
命名規範無強制建議 PSR-4

生產環境建議

  1. 應用程式核心:使用 Composer PSR-4 自動載入 (vendor/autoload.php)。
  2. 插件/模組系統:啟動階段 glob() 掃描插件目錄,各插件內部類別再用自動載入。
  3. 效能優化:生產環境執行 composer dump-autoload -o 產生 ClassMap,載入變 O(1) 陣列查找。
  4. 開發環境:關閉 ClassMap、啟用 opcache.validate_timestamps=1 即時生效。
copyright © 萬盛學電腦網 all rights reserved