PSR-0
다음은 오토로더 상호 운용성을 위해 반드시 준수해야하는 필수 요구 사항에 대해 설명합니다.
- 정규화된 네임스페이스 및 클래스는 다음과 같은 구조를 따라야 합니다.
\<Vendor Name>\(<Namespace>\)*<Class Name> - 각 네임스페이스의 최상위 네임스페이스에는
공급자(Vendor)의 이름을 사용해야 합니다. - 각 네임스페이스는 원하는 만큼의 하위 네임스페이스를 가질 수 있습니다.
- 각 네임스페이스의 구분기호는
DIRECTORY_SEPARATOR로 변환됩니다. - CLASS 이름에서 각
_문자는DIRECTORY_SEPARATOR로 변환됩니다._는 네임스페이스에서 특별한 의미가 없습니다. - 규칙에 맞게 작성된 클래스를 파일시스템에서 불러올 때
.php가 마지막에 붙습니다. - 공급자(Vendor) 이름, 네임 스페이스 및 클래스 이름의 알파벳 문자는 소문자와 대문자의 조합으로 구성 될 수 있습니다.
\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;
}
spl_autoload_register('autoload');
다음 샘플은 위에 제안 된 오토로더 표준을 따를때 클래스를 자동으로 로드 할 수 있는 SplClassLoader의 구현 예제입니다.
PHP 5.3에서 PSR-0을 따르는 클래스를 로드하는 방법 중 현재 권장되는 방법입니다.