Download the PHP package usesorane/sorane-laravel without Composer
On this page you can find all versions of the php package usesorane/sorane-laravel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download usesorane/sorane-laravel
More information about usesorane/sorane-laravel
Files in usesorane/sorane-laravel
Package sorane-laravel
Short Description This package provides the integration for Sorane, a tool for monitoring your Laravel applications.
License MIT
Homepage https://github.com/usesorane/sorane-laravel
Informations about the package sorane-laravel
Sorane: Web Application Monitoring for Laravel.
Sorane is an all-in-one tool for Error Tracking, Website Analytics, and Website Monitoring for websites made with Laravel.
It alerts you about errors in your applications and provides the context you need to fix them.
Sorane’s Website Analytics is fully server-side, with a focus on privacy-first tracking. It only collects essential visit data without cookies, invasive fingerprinting, or intrusive scripts.
It also keeps an eye on your website’s health. Sorane monitors uptime, performance, SSL certificates, domain and DNS status, Lighthouse scores, and broken links. So when something goes wrong, you’ll know.
Check out the Sorane website for more information.
Installation
You can install the package via composer:
You can publish the config file with:
This is the contents of the published config file:
Usage
Event Tracking
Sorane makes it easy to track custom events in your Laravel application. You can track anything from e-commerce events to user interactions.
Privacy-First Approach: Event tracking uses the same privacy-focused fingerprinting as website analytics:
- User agents are hashed with SHA256 (never stored in plain text)
- Session IDs are generated from hashed IP + user agent + date (daily rotation)
- IP addresses are never sent to Sorane
- Only essential data is collected for linking events and visits
Basic Event Tracking
Event Name Validation
Sorane enforces strict event naming conventions to ensure consistency and prevent categorization issues:
- Format:
snake_case
(lowercase with underscores) - Length: 3-50 characters
- Start: Must begin with a letter
- Characters: Only letters, numbers, and underscores allowed
Valid examples: user_registered
, product_added_to_cart
, newsletter_signup
Invalid examples: User Registered
, product-added
, 123_event
, user@registered
E-commerce Event Tracking
Sorane provides convenient helper methods for common e-commerce events with predefined naming:
Available Event Constants
Use predefined constants to ensure consistent naming and avoid typos:
Configuration
Event tracking can be configured in your config/sorane.php
file:
enabled
: Enable or disable event trackingqueue
: Whether to send events via Laravel queues (recommended for production)queue_name
: Which queue to use for sending events
Testing Event Tracking
You can test your event tracking setup using the included command:
This will send various test events to your Sorane dashboard.
Centralized Logging
Sorane provides centralized logging capabilities that capture and store all your application logs in one place. This makes it easy to monitor, search, and analyze log data across your entire application.
Laravel Integration: The recommended approach is to integrate Sorane with Laravel's built-in logging system using log stacks.
Laravel Logging Integration (Recommended)
Add the Sorane driver to your config/logging.php
:
Set your log channel in config/app.php
or .env
:
Now all your application logs will automatically be sent to both files and Sorane:
Configuration
Logging can be configured in your config/sorane.php
file:
Add to your .env
file:
Optional Configuration (with defaults):
All optional settings use sensible defaults, so you only need to set them if you want to customize the behavior.
Available Log Levels
Standard PSR-3 log levels are supported:
emergency
- System is unusablealert
- Action must be taken immediatelycritical
- Critical conditionserror
- Error conditionswarning
- Warning conditionsnotice
- Normal but significant conditioninfo
- Informational messagesdebug
- Debug-level messages
Testing Logging
You can test your logging configuration using the included command:
This will send various test logs to your Sorane dashboard and display your current configuration.
Error Tracking & Website Analytics
Please refer to the Sorane website for more information on how to use Sorane.
Testing
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- Sorane
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of sorane-laravel with dependencies
illuminate/contracts Version ^10.0||^11.0||^12.0
jaybizzle/crawler-detect Version ^1.3
spatie/laravel-package-tools Version ^1.16