用PHP写的QQ Client,可以登陆、登出、收发消息、添加好友

发表于:2007-06-21来源:作者:点击数: 标签:
作者:Hackfan 来源:http://blog.hackfan.net/ 2005.8.18 QQ客户端,使用腾讯tqq.tencent.com:8000HTTP接口 参考文章:http://spaces.msn.com/members/mprogramer 使用到的类: AdvancedHTTPClient 中文编码集合类库 类接口: 初始化类: $qq=newQ QC lient

   
   作者:Hackfan
来源:http://blog.hackfan.net/
2005.8.18

QQ客户端,使用腾讯tqq.tencent.com:8000 HTTP接口

参考文章:http://spaces.msn.com/members/mprogramer

使用到的类:

Advanced HTTP Client
中文编码集合类库

类接口:

 初始化类:
  $qq = new QQClient('106814','password');

 登陆:
  $qq -> login();
  参数:
   void
  返回:
   服务器返回成功:
    登陆成功:QQ_LOGIN_SUCCESS
    登陆失败:QQ_LOGIN_FAILED
     同时,全局变量$QQ_ERROR_MSG记录了服务器返回的错误说明
   服务器返回失败:QQ_RETURN_FAILED

 获得好友列表:
  $qq -> getFriendsList();
  参数:
   void
  返回:
   成功:
    array
    (
     QQ号码,
    )
   失败:QQ_RETURN_FAILED

 获得在线列表:
  $qq -> getOnlineList();
  参数:
   void
  返回:
   成功:
    好友数 > 0
     array
     (
      array
      (
       "UN" => QQ号码,
       "NK" => QQ昵称,
       "ST" => QQ状态,
       "FC" => QQ头像
      ),
     )

     关于ST:
      10为上线QQ_STATUS_ONLINE,20为离线QQ_STATUS_OFFLINE,30为忙碌QQ_STATUS_BUSY
     关于FC:
      FC为QQ头像的的ID,如的头像ID为270,那么其头使用的图片为91.bmp,其算法为FC/3+1

    好友数 = 0
     QQ_LIST_NONE
   错误:
    !(在线好友数==在线好友昵称数==在线好友状态数==在线好友头像数):QQ_LIST_ERROR
   失败:QQ_RETURN_FAILED

 获得号码信息:
  $qq -> getInfo('106814');
  参数:
   string QQ号码
  返回:
   成功:
    array
    (
     'AD' => ,  //联系地址
     'AG' => ,  //年龄
     'BT' => ,  //血型
     'CO' => ,  //星座
     'CT' => ,  //城市
     'CY' => ,  //国家
     'EM' => ,  //Email
     'FC' => ,  //头像
     'HP' => ,  //网站
     'JB' => ,  //职业
     'MO' => ,  //移动电话
     'PC' => ,  //邮编
     'PH' => ,  //联系电话
     'PR' => ,  //简介
     'PV' => ,  //省
     'RN' => ,  //真实姓名
     'SC' => ,  //毕业院校
     'SX' => ,  //性别
     'UN' => ,  //QQ号
     'NK' =>   //昵称
    )
   失败:QQ_RETURN_FAILED

 添加好友:
  $qq -> addFriend( '106814' );
  参数:
   string QQ号码
  返回:
   成功:
    对方允许任何人加为好友:QQ_ADDTOLIST_SUCCESS;
    需要验证:QQ_ADDTOLIST_NEEDAUTH;
    不允许任何人加为好友:QQ_ADDTOLIST_REFUSE;
    未知的代码:QQ_ADDTOLIST_UNKNOWN;
   失败:QQ_RETURN_FAILED

 验证:
  $qq -> replyAdd( '106814' , TYPE, MSG );
  参数:
   string QQ号码
   enum(0,1,2) 类型
    *0表示“通过验证”,1表示“拒决加为对方为好友”,2表示“为请求对方加为好友”
   string 理由
  返回:
   成功:QQ_RETURN_SUCCESS
   失败:QQ_RETURN_FAILED

 删除好友:
  $qq -> delFriend( '106814' );
  参数:
   string QQ号码
  返回:
   成功:QQ_RETURN_SUCCESS
   失败:QQ_RETURN_FAILED

 改变状态:
  $qq -> changeStatus( QQ_STATUS );
  参数:
   enum(QQ_STATUS_ONLINE,QQ_STATUS_OFFLINE,QQ_STATUS_BUSY) 类型
  返回:
   成功:QQ_RETURN_SUCCESS
   失败:QQ_RETURN_FAILED

 登出:
  $qq -> logout();
  参数:
   void
  返回:
   成功:QQ_RETURN_SUCCESS
   失败:QQ_RETURN_FAILED

 接收信息:
  $qq -> getMsg();
  参数:
   void
  返回:
    消息数 > 0
     array
     (
      array
      (
       "MT" => 消息类型,
       "UN" => 发送者号码,
       "MG" => 消息内容
      ),
     )

     关于MT:
      9为用户消息,99为系统消息,2为请求信息,3为通过验证,4为拒绝被加好友
     关于MG:
      当MT=9时,MG为用户发送的消息内容
      当MT=99时,
       MG=10(QQ_STATUS_ONLINE)表示对方上线
       MG=20(QQ_STATUS_OFFLINE)表示对方下线
       MG=30(QQ_STATUS_BUSY)表示对方进入忙碌状态
      当MT=2时,MG为请求验证的信息
      当MT=3时,MG为?
      当MT=4时,MG为拒绝理由

    好友数 = 0
     QQ_LIST_NONE
   错误:
    !(在线好友数==在线好友昵称数==在线好友状态数==在线好友头像数):QQ_LIST_ERROR
   失败:QQ_RETURN_FAILED

 发送信息:
  $qq -> sendMsg($uin,$msg);
  参数:
  返回:
   成功:QQ_RETURN_SUCCESS
   失败:QQ_RETURN_FAILED

解释:
 QQ_RETURN_SUCCESS表示服务器返回执行成功的信息
 QQ_RETURN_FAILED表示服务器没有正确返回或者返回没有正确执行
  本代码处于调试状态,当服务器没有正确返回的时候,将会打印出详细的信息

运行:推荐在Console模式下运行本程序,不建议使用WebServer运行。

原文转自:http://www.ltesting.net