PHP SDK入门指南

前提条件

本文旨在帮助您快速获取百度智能云PHP SDK并开始调用。

前提条件

开发前请确保下述前提条件已准备就绪:

  • PHP SDK包要求运行环境至少为PHP 5.3.2 版本。

  • AK/SK:SDK 认证时必须传入 AK/SK 参数,在安全认证页面 获取 Access Key和Secret Key。

    用户可以通过两种方式与百度智能云进行交互,包括认证方式和匿名方式。对于认证方式,需要通过使用Access Key Id / Secret Access Key加密的方法来验证某个请求的发送者身份。Access Key Id(AK)用于标示用户,Secret Access Key(SK)是用户用于加密认证字符串和百度智能云用来验证认证字符串的密钥,其中SK必须保密,只有用户和百度智能云知道。

安装SDK包

  1. 百度智能云官网下载PHP SDK压缩工具包。
  2. 解压ZIP包:

    BaiduBce.phar            //PHP SDK
    BosClientSample.php         //示例
    SampleConf.php            //参考配置文件,具体内容见下文
    

    说明: 用户在配置好AK/SK和Host之后,可以使用phpunit --debug BosClientSample.php来运行Sample。

  3. 在脚本文件中添加以下代码,即可以使用SDK包:

    include ‘BaiduBce.phar’;
    require ‘YourConf.php’;
    

    关于配置文件的引用请参考下各产品PHP SDK帮助手册中的配置client。

SDK目录结构

BaiduBce.phar
├──src
│   └── BaiduBce
│       ├── Auth                //BCE签名相关
│       ├── Exception           //BCE客户端的异常
│       ├── Http                //BCE的Http通信相关
│       ├── Log                 //BCE日志
│       ├── Services
│       │   └── Bos                   //以对象存储BOS为例,BOS主目录必须保留
│       │       ├── BosClient.php     //BOS操作类,所有操作可以通过BosClient类可以完成
│       │       ├── BosOptions.php    //BOS自定义配置
│       │       └── CannedAcl.php     //CannedAcl模块
│       └── Util                //BCE公用工具
└──vendor                       //第三方库

使用PHP SDK

调用PHP SDK的3个主要步骤:

  • 创建并初始化xxxClient,百度智能云服务分别配置了详细的PHP SDK 帮助指南,详细请参考产品指南。
  • 创建API请求并设置参数。
  • 发起请求并处理应答或异常。