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* 类上非法字符串偏移（感谢 @brianium）
✔ 修复 #20: 为 http-client 上传方法和 vdc 上传添加 onProgress 函数（感谢 @yconan）
✔ 修复 #21: 将所有私有字段和函数设置为受保护的（感谢 @yconan）

安装

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 许可证下发布。如果出于任何原因此许可证不符合您的需求，但您有兴趣在另一项许可证下使用此作品（如下定义），请联系 作者。

贡献

欢迎贡献（问题 ♥，pull requests ♥♥♥）！请随意克隆、分支、修改、扩展等，只要您尊重 许可证条款。

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