插件系統、模組化架構常需「掃描目錄載入所有 PHP 檔案」。本文比較 glob() 直接掃描與 spl_autoload_register 惰性載入兩種策略,並給出生產環境建議。
<?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();
}
}
}
?>
只在「真正使用到類別」時才載入檔案,避免載入未使用的類別,記憶體佔用更低。
<?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(); // 自動載入
?>
<?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 |
vendor/autoload.php)。glob() 掃描插件目錄,各插件內部類別再用自動載入。composer dump-autoload -o 產生 ClassMap,載入變 O(1) 陣列查找。opcache.validate_timestamps=1 即時生效。