Site Doctor
O Site Doctor verifica a configuração do projeto usando seus runtimes efetivos de PHP e Node. Em Projetos, selecione um projeto e escolha Diagnóstico, ou use Diagnosticar todos no cabeçalho.
Revise muitos projetos
A visão geral resume os projetos que precisam de atenção e os que não têm problemas confirmados. Filtre por Todos os projetos, Precisam de atenção ou Saudáveis; busque por nome ou caminho; e escolha 10, 20 ou 50 projetos por página. Os projetos que precisam de atenção aparecem primeiro.
Abra um projeto para revisar suas verificações. Voltar para todos os projetos preserva a busca, o filtro e a página. Verificar novamente nos detalhes atualiza aquele projeto e as contagens gerais. Executar a visão geral nunca corrige projetos em lote.
Entenda o resultado
| Resultado | Significado |
|---|---|
| Tudo certo | A verificação inspecionada passou. |
| Falhou / Atenção | Um problema confirmado precisa de atenção. |
| Opcional | Sugestão que não prejudica a saúde do projeto. |
| Não verificado | A verificação não se aplica, depende de outra ou não pôde ser confirmada automaticamente. |
Saudável significa que não foram encontradas falhas ou avisos nas verificações realizadas. Não confirma verificações não realizadas nem comprova todas as rotas da aplicação. A visão geral também identifica projetos pausados e conta verificações opcionais e não realizadas.
Revisão manual oferece orientação quando não há correção automática. A ausência de um botão não elimina um problema confirmado: banco parado, falha de autenticação ou runtime incompatível ainda podem exigir ação. Inspeções inconclusivas aparecem como não verificadas, sem serem tratadas como falhas confirmadas.
Verificações e correções
O Doctor verifica raiz pública, compatibilidade de PHP e Node, dependências do Composer e Node, .env e chave Laravel, link opcional do storage público, configuração WordPress, conexão do banco, migrações Laravel, virtual hosts, entradas do hosts do Windows e serviços necessários para servir PHP.
As correções aparecem quando seus pré-requisitos estão prontos. Incluem instalar dependências, copiar um .env.example ausente, gerar uma chave ausente, criar um link opcional do storage, criar um banco local ausente nos casos suportados, executar migrações pendentes, regenerar configuração web, atualizar hosts e iniciar serviços necessários que estejam parados.
As correções são individuais e exibem a saída do comando. Ao terminar, o projeto afetado é verificado novamente. Downloads de runtimes exigem seu clique. Cancelar correção pede interrupção; ações já concluídas não são desfeitas.
Executar migrações exige confirmação específica porque pode alterar estrutura e dados do banco. Substituir um virtual host personalizado também exige confirmação.
Storage público é opcional
O link public/storage do Laravel é útil quando a aplicação serve arquivos do disco público padrão em storage/app/public. Projetos com storage externo ou sem uploads públicos podem não precisar dele.
Links ausentes são sugestões opcionais. Links simbólicos e junctions do Windows para o destino padrão passam. Pastas, arquivos ou links existentes para outro destino são preservados; o Doctor nunca os remove para criar um link. Revise-os somente se a aplicação precisar do disco público padrão.
Limites da inspeção de banco
O Doctor preserva as credenciais configuradas pelo projeto. A inspeção automática de conexão MySQL e PostgreSQL se limita a configurações locais reconhecidas com localhost, 127.0.0.1 ou ::1 e portas padrão 3306 ou 5432. Criar um banco ausente também depende da permissão do usuário configurado. SQLite verifica o arquivo configurado sem oferecer criação automática.
Bancos externos, outras portas válidas, configurações calculadas e cache de configuração Laravel podem impedir a verificação. A sondagem usa configurações locais literais e o PHP efetivo sem carregar a aplicação. Erros desconhecidos, sondagens indisponíveis ou resultados inválidos ficam como não verificados; não liberam criação de banco nem migrações.
Problemas reconhecidos de transporte, autenticação, banco ausente e extensão continuam exigindo atenção. Por exemplo, inicie o MySQL local se estiver parado e execute novamente o diagnóstico. Uma porta inválida gera aviso de configuração; portas válidas vão de 1 a 65535.