以下是 PSR-0 的要求:
以下描述了自动加载器互操作性必须遵守的强制性要求。
强制的
- 完全限定的命名空间和类必须具有以下结构
\<Vendor Name>\(<Namespace>\)*<Class Name>
- 每个命名空间都必须有一个顶级命名空间(“供应商名称”)。
- 每个命名空间都可以拥有任意数量的子命名空间。
DIRECTORY_SEPARATOR
从文件系统加载时,每个命名空间分隔符都会转换为 a 。
- 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 类的方法。