PHPackages                             lukapeharda/pushlapgrowth - 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. [API Development](/categories/api)
4. /
5. lukapeharda/pushlapgrowth

ActiveLibrary[API Development](/categories/api)

lukapeharda/pushlapgrowth
=========================

A PHP client for the PushLapGrowth API

1.1.0(3mo ago)078MITPHPPHP ^7.3 || ^8.0

Since Dec 29Pushed 3mo agoCompare

[ Source](https://github.com/lukapeharda/push-lap-growth)[ Packagist](https://packagist.org/packages/lukapeharda/pushlapgrowth)[ RSS](/packages/lukapeharda-pushlapgrowth/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (4)Versions (6)Used By (0)

PushLapGrowth PHP Client
========================

[](#pushlapgrowth-php-client)

A PHP client for the [PushLapGrowth API](https://developers.pushlapgrowth.com/api-reference/).

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

[](#installation)

Install via Composer:

```
composer require lukapeharda/pushlapgrowth
```

Requirements
------------

[](#requirements)

- PHP 7.4 or higher
- Guzzle HTTP Client

Usage (Standard PHP)
--------------------

[](#usage-standard-php)

You can use the client in any PHP application by instantiating the `Client` class with your API Token.

```
use PushLapGrowth\Client;
use PushLapGrowth\DTO\CreateSaleData;
use PushLapGrowth\DTO\UpdateSaleData;
use PushLapGrowth\DTO\CreateReferralData;
use PushLapGrowth\Exceptions\ValidationException;

// Initialize Client
$client = new Client('YOUR_API_TOKEN');

try {
    // 0. Create a Referral
    $referralData = new CreateReferralData(
        'John Doe',
        'john@example.com',
        'ext_123', // referredUserExternalId
        'aff_abc'  // affiliateId (optional)
        // ... options: affiliateEmail, promoCode, plan, status
    );
    $client->createReferral($referralData);

    // 1. Create a Sale
    $data = new CreateSaleData(
        100.0,          // totalEarned
        'ref_123',      // referralId (optional)
        'user@example.com' // email (optional)
    );
    $response = $client->createSale($data);
    print_r($response);

    // 2. Update a Sale (using Internal ID)
    $updateData = new UpdateSaleData(
        $response['id'], // saleId
        'New Name',      // name
        null,            // email
        150.0            // totalEarned
    );
    $client->updateSale($updateData);

    // 3. Update a Sale (using External ID)
    // Useful if you only store your own system's IDs
    $externalUpdateData = new UpdateSaleData(
        null, // ID looked up automatically
        null,
        null,
        250.0
    );
    $client->updateSaleUsingExternalId('my_external_id_123', $externalUpdateData);

    // 4. Delete a Sale
    $client->deleteSale($response['id']);

    // 5. Delete a Sale (using External ID)
    $client->deleteSaleUsingExternalId('my_external_id_123');

} catch (ValidationException $e) {
    // Handle Validation Errors (422)
    print_r($e->getErrors());
} catch (\Exception $e) {
    // Handle other errors
    echo $e->getMessage();
}
```

Usage (Laravel)
---------------

[](#usage-laravel)

This package includes a Service Provider and Facade-like behavior for Laravel 5.6+ and above.

### 1. Configuration

[](#1-configuration)

Publish the configuration file (optional):

```
php artisan vendor:publish --provider="PushLapGrowth\PushLapGrowthServiceProvider" --tag="config"
```

Add your API Token to `.env`:

```
PUSHLAPGROWTH_API_TOKEN=your_token_here
```

### 2. Dependency Injection

[](#2-dependency-injection)

You can type-hint the `Client` class in your Controllers, Jobs, or Services.

```
use PushLapGrowth\Client;
use PushLapGrowth\DTO\CreateSaleData;

class SaleController extends Controller
{
    public function store(Client $client)
    {
        $data = new CreateSaleData(50.0, 'ref_abc');
        $client->createSale($data);

        return response()->json(['status' => 'success']);
    }
}
```

Error Handling
--------------

[](#error-handling)

The client throws specific exceptions for different error scenarios:

- `PushLapGrowth\Exceptions\ValidationException`: Thrown on 422 Unprocessable Entity. Use `getErrors()` to see details.
- `PushLapGrowth\Exceptions\NotFoundException`: Thrown on 404 Not Found.
- `PushLapGrowth\Exceptions\ApiException`: Thrown on other API errors (500, 400, etc.).

All exceptions extend `PushLapGrowth\Exceptions\PushLapGrowthException`.

Testing
-------

[](#testing)

Run the test suite:

```
vendor/bin/phpunit
```

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance81

Actively maintained with recent releases

Popularity11

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity44

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 ~21 days

Total

5

Last Release

99d ago

PHP version history (2 changes)1.0.0PHP ^7.4 || ^8.0

1.0.3PHP ^7.3 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/cd692eb7c3ea730aae6d7dbce5e8cb641011c0e23002fd991667df87d63019b6?d=identicon)[lpeharda](/maintainers/lpeharda)

---

Top Contributors

[![lukapeharda](https://avatars.githubusercontent.com/u/2076692?v=4)](https://github.com/lukapeharda "lukapeharda (7 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/lukapeharda-pushlapgrowth/health.svg)

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

###  Alternatives

[statamic/cms

The Statamic CMS Core Package

4.8k3.6M985](/packages/statamic-cms)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3741.3M47](/packages/tencentcloud-tencentcloud-sdk-php)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k656.1k38](/packages/neuron-core-neuron-ai)[avalara/avataxclient

Client library for Avalara's AvaTax suite of business tax calculation and processing services. Uses the REST v2 API.

528.5M7](/packages/avalara-avataxclient)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

273.0k](/packages/eslazarev-wildberries-sdk)[files.com/files-php-sdk

Files.com PHP SDK

2481.1k](/packages/filescom-files-php-sdk)

PHPackages © 2026

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