PSR-0:自动加载标准

自动加载标准

已弃用 - 自2014-10-21起,PSR-0已被标记为已弃用。PSR-4现在被推荐作为替代品。

以下描述了自动装带器互操作性必须遵守的强制性要求。

强制性

  • 完全限定的命名空间和类必须具有以下结构 \<Vendor Name>\(<Namespace>\)*<Class Name>
  • 每个名称空间必须具有顶级名称空间(“供应商名称”)。
  • 每个命名空间可以包含任意数量的子命名空间。
  • 每个命名空间分隔符DIRECTORY_SEPARATOR在从文件系统加载时转换为
  • _CLASS NAME中的每个字符都转换为a 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;
}
spl_autoload_register('autoload');

SplClassLoader实现

以下要点是一个示例SplClassLoader实现,如果您遵循上面提出的自动加载器互操作性标准,它可以加载您的类。这是目前推荐的加载符合这些标准的PHP 5.3类的方法。