rvxlab / laravel-analytics
Simple and lightweight analytics and tag manager for Laravel
Requires
- php: ^8.2
- illuminate/contracts: ^10 || ^11
- illuminate/database: ^10 || ^11
- illuminate/http: ^10||^11
- illuminate/support: ^10 || ^11
Requires (Dev)
- ergebnis/composer-normalize: ^2.43
- larastan/larastan: ^2.7
- laravel/pint: ^1.0
- orchestra/testbench: ^8.16 || ^9.0
- pestphp/pest: ^2.0
- pestphp/pest-plugin-laravel: ^2.0
- pestphp/pest-plugin-watch: ^2.1
- phpstan/extension-installer: ^1.4
README
🚧 This package is still a work in progress
A simple, extremely lightweight analytics package.
Requirements
- Laravel 10+
Installation
Install using Composer:
composer require rvxlab/laravel-analytics
Publish and run the migrations:
php artisan vendor:publish --tag="analytics-migrations"
php artisan migrate
Optional: Publish the config file:
php artisan vendor:publish --tag="analytics-config"
Setting up
There are 2 ways of setting up analytics:
- Globally
- In a route group
Globally (Laravel 11)
Add the RVxLab\Analytics\Middleware\RecordPageView
middleware by calling append
or appendToGroup
on the Illuminate\Foundation\Configuration\Middlewares
parameter of the withMiddleware
call:
use Illuminate\Foundation\Application; use Illuminate\Foundation\Configuration\Middleware; use RVxLab\Analytics\Middleware\RecordPageView; return Application::configure(basePath: dirname(__DIR__)) ->withMiddleware(function (Middleware $middleware) { $middleware->append([RecordPageView::class]); // OR $middleware->appendToGroup('<middlewareGroup>', [RecordPageView::class]); })->create();
Globally (Laravel 10 and 11 without the new slim skeleton)
Add the RVxLab\Analytics\Middleware\RecordPageView
middleware to the end of your middleware
array or the relevant group in your middlewareGroups
array of your App\Http\Kernel
:
namespace App\Http; use RVxLab\Analytics\Middleware\RecordPageView; class Kernel { protected $middleware = [ // --snip-- RecordPageView::class, ]; protected $middlewareGroups = [ 'web' => [ // --snip-- RecordPageView::class, ], ]; }
Per route
You can add the RVxLab\Analytics\Middleware\RecordPageView
middleware to a single route or to a group of routes:
use App\Http\Controllers\HomeController; use RVxLab\Analytics\Middleware\RecordPageView; Route::get('/', HomeController::class)->middleware([RecordPageView::class]); // OR Route::middleware([RecordPageView::class])->group(function () { Route::get('/', HomeController::class); });
Dealing with proxies
If your application is behind a proxy, make sure that proxy is defined in the trusted proxies.
Not doing so will cause the address in your analytics to always be 127.0.0.1
.
For example, if you use a simple site provisioned through Laravel Forge, you will want to add '127.0.0.1'
to your trusted proxies. If you're behind a load balance through AWS or go through CloudFlare, you may not know what IP the request will come from. In that case, just add '*'
to your trusted proxies.
See the Laravel documentation on trusted proxies for more information.
Using a separate database
If you wish to use a separate database for analytics, add an ANALYTICS_DB_CONNECTION
environment variable and set it to the connection you want to use. Make sure it exists in your config/database.php
file.
Changelog
Please see the Changelog for more information on what has changed recently.
License
The MIT License (MIT). Please see the License File for more information.