spl_autoload_register
(PHP 5 >= 5.1.2)
spl_autoload_register — __autoload() 関数を登録する
説明
bool spl_autoload_register ([ callback $autoload_function ] )
関数を SPL __autoload 関数スタックに登録します。このスタック内の関数がまだアクティブになっていない場合は、アクティブにします。
__autoload 関数がプログラムに実装されている場合は、__autoload スタックに明示的に登録する必要があります。
spl_autoload_register() 関数は、Zend Engine の __autoload 関数を spl_autoload() または
spl_autoload_call() に置き換えるためです。
Parameters
autoload_function
登録されるオートロード関数。パラメータが指定されていない場合、autoload
spl_autoload() のデフォルト実装関数が自動的に登録されます。
戻り値
成功した場合は TRUE を返し、失敗した場合は FALSE を返します。
注: SPL は Standard PHP Library の略称です。これは、PHP5 で導入された拡張ライブラリであり、その主な機能には、オートロード メカニズムとさまざまな Iterator インターフェイスまたはクラスの実装が含まれます。 SPL オートロード メカニズムは、関数ポインタ autoload_func をオートロード機能を備えた自己実装関数にポイントすることによって実装されます。 SPL には、spl_autoload と spl_autoload_call という 2 つの異なる関数があります。これら 2 つの異なる関数アドレスを autoload_func に指定することで、異なる自動ロード メカニズムが実装されます。
例
A という名前のクラスを定義するクラス ファイル A.php があるとします。 }
}
class A
{
public function __construct()
{
echo 'Got it.';
}
そして、このクラスAを使用する必要があるindex.phpがあります。 従来の書き方は
require('A.php');
$a = new A();
require('A.php');
$a = new A();
しかし、1 つの問題は、index.php にクラス A だけでなく多くのクラスを含める必要がある場合、何行もの require ステートメントを書かなければならず、それが時々人々を不快にさせることです。
たとえば、上記の例では、index.php は次のように記述できます:
$file = $class .php';
if (is_file($file)) {require_once($file);
$a = 新しい A();
function __autoload($class)
{
$file = $class . '.php';
if (is_file($file)) {
require_once($file);
}
$a = new A();
もちろん、上記は単なる最も単純なデモです。__autoload は単に include_path に移動してクラス ファイルを見つけ、それをロードするだけです。必要に応じて __autoload のルールを定義できます。
さらに、自動ロード時に __autoload を呼び出すのではなく、独自の関数 (またはクラス メソッド) を呼び出したい場合は、 spl_autoload_register を使用して独自の autoload 関数を登録できます。その関数のプロトタイプは次のとおりです:
bool spl_autoload_register ( [callback $autoload_function] )
上記の例を書き直してみましょう:
関数ローダー($class)
{
$file = $class .php';
require_once($file);
spl_autoload_register('ローダー');
関数ローダー($class)
$a = new A();
これも正常に実行できます。このとき、PHP がクラスを探すとき、__autoload を呼び出すのではなく、独自に定義した関数ローダーを呼び出します。同じ理由で、以下のような書き方も可能です。
class Loaderspl_autoload_register(array('Loader', 'loadClass'));
$a = 新しい A();