告别繁琐命令行：如何用Composer和cv4pve-api-php轻松管理ProxmoxVE虚拟机

qm

pvesh

corsinvest/cv4pve-api-php

<pre class="brush:php;toolbar:false;">composer require corsinvest/cv4pve-api-php

<pre class="brush:php;toolbar:false;"><?php

require_once 'vendor/autoload.php';

use Corsinvest\ProxmoxVE\Api\PveClient;

// 替换为你的Proxmox VE IP或域名
$client = new PveClient("your_proxmox_host", "8006"); // 默认端口8006

// 使用用户名和密码登录
if ($client->login('root', 'your_password', 'pam')) { // 替换为你的用户名、密码和认证域
    echo "使用用户名/密码登录成功！\n";
    // 进行后续操作
} else {
    echo "登录失败：" . $client->getError() . "\n";
}

// 或者，使用API Token登录 (Proxmox VE 6.2+ 推荐)
// 确保你的API Token格式正确：USER@REALM!TOKENID=TOKEN
$clientWithToken = new PveClient("your_proxmox_host");
$clientWithToken->setApiToken("root@pam!mytokenname=YOUR_API_TOKEN_HERE"); // 替换为你的API Token

// API Token登录后，可以直接进行API调用，无需显式login()
$version = $clientWithToken->getVersion()->version()->getResponse();
echo "通过API Token获取Proxmox VE 版本: " . $version->data->version . "." . $version->data->release . "\n";

?>

<pre class="brush:php;toolbar:false;"><?php
// ... 假设 $client 已经成功登录或设置了API Token ...

echo "\n--- 虚拟机列表 ---\n";
// 替换 "pve1" 为你的Proxmox VE节点名
foreach ($client->getNodes()->get("pve1")->getQemu()->Vmlist()->getResponse()->data as $vm) {
    echo "VMID: {$vm->vmid}, 名称: {$vm->name}, 状态: {$vm->status}, CPU: {$vm->cpu}%, 内存: " . round($vm->mem / (1024 * 1024 * 1024), 2) . " GB\n";
}

// 获取某个特定VM的快照列表
$vmId = 100; // 替换为你的VMID
echo "\n--- VM {$vmId} 的快照列表 ---\n";
foreach ($client->getNodes()->get("pve1")->getQemu()->get($vmId)->getSnapshot()->snapshotList()->getResponse()->data as $snap) {
    echo "快照名称: {$snap->name}, 描述: {$snap->description}\n";
}

?>

Result

<pre class="brush:php;toolbar:false;"><?php
// ... 假设 $client 已经成功登录 ...

$response = $client->get('/version'); // 这是一个直接的API路径调用示例

if ($response->isSuccessStatusCode()) {
    echo "API调用成功，状态码: " . $response->getStatusCode() . "\n";
    // 默认返回对象，也可以设置为返回数组：$client->setResultIsObject(false);
    var_dump($response->getResponse());
} else {
    echo "API调用失败，错误信息: " . $response->getError() . ", 状态码: " . $response->getStatusCode() . "\n";
}

// 你甚至可以获取原始HTTP响应头
// var_dump($response->getResponseHeaders());

?>

corsinvest/cv4pve-api-php