HETZNER SDK
FOR LARAVEL

use Boci\HetznerLaravel\Facades\HetznerLaravel;

$response = HetznerLaravel::servers()->create([
    'name' => 'my-server',
    'server_type' => 'cpx22',
    'image' => 'ubuntu-24.04',
    'location' => 'nbg1',
]);

$server = $response->server();

echo $server->name();    // my-server
echo $server->status();  // initializing

use Boci\HetznerLaravel\Facades\HetznerLaravel;

// The default project, from HETZNER_TOKEN
$servers = HetznerLaravel::servers()->list();

// Another project from config/hetzner-laravel.php
$staging = HetznerLaravel::project('staging')->servers()->list();

// A token only known at runtime, e.g. one per team
$theirs = HetznerLaravel::withToken($team->hetzner_token)
    ->servers()
    ->list();

use Boci\HetznerLaravel\Facades\HetznerLaravel;

HetznerLaravel::dnsZones()->create([
    'name' => 'example.com',
    'mode' => 'primary',
    'ttl' => 3600,
]);

HetznerLaravel::dnsZones()->rrsets()->create('example.com', [
    'name' => 'www',
    'type' => 'A',
    'ttl' => 3600,
    'records' => [['value' => '192.168.1.1']],
]);

use Boci\HetznerLaravel\Testing\ClientFake;
use Boci\HetznerLaravel\Responses\Servers\CreateResponse;

$client = new ClientFake([
    CreateResponse::fake(['name' => 'test-server']),
]);

$response = $client->servers()->create(['name' => 'test-server']);

expect($response->server()->name())->toBe('test-server');

// No real server was created
$client->assertSent(Servers::class, fn ($method) => $method === 'create');