Como o PHP encontra uma classe
O autoload é o mecanismo que carrega a definição de uma classe quando o programa tenta usá-la e ela ainda não está definida. No PHP, você registra uma função com spl_autoload_register(). O PHP chama essa função com o nome procurado, então ela pode localizar e incluir o arquivo que contém a definição.
A função de carregamento precisa associar o nome da classe a um arquivo. Esse caminho pode seguir uma convenção do projeto ou uma configuração gerada pelo Composer. Criar um arquivo PHP numa pasta qualquer não o torna acessível ao carregador.
Uma classe chamada Relatorio
Neste exemplo didático, Relatorio.php fica na mesma pasta do script e declara class Relatorio {}, sem namespace. O carregador atende somente a essa classe:
<?phpspl_autoload_register(function (string $classe): void { if ($classe === 'Relatorio') { require __DIR__ . '/Relatorio.php'; }});
$relatorio = new Relatorio();echo get_class($relatorio);A expressão new Relatorio() leva o PHP a acionar o carregador. Após a inclusão do arquivo, a instância é criada e o exemplo imprime Relatorio. O teste depende de o arquivo declarar essa classe. Incluir um arquivo com outro nome de classe mantém a definição procurada ausente.
O exemplo usa uma correspondência fixa para mostrar o mecanismo. Num projeto com Composer, a configuração de autoload descreve como localizar as classes da aplicação e das dependências. Quando aparecer um erro de classe não encontrada, confira o nome completo da classe com o namespace. Depois compare o caminho do arquivo com a configuração de carregamento.
Dúvidas frequentes
Perguntas frequentes sobre autoload
- O autoload também carrega funções comuns do PHP?
- O mecanismo registrado por spl_autoload_register atende a classes e construções semelhantes, como interfaces. Para funções comuns de um projeto, o Composer oferece a configuração files, que inclui os arquivos quando vendor/autoload.php é carregado.
- Posso registrar mais de um carregador?
- Sim. O PHP permite registrar vários carregadores com spl_autoload_register. Uma exceção lançada por um deles interrompe a sequência, por isso o comportamento de cada função pode afetar as seguintes.
- Preciso escrever um carregador para cada biblioteca instalada?
- O Composer gera vendor/autoload.php com as configurações de carregamento das bibliotecas que administra. Você inclui esse arquivo na aplicação e usa as classes previstas nessas configurações.
Para continuar
Recursos relacionados
Documentação
PHP: carregamento automático de definições
Explica quando o PHP aciona os carregadores e quais tipos de definição podem ser carregados.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Sessão ao vivo para investigar uma classe que o PHP não encontra, com você no editor e orientação técnica durante os ajustes.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Você confere o nome da classe e o arquivo previsto pelo autoload ao revisar uma alteração feita com agentes de código.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.