简介

本SDK包括访问AbleCloud云端服务的API，以及AbleCloud与微信公众号对接的API。

• 子目录 lib/ablecloud

  AbleCloud云端服务API。

• 子目录 lib/bridge

  AbleCloud与第三方云平台对接的工具。与微信对接：ACBridgeWeChat。

• 子目录 demo

  微信公众号与AbleCloud对接demo。

• 子目录 docs

  API参考文档。首页名字：index.html。

• 适用PHP版本

  本SDK使用了PHP v5.6及其后续版本才支持的不定长参数。使用v5.6之前版本PHP的开发者可以修改文件 ablecloud/services/ACStoreScanner.php 第45行及第123行，分别去掉行中函数select及函数groupBy参数列表里的'...'符号，并在调用此两行所对应的函数时使用字符串数组作为参数。

• 使用说明
  • 配置 ablecloud/ACConfig.php 中的开发者信息

  • 引用文件 ablecloud/ACClient.php

    在调用 session_start() 方法之前引用 ablecloud/ACClient.php ，或者直接引用 bridge/ACBridgeWeChat.php （针对开发微信公众号后台应用的场景。该文件会引用 ablecloud/ACClient.php ），并且调用方法 ACClient::init() 完成初始化。

    该步骤执行的初始化设置包括 session_set_save_handler() 等。

  • 访问外网

    • 如果代码运行在AbleCloud云平台的托管环境中，需要通过AbleCloud云平台的代理服务器来访问外网。

      AbleCloud云平台PHP运行环境支持使用PHP Curl访问外网，但要按如下代码配置代理服务器：

            $ch = curl_init();
            // ......
            $defaultProxy = 'http://xxx.xxx.xxx.xxx:1234'; // 若缺省条件下不使用代理，可以设置 $defaultProxy 为 NULL 。
            curl_setopt($ch, CURLOPT_PROXY, ACConfig::getProxyURL($defaultProxy));
            // ......
            curl_close($ch);
            

    • 如果代码不是运行在AbleCloud云平台的托管环境中，访问外网时不受上述条件限制。

      此时，ACConfig::getProxyURL($defaultProxy) 将返回调用者设置的地址，因此上例中的代码在非AbleCloud云平台托管环境下也适用。