PHPackages                             evntaly/evntaly-php - 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 &amp; Helpers](/categories/utility)
4. /
5. evntaly/evntaly-php

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

evntaly/evntaly-php
===================

PHP SDK for Evntaly

v1.1.2(1y ago)5261MITPHPPHP ^7.4 || ^8.0

Since Apr 1Pushed 1y ago1 watchersCompare

[ Source](https://github.com/Evntaly/evntaly-php)[ Packagist](https://packagist.org/packages/evntaly/evntaly-php)[ RSS](/packages/evntaly-evntaly-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (2)Versions (7)Used By (0)

 [![Evntaly Cover](https://camo.githubusercontent.com/f64598a37e0bd2847955d2bbec3c0da053b337d3031d7f6d85b4707e9f9166be/68747470733a2f2f63646e2e65766e74616c792e636f6d2f5265736f75726365732f6f672e706e67)](https://camo.githubusercontent.com/f64598a37e0bd2847955d2bbec3c0da053b337d3031d7f6d85b4707e9f9166be/68747470733a2f2f63646e2e65766e74616c792e636f6d2f5265736f75726365732f6f672e706e67)

Evntaly
=======

[](#evntaly)

 An advanced event tracking and analytics platform designed to help developers capture, analyze, and react to user interactions efficiently.

 The full documentation can be found at [Evntaly Documentation](https://evntaly.gitbook.io/evntaly/getting-started)

[![Latest Version on Packagist](https://camo.githubusercontent.com/6d9661520c7c84ff4794bbe6e68652b4a53ba6200c521f6ff7e35e93a481f309/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f65766e74616c792f65766e74616c792d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/evntaly/evntaly-php)[![MIT Licensed](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Total Downloads](https://camo.githubusercontent.com/e798323c4993ca048fff9b6a629242a080654c9475f7b69527a6b0be3c53e763/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f65766e74616c792f65766e74616c792d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/evntaly/evntaly-php)

evntaly-php
===========

[](#evntaly-php)

**evntaly-php** is a PHP client for interacting with the Evntaly event tracking platform. It provides developers with a straightforward interface to initialize the SDK, track events, identify users, manage tracking states, and potentially interact with other Evntaly API features within PHP applications.

Features
--------

[](#features)

- **Initialize** the SDK with a developer secret and project token.
- **Track events** with comprehensive metadata and tags.
- **Identify users** for personalization and detailed analytics.
- **Enable or disable** tracking globally within your application instance.

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

[](#installation)

Install the SDK using [Composer](https://getcomposer.org/):

```
composer require evntaly/evntaly-php
```

Usage
-----

[](#usage)

### Initialization

[](#initialization)

First, include the Composer autoloader in your project. Then, initialize the SDK with your developer secret and project token obtained from your [Evntaly dashboard](https://app.evntaly.com/account/settings/api).

```
use Evntaly\EvntalySDK;

$developerSecret = 'YOUR_DEVELOPER_SECRET';
$projectToken = 'YOUR_PROJECT_TOKEN';

$sdk = new EvntalySDK($developerSecret, $projectToken);
```

### Tracking Events

[](#tracking-events)

To track an event, use the `track` method with an associative array containing the event details.

```
$response = $sdk->track([
    "title" => "Payment Received",
    "description" => "User completed a purchase successfully",
    "message" => "Order #12345 confirmed for user.",
    "data" => [
        "user_id" => "usr_67890",
        "order_id" => "12345",
        "amount" => 99.99,
        "currency" => "USD",
        "payment_method" => "credit_card",
        "timestamp" => date('c'),
        "referrer" => "social_media",
        "email_verified" => true
    ],
    "tags" => ["purchase", "payment", "usd", "checkout-v2"],
    "notify" => true,
    "icon" => "💰",
    "apply_rule_only" => false,
    "user" => ["id" => "usr_0f6934fd-99c0-41ca-84f4"],
    "type" => "Transaction",
    "sessionID" => "sid_20750ebc-dabf-4fd4-9498",
    "feature" => "Checkout",
    "topic" => "@Sales"
]);
```

### Identifying Users

[](#identifying-users)

To identify or update user details, use the `identifyUser` method. This helps link events to specific users and enriches your analytics.

```
$response = $sdk->identifyUser([
    "id" => "usr_0f6934fd-99c0-41ca-84f4",
    "email" => "john.doe@example.com",
    "full_name" => "Johnathan Doe",
    "organization" => "ExampleCorp Inc.",
    "data" => [
        "username" => "JohnD",
        "location" => "New York, USA",
        "plan_type" => "Premium",
        "signup_date" => "2024-01-15T10:00:00Z",
        "timezone" => "America/New_York"
    ]
]);
```

### Enabling/Disabling Tracking

[](#enablingdisabling-tracking)

You can globally enable or disable event tracking for the current SDK instance. This might be useful for development/testing or respecting user consent.

```
// Disable tracking - subsequent track/identify calls will be ignored
$sdk->disableTracking();

// Re-enable tracking
$sdk->enableTracking();
```

Contributing
------------

[](#contributing)

Contributions are welcome! Please open an issue or submit a pull request on GitHub.

License
-------

[](#license)

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

Contributors
------------

[](#contributors)

[![Mohamed Kamal Ayad](https://camo.githubusercontent.com/3159b7c8f85ad6f979e43ca043157a2b9b40340d17de4513639c15625ec1ff4e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2d4d6f68616d65642d2d4b616d616c2d2d417961642d626c61636b3f7374796c653d666c61742d737175617265266c6f676f3d676974687562266c6f676f436f6c6f723d7768697465266c6162656c436f6c6f723d313831373137)](https://github.com/Mohamed-Kamal-Ayad)

---

**Note:** Always replace `'YOUR_DEVELOPER_SECRET'` and `'YOUR_PROJECT_TOKEN'` with your actual credentials provided by Evntaly. Keep your Developer Secret confidential.

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance47

Moderate activity, may be stable

Popularity12

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~4 days

Total

5

Last Release

395d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/eef51bf495351e97afea27b934b48d82089bcd62f94fe67dbe7c111cf84bef0d?d=identicon)[Mohamed-Kamal-Ayad](/maintainers/Mohamed-Kamal-Ayad)

---

Top Contributors

[![Mohamed-Kamal-Ayad](https://avatars.githubusercontent.com/u/99005822?v=4)](https://github.com/Mohamed-Kamal-Ayad "Mohamed-Kamal-Ayad (24 commits)")

---

Tags

evntalyevntaly-php

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/evntaly-evntaly-php/health.svg)

```
[![Health](https://phpackages.com/badges/evntaly-evntaly-php/health.svg)](https://phpackages.com/packages/evntaly-evntaly-php)
```

###  Alternatives

[shlinkio/shlink

A self-hosted and PHP-based URL shortener application with CLI and REST interfaces

4.8k4.3k](/packages/shlinkio-shlink)[ralphjsmit/laravel-helpers

A package containing handy helpers for your Laravel-application.

13704.6k2](/packages/ralphjsmit-laravel-helpers)[dhlparcel/magento2-plugin

DHL Parcel plugin for Magento 2

11180.5k2](/packages/dhlparcel-magento2-plugin)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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