騰訊im · php常用實例

## 1、下載官方的TLSSigAPIv2.php簽名生成類 [下載地址](https://cloud.tencent.com/document/product/269/1630) ## 2、創建postcurl和隨機字符串生成公共方法 ```php function randomsum($sum){ $z=""; for($i=0;$i<$sum/4;$i++){ $z .=rand(1000,9999); } return $z; } /** * curl post 模擬發送數據 * @param $cate * @return array */ function postCurls($url, $data){ $data = json_encode($data); $curl = curl_init(); curl_setopt($curl, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_0); //HTTP瀏覽器訪問版本 curl_setopt($curl, CURLOPT_HEADER, false); //頭部信息 curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); //返回的內容作為變量儲存 curl_setopt($curl, CURLOPT_URL, $url); //訪問網址 curl_setopt($curl, CURLOPT_POST, true); //post請求 curl_setopt($curl, CURLOPT_POSTFIELDS, $data); //請求數據 curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,false); //對認證證書來源的檢查 curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false); //從證書中檢查SSL加密算法是否存在 $result = curl_exec($curl); //抓取URL并把它傳遞給瀏覽器 curl_close($curl); //關閉當前curl return $result; } ``` ## 3、建立用戶管理類和群組管理類對接接口（可以寫到一個類里面）下面是直接進行接口的post提交 **3.1用戶管理類** ```php <?php require_once "curl.php";//公共函數 require_once "TLSSigAPIv2.php";//簽名生成 //$account = new User; // var_dump($account->genUserSig($id),0); // var_dump($account->account_import("2","1","1"),1); // var_dump($account->account_delete([ ["UserID"=>"1"] ]),2);die; // var_dump($account->account_check([ ["UserID"=>"1"] ]),3);die; // var_dump($account->querystate([1] ,1),4); class User{ private $sdkappid = ***; private $identifier = "***"; //自有帳號導入即時通信 public function account_import($Identifier,$Nick,$FaceUrl) { $url = "https://console.tim.qq.com/v4/im_open_login_svc/account_import?"; $url = $this->geturlparameter($url); $data = [ "Identifier" => $Identifier, "Nick" => $Nick, "FaceUrl" => $FaceUrl ]; // var_dump($data);die; $s = postCurls($url,$data); return $s; } //刪除 public function account_delete($DeleteItem) { $url = "https://console.tim.qq.com/v4/im_open_login_svc/account_delete?"; $url = $this->geturlparameter($url); $data = [ "DeleteItem" => $DeleteItem ]; // echo( json_encode($data)); $s = postCurls($url,$data); return $s; } //查詢帳號 public function account_check($CheckItem) { $url = "https://console.tim.qq.com/v4/im_open_login_svc/account_check?"; $url = $this->geturlparameter($url); $data = [ "CheckItem" => $CheckItem ]; // echo( json_encode($data)); $s = postCurls($url,$data); return $s; } //查詢帳號在線狀態 public function querystate($To_Account ,$IsNeedDetail) { $url = "https://console.tim.qq.com/v4/im_open_login_svc/account_check?"; $url = $this->geturlparameter($url); $data = [ "IsNeedDetail" => $IsNeedDetail, "To_Account" => $To_Account ]; // echo( json_encode($data)); $s = postCurls($url,$data); return $s; } //帳號生成的簽名 public function genUserSig($id) { $TLSSigAPIv2 = new TLSSigAPIv2($this->sdkappid,false); // var_dump(1);die; $TLSSigAPIv2 = new TLSSigAPIv2($this->sdkappid,"b7009c4a7bc78740e5a472a443978d282805cf62d931db0bc89920d0d57a7c80"); return $TLSSigAPIv2->genUserSig($id); } //鏈接 public function geturlparameter($url) { $TLSSigAPIv2 = new TLSSigAPIv2($this->sdkappid,false); // var_dump(1);die; $TLSSigAPIv2 = new TLSSigAPIv2($this->sdkappid,"b7009c4a7bc78740e5a472a443978d282805cf62d931db0bc89920d0d57a7c80"); $zz = $url.http_build_query(array( "sdkappid" => $this->sdkappid, "identifier" => $this->identifier, "usersig" => $TLSSigAPIv2->genUserSig("administrator"), 'random' => randomsum(32), 'contenttype' => 'json' )); return $zz; } } ``` **3.2群組管理類** ```php <?php // namespace Tencent; require_once "curl.php";//公共函數 require_once "TLSSigAPIv2.php";//簽名生成 // use Tencent\TLSSigAPIv2; //本接口用于將 App 自有帳號導入即時通信 IM 帳號系統，為該帳號創建一個對應的內部 ID，使該帳號能夠使用即時通信 IM 服務。 //$Group = new Group; // // var_dump($Group->get_appid_group_list([]),1); // var_dump($Group->create_group("1","test" ),2); // var_dump($Group-> destroy_group("@TGS#2MQF3EZG4"),3); // $MemberList=[["Member_Account"=>"2"]]; // var_dump($Group->add_group_member("@TGS#2ORF3EZGA",$MemberList),4); //刪除成員 // $MemberList=[["Member_Account"=>"2"]]; // var_dump($Group->add_group_member("@TGS#2ORF3EZGA",$MemberList),5); // var_dump($Group-> get_joined_group_list( "2"),6); // var_dump($Group-> get_group_info(["@TGS#2ORF3EZGA"]),7); // var_dump($Group-> get_role_in_group("@TGS#2ORF3EZGA",["2"]),8); // var_dump($Group-> modify_group_member_info("@TGS#2ORF3EZGA", "2" ,1),9); // var_dump($Group-> modify_group_member_info("@TGS#2ORF3EZGA", "2" ,2),9.2); // var_dump($Group-> modify_group_member_info("@TGS#2ORF3EZGA", "2" ,3),9.3); // var_dump($Group-> get_online_member_num("@TGS#2ORF3EZGA" ),10); // var_dump($Group-> get_group_member_info("@TGS#2ORF3EZGA" ),11); class Group { private $sdkappid = ***; private $identifier = "****"; //創建群 public function create_group($Owner_Account,$GroupName,$Introduction="",$Notification="",$FaceUrl="") { $url = "https://console.tim.qq.com/v4/group_open_http_svc/create_group?"; $url = $this->geturlparameter($url); $data=[ "Owner_Account"=> $Owner_Account, "Type"=> "AVChatRoom", "Name"=> $GroupName, ]; // "Owner_Account"=> $Owner_Account, // 群主的 UserId（選填） // "Type"=> "Public", // 群組類型：Private/Public/ChatRoom/AVChatRoom // "Name"=> $TestGroup, // 群名稱（必填） // "Introduction"=> $Introduction, // 群簡介（選填） // "Notification"=> $Notification, // 群公告（選填） // "FaceUrl"=>$FaceUrl, // 群頭像 URL（選填） // "MaxMemberCount"=> 500, // 最大群成員數量（選填） // "ApplyJoinOption"=> "FreeAccess" // 申請加群處理方式（選填） $s = postCurls($url,$data); return $s; } // 解散群成員 public function destroy_group($GroupId) { $url = "https://console.tim.qq.com/v4/group_open_http_svc/destroy_group?"; $url = $this->geturlparameter($url); $data=[ "GroupId"=> $GroupId, ]; // "Owner_Account"=> $Owner_Account, // 群主的 UserId（選填） // "Type"=> "Public", // 群組類型：Private/Public/ChatRoom/AVChatRoom // "Name"=> $TestGroup, // 群名稱（必填） // "Introduction"=> $Introduction, // 群簡介（選填） // "Notification"=> $Notification, // 群公告（選填） // "FaceUrl"=>$FaceUrl, // 群頭像 URL（選填） // "MaxMemberCount"=> 500, // 最大群成員數量（選填） // "ApplyJoinOption"=> "FreeAccess" // 申請加群處理方式（選填） $s = postCurls($url,$data); return $s; } //增加群成員 public function add_group_member($GroupId,$MemberList) { $url = "https://console.tim.qq.com/v4/group_open_http_svc/add_group_member?"; $url = $this->geturlparameter($url); $data=[ "GroupId"=> $GroupId, "MemberList"=> $MemberList, ]; $s = postCurls($url,$data); return $s; } //刪除群成員 public function delete_group_member($GroupId,$MemberList) { $url = "https://console.tim.qq.com/v4/group_open_http_svc/delete_group_member?"; $url = $this->geturlparameter($url); $data=[ "GroupId"=> $GroupId, "MemberToDel_Account"=> $MemberList, ]; $s = postCurls($url,$data); return $s; } //獲取用戶所加入的群組 public function get_joined_group_list( $MemberList) { $url = "https://console.tim.qq.com/v4/group_open_http_svc/get_joined_group_list?"; $url = $this->geturlparameter($url); $data=[ "Member_Account"=> $MemberList, ]; $s = postCurls($url,$data); return $s; } //獲取群組詳細信息 public function get_group_info( $GroupIdList) { $url = "https://console.tim.qq.com/v4/group_open_http_svc/get_group_info?"; $url = $this->geturlparameter($url); $data=[ "GroupIdList"=> $GroupIdList, ]; $s = postCurls($url,$data); return $s; } //查詢用戶在群組中的身份 public function get_role_in_group($GroupId,$MemberList) { $url = "https://console.tim.qq.com/v4/group_open_http_svc/get_role_in_group?"; $url = $this->geturlparameter($url); $data=[ "GroupId"=> $GroupId, "User_Account"=> $MemberList, ]; $s = postCurls($url,$data); return $s; } // 修改用戶信息 public function modify_group_member_info($GroupId,$Member_Account,$type="1") { if($type==1){ // 設置管理元 $data=[ "GroupId"=>$GroupId, // 要操作的群組（必填） "Member_Account"=> $Member_Account, // 要操作的群成員（必填） "Role"=>"Admin" // 設置管理員 ]; } elseif ( $type==2){ // 取消管理員 $data=[ "GroupId"=>$GroupId, // 要操作的群組（必填） "Member_Account"=> $Member_Account, // 要操作的群成員（必填） "Role"=> "Member" // 設置管理員 ]; }else { // 設置指定的群成員禁言時間。 $data=[ "GroupId"=>$GroupId, // 要操作的群組（必填） "Member_Account"=> $Member_Account, // 要操作的群成員（必填） "ShutUpTime"=> "86400" // 設置管理員 ]; } $url = "https://console.tim.qq.com/v4/group_open_http_svc/modify_group_member_info?"; $url = $this->geturlparameter($url); // var_dump($data);die; $s = postCurls($url,$data); return $s; } //獲取直播群在線人數 public function get_online_member_num($GroupId) { // 設置管理元 $data=[ "GroupId"=>$GroupId, // 要操作的群組（必填） ]; $url = "https://console.tim.qq.com/v4/group_open_http_svc/get_online_member_num?"; $url = $this->geturlparameter($url); // var_dump($data);die; $s = postCurls($url,$data); return $s; } //獲取群成員詳細資料 public function get_group_member_info($GroupId) { // 設置管理元 $data=[ "GroupId"=>$GroupId, // 要操作的群組（必填） ]; $url = "https://console.tim.qq.com/v4/group_open_http_svc/get_group_member_info?"; $url = $this->geturlparameter($url); // var_dump($data);die; $s = postCurls($url,$data); return $s; } // 獲取 App 中的所有群組 public function get_appid_group_list($Limit=1000,$Next=0,$GroupType="Public") { $url = "https://console.tim.qq.com/v4/group_open_http_svc/get_appid_group_list?"; $url = $this->geturlparameter($url); $data=[ "Limit"=> 1000, "Next"=> 0, "GroupType" => $GroupType // 拉取哪種群組形態，不填為拉取所有 ]; $s = postCurls($url,$data); return $s; } //鏈接 public function geturlparameter($url) { $TLSSigAPIv2 = new TLSSigAPIv2($this->sdkappid,false); // var_dump(1);die; $TLSSigAPIv2 = new TLSSigAPIv2($this->sdkappid,"b7009c4a7bc78740e5a472a443978d282805cf62d931db0bc89920d0d57a7c80"); $zz = $url.http_build_query(array( "sdkappid" => $this->sdkappid, "identifier" => $this->identifier, "usersig" => $TLSSigAPIv2->genUserSig("administrator"), 'random' => randomsum(32), 'contenttype' => 'json' )); return $zz; } } ```