Repolode
filp

filp/whoops

Um framework de tratamento de erros para PHP que substitui a saída de erro padrão por uma página de depuração legível e respostas estruturadas em JSON/XML.

Estrelas
13,226
Forks
599
Issues abertas
7
Último commit
há 7 dias

O que é?

Whoops é um framework de tratamento de erros para PHP que permite empilhar handlers. Sua saída principal é uma página de erro detalhada para projetos web, que mostra a exceção, o stack trace e o trecho de código ao redor, agilizando a depuração durante o desenvolvimento.

Além da página HTML, Whoops inclui handlers para saída em texto puro em aplicações CLI e para respostas em JSON e XML adequadas a requisições AJAX e APIs. Os handlers podem ser empilhados e combinados; também é possível registrar closures ou callables como handlers. Os arquivos referenciados podem ser abertos diretamente em um editor ou IDE.

A biblioteca não tem dependências obrigatórias e pode ser instalada com Composer. Muitos frameworks, incluindo Laravel e Mezzio, já a incluem, e há integrações da comunidade para outros, como Slim, CakePHP e Zend.

Recursos principais

  • 01Handler de erros baseado em pilha que encadeia vários handlers
  • 02Página de erro HTML formatada, com stack trace e contexto do código-fonte
  • 03Handlers de resposta em JSON, XML e texto puro
  • 04Abre arquivos referenciados diretamente em um editor ou IDE
  • 05Sem dependências obrigatórias e instalável via Composer

Casos de uso

  • Depurar aplicações web em PHP durante o desenvolvimento
  • Retornar respostas de erro estruturadas em endpoints AJAX ou de API
  • Exibir mensagens de erro legíveis em ferramentas de linha de comando em PHP

Início rápido

  1. 1

    Instale o Whoops no seu projeto PHP com o Composer

    composer require filp/whoops
  2. 2

    Registre o manipulador de erros formatado no seu código

Tópicos

Perguntas frequentes

O que é whoops?
Um framework de tratamento de erros para PHP que substitui a saída de erro padrão por uma página de depuração legível e respostas estruturadas em JSON/XML. Whoops é um framework de tratamento de erros para PHP que permite empilhar handlers. Sua saída principal é uma página de erro detalhada para projetos web, que mostra a exceção, o stack trace e o trecho de código ao redor, agilizando a depuração durante o desenvolvimento.
whoops é gratuito? Qual é a licença?
whoops é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
whoops ainda é mantido?
Manutenção ativa. O último commit de whoops foi em 18 de out. de 2026.
Para que posso usar whoops?
Depurar aplicações web em PHP durante o desenvolvimento Retornar respostas de erro estruturadas em endpoints AJAX ou de API Exibir mensagens de erro legíveis em ferramentas de linha de comando em PHP
Como instalar whoops?
Instale o Whoops no seu projeto PHP com o Composer: composer require filp/whoops Registre o manipulador de erros formatado no seu código
Onde consigo whoops?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/filp/whoops

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados