(PHP 5 >= 5.1.0, PHP 7, PHP 8)
spl_autoload_register — 注册指定的函数作为 __autoload 的实现
使用 spl 提供的 __autoload 队列注册函数。如果队列尚未激活，则将激活。
如果在代码中已经实现了 __autoload() 函数，必须显式注册到 __autoload() 队列中。因为 spl_autoload_register() 通过 spl_autoload() 或 spl_autoload_call() 有效替换 __autoload() 函数的存储缓存。
如果需要多个自动加载函数，则 spl_autoload_register() 允许这么做。它有效的创建了自动加载函数队列，并按定义的顺序进行遍历。相比之下，__autoload() 只能定义一次。
callback
正在注册的自动装载函数。如果为 null，则将注册 spl_autoload() 的默认实现。
$class): void
class 将是不包含开头反斜线的完整标识符。
throw
此参数指定 spl_autoload_register() 在无法注册
callback 时是否应抛出异常。
prepend如果是 true，spl_autoload_register() 会添加函数到队列之首，而不是队列尾部。
成功时返回 true， 或者在失败时返回 false。
| 版本 | 说明 |
|---|---|
| 8.0.0 |
callback 现在可以为 null。
|
示例 #1 spl_autoload_register() 作为 __autoload() 函数的替代
<?php
// function __autoload($class) {
// include 'classes/' . $class . '.class.php';
// }
function my_autoloader($class) {
include 'classes/' . $class . '.class.php';
}
spl_autoload_register('my_autoloader');
// 或者可以使用匿名函数
spl_autoload_register(function ($class) {
include 'classes/' . $class . '.class.php';
});
?>
示例 #2 类未能加载的 spl_autoload_register() 例子
<?php
namespace Foobar;
class Foo {
static public function test($class) {
print '[['. $class .']]';
}
}
spl_autoload_register(__NAMESPACE__ .'\Foo::test');
new InexistentClass;
?>
以上例程的输出类似于：
[[Foobar\InexistentClass]] Fatal error: Class 'Foobar\InexistentClass' not found in ...
示例 #3 提供的标识符将不包含开头的反斜线
<?php
spl_autoload_register(static function ($class) {
var_dump($class);
});
class_exists('RelativeName');
class_exists('RelativeName\\WithNamespace');
class_exists('\\AbsoluteName');
class_exists('\\AbsoluteName\\WithNamespace');
?>
以上例程会输出：
string(12) "RelativeName" string(26) "RelativeName\WithNamespace" string(12) "AbsoluteName" string(26) "AbsoluteName\WithNamespace"