SDK PHP
Le SDK officiel PHP wrappe l'API REST avec un type-checking idiomatique. Toutes les actions du dashboard sont disponibles.
Installation
$ composer require di2amp/sdk
Authentification
Toutes les requêtes se font avec un token API que vous générez dans le dashboard, onglet « API tokens ».
use Di2amp\\PaasClient;
$client = new PaasClient([ 'token' => getenv('PAAS_API_TOKEN'), ]);
$client = new PaasClient([ 'token' => getenv('PAAS_API_TOKEN'), ]);
Lister les apps
$apps = $client->apps()->list();
foreach ($apps as $app) {
echo $app->name . ' ' . $app->url . PHP_EOL;
}
Créer une app
$app = $client->apps()->create([
'name' => 'monsite',
'region' => 'fr-1',
]);
Streaming des logs
Les logs en temps réel arrivent via un stream Server-Sent Events. Le SDK le wrappe pour rester idiomatique.
foreach ($client->logs()->stream('monsite') as $line) {
echo $line . PHP_EOL;
}
Gestion des erreurs
Toutes les erreurs renvoyées par l'API sont mappées en exceptions typées. Vous catchez par catégorie : AuthError, RateLimitError, NotFoundError, ValidationError, ServerError.
Code source et référence complète
Le SDK est open source (Apache 2.0). Bug, suggestion, ou contribution : sur le repo GitHub.
- Repo : github.com/di2amp/sdk-php
- Référence générée : PHP API reference
- Changelog : Voir les versions