README

VMware vCloud SDK for PHP (修复版) - 使用 Composer 导入的存储库

本项目是从 原始 VMWare SDK for PHP 分支出来的，除了以下新增和更改外

✔ 将 VMware/VCloud/API.php (5 MB) 以及其他几个文件拆分为独立的类文件
✔ 规范化类路径 (VMware/VCloud/SDK/**/*.php 和 VMware/VCloud/API/**/*.php)
✔ 与 Composer 的自动加载兼容
✔ 修复了 #2: 允许检索当前登录用户的用户名和令牌
✔ 修复了 #3: 删除不必要的 require_once
✔ 修复了 #5: Edge 网关修改不工作
✔ 修复了 #6: 上传大 OVF 文件不工作
✔ 修复了 #7: 在 Windows/Cygwin 上上传 OVF 文件不工作
✔ 修复了 #8: 在 VMware_VCloud_SDK_Vdc::uploadMedia 中设置图像类型 (感谢 @brianium)
✔ 修复了 #9: 在 VMware_VCloud_API_QueryResultVAppTemp 上添加对 storageKB 字段的支持 (感谢 @brianium)
✔ 修复了 #12: VMware_VCloud_SDK_Vdc::sendUploadVAppTemplateRequest 应使用 $vdcStorageProfileRef (感谢 @brianium)
✔ 修复了 #16: OperatingSytemSection 和 VirtualHardwareSection 应具有 "ovf" 命名空间 (感谢 @brianium)
✔ 修复了 #17: 在 VMware_VCloud_API_QueryResultTaskRecordType 中添加对详细信息的支持 (感谢 @brianium)
✔ 修复了 #18: 在 SDK_Constants 中添加 vmPendingQuestion (感谢 @brianium)
✔ 修复了 #19: PHP 警告：在多个 API_QueryResult* 类上非法字符串偏移量
✔ 修复了 #20: 为 http-client 上传方法和 vdc 上传添加 onProgress 函数 (感谢 @yconan)
✔ 修复了 #21: 将所有私有字段和函数设置为受保护

安装

vmware/vcloud-sdk-patched 通过 Composer 提供。

  "repositories": [
    {
      "type": "pear",
      "url": "http://pear.php.net"
    }
  ],
  "require": {
    "vmware/vcloud-sdk-patched": "550.5.0",
    "pear-pear/HTTP_Request2": "*"
  }

php composer.phar update

如果您不熟悉 Composer，请阅读 完整的安装说明。

用法

请参阅 API 文档 或 官方 VMware 文档

包含 Composer 自动加载

// On top of your script
require_once 'path/to/.../vendor/autoload.php';

登录

// $hostname = ...
// $username = ...
// $organization = ...
// $password = ...
// $apiVersion = ...
try {
    $service = \VMware_VCloud_SDK_Service::getService();
    $service->login(
        $hostname,
        array(
            'username' => $username . '@' . $organization,
            'password' => $password,
        ),
        array(
            'proxy_host' => null,
            'proxy_port' => null,
            'proxy_user' => null,
            'proxy_password' => null,
            'ssl_verify_peer' => false,
            'ssl_verify_host' => false,
            'ssl_cafile'  => null,
        ),
        $apiVersion
    );
} catch (\VMware_VCloud_SDK_Exception $e) {
    throw new \Exception('Login failed');
}

版本控制

以 Semver 作为版本基础的基准，本项目还遵循了额外的版本编号指南。每个版本都遵循 vwx.y.z 的格式，其中

• vwx 是基于此 SDK 的 vCloud SDK 的连接字符串（例如，"512" 代表 5.1.2）
• 对 y 的每次修改都会引入一个新的补丁
• y 的修改仅仅是现有补丁的修正

许可

本项目在 Creative Commons - Attribution 3.0 Unported 许可下发布。如果您因任何原因需要使用其他许可，但希望使用（如下文所述）该作品，请联系 作者。

贡献

欢迎贡献（问题 ♥，拉取请求 ♥♥♥）！您可以自由地克隆、分叉、修改、扩展等，只要您遵守 许可条款。

有关详细信息，请参阅 贡献说明。