sebastka / domeneshop-laravel

v0.1.0 2026-09-12 15:17 UTC

Requires

• php: >=8.4
• guzzlehttp/guzzle: ^7.10 || ^8.0
• illuminate/support: ^11.0 || ^12.0 || ^13.0
• sebastka/domeneshop-php: ^0.1

Requires (Dev)

• illuminate/config: ^13.31
• illuminate/container: ^13.31
• phpunit/phpunit: ^13.3
• vlucas/phpdotenv: ^5.7

MIT

• Sebastian Karlsen

• dns
• laravel
• domeneshop

Published on Packagist.org on 2026-09-12 17:45 UTC

README

Laravel integration for sebastka/domeneshop-php — a service provider, a config file, and a facade.

Unofficial. This is a third-party package; it is not published by Domeneshop.

Install

composer require sebastka/domeneshop-laravel

The provider and the Domeneshop alias are registered automatically through package discovery. Requires PHP 8.4+ and Laravel 11, 12 or 13.

Configure

Add your credentials to .env — generate them at domeneshop.no/admin?view=api:

DOMENESHOP_TOKEN=your-token
DOMENESHOP_SECRET=your-secret

That is all most applications need. To change timeouts or the endpoint, publish the config file:

php artisan vendor:publish --tag=domeneshop-config

// config/domeneshop.php
return [
    'token'           => env('DOMENESHOP_TOKEN', ''),
    'secret'          => env('DOMENESHOP_SECRET', ''),
    'base_uri'        => env('DOMENESHOP_BASE_URI', DomeneshopClient::DEFAULT_BASE_URI),
    'timeout'         => env('DOMENESHOP_TIMEOUT', 30),
    'connect_timeout' => env('DOMENESHOP_CONNECT_TIMEOUT', 10),
];

Usage

Inject the client wherever you need it — it is bound as a singleton:

use Sebastka\Domeneshop\DomeneshopClient;
use Sebastka\Domeneshop\Model\ARecord;

final class PointSubdomainAtServer
{
    public function __construct(private readonly DomeneshopClient $domeneshop)
    {
    }

    public function handle(string $domain, string $host, string $ip): int
    {
        $target = $this->domeneshop->domains()->findByName($domain)
            ?? throw new \RuntimeException("No such domain: {$domain}");

        return $this->domeneshop->dns()->create($target->id, new ARecord($host, $ip));
    }
}

Or use the facade:

use Sebastka\Domeneshop\Laravel\Facades\Domeneshop;

$domains = Domeneshop::domains()->list();
$records = Domeneshop::dns()->list($domains[0]->id);

The facade forwards to the same resource accessors the client exposes — domains(), dns(), forwards(), invoices() and dynDns(). See the core package's README for the full operation surface, the record classes, and error handling.

Notes

The binding is deferred: an application that never touches the API never constructs a client, so missing credentials do not break unrelated requests. The credential check runs when the client is first resolved.

Because the client is a singleton, a test can swap it wholesale:

$this->app->instance(DomeneshopClient::class, $fakeClient);

For a fake that records requests without hitting the network, construct a real DomeneshopClient with an injected PSR-18 mock — see the core package's test fixtures.