哈希空间 Ctrl + F 进行搜索
首页 php手册中文版 CSS中文手册 哈希文档 Markdown在线工具

PHP spl 组件

spl_autoload_register

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

spl_autoload_register注册指定的函数作为 __autoload 的实现

说明

spl_autoload_register(?callable $callback = null, bool $throw = true, bool $prepend = false): bool

使用 spl 提供的 __autoload 队列注册函数。如果队列尚未激活,则将激活。

如果在代码中已经实现了 __autoload() 函数,必须显式注册到 __autoload() 队列中。因为 spl_autoload_register() 通过 spl_autoload()spl_autoload_call() 有效替换 __autoload() 函数的存储缓存。

如果需要多个自动加载函数,则 spl_autoload_register() 允许这么做。它有效的创建了自动加载函数队列,并按定义的顺序进行遍历。相比之下,__autoload() 只能定义一次。

参数

callback

正在注册的自动装载函数。如果为 null,则将注册 spl_autoload() 的默认实现。

callback(string $class_name): void
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($name) {
        print 
'[['$name .']]';
    }
}

spl_autoload_register(__NAMESPACE__ .'\Foo::test');

new 
InexistentClass;

?>

以上例程的输出类似于:

[[Foobar\InexistentClass]]
Fatal error: Class 'Foobar\InexistentClass' not found in ...

参见

打开 哈希空间 微信小程序中查看更佳