PHP code example of teaminfinitylk / laravel-hestiacp-sdk

    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

teaminfinitylk / laravel-hestiacp-sdk example snippets

use Hestia;

$users = Hestia::users()->list();
$domains = Hestia::web()->list('admin');

use TeamInfinityLK\HestiaCP\HestiaClient;

class HostingController extends Controller
{
    public function __construct(private HestiaClient $hestia) {}

    public function index()
    {
        return $this->hestia->users()->list();
    }
}

use TeamInfinityLK\HestiaCP\HestiaClient;

// With API key
$client = HestiaClient::connect('https://hestia.example.com:8083', 'KEYID:SECRET');

// With username + password
$client = HestiaClient::connectWithCredentials('https://hestia.example.com:8083', 'admin', 'password');

$hestia->users()->list();                          // v-list-users
$hestia->users()->get('john');                     // v-list-user
$hestia->users()->create([
    'user'     => 'john',
    'password' => 'secret',
    'email'    => '[email protected]',
    'package'  => 'default',    // optional
    'name'     => 'John',       // optional
    'lastname' => 'Doe',        // optional
]);                                                // v-add-user
$hestia->users()->changePassword('john', 'newpass');  // v-change-user-password
$hestia->users()->changeContact('john', '[email protected]'); // v-change-user-contact
$hestia->users()->changePackage('john', 'premium');   // v-change-user-package
$hestia->users()->suspend('john');                 // v-suspend-user
$hestia->users()->unsuspend('john');               // v-unsuspend-user
$hestia->users()->delete('john');                  // v-delete-user

$hestia->web()->list('john');                      // v-list-web-domains
$hestia->web()->get('john', 'example.com');        // v-list-web-domain
$hestia->web()->create([
    'user'    => 'john',
    'domain'  => 'example.com',
    'ip'      => '192.168.1.1',  // optional (defaults to server primary IP)
    'aliases' => 'www.example.com', // optional
]);                                                // v-add-web-domain
$hestia->web()->addSsl('john', 'example.com');    // v-add-letsencrypt-domain
$hestia->web()->suspend('john', 'example.com');   // v-suspend-web-domain
$hestia->web()->unsuspend('john', 'example.com'); // v-unsuspend-web-domain
$hestia->web()->delete('john', 'example.com');    // v-delete-web-domain

// Domains
$hestia->mail()->list('john');                     // v-list-mail-domains
$hestia->mail()->get('john', 'example.com');       // v-list-mail-domain
$hestia->mail()->create([
    'user'      => 'john',
    'domain'    => 'example.com',
    'antispam'  => 'yes',   // optional, default: yes
    'antivirus' => 'yes',   // optional, default: yes
    'dkim'      => 'yes',   // optional, default: yes
    'ssl'       => 'no',    // optional
]);                                                // v-add-mail-domain
$hestia->mail()->suspend('john', 'example.com');   // v-suspend-mail-domain
$hestia->mail()->unsuspend('john', 'example.com'); // v-unsuspend-mail-domain
$hestia->mail()->delete('john', 'example.com');    // v-delete-mail-domain

// Accounts
$hestia->mail()->listAccounts('john', 'example.com'); // v-list-mail-accounts
$hestia->mail()->addAccount([
    'user'     => 'john',
    'domain'   => 'example.com',
    'account'  => 'info',
    'password' => 'secret',
    'quota'    => '0',       // optional, 0 = unlimited
]);                                                // v-add-mail-account
$hestia->mail()->changeAccountPassword('john', 'example.com', 'info', 'newpass');
$hestia->mail()->deleteAccount('john', 'example.com', 'info'); // v-delete-mail-account

$hestia->databases()->list('john');                // v-list-databases
$hestia->databases()->get('john', 'john_blog');    // v-list-database
$hestia->databases()->create([
    'user'     => 'john',
    'database' => 'blog',      // stored as john_blog
    'dbuser'   => 'bloguser',  // stored as john_bloguser
    'dbpass'   => 'secret',
    'type'     => 'mysql',     // optional, default: mysql
    'charset'  => 'utf8mb4',   // optional
]);                                                // v-add-database
$hestia->databases()->changePassword('john', 'john_blog', 'john_bloguser', 'newpass');
$hestia->databases()->suspend('john', 'john_blog');   // v-suspend-database
$hestia->databases()->unsuspend('john', 'john_blog'); // v-unsuspend-database
$hestia->databases()->delete('john', 'john_blog');    // v-delete-database

// Zones
$hestia->dns()->list('john');                      // v-list-dns-domains
$hestia->dns()->get('john', 'example.com');        // v-list-dns-domain
$hestia->dns()->create([
    'user'   => 'john',
    'domain' => 'example.com',
    'ip'     => '192.168.1.1', // optional
]);                                                // v-add-dns-domain
$hestia->dns()->suspend('john', 'example.com');
$hestia->dns()->unsuspend('john', 'example.com');
$hestia->dns()->delete('john', 'example.com');    // v-delete-dns-domain

