trophy/php

Trophy PHP Library

dev-master 2025-09-19 16:48 UTC

Requires

• php: ^8.1
• ext-json: *
• guzzlehttp/guzzle: ^7.4

Requires (Dev)

• friendsofphp/php-cs-fixer: 3.5.0
• phpstan/phpstan: ^1.12
• phpunit/phpunit: ^9.0

MIT

• api
• sdk
• Gamification
• trophy

README

The Trophy PHP SDK provides convenient access to the Trophy API from applications written in PHP.

Trophy provides APIs and tools for adding gamification to your application, keeping users engaged through rewards, achievements, streaks, and personalized communication.

Installation

You can install the bindings via Composer. Run the following command:

composer require trophyso/php

To use the bindings, use the Composer's autoload:

require_once('vendor/autoload.php');

Usage

The package needs to be configured with your account's API key, which is available in the Trophy web interface. Set the API key with the following:

use Trophy\TrophyClient;
use Trophy\Metrics\Requests\MetricsEventRequest;
use Trophy\Types\EventRequestUser;

$trophy = new TrophyClient('your-api-key');

Then you can access the Trophy API through the $trophy client. For example, you can send a metric event:

// Create a new user object
$user = new EventRequestUser([
    'id' => '18',
    'email' => '[e-mail]'
]);

// Create a new MetricsEventRequest object
$request = new MetricsEventRequest([
    'user' => $user,
    'value' => 750
]);

// Send the event to the Trophy API
$trophy->metrics->event("words-written", $request);

Documentation

See the Trophy API Docs for more information on the accessible endpoints.