Libvirt-Manager/README_ZH.md

Libvirt-Manager

这是一个简单的 Libvirt 虚拟机管理器，使用 PHP 开发。

它可以启动、关闭、强制结束或读取虚拟机信息，列出虚拟机列表等。

这个项目是为了让开发者管理虚拟机更简单，更轻松。

你需要安装 PHP_SSH2 模块来使用此管理器。

唔...第一次写英文 ReadMe，英文很蹩脚，请不要在意...嘤嘤嘤

连接到服务器的示例代码

include("libvirt/libvirt.php");
$Libvirt = new Libvirt();
$Libvirt->setHost("192.168.3.181", 22, "/data/libvirt/");
$Libvirt->connect("root", "123456");

Libvirt Manager 需要通过 SSH 连接到服务器进行操作，请确认你的服务器已启用 sshd 服务。

在示例代码中，192.168.3.181 是服务器地址，22 是服务器端口，/data/libvirt/ 是你希望 Libvirt 使用的数据储存目录。

在登录时，请使用用户名和密码（目前暂不支持证书登录），示例代码中的用户名和密码分别是 root 和 123456

创建虚拟机示例代码

$Libvirt->createDisk("Test", "qcow2", "30G");
$Libvirt->createVMXML("Test", 2, 2048576, "/data/libvirt/images/Test/Test.qcow2", "/data/iso/CentOS-7-x86_64-Minimal-1804.iso", "cdrom", "network", "default", $Libvirt->randomMac(), "virbr0", 0, 0, 5902);
$Libvirt->define("/data/libvirt/Test.xml");
$Libvirt->setPermission("Test");
$Libvirt->start("Test");

创建一个虚拟磁盘

String createDisk ( Name, Format, Size )

创建一个虚拟机 XML 配置文件

createVMXML 方法一共有 13 个参数

void createVMXML ( Name, vCPU, Ram, Disk, ISO, Boot Device, Network type, Network name, MAC Address, Network bridge, Bandwidth in, Bandwidth out, VNC Port )

将虚拟机 XML 配置文件注册到系统

String define ( XML File Path )

设置可执行权限

void setPermission ( Name )

启动虚拟机

String start ( Name )

正常停止虚拟机

String shutdown ( Name )

强制停止虚拟机

如果你的虚拟机出现了问题导致不能使用 shutdown 方法停止时，可以使用此方法强制结束虚拟机，但是可能会丢失数据。

String destroy ( Name )

获得虚拟机列表

你可以使用此方法获得所有已注册的虚拟机列表，它将会返回一个数组。

String getList ()

获得虚拟机信息

你可以使用此方法获得任何已注册的虚拟机信息，它将会返回一个数组。

String getInfo ( Name )

导出虚拟机的 XML 配置文件

此方法可以读取虚拟机的 XML 配置文件并返回

String dumpxml ( Name )

克隆现有的虚拟机

你可以使用此方法复制一个现有的虚拟机

此方法也许需要消耗很长时间，具体视磁盘性能而定，建议加一行代码 set_time_limit(120) 以防止脚本超时。

String cloneVM ( Name, New name, New disk path )

设置虚拟机网卡

此方法可以设置虚拟机的网卡

第三个参数是布尔型的，如果赋值是 true，将会启用网卡，如果赋值是 false，将会禁用网卡。

String setNetwork ( Server, Network name, Status )

你可以在 libvirt/libvirt.php 找到更多信息