itsgoingd/clockwork

어떤 프로젝트인가요?

핵심 기능

• 01요청, 데이터베이스 및 캐시 쿼리, Redis 명령, 로그, 이벤트, 작업, 뷰를 수집합니다.
• 02HTTP 요청, Artisan 명령, 큐 작업 및 테스트에서 사용할 수 있습니다.
• 03기본 제공 웹 페이지, 브라우저 확장 프로그램 또는 툴바에서 데이터를 확인할 수 있습니다.
• 04요청 시 수집, 오류만 수집, 느린 요청만 수집 등의 수집 모드를 설정할 수 있습니다.
• 05clock() 헬퍼로 변수를 로그에 남기고 타임라인 API로 코드 실행 시간을 표시합니다.
• 06중복(N+1) 데이터베이스 쿼리를 감지하고 스택 트레이스를 캡처합니다.

활용 사례

• 개발 중 Laravel 애플리케이션의 데이터베이스 쿼리와 성능을 디버깅합니다.
• 브라우저 기반 디버거 없이 모바일 앱이나 프런트엔드에서 보낸 API 요청을 살펴봅니다.
• 큐 작업과 Artisan 명령을 프로파일링해 시간이 어디에 쓰이는지 확인합니다.
• PHP 코드의 버그를 추적하면서 변수 값을 인라인으로 로그에 남깁니다.

빠른 시작

1. 1

   Composer로 라이브러리를 설치하세요

   composer require itsgoingd/clockwork
2. 2

   추가 기능을 활성화하려면 설정 파일을 퍼블리시하세요(Laravel)

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

   앱에서 /clockwork 경로를 열어 수집된 데이터를 확인하세요

사용 전 알아둘 점

• !기본적으로 Clockwork는 디버그 모드에서만 활성화됩니다.
• !이 저장소에는 서버 측 구성 요소만 포함되어 있습니다. 데이터를 보려면 브라우저 확장 프로그램이나 내장된 /clockwork 인터페이스도 필요합니다.
• !Laravel 앱에서 기능을 가장 잘 활용할 수 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

clockwork은(는) 무엇인가요?

주로 Laravel 앱을 위한 PHP 개발 도구로, 브라우저에서 요청 데이터와 쿼리, 로그, 타임라인 등을 확인할 수 있습니다. Clockwork는 애플리케이션이 실행되는 동안 내부를 살펴볼 수 있게 해주는 PHP 개발 도구입니다. HTTP 요청, Artisan 명령, 큐 작업 및 테스트에서 요청 데이터, 성능 지표, 로그 항목, 데이터베이스 쿼리, 캐시 및 Redis 명령, 디스패치된 이벤트, 대기열에 추가된 작업, 렌더링된 뷰를 수집합니다.

clockwork은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

clockwork은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

clockwork은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. clockwork의 마지막 커밋은 2026년 8월 29일입니다.

clockwork은(는) 어디에 사용할 수 있나요?

개발 중 Laravel 애플리케이션의 데이터베이스 쿼리와 성능을 디버깅합니다. 브라우저 기반 디버거 없이 모바일 앱이나 프런트엔드에서 보낸 API 요청을 살펴봅니다. 큐 작업과 Artisan 명령을 프로파일링해 시간이 어디에 쓰이는지 확인합니다. PHP 코드의 버그를 추적하면서 변수 값을 인라인으로 로그에 남깁니다.

clockwork는 어떻게 설치하나요?

Composer로 라이브러리를 설치하세요: composer require itsgoingd/clockwork 추가 기능을 활성화하려면 설정 파일을 퍼블리시하세요(Laravel): php artisan vendor:publish --provider="Clockwork\Support\Laravel\ClockworkServiceProvider" 앱에서 /clockwork 경로를 열어 수집된 데이터를 확인하세요

clockwork은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/itsgoingd/clockwork