演进历史
- PHP 5 前:手动
require_once 或框架自研目录扫描
- PHP 5.1.2+:
__autoload() 魔术函数(仅支持单一加载器)
- PHP 5.1.2+:
spl_autoload_register() 支持多加载器栈(推荐)
- PHP 5.3+:命名空间 + PSR-0/PSR-4 标准,成为生态基石
PSR-4 标准映射规则
// 命名空间前缀 -> 基础目录
'App\\' => __DIR__ . '/src'
'Vendor\\Pkg\\' => __DIR__ . '/vendor/vendor/pkg/src'
// 类名: App\Controller\UserController
// 文件: src/Controller/UserController.php
通用自动加载器实现
<?php
class ClassLoader {
private $prefixes = array(); // prefix => [base_dirs]
public function addPrefix($prefix, $baseDir) {
$prefix = rtrim($prefix, '\\') . '\\';
$baseDir = rtrim($baseDir, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR;
$this->prefixes[$prefix][] = $baseDir;
}
public function register() {
spl_autoload_register(array($this, 'loadClass'));
}
public function loadClass($class) {
foreach ($this->prefixes as $prefix => $dirs) {
if (strpos($class, $prefix) !== 0) continue;
$relative = substr($class, strlen($prefix));
$file = str_replace('\\', DIRECTORY_SEPARATOR, $relative) . '.php';
foreach ($dirs as $dir) {
$full = $dir . $file;
if (is_file($full)) {
require $full;
return true;
}
}
}
return false;
}
}
// 使用
$loader = new ClassLoader();
$loader->addPrefix('App', __DIR__ . '/src');
$loader->addPrefix('Vendor\\Package', __DIR__ . '/vendor/package/src');
$loader->register();
Composer 自动加载(生产标准)
// composer.json
{
"autoload": {
"psr-4": {
"App\\": "src/",
"Tests\\": "tests/"
},
"files": ["src/helpers.php"] // 全局函数
}
}
// 运行 composer dump-autoload 生成 vendor/autoload.php
// 入口文件只需:
require __DIR__ . '/vendor/autoload.php';
性能优化:类映射缓存
// 生产环境生成 classmap,避免文件系统 stat
// composer dump-autoload -a (authoritative)
// 或使用 APCu 缓存查找结果
function apcu_autoload($class) {
$file = apcu_fetch('autoload_' . $class);
if ($file) { require $file; return true; }
// ... 正常查找 ...
if (is_file($full)) {
apcu_store('autoload_' . $class, $full);
require $full;
return true;
}
return false;
}
调试技巧
spl_autoload_functions() 查看已注册加载器
spl_autoload_call('ClassName') 手动触发
- 开启
xdebug 追踪加载耗时