Создание PHP инструментов администрирования хостинга: вариации реализации

Ниже приведены расширенные примеры кода с подробными пояснениями и демонстрацией результатов.

Пример 1. Полный скрипт создания аккаунта через WHM API с обработкой ошибок

<?php
class WHMAccountCreator {
    private $host;
    private $username;
    private $token;

    public function __construct($host, $username, $token) {
        $this->host = rtrim($host, '/') . ':2087';
        $this->username = $username;
        $this->token = $token;
    }

    public function createAccount($domain, $username, $password, $plan = 'default') {
        $query = http_build_query([
            'username' => $username,
            'domain'   => $domain,
            'password' => $password,
            'plan'     => $plan,
            'contactemail' => 'admin@' . $domain,
        ]);

        $url = $this->host . '/json-api/createacct?' . $query;
        $ch = curl_init($url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'Authorization: whm ' . $this->username . ':' . $this->token,
        ]);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);

        $response = curl_exec($ch);
        $info = curl_getinfo($ch);
        curl_close($ch);

        if ($info['http_code'] !== 200) {
            return ['success' => false, 'error' => 'HTTP: ' . $info['http_code']];
        }

        $data = json_decode($response, true);
        if (isset($data['metadata']['result']) && $data['metadata']['result'] == 1) {
            return ['success' => true, 'ip' => $data['data']['ip']];
        } else {
            $error = $data['metadata']['reason'] ?? 'Неизвестная ошибка';
            return ['success' => false, 'error' => $error];
        }
    }
}

// Использование
$creator = new WHMAccountCreator('https://server.domain.com', 'root', 'mytoken123');
$result = $creator->createAccount('example.org', 'exampleusr', 'SuperP@ss!');

if ($result['success']) {
    echo "Аккаунт создан. IP: {$result['ip']}";
} else {
    echo "Ошибка: {$result['error']}";
}
?>

Аккаунт создан. IP: 192.168.1.100

Класс инкапсулирует логику, упрощает повторное использование. Параметр plan должен быть определён в WHM. При ошибке возвращается массив с подробным описанием.

Пример 2. Создание виртуального хоста Nginx через PHP с поддержкой SSL (Let's Encrypt)

<?php
function createNginxVhost($domain, $rootDir, $ssl = false) {
    $config = <<<NGINX
server {
    listen 80;
    server_name $domain;
    return 301 https://$domain\$request_uri;
}

server {
    listen 443 ssl http2;
    server_name $domain;
    root $rootDir;

    index index.php index.html;

    ssl_certificate     /etc/letsencrypt/live/$domain/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/$domain/privkey.pem;

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME \$document_root\$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.ht {
        deny all;
    }
}
NGINX;

    $configPath = "/etc/nginx/sites-available/$domain.conf";
    file_put_contents($configPath, $config);
    exec("ln -s $configPath /etc/nginx/sites-enabled/");
    exec("nginx -t 2>&1", $output, $return_var);

    if ($return_var === 0) {
        exec('systemctl reload nginx');
        echo "Конфигурация Nginx для $domain применена.";
    } else {
        echo "Ошибка в конфигурации: " . implode("\n", $output);
    }
}

// Вызов
createNginxVhost('example.com', '/var/www/example', true);
?>

Конфигурация Nginx для example.com применена.

Скрипт генерирует конфигурацию с редиректом на HTTPS и поддержкой PHP-FPM. Важно предварительно получить сертификат Let's Encrypt через certbot.

Пример 3. Создание и предоставление доступа к базе данных MySQL с использованием PDO

<?php
$pdo = new PDO('mysql:host=localhost', 'root', 'example_root_password');
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

$dbName = 'client_' . uniqid('db_');
$userName = 'client_' . uniqid('user_');
$userPass = substr(str_shuffle('abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!@#$%'), 0, 16);

try {
    $pdo->exec("CREATE DATABASE `$dbName` CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci");
    $pdo->exec("CREATE USER '$userName'@'localhost' IDENTIFIED BY '$userPass'");
    $pdo->exec("GRANT ALL PRIVILEGES ON `$dbName`.* TO '$userName'@'localhost'");
    $pdo->exec('FLUSH PRIVILEGES');

    echo "База данных: $dbName
";
    echo "Пользователь: $userName
";
    echo "Пароль: $userPass
";
} catch (PDOException $e) {
    echo "Ошибка: " . $e->getMessage();
}
?>

База данных: client_db_62a1f3
Пользователь: client_user_9bcdef
Пароль: aB3$kL9m@xY7!zQ1

PDO выбрасывает исключения при ошибках, что упрощает отладку. Используется случайная генерация пароля из набора символов для повышения безопасности.

Пример 4. Управление почтовыми ящиками через exec (Postfix + Dovecot)

<?php
function createMailbox($email, $password) {
    $username = explode('@', $email)[0];
    $domain = explode('@', $email)[1];

    // Создание системного пользователя (виртуальный пользователь для Dovecot)
    $cmd = "sudo useradd -m -s /bin/false -d /home/vmail/$domain/$username $username";
    exec($cmd, $output, $ret);
    if ($ret !== 0) {
        return "Ошибка создания пользователя: " . implode(' ', $output);
    }

    // Установка пароля
    $cmd = "echo '$username:$password' | sudo chpasswd";
    exec($cmd, $output, $ret);
    if ($ret !== 0) {
        return "Ошибка установки пароля.";
    }

    // Создание каталога Maildir
    $home = "/home/vmail/$domain/$username";
    exec("sudo mkdir -p $home/Maildir/new $home/Maildir/cur $home/Maildir/tmp");
    exec("sudo chown -R $username:$username $home");
    exec("sudo chmod -R 700 $home/Maildir");

    return "Почтовый ящик $email создан.";
}

echo createMailbox('user@example.com', 'mailpass123');
?>

Почтовый ящик user@example.com создан.

В данном примере используется виртуальный каталог /home/vmail, который часто настраивается в Postfix. Перед использованием необходимо убедиться, что Dovecot настроен на работу с Maildir и системную аутентификацию.