// Records
$hestia->dns()->listRecords('john', 'example.com');  // v-list-dns-records
$hestia->dns()->addRecord('john', 'example.com', [
    'record'   => 'mail',
    'type'     => 'A',
    'value'    => '192.168.1.2',
    'priority' => '0',         // optional
    'ttl'      => '14400',     // optional
]);                                                // v-add-dns-record
$hestia->dns()->updateRecord('john', 'example.com', 5, [...]);
$hestia->dns()->deleteRecord('john', 'example.com', 5); // v-delete-dns-record

$hestia->cron()->list('john');                     // v-list-cron-jobs
$hestia->cron()->get('john', 1);                   // v-list-cron-job (by numeric job ID)
$hestia->cron()->create([
    'user'    => 'john',
    'min'     => '0',
    'hour'    => '2',
    'day'     => '*',
    'month'   => '*',
    'wday'    => '*',
    'command' => '/home/john/scripts/backup.sh',
]);                                                // v-add-cron-job
$hestia->cron()->suspend('john', 1);              // v-suspend-cron-job
$hestia->cron()->unsuspend('john', 1);            // v-unsuspend-cron-job
$hestia->cron()->delete('john', 1);               // v-delete-cron-job

$hestia->backups()->list('john');                  // v-list-user-backups
$hestia->backups()->get('john', '2024-01-01_00-00-00.tar');
$hestia->backups()->create('john');                // v-backup-user (triggers backup now)
$hestia->backups()->restore('john', '2024-01-01_00-00-00.tar', [
    'web'  => 'yes',   // optional, default all yes
    'mail' => 'yes',
    'db'   => 'yes',
    'dns'  => 'yes',
]);                                                // v-restore-user
$hestia->backups()->delete('john', '2024-01-01_00-00-00.tar');

$hestia->firewall()->list();                       // v-list-firewall
$hestia->firewall()->get(1);                       // v-list-firewall-rule
$hestia->firewall()->create([
    'action'   => 'ACCEPT',      // ACCEPT | DROP | REJECT
    'ip'       => '0.0.0.0/0',
    'port'     => '80',
    'protocol' => 'TCP',         // optional
    'comment'  => 'Allow HTTP',  // optional
]);                                                // v-add-firewall-rule
$hestia->firewall()->delete(1);                    // v-delete-firewall-rule

// Bans (fail2ban)
$hestia->firewall()->listBans('CUSTOM');           // v-list-firewall-ban
$hestia->firewall()->banIp('1.2.3.4', 'CUSTOM');  // v-add-firewall-ban
$hestia->firewall()->unbanIp('1.2.3.4', 'CUSTOM');// v-delete-firewall-ban

$hestia->ips()->list();                            // v-list-sys-ips
$hestia->ips()->get('192.168.1.100');              // v-list-sys-ip
$hestia->ips()->create([
    'ip'        => '192.168.1.100',
    'netmask'   => '255.255.255.0',
    'interface' => 'eth0',
    'user'      => 'admin',    // optional
    'status'    => 'shared',   // optional
]);                                                // v-add-sys-ip
$hestia->ips()->changeOwner('192.168.1.100', 'john');
$hestia->ips()->changeName('192.168.1.100', 'My IP');
$hestia->ips()->delete('192.168.1.100');           // v-delete-sys-ip

$hestia->packages()->list();                       // v-list-user-packages
$hestia->packages()->get('default');               // v-list-user-package
$hestia->packages()->delete('old-package');        // v-delete-user-package

use TeamInfinityLK\HestiaCP\Exceptions\ApiException;
use TeamInfinityLK\HestiaCP\Exceptions\AuthenticationException;
use TeamInfinityLK\HestiaCP\Exceptions\ConnectionException;

try {
    $users = Hestia::users()->list();
} catch (AuthenticationException $e) {
    // Invalid API key / credentials
} catch (ConnectionException $e) {
    // Cannot reach the HestiaCP server
} catch (ApiException $e) {
    // HestiaCP returned an error code
    echo $e->getMessage();   // "Failed to list users: E_FORBIDDEN"
    echo $e->getCode();      // HestiaCP return code (1–20)
}

// 1. Create the user account
$hestia->users()->create([
    'user'     => 'john',
    'password' => 'generated-password',
    'email'    => '[email protected]',
    'package'  => 'starter',
    'name'     => 'John',
    'lastname' => 'Doe',
]);

// 2. Add their web domain
$hestia->web()->create([
    'user'   => 'john',
    'domain' => 'johnssite.com',
]);

// 3. Enable Let's Encrypt SSL
$hestia->web()->addSsl('john', 'johnssite.com');

// 4. Set up mail
$hestia->mail()->create([
    'user'   => 'john',
    'domain' => 'johnssite.com',
]);
$hestia->mail()->addAccount([
    'user'     => 'john',
    'domain'   => 'johnssite.com',
    'account'  => 'info',
    'password' => 'mail-password',
]);

// 5. Create database
$hestia->databases()->create([
    'user'     => 'john',
    'database' => 'maindb',
    'dbuser'   => 'mainuser',
    'dbpass'   => 'db-password',
]);

// Suspend account on non-payment
$hestia->users()->suspend('john');

// Reactivate
$hestia->users()->unsuspend('john');

// Terminate
$hestia->users()->delete('john');

bash
php artisan vendor:publish --provider="TeamInfinityLK\HestiaCP\Laravel\HestiaServiceProvider"