PHPackages                             viezel/laravel-amplitude - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. viezel/laravel-amplitude

ActiveLibrary[Utility & Helpers](/categories/utility)

viezel/laravel-amplitude
========================

A Laravel package to work with Amplitude.

1.2.0(1y ago)041.5k—8.6%2MITPHPPHP ^8.2|^8.3

Since Dec 16Pushed 1y agoCompare

[ Source](https://github.com/viezel/laravel-amplitude)[ Packagist](https://packagist.org/packages/viezel/laravel-amplitude)[ Docs](https://github.com/viezel/laravel-amplitude)[ RSS](/packages/viezel-laravel-amplitude/feed)WikiDiscussions master Synced today

READMEChangelog (2)Dependencies (4)Versions (8)Used By (0)

Laravel package for Amplitude API.
==================================

[](#laravel-package-for-amplitude-api)

Installation
------------

[](#installation)

```
composer require viezel/laravel-amplitude
```

The `AMPLITUDE_API_URL` is either US or EU based. Please pay attention.

```
AMPLITUDE_API_KEY=
AMPLITUDE_API_URL=https://api.eu.amplitude.com/2/httpapi
```

```
'aliases' => [
    ...

    'Amplitude' => LaravelAmplitude\Facades\Amplitude::class
]
```

Usage
-----

[](#usage)

Laravel Amplitude uses a simple syntax to track your product events easily.

### Setting the User Id

[](#setting-the-user-id)

First of all, before sending anything, you will need to set the User ID.

```
Amplitude::setUserId('user_id');
```

Note: setting the user id is MANDATORY. Otherwise, you will get an error when trying to send data to Amplitude.

### Sending Events

[](#sending-events)

Once the user id is set, you are ready to send events to your Amplitude project.

```
// simple sending...
Amplitude::sendEvent('app_opened');

// sending with properties...
Amplitude::sendEvent('subscription_paid', ['was_trial' => true]);
```

Also, you can change the user properties with the dedicated method `setUserProperties`:

```
// properties new values are set here
Amplitude::setUserProperties([
    'trial' => false,
    'plan' => 'professional'
]);

// data is sent to Amplitude here
Amplitude::sendEvent('subscription_paid', ['was_trial' => true]);
```

IMPORTANT: the properties will be sent to Amplitude at the next `sendEvent` call. Without any other call to `sendEvent`, the new user properties are not going to be saved.

### Queueing Events

[](#queueing-events)

If send a lot of events and you want to keep your performances good, you may choose events queueing instead of the simple sending you just saw.

With events queueing, **you will send all your events once the request is over**, instead of making different API calls during the request lifecycle.

To use it, just switch your `sendEvent` calls to `queueEvent` method.

```
// simple sending...
Amplitude::queueEvent('app_opened');

// sending with properties...
Amplitude::queueEvent('subscription_paid', ['was_trial' => true]);
```

Nothing more to do! When the request will be finished, Laravel Amplitude will automatically trigger the send operation of your data.

However, if you want more control and you want to send your queued events in your code, you can do it manually with a call to the `sendQueuedEvents` method.

```
// queueing an event...
Amplitude::queueEvent('app_opened');

// queueing another event...
Amplitude::queueEvent('subscription_paid', ['was_trial' => true]);

// send them!
Amplitude::sendQueuedEvents();
```

Credits
-------

[](#credits)

- [Francesco Malatesta](https://github.com/francescomalatesta)
- [All Contributors](../../contributors)

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance42

Moderate activity, may be stable

Popularity30

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 71.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~77 days

Recently: every ~116 days

Total

7

Last Release

465d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/1e24155f0d3ab61799ca35477a940edce613075a20d1073f2241905271f29d23?d=identicon)[viezel](/maintainers/viezel)

---

Top Contributors

[![francescomalatesta](https://avatars.githubusercontent.com/u/1940952?v=4)](https://github.com/francescomalatesta "francescomalatesta (23 commits)")[![viezel](https://avatars.githubusercontent.com/u/312065?v=4)](https://github.com/viezel "viezel (8 commits)")[![kondratovbr](https://avatars.githubusercontent.com/u/5469212?v=4)](https://github.com/kondratovbr "kondratovbr (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/viezel-laravel-amplitude/health.svg)

```
[![Health](https://phpackages.com/badges/viezel-laravel-amplitude/health.svg)](https://phpackages.com/packages/viezel-laravel-amplitude)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M345](/packages/psalm-plugin-laravel)[renatomarinho/laravel-page-speed

Laravel Page Speed

2.5k1.7M11](/packages/renatomarinho-laravel-page-speed)[illuminate/pagination

The Illuminate Pagination package.

12234.1M1.0k](/packages/illuminate-pagination)[illuminate/pipeline

The Illuminate Pipeline package.

9349.2M282](/packages/illuminate-pipeline)[illuminate/redis

The Illuminate Redis package.

8314.6M374](/packages/illuminate-redis)[illuminate/cookie

The Illuminate Cookie package.

244.6M137](/packages/illuminate-cookie)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)