Skip to content

Latest commit

 

History

History
executable file
·
60 lines (45 loc) · 2.99 KB

PSR-0.md

File metadata and controls

executable file
·
60 lines (45 loc) · 2.99 KB
Raw

A seguir, o manual com os requisitos obrigatórios que devem ser seguidos para a interoperabilidade de autocarregamento (autoloading).

Obrigatório

  • Uma namespace totalmente qualificada e as classes devem seguir a seguinte estrutura \<Nome de Fornecedor>\(<Namespace>\)*<Nome da Classe>
  • Cada namespace deve ter uma namespace de nível superior ("Nome de Fornecedor").
  • Cada namespace pode ter quantos sub-namespaces que quiser.
  • Cada separador de namespace é convertido para DIRECTORY_SEPARATOR durante o carregamento do sistema de arquivos.
  • Cada caractere _ no nome da classe é convertido para DIRECTORY_SEPARATOR. O caractere _não tem nenhum significado especial na namespace.
  • A namespace totalmente qualificada e a classe é sufixada com .php durante o carregamento do sistema de arquivos.
  • Caracteres alfabéticos em nomes de fornecedor, namespaces e nomes de classe podem ser de qualquer combinação de letras maiúsculas ("upper case") e minúsculas ("lower case").

Exemplos

  • \Doctrine\Common\IsolatedClassLoader => /caminho/para/projeto/lib/vendor/Doctrine/Common/IsolatedClassLoader.php
  • \Symfony\Core\Request => /caminho/para/projeto/lib/vendor/Symfony/Core/Request.php
  • \Zend\Acl => /caminho/para/projeto/lib/vendor/Zend/Acl.php
  • \Zend\Mail\Message => /caminho/para/projeto/lib/vendor/Zend/Mail/Message.php

Underscores em Namespaces e Nomes de Classe

  • \namespace\package\Class_Name => /caminho/para/projeto/lib/vendor/namespace/package/Class/Name.php
  • \namespace\package_name\Class_Name => /caminho/para/projeto/lib/vendor/namespace/package_name/Class/Name.php

Os padrões que definimos aqui devem ser o menor denominador comum para uma indolor interoperabilidade de autocarregamento. Você pode testar se está seguindo esses padrões utilizando esta amostra da implementação da SplClassLoader que é capaz de carregar classes do PHP 5.3.

Implementação Exemplo

Abaixo está uma função de exemplo para simplesmente demonstrar como os padrões propostos acima são autocarregados.

<?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;
}

Implementação da SplClassLoader

O seguinte gist é um exemplo de implementação da SplClassLoader que pode carregar suas classes se você seguir as propostas de interoperabilidade de autocarregamento citadas acima. Essa é a forma recomendada atual para carregar classes de PHP 5.3 que seguem estes padrões.