准备工作

本文档是Bmob官方提供的PHP SDK，方便PHP开发人员快速使用Bmob进行后端开发。

【注】运行PHP需要相关运行环境，推荐在5.*以上环境上使用。PHP官方下载地址为：http://php.net/ 。

SDK下载

请到以下的Github地址clone我们的SDK最新代码：https://github.com/bmob/bmob-php-sdk

安装和配置

打开lib/BmobConfig.class.php，填写APPID（后台获取“应用密钥”中的Application ID）和RESTKEY（后台获取“应用密钥”中的REST API Key）相应的值。如下所示：

  1. class BmobConfig{
  2.     const APPID = '';       //替换后台"应用密钥"中的Application ID
  3.     const RESTKEY = '';     //后台"应用密钥"中的REST API Key
  4.     const BMOBURL = 'https://api.bmob.cn/1/';   //保持不变
  6. }

运行效果

打开项目中的test.php文件，可以看到如何使用PHP SDK相关的方法。

  1. <?php
  2. include_once 'lib/BmobObject.class.php';
  3. include_once 'lib/BmobUser.class.php';
  4. try {
  5.     /*
  6.      *  BmobObject 的例子
  7.     */    
  8.     $bmobObj = new BmobObject("GameScore");
  9.     $res=$bmobObj->create(array("score"=>80,"playerName"=>"game")); //添加对象
  10.     $res=$bmobObj->get("bd89c6bce9"); // 获取id为bd89c6bce9的对象
  11.     $res=$bmobObj->get(); //获取所有对象
  12.     //更新对象bd89c6bce9, 任何您未指定的key都不会更改,所以您可以只更新对象数据的一个子集
  13.     $res=$bmobObj->update("bd89c6bce9", array("score"=>60,"playerName"=>"game"));  
  14.     $res=$bmobObj->delete("bd89c6bce9"); //删除对象bd89c6bce9
  15.     //对象的查询,这里是表示查找playerName为"game"的对象，只返回２个结果
  16.     $res=$bmobObj->get("",array('where={"playerName":"game"}','limit=2')); 
  17.     //id为bd89c6bce9的field score数值减2
  18.     $res=$bmobObj->increment("bd89c6bce9","score",array(-2)); 
  19.     //id为bd89c6bce9的field score数值加2
  20.     $res=$bmobObj->increment("bd89c6bce9","score",array(2)); 
  22.     /*
  23.      *  BmobUser 的例子
  24.      */    
  25.     $bmobUser = new BmobUser();
  26.     //用户注册, 其中username和password为必填字段
  27.     $res = $bmobUser->register(array("username"=>"cooldude117", "password"=>"p_n7!-e8", "phone"=>"415-392-0202", "email"=>"bmobtest111@126.com")); 
  28.     //用户登录, 第一个参数为用户名,第二个参数为密码
  29.     $res = $bmobUser->login("cooldude117","p_n7!-e8"); 
  30.     // 获取id为415b8fe99a用户的信息
  31.     $res = $bmobUser->get("415b8fe99a"); 
  32.     $res = $bmobUser->get(); // 获取所有用户的信息
  33.     $res = $bmobUser->update("415b8fe99a", "050391db407114d9801c8f2788c6b25a", array("phone"=>"02011111")); // 更新用户的信息
  34.     // 请求重设密码,前提是用户将email与他们的账户关联起来
  35.     $res = $bmobUser->requestPasswordReset("bmobtest111@126.com");
  36.     // 删除id为415b8fe99a的用户, 第一参数是用户id, 第二个参数为sessiontoken,在用户登录或注册后获取, 必填
  37.     $res = $bmobUser->delete("415b8fe99a", "050391db407114d9801c8f2788c6b25a"); 
  39.     /*
  40.      *  BmobCloudCode 的例子
  41.      */    
  42.     //调用名字为getMsgCode的云端代码
  43.     $cloudCode = new BmobCloudCode('getMsgCode');
  44.     //传入参数name，其值为bmob
  45.     $res = $cloudCode->get(array("name"=>"bmob"));
  48.     var_dump($res);
  50. } catch (Exception $e) {
  51.     echo $e;
  52. }

类库说明

  1. BmobConfig

Bmob配置类，使用的时候需要修改里面的配置信息

  1. BmobUser

Bmob用户表处理类，负责处理与_User表相关的事情

  1. BmobObject

Bmob对象处理类，负责处理云端各种表的数据操作

  1. BmobRestClient

Bmob基础类，用于完成REST API请求

  1. BmobException

Bmob异常处理类

  1. BmobCloudCode

Bmob云端代码调用类

Bmob官方信息

官方网址：http://www.bmob.cn

问答社区：http://wenda.bmob.cn

技术邮箱：support@bmob.cn