Об этом проекте

Rybbit Sdk For Laravel — это Composer-пакет, который интегрирует открытую privacy-friendly платформу аналитики Rybbit в Laravel-приложения. Он предоставляет нативный Laravel API как для клиентского, так и для серверного трекинга. Ключевые возможности: - **Blade-директива**: тег `@rybbit` внедряет скрипт трекинга Rybbit в представления, поддерживая атрибуты `data-debounce`, `data-tag`, `data-skip-patterns` и `data-mask-patterns`. - **Серверный трекинг событий**: фасад `Rybbit` отправляет pageviews, пользовательские события, метрики производительности, клики вовне и ошибки напрямую на `/api/track` Rybbit из бэкенда. - **Запросы по пользователям**: чтение пользователей сайта, поиск индивидуальных профилей пользователей и устройств, получение дневных счётчиков сессий или удаление данных пользователей через read API Rybbit. - **Обзорная статистика**: получение ключевых KPI, дискретизированных временных рядов (ежедневно/ежечасно/еженедельно), счётчиков живых посетителей и разбивки по размерностям: страница, страна, браузер и др. - **Туннельный прокси**: по умолчанию пакет регистрирует локальные маршруты, которые проксируют трекинговые запросы (скрипт, track, identify, replay сессий, конфигурация сайта) через собственный домен приложения, обходя блокировщики рекламы и встроенную защиту приватности браузеров. Клиентские IP определяются из `X-Forwarded-For` и передаются дальше. Неудавшиеся запросы переотправляются, а данные replay сессий используют queued jobs. - **Поддержка тестирования**: `Rybbit::fake()` заменяет фасад on-memory spy, записывающим каждый вызов и предоставляющим вспомогательные методы для ассертов над всеми методами трекинга и запросов. - **Laravel Boost skill**: поставляется Agent Skill для AI coding agent Laravel Boost. Конфигурация управляется переменными окружения (`RYBBIT_SITE_ID`, `RYBBIT_HOST`, `RYBBIT_API_KEY` и др.) и опубликованным файлом `config/rybbit.php`. Пакет поддерживает как Rybbit Cloud, так и self-hosted экземпляры Rybbit. Покрытие функций включает внедрение скрипта, туннелирование, серверные события и read-запросы; goals, funnels, sessions и административные endpoints не покрыты.