PSR-0 の要件は次のとおりです。
次に、オートローダーの相互運用性のために順守する必要がある必須要件について説明します。
必須
- 完全修飾された名前空間とクラスには、次の構造が必要です
\<Vendor Name>\(<Namespace>\)*<Class Name>
- 各名前空間には、最上位の名前空間 (「ベンダー名」) が必要です。
- 各名前空間は、必要な数のサブ名前空間を持つことができます。
- 各ネームスペース セパレータは
DIRECTORY_SEPARATOR
、ファイル システムからロードするときに に変換されます。
_
CLASS NAME の
各文字はDIRECTORY_SEPARATOR
. 文字は_
名前空間で特別な意味を持ちません。
.php
ファイル システムからロードするときは、完全修飾された名前空間とクラスに接尾辞 が付けられます。
- ベンダー名、名前空間、およびクラス名のアルファベット文字は、小文字と大文字の任意の組み合わせにすることができます。
例
\Doctrine\Common\IsolatedClassLoader
=>/path/to/project/lib/vendor/Doctrine/Common/IsolatedClassLoader.php
\Symfony\Core\Request
=>/path/to/project/lib/vendor/Symfony/Core/Request.php
\Zend\Acl
=>/path/to/project/lib/vendor/Zend/Acl.php
\Zend\Mail\Message
=>/path/to/project/lib/vendor/Zend/Mail/Message.php
名前空間とクラス名のアンダースコア
\namespace\package\Class_Name
=>/path/to/project/lib/vendor/namespace/package/Class/Name.php
\namespace\package_name\Class_Name
=>/path/to/project/lib/vendor/namespace/package_name/Class/Name.php
ここで設定した基準は、痛みのないオートローダーの相互運用性を実現するための最小公約数でなければなりません。PHP 5.3 クラスをロードできるこのサンプル SplClassLoader 実装を利用して、これらの標準に従っていることをテストできます。
実装例
以下は、上記の提案された標準がどのように自動ロードされるかを簡単に示すための関数の例です。
<?php
function autoload($className)
{
$className = ltrim($className, '\\');
$fileName = '';
$namespace = '';
if ($lastNsPos = strrpos($className, '\\')) {
$namespace = substr($className, 0, $lastNsPos);
$className = substr($className, $lastNsPos + 1);
$fileName = str_replace('\\', DIRECTORY_SEPARATOR, $namespace) . DIRECTORY_SEPARATOR;
}
$fileName .= str_replace('_', DIRECTORY_SEPARATOR, $className) . '.php';
require $fileName;
}
SplClassLoader の実装
次の要点は、上記で提案されたオートローダーの相互運用性標準に従う場合に、クラスをロードできる SplClassLoader 実装のサンプルです。これらの標準に準拠する PHP 5.3 クラスをロードする現在推奨されている方法です。