API文档>QStack>插件>云计算 > 云计算插件开发说明

云计算插件开发说明

发布时间:2022-03-30 15:43

一、概述

通过云计算插件,你可以将您所需要的云服务平台(如百度云等)集成到QStack系统当中,该插件类型属于钩子类型的插件。
开发云计算插件,必须严格按照本文介绍的命名规则,否则将导致插件无法运行或出错。

二、根据插件开发说明文档创建好插件的基本结构

三、插件目录以及文件说明:

以腾讯云为例,品牌标识:qcloud
文件夹以品牌标识为文件名,并且首字母大写,其余小写,例如:Qcloud

文件必须包含三个部分的文件:

  • Product 产品同步处理文件,此文件名由品牌标识(Qcloud)和Product组成 例如: QcloudProduct.php
  • Operate 产品操作类(如产品询价、产品下单、开关机重启等)文件,此文件名由标识(Qcloud)和Operate组成,例如: QcloudOperate.php
  • Check 数据验证类文件,此文件名由标识(Qcloud)和Check组成,例如: QcloudCheck.php

其他文件:

  • Attr 产品属性类(非必须),此文件名由标识(Qcloud)和Attr组成,例如: QcloudAttr.php,如果公共属性类(CloudAttr.php)已经无法满足当前需求,可按照文档要求自行补充。如果公共属性类能满足要求,则可以不用创建此类文件
注意:
  • 除了这三个文件必须按照规范来,其他php文件名均可自定义。
  • 类文件存放路径:/extend/CloudApi/Qcloud(Qcloud存储插件的处理类,主要存放以上三个文件)
HTML文件命名规则:
  • 介绍页由 “标识(qcloud)” 和 “_index” 组成,例如:qcloud_index.html
  • 购买页由 “标识(qcloud)” 和 “_buy” 组成,例如:qcloud_buy.html
HTML视图文件存放路径:
  • pc端:/view/home/pc/cloud_server
  • 手机端:/view/wap/cloud_server

四、日志通用处理:

  • 接口日志需要使用到的类文件 Log.php的saveApiSendLog方法
    调用方式,例:

       Log::saveApiSendLog(
          '业务标识',
          '品牌类型',
          '品牌名称',
          '操作类型',
          'API请求地址',
          '返回结果0=>失败,1=>成功',
          '返回信息',
          '请求参数',
          '账号类型0=>系统,1=>普通用户,2=>后台管理',
          '账号ID',
          '是否需要回调0=>不需要,1=>需要',
          '业务id',
       );
    
  • 数据返回格式:return [‘result’ => true, ‘list’ => $list];

参数名 类型 说明
result bool 成功: true,失败:false
text string 返回信息
list array 返回数组信息,具体查看各类方法 list 返回参数

五、子订单附加信息补充

otherParams方法,主要用于子订单附加信息,扩展配置信息字段

/**
* 子订单附加信息
*param array $data 为前台提交的数据
**/

public function otherParams(array $data){
    return [
        'cpu' => $data['cpu'],
        'memory' => $data['memory'],
    ];
}
本文导读