(PHP 5 >= 5.1.2)
spl_autoload_register — 指定した関数を __autoload() の実装として登録する
$autoload_function
[, bool $throw = true
[, bool $prepend = false
]]] )指定した関数を、spl が提供する __autoload スタックに登録します。 スタックがまだアクティブになっていない場合は、まずアクティブにします。
もしあなたのコード中に __autoload() 関数が存在するのなら、 それを明示的に __autoload スタックに登録しなければなりません。 なぜなら、spl_autoload_register() は、 spl_autoload() あるいは spl_autoload_call() によって __autoload() 関数のエンジンキャッシュを効率的に置き換えるからです。
複数の autoload 関数が必要となる場合でも spl_autoload_register() は対応できます。この関数は autoload 関数のキューを作成し、 定義された順にそれを実行していきます。一方 __autoload() は、一度しか定義できません。
autoload_function
登録したい autoload 関数。 パラメータが指定されなかった場合は、デフォルト実装である spl_autoload() が登録されます。
throw
このパラメータは、
spl_autoload_register()
が autoload_function
を登録できなかったときに例外をスローするかどうかを指定します。
prepend
true の場合、spl_autoload_register() はスタックの最後の追加するのではなく先頭に追加します。
成功した場合に TRUE を、失敗した場合に FALSE を返します。
| バージョン | 説明 |
|---|---|
| 5.3.0 | 名前空間に対応するようになりました。 |
| 5.3.0 |
prepend パラメータが追加されました。
|
例1 spl_autoload_register() の例
<?php
namespace Foobar;
class Foo {
static public function test($name) {
print '[['. $name .']]';
}
}
spl_autoload_register(__NAMESPACE__ .'\Foo::test'); // PHP 5.3.0 以降
new InexistentClass;
?>
上の例の出力は、 たとえば以下のようになります。
[[Foobar\InexistentClass]] Fatal error: Class 'Foobar\InexistentClass' not found in ...