隨著項目規模增長,require_once 大量文件會嚴重拖慢啟動速度。惰性加載(自動加載)按需引入類文件,是現代 PHP 框架(Laravel、Symfony、ThinkPHP)的核心機制。本文從 ReflectionClass 切入,演示自動加載原理並構建一個符合 PSR-4 的加載器。
<?php
// test.php
class Test {
public function showName() { var_dump(__CLASS__); }
}
// index.php
var_dump(get_included_files()); // 僅 index.php
$rf = new ReflectionClass('Test'); // 觸發自動加載
var_dump(get_included_files()); // 新增 test.php
$obj = $rf->newInstance();
$obj->showName();
// 自動加載函數
function __autoload($class) {
$file = __DIR__ . '/' . $class . '.php';
if (file_exists($file)) require_once $file;
}
?>
<?php
// 簡易 PSR-4 加載器
class Autoloader {
private $prefixes = []; // 命名空間前綴 => 基礎目錄
public function addNamespace(string $prefix, string $baseDir): void {
$prefix = trim($prefix, '\\') . '\\';
$baseDir = rtrim($baseDir, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR;
$this->prefixes[$prefix] = $baseDir;
}
public function register(): void {
spl_autoload_register([$this, 'loadClass']);
}
public function loadClass(string $class): void {
foreach ($this->prefixes as $prefix => $baseDir) {
if (strncmp($class, $prefix, strlen($prefix)) !== 0) continue;
$relative = substr($class, strlen($prefix));
$file = $baseDir . str_replace('\\', DIRECTORY_SEPARATOR, $relative) . '.php';
if (file_exists($file)) {
require_once $file;
return;
}
}
}
}
// 使用
$loader = new Autoloader();
$loader->addNamespace('App', __DIR__ . '/src');
$loader->addNamespace('Vendor\\Package', __DIR__ . '/vendor/package/src');
$loader->register();
// 現在可以直接 new App\Controller\UserController() 等
?>
<?php
function getInstance(string $class, bool $new = false) {
static $instances = [];
if (!$new && isset($instances[$class])) return $instances[$class];
$rf = new ReflectionClass($class);
$instance = $rf->newInstance();
if (!$new) $instances[$class] = $instance;
return $instance;
}
?>
ReflectionClass 實例化時會觸發自動加載機制。spl_autoload_register 支持多個加載器鏈,優先級按註冊順序。vendor/autoload.php 即是標準 PSR-4 加載器,項目中直接 require 'vendor/autoload.php' 即可。src/Controller/UserController.php 對應 App\Controller\UserController。opcache.preload 預加載熱門類,進一步提升性能。