nomadicsoft/envoyer-php

PHP client for the Laravel Envoyer REST API

v0.1.0 2026-07-08 12:26 UTC

Requires

• php: ^8.2
• ext-json: *
• illuminate/collections: ^10.0|^11.0|^12.0
• illuminate/http: ^10.0|^11.0|^12.0
• illuminate/support: ^10.0|^11.0|^12.0

Requires (Dev)

• orchestra/testbench: ^10.0
• phpunit/phpunit: ^11.0

MIT

• Nomadicsoft

Published on Packagist.org on 2026-07-08 13:42 UTC

README

PHP client for the Laravel Envoyer REST API.

Maintained replacement for community SDKs that lag behind the official API (including heartbeats).

Requirements

• PHP 8.2+
• ext-json

Installation

composer require nomadicsoft/envoyer-php

Create an API token in Envoyer under User Settings → API Tokens.

Usage

use Nomadicsoft\Envoyer\Envoyer;

$envoyer = Envoyer::make($apiToken);

// Projects
$envoyer->projects()->all();
$envoyer->projects()->find($projectId);

// Environment (.env in Envoyer — canonical source, not the server file)
$envoyer->environments()->on($projectId)->get($environmentKey);
$envoyer->environments()->on($projectId)->update($environmentKey, $contents, $serverIds);
$envoyer->environments()->on($projectId)->servers();

// Deployments
$envoyer->deployments()->on($projectId)->all();
$envoyer->deployments()->on($projectId)->deploy(['from' => 'branch', 'branch' => 'main']);

// Servers, hooks, heartbeats, collaborators, notifications, actions
$envoyer->servers()->on($projectId)->all();
$envoyer->hooks()->on($projectId)->all();
$envoyer->heartbeats()->on($projectId)->all();
$envoyer->actions()->all();

Errors

Non-success HTTP responses throw Nomadicsoft\Envoyer\Exceptions\EnvoyerException with getStatusCode() and getResponseBody().

License

MIT