Repolode
itsgoingd

itsgoingd/clockwork

Ferramenta de desenvolvimento PHP que mostra dados de requisições, consultas, logs, timelines e muito mais no navegador, principalmente em apps Laravel.

Alternativa open source a:Laravel Telescope

Estrelas
5,947
Forks
332
Issues abertas
39
Último commit
há 2 meses

O que é?

O Clockwork é uma ferramenta de desenvolvimento PHP que dá visibilidade ao que acontece na sua aplicação durante a execução. Ele coleta dados de requisições, métricas de desempenho, entradas de log, consultas ao banco de dados, comandos de cache e Redis, eventos disparados, jobs na fila e views renderizadas em requisições HTTP, comandos Artisan, jobs na fila e testes.

Este repositório contém o componente do lado do servidor. Ele é instalado com o Composer e coleta dados enquanto o app está em execução. Os dados coletados podem ser consultados pela interface web integrada em `/clockwork`, por uma extensão para Chrome ou Firefox ou por uma toolbar do lado do cliente. A coleta pode ser limitada ao modo sob demanda, a respostas de erro, a respostas lentas ou a requisições que correspondam a uma closure personalizada.

Os desenvolvedores podem registrar variáveis arbitrárias com o helper `clock()`, que retorna o primeiro argumento para que possa ser inserido inline. Uma API de timeline permite marcar trechos nomeados do código e ver quanto tempo levam.

Recursos principais

  • 01Coleta requisições, consultas ao banco de dados e ao cache, comandos Redis, logs, eventos, jobs e views.
  • 02Funciona com requisições HTTP, comandos Artisan, jobs na fila e testes.
  • 03Permite visualizar os dados em uma página web integrada, em uma extensão para navegador ou em uma toolbar.
  • 04Oferece modos de coleta configuráveis, como sob demanda, somente erros e somente respostas lentas.
  • 05Registra variáveis com o helper `clock()` e marca a duração de trechos do código com uma API de timeline.
  • 06Detecta consultas duplicadas ao banco de dados (N+1) e captura stack traces.

Casos de uso

  • Depurar consultas ao banco de dados e o desempenho de uma aplicação Laravel durante o desenvolvimento.
  • Inspecionar requisições de API feitas por um app mobile ou pelo frontend sem usar um debugger no navegador.
  • Analisar o desempenho de jobs na fila e comandos Artisan para identificar onde o tempo é gasto.
  • Registrar variáveis inline ao investigar um bug em código PHP.

Início rápido

  1. 1

    Instale a biblioteca com o Composer

    composer require itsgoingd/clockwork
  2. 2

    Publique o arquivo de configuração para habilitar recursos extras (Laravel)

    php artisan vendor:publish --provider="Clockwork\Support\Laravel\ClockworkServiceProvider"
  3. 3

    Abra a rota /clockwork no seu app para ver os dados coletados

Antes de usar

  • Por padrão, o Clockwork só fica ativo no modo de depuração.
  • Este repositório contém apenas o componente do lado do servidor; para visualizar os dados, também é necessária a extensão do navegador ou a interface integrada /clockwork.
  • O conjunto de recursos é mais completo em apps Laravel.

Em coleções

Tópicos

Perguntas frequentes

O que é clockwork?
Ferramenta de desenvolvimento PHP que mostra dados de requisições, consultas, logs, timelines e muito mais no navegador, principalmente em apps Laravel. O Clockwork é uma ferramenta de desenvolvimento PHP que dá visibilidade ao que acontece na sua aplicação durante a execução. Ele coleta dados de requisições, métricas de desempenho, entradas de log, consultas ao banco de dados, comandos de cache e Redis, eventos disparados, jobs na fila e views renderizadas em requisições HTTP, comandos Artisan, jobs na fila e testes.
clockwork é gratuito? Qual é a licença?
clockwork é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
clockwork ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de clockwork foi em 29 de ago. de 2026.
Para que posso usar clockwork?
Depurar consultas ao banco de dados e o desempenho de uma aplicação Laravel durante o desenvolvimento. Inspecionar requisições de API feitas por um app mobile ou pelo frontend sem usar um debugger no navegador. Analisar o desempenho de jobs na fila e comandos Artisan para identificar onde o tempo é gasto. Registrar variáveis inline ao investigar um bug em código PHP.
Como instalar clockwork?
Instale a biblioteca com o Composer: composer require itsgoingd/clockwork Publique o arquivo de configuração para habilitar recursos extras (Laravel): php artisan vendor:publish --provider="Clockwork\Support\Laravel\ClockworkServiceProvider" Abra a rota /clockwork no seu app para ver os dados coletados
Onde consigo clockwork?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/itsgoingd/clockwork

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

Projetos relacionados