Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é autoload?

    O autoload carrega classes ainda não definidas quando o PHP precisa delas. O carregador procura os arquivos conforme a configuração registrada no projeto.

    Também chamado de: carregamento automático de classes

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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:

    <?php
    spl_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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano