facebook chat api 使用
官方API文档： https://developers.facebook.com/docs/chat/
下面是根据文档修改的类：
<?php
class Invite_Chat{
protected static $_instance = array();
private $server = 'chat.facebook.com'; // fb xmpp 服务器
private $access_token = '';
// FB chat XMPP 标准
private $STREAM_XML = '<stream:stream
xmlns:stream="http://etherx.jabber.org/streams"
version="1.0" xmlns="jabber:client" to="chat.facebook.com"
xml:lang="en" xmlns:xml="http://www.w3.org/XML/1998/namespace">';
private $AUTH_XML = '<auth xmlns="urn:ietf:params:xml:ns:xmpp-sasl"
mechanism="X-FACEBOOK-PLATFORM"></auth>';
private $CLOSE_XML = '</stream:stream>';
private $RESOURCE_XML = '<iq type="set" id="3">
<bind xmlns="urn:ietf:params:xml:ns:xmpp-bind">
<resource>fb_xmpp_script</resource></bind></iq>';
private $SESSION_XML = '<iq type="set" id="4" to="chat.facebook.com">
<session xmlns="urn:ietf:params:xml:ns:xmpp-session"/></iq>';
private $START_TLS = '<starttls xmlns="urn:ietf:params:xml:ns:xmpp-tls"/>';
/**
*
* @return Invite_Chat
*/
public static function factory(){
if( !is_object( self::$_instance['invite_chat'])){
self::$_instance['invite_chat'] = new Invite_Chat();
}
return self::$_instance['invite_chat'];
}
/**
*
* 获取用户access_token
* @param unknown_type $from
*/
public function getAccessToken($from){
// 根据FB API 获取access token 这里需要自己处理
return $this->access_token;
}
/**
*
* 连接xmpp server
* @param unknown_type $server
*/
public function open_connection($server){
$fp = fsockopen($server, 5222, $errno, $errstr);
if(!$fp){
// print "$errstr ($errno)<br>";
}else{
// print "connnection open<br>";
}
return $fp;
}
/**
*
* 发送xmpp文件流
* @param unknown_type $fp
* @param unknown_type $xml
*/
public function send_xml($fp, $xml){
fwrite($fp, $xml);
}
/**
*
* 接收xmpp文件流
* @param unknown_type $fp
* @param unknown_type $size
*/
public function recv_xml($fp, $size=4096) {
$xml = fread($fp, $size);
if (!preg_match('/^</', $xml)) {
$xml = '<' . $xml;
}
if ($xml === "") {
return null;
}
// parses xml
$xml_parser = xml_parser_create();
xml_parse_into_struct($xml_parser, $xml, $val, $index);
xml_parser_free($xml_parser);
return array($val, $index);
}
/**
*
* 解析xmpp文件流
* @param unknown_type $fp
* @param unknown_type $tag
* @param unknown_type $value
* @param unknown_type $ret
*/
public function find_xmpp($fp, $tag, $value=null, &$ret=null) {
static $val = null, $index = null;
do {
if ($val === null && $index === null) {
list($val, $index) = $this->recv_xml($fp);
if ($val === null || $index === null) {
return false;
}
}
foreach ($index as $tag_key => $tag_array) {
if ($tag_key === $tag) {
if ($value === null) {
if (isset($val[$tag_array[0]]['value'])) {
$ret = $val[$tag_array[0]]['value'];
}
return true;
}
foreach ($tag_array as $i => $pos) {
if ($val[$pos]['tag'] === $tag && isset($val[$pos]['value']) && $val[$pos]['value'] === $value) {
$ret = $val[$pos]['value'];
return true;
}
}
}
}
$val = $index = null;
}while (!feof($fp));
return false;
}
/**
*
* xmpp 通信
* @param unknown_type $options
* @param unknown_type $access_token
* @param unknown_type $message
*/
public function xmpp_connect($options, $access_token, $message){
$fp = $this->open_connection($options['server']);
if(!$fp){
return -1;
}
// initiates auth process (using X-FACEBOOK_PLATFORM)
$this->send_xml($fp, $this->STREAM_XML);
if(!$this->find_xmpp($fp, 'STREAM:STREAM')){
return -2;
}
if(!$this->find_xmpp($fp, 'MECHANISM', 'X-FACEBOOK-PLATFORM')){
return -3;
}
// starting tls - MANDATORY TO USE OAUTH TOKEN!!!!
$this->send_xml($fp, $this->START_TLS);
if(!$this->find_xmpp($fp, 'PROCEED', null, $proceed)){
return -4;
}
stream_socket_enable_crypto($fp, true, STREAM_CRYPTO_METHOD_TLS_CLIENT);
$this->send_xml($fp, $this->STREAM_XML);
if(!$this->find_xmpp($fp, 'STREAM:STREAM')){
return -5;
}
if(!$this->find_xmpp($fp, 'MECHANISM', 'X-FACEBOOK-PLATFORM')){
return -6;
}
// gets challenge from server and decode it
$this->send_xml($fp, $this->AUTH_XML);
if(!$this->find_xmpp($fp, 'CHALLENGE', null, $challenge)){
return -7;
}
$challenge = base64_decode($challenge);
$challenge = urldecode($challenge);
parse_str($challenge, $challenge_array);
// creates the response array
$resp_array = array(
'method' => $challenge_array['method'],
'nonce' => $challenge_array['nonce'],
'access_token' => $access_token,
'api_key' => $options['app_id'],
'call_id' => 0,
'v' => '1.0',
);
// creates signature
$response = http_build_query($resp_array);
// sends the response and waits for success
$xml = '<response xmlns="urn:ietf:params:xml:ns:xmpp-sasl">'.
base64_encode($response).'</response>';
$this->send_xml($fp, $xml);
if (!$this->find_xmpp($fp, 'SUCCESS')) {
return -8;
}
// finishes auth process
$this->send_xml($fp, $this->STREAM_XML);
if(!$this->find_xmpp($fp,'STREAM:STREAM')) {
return -9;
}
if(!$this->find_xmpp($fp, 'STREAM:FEATURES')){
return -10;
}
$this->send_xml($fp, $this->RESOURCE_XML);
if(!$this->find_xmpp($fp, 'JID')){
return -11;
}
$this->send_xml($fp, $this->SESSION_XML);
if(!$this->find_xmpp($fp, 'SESSION')){
return -12;
}
// send messages
$this->send_xml($fp, $message);
// we made it!
$this->send_xml($fp, $this->CLOSE_XML);
// print ("Authentication complete<br>");
fclose($fp);
return true;
}
/**
*
* 发送chat 信息
* @param $from 发送者id
* @param $to_puid 接收者id
* @param $message 消息。 例： http://www.google.com 直接输入连接即可
*/
function chat($from, $to_puid, $message){
$app_id= '应用appid';
$app_secret= '应用secret';
$my_url = '应用app_url';
$message_xml = '<message to="-'.$to_puid.'@chat.facebook.com" from="-'.$from.'@chat.facebook.com" >'.
'<body>'.$message.'</body>'.
'</message>';
$options = array(
'uid' => $from,
'app_id' => $app_id,
'server' => $this->server
);
$access_token = $this->getAccessToken($from);
if(empty($access_token)){
return false;
}
if($this->xmpp_connect($options, $access_token, $message_xml) > 0){
return true;
}else{
return false;
}
}
} // end class
需要注意的地方：
1. 官方文档没有写明在哪里添加消息发送。如果想了解详情，最好去看看XMPP协议。
2. 使用Chat API 接口，需要先获取Chat 权限。
3. access_token 和官方的获取方式不同，这个可以根据自己的应用的结构进行调整。
获取chat 权限：
js 方法：
function getXmpplogin(){ FB.ui({ method : 'permissions.request',perms : 'xmpp_login'}, function(r){ console.log(r); }); } getXmpplogin();
url 方法：
<?php $appid = ''; $secret = ''; $appurl = ''; $url = 'https://www.facebook.com/dialog/oauth?scope=PERMISSIONS_NAME&client_id=APPID&redirect_uri=APPURL';
