laravel-plausible

Laravel Plausible는 Plausible Analytics를 Laravel 애플리케이션에 통합하는 패키지입니다. Plausible Stats API와 상호작용하기 위한 간단한 파사드를 제공하여, 개발자가 실시간 방문자 수, 집계 메트릭, 시간 시리즈 데이터, 다양한 속성별 분해 데이터를 가져올 수 있습니다. 설치 방법은 Composer를 사용해 composer require njoguamos/laravel-plausible 명령을 실행한 후 php artisan plausible:install로 설정 파일을 게시하면 됩니다. 설치 후 .env 파일에 Plausible 사이트 ID와 API 키를 추가해야 하며, 자체 호스팅 인스턴스의 경우 PLAUSIBLE_BASE_URL을 선택적으로 설정할 수 있습니다. 패키지는 여러 메서드를 제공합니다: Plausible::realtime()은 현재 방문자 수를 반환하고, Plausible::aggregates()는 기간, 메트릭, 비교, 필터, 날짜 범위, 가져온 데이터 포함 등 선택적 매개변수와 함께 요약 메트릭을 검색합니다. Plausible::timeSeries()는 구성 가능한 간격으로 시간별 데이터 포인트를 반환하며, Plausible::breakdown()은 페이지, 브라우저, 국가 등의 속성으로 그룹화된 통계를 한도, 페이지 처리, 필터링 지원을 포함해 제공합니다. API 호출을 줄이기 위해 응답은 기본값 3분 동안 캐시되며, 캐시 기간과 드라이버는 PLAUSIBLE_CACHE_DURATION 및 PLAUSIBLE_CACHE_DRIVER 환경 변수를 통해 조정하거나 PLAUSIBLE_CACHE=false로 캐시를 완전히 비활성화할 수 있습니다. 패키지는 composer test로 실행 가능한 테스트 스위트와 표준 Laravel 기여 가이드라인을 따릅니다.