From 074a730042679675bd13da3d5bdd64cf901af781 Mon Sep 17 00:00:00 2001

From: Elmer Zhang Date: Mon, 12 Nov 2012 15:05:48 +0800

Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E7=9B=AE=E5=BD=95=E7=BB=93?=

=?UTF-8?q?=E6=9E=84=E3=80=82?=

MIME-Version: 1.0

Content-Type: text/plain; charset=UTF-8

Content-Transfer-Encoding: 8bit

---

callback.php | 39 +

config.php | 10 +

saetv2.ex.class.php | 3270 +++++++++++++++++++++++++++++++++++++++++++

weibo_login.png | Bin 0 -> 16128 bytes

weibolist.php | 48 +

5 files changed, 3367 insertions(+)

create mode 100644 callback.php

create mode 100644 config.php

create mode 100644 saetv2.ex.class.php

create mode 100644 weibo_login.png

create mode 100644 weibolist.php

diff --git a/callback.php b/callback.php

new file mode 100644

index 0000000..bf17d41

--- /dev/null

+++ b/callback.php

@@ -0,0 +1,39 @@

+getAccessToken( 'code', $keys ) ;

+} catch (OAuthException $e) {

+}

+}

+

+if ($token) {

+$_SESSION['token'] = $token;

+setcookie( 'weibojs_'.$o->client_id, http_build_query($token) );

+?>

+授权完成,进入你的微博列表页面

+

+授权失败。

+

diff --git a/config.php b/config.php

new file mode 100644

index 0000000..eb4c891

--- /dev/null

+++ b/config.php

@@ -0,0 +1,10 @@

+

+ */

+

+/**

+ * @ignore

+ */

+class OAuthException extends Exception {

+// pass

+}

+

+

+/**

+ * 新浪微博 OAuth 认证类(OAuth2)

+ *

+ * 授权机制说明请大家参考微博开放平台文档：{@link http://open.weibo.com/wiki/Oauth2}

+ *

+ * @package sae

+ * @author Elmer Zhang

+ * @version 1.0

+ */

+class SaeTOAuthV2 {

+/**

+ * @ignore

+ */

+public $client_id;

+/**

+ * @ignore

+ */

+public $client_secret;

+/**

+ * @ignore

+ */

+public $access_token;

+/**

+ * @ignore

+ */

+public $refresh_token;

+/**

+ * Contains the last HTTP status code returned.

+ *

+ * @ignore

+ */

+public $http_code;

+/**

+ * Contains the last API call.

+ *

+ * @ignore

+ */

+public $url;

+/**

+ * Set up the API root URL.

+ *

+ * @ignore

+ */

+public $host = "https://api.weibo.com/2/";

+/**

+ * Set timeout default.

+ *

+ * @ignore

+ */

+public $timeout = 30;

+/**

+ * Set connect timeout.

+ *

+ * @ignore

+ */

+public $connecttimeout = 30;

+/**

+ * Verify SSL Cert.

+ *

+ * @ignore

+ */

+public $ssl_verifypeer = FALSE;

+/**

+ * Respons format.

+ *

+ * @ignore

+ */

+public $format = 'json';

+/**

+ * Decode returned json data.

+ *

+ * @ignore

+ */

+public $decode_json = TRUE;

+/**

+ * Contains the last HTTP headers returned.

+ *

+ * @ignore

+ */

+public $http_info;

+/**

+ * Set the useragnet.

+ *

+ * @ignore

+ */

+public $useragent = 'Sae T OAuth2 v0.1';

+

+/**

+ * print the debug info

+ *

+ * @ignore

+ */

+public $debug = FALSE;

+

+/**

+ * boundary of multipart

+ * @ignore

+ */

+public static $boundary = '';

+

+/**

+ * Set API URLS

+ */

+/**

+ * @ignore

+ */

+function accessTokenURL() { return 'https://api.weibo.com/oauth2/access_token'; }

+/**

+ * @ignore

+ */

+function authorizeURL() { return 'https://api.weibo.com/oauth2/authorize'; }

+

+/**

+ * construct WeiboOAuth object

+ */

+function __construct($client_id, $client_secret, $access_token = NULL, $refresh_token = NULL) {

+$this->client_id = $client_id;

+$this->client_secret = $client_secret;

+$this->access_token = $access_token;

+$this->refresh_token = $refresh_token;

+}

+

+/**

+ * authorize接口

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/Oauth2/authorize Oauth2/authorize}

+ *

+ * @param string $url 授权后的回调地址,站外应用需与回调地址一致,站内应用需要填写canvas page的地址

+ * @param string $response_type 支持的值包括 code 和token 默认值为code

+ * @param string $state 用于保持请求和回调的状态。在回调时,会在Query Parameter中回传该参数

+ * @param string $display 授权页面类型 可选范围:

+ * - default默认授权页面

+ * - mobile支持html5的手机

+ * - wap1.2wap1.2页面

+ * - wap2.0wap2.0页面

+ * - apponweibo站内应用专用,站内应用不传display参数,并且response_type为token时,默认使用改display.授权后不会返回access_token，只是输出js刷新站内应用父框架

+ * @param bool $forcelogin 是否强制用户重新登录，true：是，false：否。默认false。

+ * @param string $language 授权页语言，缺省为中文简体版，en为英文版。英文版测试中，开发者任何意见可反馈至 @微博API

+ * @return array

+ */

+function getAuthorizeURL( $url, $response_type = 'code', $state = NULL, $display = NULL, $forcelogin = NULL, $language = NULL ) {

+$params = array();

+$params['client_id'] = $this->client_id;

+$params['redirect_uri'] = $url;

+$params['response_type'] = $response_type;

+$params['state'] = $state;

+$params['display'] = $display;

+$params['forcelogin'] = $forcelogin;

+$params['language'] = $language;

+return $this->authorizeURL() . "?" . http_build_query($params);

+}

+

+/**

+ * access_token接口

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/OAuth2/access_token OAuth2/access_token}

+ *

+ * @param string $type 请求的类型,可以为:code, password, token

+ * @param array $keys 其他参数：

+ * - 当$type为code时： array('code'=>..., 'redirect_uri'=>...)

+ * - 当$type为password时： array('username'=>..., 'password'=>...)

+ * - 当$type为token时： array('refresh_token'=>...)

+ * @return array

+ */

+function getAccessToken( $type = 'code', $keys ) {

+$params = array();

+$params['client_id'] = $this->client_id;

+$params['client_secret'] = $this->client_secret;

+if ( $type === 'token' ) {

+$params['grant_type'] = 'refresh_token';

+$params['refresh_token'] = $keys['refresh_token'];

+} elseif ( $type === 'code' ) {

+$params['grant_type'] = 'authorization_code';

+$params['code'] = $keys['code'];

+$params['redirect_uri'] = $keys['redirect_uri'];

+} elseif ( $type === 'password' ) {

+$params['grant_type'] = 'password';

+$params['username'] = $keys['username'];

+$params['password'] = $keys['password'];

+} else {

+throw new OAuthException("wrong auth type");

+}

+

+$response = $this->oAuthRequest($this->accessTokenURL(), 'POST', $params);

+$token = json_decode($response, true);

+if ( is_array($token) && !isset($token['error']) ) {

+$this->access_token = $token['access_token'];

+$this->refresh_token = $token['refresh_token'];

+} else {

+throw new OAuthException("get access token failed." . $token['error']);

+}

+return $token;

+}

+

+/**

+ * 解析 signed_request

+ *

+ * @param string $signed_request 应用框架在加载iframe时会通过向Canvas URL post的参数signed_request

+ *

+ * @return array

+ */

+function parseSignedRequest($signed_request) {

+list($encoded_sig, $payload) = explode('.', $signed_request, 2);

+$sig = self::base64decode($encoded_sig) ;

+$data = json_decode(self::base64decode($payload), true);

+if (strtoupper($data['algorithm']) !== 'HMAC-SHA256') return '-1';

+$expected_sig = hash_hmac('sha256', $payload, $this->client_secret, true);

+return ($sig !== $expected_sig)? '-2':$data;

+}

+

+/**

+ * @ignore

+ */

+function base64decode($str) {

+return base64_decode(strtr($str.str_repeat('=', (4 - strlen($str) % 4)), '-_', '+/'));

+}

+

+/**

+ * 读取jssdk授权信息，用于和jssdk的同步登录

+ *

+ * @return array 成功返回array('access_token'=>'value', 'refresh_token'=>'value'); 失败返回false

+ */

+function getTokenFromJSSDK() {

+$key = "weibojs_" . $this->client_id;

+if ( isset($_COOKIE[$key]) && $cookie = $_COOKIE[$key] ) {

+parse_str($cookie, $token);

+if ( isset($token['access_token']) && isset($token['refresh_token']) ) {

+$this->access_token = $token['access_token'];

+$this->refresh_token = $token['refresh_token'];

+return $token;

+} else {

+return false;

+}

+} else {

+return false;

+}

+}

+

+/**

+ * 从数组中读取access_token和refresh_token

+ * 常用于从Session或Cookie中读取token，或通过Session/Cookie中是否存有token判断登录状态。

+ *

+ * @param array $arr 存有access_token和secret_token的数组

+ * @return array 成功返回array('access_token'=>'value', 'refresh_token'=>'value'); 失败返回false

+ */

+function getTokenFromArray( $arr ) {

+if (isset($arr['access_token']) && $arr['access_token']) {

+$token = array();

+$this->access_token = $token['access_token'] = $arr['access_token'];

+if (isset($arr['refresh_token']) && $arr['refresh_token']) {

+$this->refresh_token = $token['refresh_token'] = $arr['refresh_token'];

+}

+

+return $token;

+} else {

+return false;

+}

+}

+

+/**

+ * GET wrappwer for oAuthRequest.

+ *

+ * @return mixed

+ */

+function get($url, $parameters = array()) {

+$response = $this->oAuthRequest($url, 'GET', $parameters);

+if ($this->format === 'json' && $this->decode_json) {

+return json_decode($response, true);

+}

+return $response;

+}

+

+/**

+ * POST wreapper for oAuthRequest.

+ *

+ * @return mixed

+ */

+function post($url, $parameters = array(), $multi = false) {

+$response = $this->oAuthRequest($url, 'POST', $parameters, $multi );

+if ($this->format === 'json' && $this->decode_json) {

+return json_decode($response, true);

+}

+return $response;

+}

+

+/**

+ * DELTE wrapper for oAuthReqeust.

+ *

+ * @return mixed

+ */

+function delete($url, $parameters = array()) {

+$response = $this->oAuthRequest($url, 'DELETE', $parameters);

+if ($this->format === 'json' && $this->decode_json) {

+return json_decode($response, true);

+}

+return $response;

+}

+

+/**

+ * Format and sign an OAuth / API request

+ *

+ * @return string

+ * @ignore

+ */

+function oAuthRequest($url, $method, $parameters, $multi = false) {

+

+if (strrpos($url, 'http://') !== 0 && strrpos($url, 'https://') !== 0) {

+$url = "{$this->host}{$url}.{$this->format}";

+}

+

+switch ($method) {

+case 'GET':

+$url = $url . '?' . http_build_query($parameters);

+return $this->http($url, 'GET');

+default:

+$headers = array();

+if (!$multi && (is_array($parameters) || is_object($parameters)) ) {

+$body = http_build_query($parameters);

+} else {

+$body = self::build_http_query_multi($parameters);

+$headers[] = "Content-Type: multipart/form-data; boundary=" . self::$boundary;

+}

+return $this->http($url, $method, $body, $headers);

+}

+}

+

+/**

+ * Make an HTTP request

+ *

+ * @return string API results

+ * @ignore

+ */

+function http($url, $method, $postfields = NULL, $headers = array()) {

+$this->http_info = array();

+$ci = curl_init();

+/* Curl settings */

+curl_setopt($ci, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_0);

+curl_setopt($ci, CURLOPT_USERAGENT, $this->useragent);

+curl_setopt($ci, CURLOPT_CONNECTTIMEOUT, $this->connecttimeout);

+curl_setopt($ci, CURLOPT_TIMEOUT, $this->timeout);

+curl_setopt($ci, CURLOPT_RETURNTRANSFER, TRUE);

+curl_setopt($ci, CURLOPT_ENCODING, "");

+curl_setopt($ci, CURLOPT_SSL_VERIFYPEER, $this->ssl_verifypeer);

+curl_setopt($ci, CURLOPT_SSL_VERIFYHOST, 1);

+curl_setopt($ci, CURLOPT_HEADERFUNCTION, array($this, 'getHeader'));

+curl_setopt($ci, CURLOPT_HEADER, FALSE);

+

+switch ($method) {

+case 'POST':

+curl_setopt($ci, CURLOPT_POST, TRUE);

+if (!empty($postfields)) {

+curl_setopt($ci, CURLOPT_POSTFIELDS, $postfields);

+$this->postdata = $postfields;

+}

+break;

+case 'DELETE':

+curl_setopt($ci, CURLOPT_CUSTOMREQUEST, 'DELETE');

+if (!empty($postfields)) {

+$url = "{$url}?{$postfields}";

+}

+}

+

+if ( isset($this->access_token) && $this->access_token )

+$headers[] = "Authorization: OAuth2 ".$this->access_token;

+

+if ( !empty($this->remote_ip) ) {

+if ( defined('SAE_ACCESSKEY') ) {

+$headers[] = "SaeRemoteIP: " . $this->remote_ip;

+} else {

+$headers[] = "API-RemoteIP: " . $this->remote_ip;

+}

+} else {

+if ( !defined('SAE_ACCESSKEY') ) {

+$headers[] = "API-RemoteIP: " . $_SERVER['REMOTE_ADDR'];

+}

+}

+curl_setopt($ci, CURLOPT_URL, $url );

+curl_setopt($ci, CURLOPT_HTTPHEADER, $headers );

+curl_setopt($ci, CURLINFO_HEADER_OUT, TRUE );

+

+$response = curl_exec($ci);

+$this->http_code = curl_getinfo($ci, CURLINFO_HTTP_CODE);

+$this->http_info = array_merge($this->http_info, curl_getinfo($ci));

+$this->url = $url;

+

+if ($this->debug) {

+echo "=====post data======\r\n";

+var_dump($postfields);

+

+echo "=====headers======\r\n";

+print_r($headers);

+

+echo '=====request info====='."\r\n";

+print_r( curl_getinfo($ci) );

+

+echo '=====response====='."\r\n";

+print_r( $response );

+}

+curl_close ($ci);

+return $response;

+}

+

+/**

+ * Get the header info to store.

+ *

+ * @return int

+ * @ignore

+ */

+function getHeader($ch, $header) {

+$i = strpos($header, ':');

+if (!empty($i)) {

+$key = str_replace('-', '_', strtolower(substr($header, 0, $i)));

+$value = trim(substr($header, $i + 2));

+$this->http_header[$key] = $value;

+}

+return strlen($header);

+}

+

+/**

+ * @ignore

+ */

+public static function build_http_query_multi($params) {

+if (!$params) return '';

+

+uksort($params, 'strcmp');

+

+$pairs = array();

+

+self::$boundary = $boundary = uniqid('------------------');

+$MPboundary = '--'.$boundary;

+$endMPboundary = $MPboundary. '--';

+$multipartbody = '';

+

+foreach ($params as $parameter => $value) {

+

+if( in_array($parameter, array('pic', 'image')) && $value{0} == '@' ) {

+$url = ltrim( $value, '@' );

+$content = file_get_contents( $url );

+$array = explode( '?', basename( $url ) );

+$filename = $array[0];

+

+$multipartbody .= $MPboundary . "\r\n";

+$multipartbody .= 'Content-Disposition: form-data; name="' . $parameter . '"; filename="' . $filename . '"'. "\r\n";

+$multipartbody .= "Content-Type: image/unknown\r\n\r\n";

+$multipartbody .= $content. "\r\n";

+} else {

+$multipartbody .= $MPboundary . "\r\n";

+$multipartbody .= 'content-disposition: form-data; name="' . $parameter . "\"\r\n\r\n";

+$multipartbody .= $value."\r\n";

+}

+

+}

+

+$multipartbody .= $endMPboundary;

+return $multipartbody;

+}

+}

+

+

+/**

+ * 新浪微博操作类V2

+ *

+ * 使用前需要先手工调用saetv2.ex.class.php

+ *

+ * @package sae

+ * @author Easy Chen, Elmer Zhang,Lazypeople

+ * @version 1.0

+ */

+class SaeTClientV2

+{

+/**

+ * 构造函数

+ *

+ * @access public

+ * @param mixed $akey 微博开放平台应用APP KEY

+ * @param mixed $skey 微博开放平台应用APP SECRET

+ * @param mixed $access_token OAuth认证返回的token

+ * @param mixed $refresh_token OAuth认证返回的token secret

+ * @return void

+ */

+function __construct( $akey, $skey, $access_token, $refresh_token = NULL)

+{

+$this->oauth = new SaeTOAuthV2( $akey, $skey, $access_token, $refresh_token );

+}

+

+/**

+ * 开启调试信息

+ *

+ * 开启调试信息后，SDK会将每次请求微博API所发送的POST Data、Headers以及请求信息、返回内容输出出来。

+ *

+ * @access public

+ * @param bool $enable 是否开启调试信息

+ * @return void

+ */

+function set_debug( $enable )

+{

+$this->oauth->debug = $enable;

+}

+

+/**

+ * 设置用户IP

+ *

+ * SDK默认将会通过$_SERVER['REMOTE_ADDR']获取用户IP，在请求微博API时将用户IP附加到Request Header中。但某些情况下$_SERVER['REMOTE_ADDR']取到的IP并非用户IP，而是一个固定的IP(例如使用SAE的Cron或TaskQueue服务时)，此时就有可能会造成该固定IP达到微博API调用频率限额，导致API调用失败。此时可使用本方法设置用户IP，以避免此问题。

+ *

+ * @access public

+ * @param string $ip 用户IP

+ * @return bool IP为非法IP字符串时，返回false，否则返回true

+ */

+function set_remote_ip( $ip )

+{

+if ( ip2long($ip) !== false ) {

+$this->oauth->remote_ip = $ip;

+return true;

+} else {

+return false;

+}

+}

+

+/**

+ * 获取最新的公共微博消息

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/statuses/public_timeline statuses/public_timeline}

+ *

+ * @access public

+ * @param int $count 单页返回的记录条数，默认为50。

+ * @param int $page 返回结果的页码，默认为1。

+ * @param int $base_app 是否只获取当前应用的数据。0为否(所有数据)，1为是(仅当前应用)，默认为0。

+ * @return array

+ */

+function public_timeline( $page = 1, $count = 50, $base_app = 0 )

+{

+$params = array();

+$params['count'] = intval($count);

+$params['page'] = intval($page);

+$params['base_app'] = intval($base_app);

+return $this->oauth->get('statuses/public_timeline', $params);//可能是接口的bug不能补全

+}

+

+/**

+ * 获取当前登录用户及其所关注用户的最新微博消息。

+ *

+ * 获取当前登录用户及其所关注用户的最新微博消息。和用户登录 http://weibo.com 后在“我的首页”中看到的内容相同。同friends_timeline()

+ *

对应API：{@link http://open.weibo.com/wiki/2/statuses/home_timeline statuses/home_timeline}

+ *

+ * @access public

+ * @param int $page 指定返回结果的页码。根据当前登录用户所关注的用户数及这些被关注用户发表的微博数，翻页功能最多能查看的总记录数会有所不同，通常最多能查看1000条左右。默认值1。可选。

+ * @param int $count 每次返回的记录数。缺省值50，最大值200。可选。

+ * @param int $since_id 若指定此参数，则只返回ID比since_id大的微博消息(即比since_id发表时间晚的微博消息)。可选。

+ * @param int $max_id 若指定此参数，则返回ID小于或等于max_id的微博消息。可选。

+ * @param int $base_app 是否只获取当前应用的数据。0为否(所有数据)，1为是(仅当前应用)，默认为0。

+ * @param int $feature 过滤类型ID，0：全部、1：原创、2：图片、3：视频、4：音乐，默认为0。

+ * @return array

+ */

+function home_timeline( $page = 1, $count = 50, $since_id = 0, $max_id = 0, $base_app = 0, $feature = 0 )

+{

+$params = array();

+if ($since_id) {

+$this->id_format($since_id);

+$params['since_id'] = $since_id;

+}

+if ($max_id) {

+$this->id_format($max_id);

+$params['max_id'] = $max_id;

+}

+$params['count'] = intval($count);

+$params['page'] = intval($page);

+$params['base_app'] = intval($base_app);

+$params['feature'] = intval($feature);

+

+return $this->oauth->get('statuses/home_timeline', $params);

+}

+

+/**

+ * 获取当前登录用户及其所关注用户的最新微博消息。

+ *

+ * 获取当前登录用户及其所关注用户的最新微博消息。和用户登录 http://weibo.com 后在“我的首页”中看到的内容相同。同home_timeline()

+ *

对应API：{@link http://open.weibo.com/wiki/2/statuses/friends_timeline statuses/friends_timeline}

+ *

+ * @access public

+ * @param int $page 指定返回结果的页码。根据当前登录用户所关注的用户数及这些被关注用户发表的微博数，翻页功能最多能查看的总记录数会有所不同，通常最多能查看1000条左右。默认值1。可选。

+ * @param int $count 每次返回的记录数。缺省值50，最大值200。可选。

+ * @param int $since_id 若指定此参数，则只返回ID比since_id大的微博消息(即比since_id发表时间晚的微博消息)。可选。

+ * @param int $max_id 若指定此参数，则返回ID小于或等于max_id的微博消息。可选。

+ * @param int $base_app 是否基于当前应用来获取数据。1为限制本应用微博，0为不做限制。默认为0。可选。

+ * @param int $feature 微博类型，0全部，1原创，2图片，3视频，4音乐. 返回指定类型的微博信息内容。转为为0。可选。

+ * @return array

+ */

+function friends_timeline( $page = 1, $count = 50, $since_id = 0, $max_id = 0, $base_app = 0, $feature = 0 )

+{

+return $this->home_timeline( $since_id, $max_id, $count, $page, $base_app, $feature);

+}

+

+/**

+ * 获取用户发布的微博信息列表

+ *

+ * 返回用户的发布的最近n条信息，和用户微博页面返回内容是一致的。此接口也可以请求其他用户的最新发表微博。

+ *

对应API：{@link http://open.weibo.com/wiki/2/statuses/user_timeline statuses/user_timeline}

+ *

+ * @access public

+ * @param int $page 页码

+ * @param int $count 每次返回的最大记录数，最多返回200条，默认50。

+ * @param mixed $uid 指定用户UID或微博昵称

+ * @param int $since_id 若指定此参数，则只返回ID比since_id大的微博消息(即比since_id发表时间晚的微博消息)。可选。

+ * @param int $max_id 若指定此参数，则返回ID小于或等于max_id的提到当前登录用户微博消息。可选。

+ * @param int $base_app 是否基于当前应用来获取数据。1为限制本应用微博，0为不做限制。默认为0。

+ * @param int $feature 过滤类型ID，0：全部、1：原创、2：图片、3：视频、4：音乐，默认为0。

+ * @param int $trim_user 返回值中user信息开关，0：返回完整的user信息、1：user字段仅返回uid，默认为0。

+ * @return array

+ */

+function user_timeline_by_id( $uid = NULL , $page = 1 , $count = 50 , $since_id = 0, $max_id = 0, $feature = 0, $trim_user = 0, $base_app = 0)

+{

+$params = array();

+$params['uid']=$uid;

+if ($since_id) {

+$this->id_format($since_id);

+$params['since_id'] = $since_id;

+}

+if ($max_id) {

+$this->id_format($max_id);

+$params['max_id'] = $max_id;

+}

+$params['base_app'] = intval($base_app);

+$params['feature'] = intval($feature);

+$params['count'] = intval($count);

+$params['page'] = intval($page);

+$params['trim_user'] = intval($trim_user);

+

+return $this->oauth->get( 'statuses/user_timeline', $params );

+}

+

+

+/**

+ * 获取用户发布的微博信息列表

+ *

+ * 返回用户的发布的最近n条信息，和用户微博页面返回内容是一致的。此接口也可以请求其他用户的最新发表微博。

+ *

对应API：{@link http://open.weibo.com/wiki/2/statuses/user_timeline statuses/user_timeline}

+ *

+ * @access public

+ * @param string $screen_name 微博昵称，主要是用来区分用户UID跟微博昵称，当二者一样而产生歧义的时候，建议使用该参数

+ * @param int $page 页码

+ * @param int $count 每次返回的最大记录数，最多返回200条，默认50。

+ * @param int $since_id 若指定此参数，则只返回ID比since_id大的微博消息(即比since_id发表时间晚的微博消息)。可选。

+ * @param int $max_id 若指定此参数，则返回ID小于或等于max_id的提到当前登录用户微博消息。可选。

+ * @param int $feature 过滤类型ID，0：全部、1：原创、2：图片、3：视频、4：音乐，默认为0。

+ * @param int $trim_user 返回值中user信息开关，0：返回完整的user信息、1：user字段仅返回uid，默认为0。

+ * @param int $base_app 是否基于当前应用来获取数据。1为限制本应用微博，0为不做限制。默认为0。

+ * @return array

+ */

+function user_timeline_by_name( $screen_name = NULL , $page = 1 , $count = 50 , $since_id = 0, $max_id = 0, $feature = 0, $trim_user = 0, $base_app = 0 )

+{

+$params = array();

+$params['screen_name'] = $screen_name;

+if ($since_id) {

+$this->id_format($since_id);

+$params['since_id'] = $since_id;

+}

+if ($max_id) {

+$this->id_format($max_id);

+$params['max_id'] = $max_id;

+}

+$params['base_app'] = intval($base_app);

+$params['feature'] = intval($feature);

+$params['count'] = intval($count);

+$params['page'] = intval($page);

+$params['trim_user'] = intval($trim_user);

+

+return $this->oauth->get( 'statuses/user_timeline', $params );

+}

+

+

+

+/**

+ * 批量获取指定的一批用户的timeline

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/statuses/timeline_batch statuses/timeline_batch}

+ *

+ * @param string $screen_name 需要查询的用户昵称，用半角逗号分隔，一次最多20个

+ * @param int $count 单页返回的记录条数，默认为50。

+ * @param int $page 返回结果的页码，默认为1。

+ * @param int $base_app 是否只获取当前应用的数据。0为否(所有数据)，1为是(仅当前应用)，默认为0。

+ * @param int $feature 过滤类型ID，0：全部、1：原创、2：图片、3：视频、4：音乐，默认为0。

+ * @return array

+ */

+function timeline_batch_by_name( $screen_name, $page = 1, $count = 50, $feature = 0, $base_app = 0)

+{

+$params = array();

+if (is_array($screen_name) && !empty($screen_name)) {

+$params['screen_name'] = join(',', $screen_name);

+} else {

+$params['screen_name'] = $screen_name;

+}

+$params['count'] = intval($count);

+$params['page'] = intval($page);

+$params['base_app'] = intval($base_app);

+$params['feature'] = intval($feature);

+return $this->oauth->get('statuses/timeline_batch', $params);

+}

+

+/**

+ * 批量获取指定的一批用户的timeline

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/statuses/timeline_batch statuses/timeline_batch}

+ *

+ * @param string $uids 需要查询的用户ID，用半角逗号分隔，一次最多20个。

+ * @param int $count 单页返回的记录条数，默认为50。

+ * @param int $page 返回结果的页码，默认为1。

+ * @param int $base_app 是否只获取当前应用的数据。0为否(所有数据)，1为是(仅当前应用)，默认为0。

+ * @param int $feature 过滤类型ID，0：全部、1：原创、2：图片、3：视频、4：音乐，默认为0。

+ * @return array

+ */

+function timeline_batch_by_id( $uids, $page = 1, $count = 50, $feature = 0, $base_app = 0)

+{

+$params = array();

+if (is_array($uids) && !empty($uids)) {

+foreach($uids as $k => $v) {

+$this->id_format($uids[$k]);

+}

+$params['uids'] = join(',', $uids);

+} else {

+$params['uids'] = $uids;

+}

+$params['count'] = intval($count);

+$params['page'] = intval($page);

+$params['base_app'] = intval($base_app);

+$params['feature'] = intval($feature);

+return $this->oauth->get('statuses/timeline_batch', $params);

+}

+

+

+/**

+ * 返回一条原创微博消息的最新n条转发微博消息。本接口无法对非原创微博进行查询。

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/statuses/repost_timeline statuses/repost_timeline}

+ *

+ * @access public

+ * @param int $sid 要获取转发微博列表的原创微博ID。

+ * @param int $page 返回结果的页码。

+ * @param int $count 单页返回的最大记录数，最多返回200条，默认50。可选。

+ * @param int $since_id 若指定此参数，则只返回ID比since_id大的记录(比since_id发表时间晚)。可选。

+ * @param int $max_id 若指定此参数，则返回ID小于或等于max_id的记录。可选。

+ * @param int $filter_by_author 作者筛选类型，0：全部、1：我关注的人、2：陌生人，默认为0。

+ * @return array

+ */

+function repost_timeline( $sid, $page = 1, $count = 50, $since_id = 0, $max_id = 0, $filter_by_author = 0 )

+{

+$this->id_format($sid);

+

+$params = array();

+$params['id'] = $sid;

+if ($since_id) {

+$this->id_format($since_id);

+$params['since_id'] = $since_id;

+}

+if ($max_id) {

+$this->id_format($max_id);

+$params['max_id'] = $max_id;

+}

+$params['filter_by_author'] = intval($filter_by_author);

+

+return $this->request_with_pager( 'statuses/repost_timeline', $page, $count, $params );

+}

+

+/**

+ * 获取当前用户最新转发的n条微博消息

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/statuses/repost_by_me statuses/repost_by_me}

+ *

+ * @access public

+ * @param int $page 返回结果的页码。

+ * @param int $count 每次返回的最大记录数，最多返回200条，默认50。可选。

+ * @param int $since_id 若指定此参数，则只返回ID比since_id大的记录(比since_id发表时间晚)。可选。

+ * @param int $max_id 若指定此参数，则返回ID小于或等于max_id的记录。可选。

+ * @return array

+ */

+function repost_by_me( $page = 1, $count = 50, $since_id = 0, $max_id = 0 )

+{

+$params = array();

+if ($since_id) {

+$this->id_format($since_id);

+$params['since_id'] = $since_id;

+}

+if ($max_id) {

+$this->id_format($max_id);

+$params['max_id'] = $max_id;

+}

+

+return $this->request_with_pager('statuses/repost_by_me', $page, $count, $params );

+}

+

+/**

+ * 获取@当前用户的微博列表

+ *

+ * 返回最新n条提到登录用户的微博消息(即包含@username的微博消息)

+ *

对应API：{@link http://open.weibo.com/wiki/2/statuses/mentions statuses/mentions}

+ *

+ * @access public

+ * @param int $page 返回结果的页序号。

+ * @param int $count 每次返回的最大记录数(即页面大小)，不大于200，默认为50。

+ * @param int $since_id 若指定此参数，则只返回ID比since_id大的微博消息(即比since_id发表时间晚的微博消息)。可选。

+ * @param int $max_id 若指定此参数，则返回ID小于或等于max_id的提到当前登录用户微博消息。可选。

+ * @param int $filter_by_author 作者筛选类型，0：全部、1：我关注的人、2：陌生人，默认为0。

+ * @param int $filter_by_source 来源筛选类型，0：全部、1：来自微博、2：来自微群，默认为0。

+ * @param int $filter_by_type 原创筛选类型，0：全部微博、1：原创的微博，默认为0。

+ * @return array

+ */

+function mentions( $page = 1, $count = 50, $since_id = 0, $max_id = 0, $filter_by_author = 0, $filter_by_source = 0, $filter_by_type = 0 )

+{

+$params = array();

+if ($since_id) {

+$this->id_format($since_id);

+$params['since_id'] = $since_id;

+}

+if ($max_id) {

+$this->id_format($max_id);

+$params['max_id'] = $max_id;

+}

+$params['filter_by_author'] = $filter_by_author;

+$params['filter_by_source'] = $filter_by_source;

+$params['filter_by_type'] = $filter_by_type;

+

+return $this->request_with_pager( 'statuses/mentions', $page, $count, $params );

+}

+

+

+/**

+ * 根据ID获取单条微博信息内容

+ *

+ * 获取单条ID的微博信息，作者信息将同时返回。

+ *

对应API：{@link http://open.weibo.com/wiki/2/statuses/show statuses/show}

+ *

+ * @access public

+ * @param int $id 要获取已发表的微博ID, 如ID不存在返回空

+ * @return array

+ */

+function show_status( $id )

+{

+$this->id_format($id);

+$params = array();

+$params['id'] = $id;

+return $this->oauth->get('statuses/show', $params);

+}

+

+/**

+ * 根据微博id号获取微博的信息

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/statuses/show_batch statuses/show_batch}

+ *

+ * @param string $ids 需要查询的微博ID，用半角逗号分隔，最多不超过50个。

+ * @return array

+ */

+ function show_batch( $ids )

+{

+$params=array();

+if (is_array($ids) && !empty($ids)) {

+foreach($ids as $k => $v) {

+$this->id_format($ids[$k]);

+}

+$params['ids'] = join(',', $ids);

+} else {

+$params['ids'] = $ids;

+}

+return $this->oauth->get('statuses/show_batch', $params);

+}

+

+/**

+ * 通过微博(评论、私信)ID获取其MID

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/statuses/querymid statuses/querymid}

+ *

+ * @param int|string $id 需要查询的微博(评论、私信)ID，批量模式下，用半角逗号分隔，最多不超过20个。

+ * @param int $type 获取类型，1：微博、2：评论、3：私信，默认为1。

+ * @param int $is_batch 是否使用批量模式，0：否、1：是，默认为0。

+ * @return array

+ */

+function querymid( $id, $type = 1, $is_batch = 0 )

+{

+$params = array();

+$params['id'] = $id;

+$params['type'] = intval($type);

+$params['is_batch'] = intval($is_batch);

+return $this->oauth->get( 'statuses/querymid', $params);

+}

+

+/**

+ * 通过微博(评论、私信)MID获取其ID

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/statuses/queryid statuses/queryid}

+ *

+ * @param int|string $mid 需要查询的微博(评论、私信)MID，批量模式下，用半角逗号分隔，最多不超过20个。

+ * @param int $type 获取类型，1：微博、2：评论、3：私信，默认为1。

+ * @param int $is_batch 是否使用批量模式，0：否、1：是，默认为0。

+ * @param int $inbox 仅对私信有效，当MID类型为私信时用此参数，0：发件箱、1：收件箱，默认为0 。

+ * @param int $isBase62 MID是否是base62编码，0：否、1：是，默认为0。

+ * @return array

+ */

+function queryid( $mid, $type = 1, $is_batch = 0, $inbox = 0, $isBase62 = 0)

+{

+$params = array();

+$params['mid'] = $mid;

+$params['type'] = intval($type);

+$params['is_batch'] = intval($is_batch);

+$params['inbox'] = intval($inbox);

+$params['isBase62'] = intval($isBase62);

+return $this->oauth->get('statuses/queryid', $params);

+}

+

+/**

+ * 按天返回热门微博转发榜的微博列表

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/statuses/hot/repost_daily statuses/hot/repost_daily}

+ *

+ * @param int $count 返回的记录条数，最大不超过50，默认为20。

+ * @param int $base_app 是否只获取当前应用的数据。0为否(所有数据)，1为是(仅当前应用)，默认为0。

+ * @return array

+ */

+function repost_daily( $count = 20, $base_app = 0)

+{

+$params = array();

+$params['count'] = intval($count);

+$params['base_app'] = intval($base_app);

+return $this->oauth->get('statuses/hot/repost_daily', $params);

+}

+

+/**

+ * 按周返回热门微博转发榜的微博列表

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/statuses/hot/repost_weekly statuses/hot/repost_weekly}

+ *

+ * @param int $count 返回的记录条数，最大不超过50，默认为20。

+ * @param int $base_app 是否只获取当前应用的数据。0为否(所有数据)，1为是(仅当前应用)，默认为0。

+ * @return array

+ */

+function repost_weekly( $count = 20, $base_app = 0)

+{

+$params = array();

+$params['count'] = intval($count);

+$params['base_app'] = intval($base_app);

+return $this->oauth->get( 'statuses/hot/repost_weekly', $params);

+}

+

+/**

+ * 按天返回热门微博评论榜的微博列表

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/statuses/hot/comments_daily statuses/hot/comments_daily}

+ *

+ * @param int $count 返回的记录条数，最大不超过50，默认为20。

+ * @param int $base_app 是否只获取当前应用的数据。0为否(所有数据)，1为是(仅当前应用)，默认为0。

+ * @return array

+ */

+function comments_daily( $count = 20, $base_app = 0)

+{

+$params = array();

+$params['count'] = intval($count);

+$params['base_app'] = intval($base_app);

+return $this->oauth->get( 'statuses/hot/comments_daily', $params);

+}

+

+/**

+ * 按周返回热门微博评论榜的微博列表

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/statuses/hot/comments_weekly statuses/hot/comments_weekly}

+ *

+ * @param int $count 返回的记录条数，最大不超过50，默认为20。

+ * @param int $base_app 是否只获取当前应用的数据。0为否(所有数据)，1为是(仅当前应用)，默认为0。

+ * @return array

+ */

+function comments_weekly( $count = 20, $base_app = 0)

+{

+$params = array();

+$params['count'] = intval($count);

+$params['base_app'] = intval($base_app);

+return $this->oauth->get( 'statuses/hot/comments_weekly', $params);

+}

+

+

+/**

+ * 转发一条微博信息。

+ *

+ * 可加评论。为防止重复，发布的信息与最新信息一样话，将会被忽略。

+ *

对应API：{@link http://open.weibo.com/wiki/2/statuses/repost statuses/repost}

+ *

+ * @access public

+ * @param int $sid 转发的微博ID

+ * @param string $text 添加的评论信息。可选。

+ * @param int $is_comment 是否在转发的同时发表评论，0：否、1：评论给当前微博、2：评论给原微博、3：都评论，默认为0。

+ * @return array

+ */

+function repost( $sid, $text = NULL, $is_comment = 0 )

+{

+$this->id_format($sid);

+

+$params = array();

+$params['id'] = $sid;

+$params['is_comment'] = $is_comment;

+if( $text ) $params['status'] = $text;

+

+return $this->oauth->post( 'statuses/repost', $params );

+}

+

+/**

+ * 删除一条微博

+ *

+ * 根据ID删除微博消息。注意：只能删除自己发布的信息。

+ *

对应API：{@link http://open.weibo.com/wiki/2/statuses/destroy statuses/destroy}

+ *

+ * @access public

+ * @param int $id 要删除的微博ID

+ * @return array

+ */

+function delete( $id )

+{

+return $this->destroy( $id );

+}

+

+/**

+ * 删除一条微博

+ *

+ * 删除微博。注意：只能删除自己发布的信息。

+ *

对应API：{@link http://open.weibo.com/wiki/2/statuses/destroy statuses/destroy}

+ *

+ * @access public

+ * @param int $id 要删除的微博ID

+ * @return array

+ */

+function destroy( $id )

+{

+$this->id_format($id);

+$params = array();

+$params['id'] = $id;

+return $this->oauth->post( 'statuses/destroy', $params );

+}

+

+

+/**

+ * 发表微博

+ *

+ * 发布一条微博信息。

+ *

注意：lat和long参数需配合使用，用于标记发表微博消息时所在的地理位置，只有用户设置中geo_enabled=true时候地理位置信息才有效。

+ *

注意：为防止重复提交，当用户发布的微博消息与上次成功发布的微博消息内容一样时，将返回400错误，给出错误提示：“40025:Error: repeated weibo text!“。

+ *

对应API：{@link http://open.weibo.com/wiki/2/statuses/update statuses/update}

+ *

+ * @access public

+ * @param string $status 要更新的微博信息。信息内容不超过140个汉字, 为空返回400错误。

+ * @param float $lat 纬度，发表当前微博所在的地理位置，有效范围 -90.0到+90.0, +表示北纬。可选。

+ * @param float $long 经度。有效范围-180.0到+180.0, +表示东经。可选。

+ * @param mixed $annotations 可选参数。元数据，主要是为了方便第三方应用记录一些适合于自己使用的信息。每条微博可以包含一个或者多个元数据。请以json字串的形式提交，字串长度不超过512个字符，或者数组方式，要求json_encode后字串长度不超过512个字符。具体内容可以自定。例如：'[{"type2":123}, {"a":"b", "c":"d"}]'或array(array("type2"=>123), array("a"=>"b", "c"=>"d"))。

+ * @return array

+ */

+function update( $status, $lat = NULL, $long = NULL, $annotations = NULL )

+{

+$params = array();

+$params['status'] = $status;

+if ($lat) {

+$params['lat'] = floatval($lat);

+}

+if ($long) {

+$params['long'] = floatval($long);

+}

+if (is_string($annotations)) {

+$params['annotations'] = $annotations;

+} elseif (is_array($annotations)) {

+$params['annotations'] = json_encode($annotations);

+}

+

+return $this->oauth->post( 'statuses/update', $params );

+}

+

+/**

+ * 发表图片微博

+ *

+ * 发表图片微博消息。目前上传图片大小限制为<5M。

+ *

注意：lat和long参数需配合使用，用于标记发表微博消息时所在的地理位置，只有用户设置中geo_enabled=true时候地理位置信息才有效。

+ *

对应API：{@link http://open.weibo.com/wiki/2/statuses/upload statuses/upload}

+ *

+ * @access public

+ * @param string $status 要更新的微博信息。信息内容不超过140个汉字, 为空返回400错误。

+ * @param string $pic_path 要发布的图片路径, 支持url。[只支持png/jpg/gif三种格式, 增加格式请修改get_image_mime方法]

+ * @param float $lat 纬度，发表当前微博所在的地理位置，有效范围 -90.0到+90.0, +表示北纬。可选。

+ * @param float $long 可选参数，经度。有效范围-180.0到+180.0, +表示东经。可选。

+ * @return array

+ */

+function upload( $status, $pic_path, $lat = NULL, $long = NULL )

+{

+$params = array();

+$params['status'] = $status;

+$params['pic'] = '@'.$pic_path;

+if ($lat) {

+$params['lat'] = floatval($lat);

+}

+if ($long) {

+$params['long'] = floatval($long);

+}

+

+return $this->oauth->post( 'statuses/upload', $params, true );

+}

+

+

+/**

+ * 指定一个图片URL地址抓取后上传并同时发布一条新微博

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/statuses/upload_url_text statuses/upload_url_text}

+ *

+ * @param string $status 要发布的微博文本内容，内容不超过140个汉字。

+ * @param string $url 图片的URL地址，必须以http开头。

+ * @return array

+ */

+function upload_url_text( $status, $url )

+{

+$params = array();

+$params['status'] = $status;

+$params['url'] = $url;

+return $this->oauth->post( 'statuses/upload', $params, true );

+}

+

+

+/**

+ * 获取表情列表

+ *

+ * 返回新浪微博官方所有表情、魔法表情的相关信息。包括短语、表情类型、表情分类，是否热门等。

+ *

对应API：{@link http://open.weibo.com/wiki/2/emotions emotions}

+ *

+ * @access public

+ * @param string $type 表情类别。"face":普通表情，"ani"：魔法表情，"cartoon"：动漫表情。默认为"face"。可选。

+ * @param string $language 语言类别，"cnname"简体，"twname"繁体。默认为"cnname"。可选

+ * @return array

+ */

+function emotions( $type = "face", $language = "cnname" )

+{

+$params = array();

+$params['type'] = $type;

+$params['language'] = $language;

+return $this->oauth->get( 'emotions', $params );

+}

+

+

+/**

+ * 根据微博ID返回某条微博的评论列表

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/comments/show comments/show}

+ *

+ * @param int $sid 需要查询的微博ID。

+ * @param int $page 返回结果的页码，默认为1。

+ * @param int $count 单页返回的记录条数，默认为50。

+ * @param int $since_id 若指定此参数，则返回ID比since_id大的评论(即比since_id时间晚的评论)，默认为0。

+ * @param int $max_id 若指定此参数，则返回ID小于或等于max_id的评论，默认为0。

+ * @param int $filter_by_author 作者筛选类型，0：全部、1：我关注的人、2：陌生人，默认为0。

+ * @return array

+ */

+function get_comments_by_sid( $sid, $page = 1, $count = 50, $since_id = 0, $max_id = 0, $filter_by_author = 0 )

+{

+$params = array();

+$this->id_format($sid);

+$params['id'] = $sid;

+if ($since_id) {

+$this->id_format($since_id);

+$params['since_id'] = $since_id;

+}

+if ($max_id) {

+$this->id_format($max_id);

+$params['max_id'] = $max_id;

+}

+$params['count'] = $count;

+$params['page'] = $page;

+$params['filter_by_author'] = $filter_by_author;

+return $this->oauth->get( 'comments/show', $params );

+}

+

+

+/**

+ * 获取当前登录用户所发出的评论列表

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/comments/by_me comments/by_me}

+ *

+ * @param int $since_id 若指定此参数，则返回ID比since_id大的评论(即比since_id时间晚的评论)，默认为0。

+ * @param int $max_id 若指定此参数，则返回ID小于或等于max_id的评论，默认为0。

+ * @param int $count 单页返回的记录条数，默认为50。

+ * @param int $page 返回结果的页码，默认为1。

+ * @param int $filter_by_source 来源筛选类型，0：全部、1：来自微博的评论、2：来自微群的评论，默认为0。

+ * @return array

+ */

+function comments_by_me( $page = 1 , $count = 50, $since_id = 0, $max_id = 0, $filter_by_source = 0 )

+{

+$params = array();

+if ($since_id) {

+$this->id_format($since_id);

+$params['since_id'] = $since_id;

+}

+if ($max_id) {

+$this->id_format($max_id);

+$params['max_id'] = $max_id;

+}

+$params['count'] = $count;

+$params['page'] = $page;

+$params['filter_by_source'] = $filter_by_source;

+return $this->oauth->get( 'comments/by_me', $params );

+}

+

+/**

+ * 获取当前登录用户所接收到的评论列表

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/comments/to_me comments/to_me}

+ *

+ * @param int $since_id 若指定此参数，则返回ID比since_id大的评论(即比since_id时间晚的评论)，默认为0。

+ * @param int $max_id 若指定此参数，则返回ID小于或等于max_id的评论，默认为0。

+ * @param int $count 单页返回的记录条数，默认为50。

+ * @param int $page 返回结果的页码，默认为1。

+ * @param int $filter_by_author 作者筛选类型，0：全部、1：我关注的人、2：陌生人，默认为0。

+ * @param int $filter_by_source 来源筛选类型，0：全部、1：来自微博的评论、2：来自微群的评论，默认为0。

+ * @return array

+ */

+function comments_to_me( $page = 1 , $count = 50, $since_id = 0, $max_id = 0, $filter_by_author = 0, $filter_by_source = 0)

+{

+$params = array();

+if ($since_id) {

+$this->id_format($since_id);

+$params['since_id'] = $since_id;

+}

+if ($max_id) {

+$this->id_format($max_id);

+$params['max_id'] = $max_id;

+}

+$params['count'] = $count;

+$params['page'] = $page;

+$params['filter_by_author'] = $filter_by_author;

+$params['filter_by_source'] = $filter_by_source;

+return $this->oauth->get( 'comments/to_me', $params );

+}

+

+/**

+ * 最新评论(按时间)

+ *

+ * 返回最新n条发送及收到的评论。

+ *

对应API：{@link http://open.weibo.com/wiki/2/comments/timeline comments/timeline}

+ *

+ * @access public

+ * @param int $page 页码

+ * @param int $count 每次返回的最大记录数，最多返回200条，默认50。

+ * @param int $since_id 若指定此参数，则只返回ID比since_id大的评论(比since_id发表时间晚)。可选。

+ * @param int $max_id 若指定此参数，则返回ID小于或等于max_id的评论。可选。

+ * @return array

+ */

+function comments_timeline( $page = 1, $count = 50, $since_id = 0, $max_id = 0 )

+{

+$params = array();

+if ($since_id) {

+$this->id_format($since_id);

+$params['since_id'] = $since_id;

+}

+if ($max_id) {

+$this->id_format($max_id);

+$params['max_id'] = $max_id;

+}

+

+return $this->request_with_pager( 'comments/timeline', $page, $count, $params );

+}

+

+

+/**

+ * 获取最新的提到当前登录用户的评论，即@我的评论

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/comments/mentions comments/mentions}

+ *

+ * @param int $since_id 若指定此参数，则返回ID比since_id大的评论(即比since_id时间晚的评论)，默认为0。

+ * @param int $max_id 若指定此参数，则返回ID小于或等于max_id的评论，默认为0。

+ * @param int $count 单页返回的记录条数，默认为50。

+ * @param int $page 返回结果的页码，默认为1。

+ * @param int $filter_by_author 作者筛选类型，0：全部、1：我关注的人、2：陌生人，默认为0。

+ * @param int $filter_by_source 来源筛选类型，0：全部、1：来自微博的评论、2：来自微群的评论，默认为0。

+ * @return array

+ */

+function comments_mentions( $page = 1, $count = 50, $since_id = 0, $max_id = 0, $filter_by_author = 0, $filter_by_source = 0)

+{

+$params = array();

+$params['since_id'] = $since_id;

+$params['max_id'] = $max_id;

+$params['count'] = $count;

+$params['page'] = $page;

+$params['filter_by_author'] = $filter_by_author;

+$params['filter_by_source'] = $filter_by_source;

+return $this->oauth->get( 'comments/mentions', $params );

+}

+

+

+/**

+ * 根据评论ID批量返回评论信息

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/comments/show_batch comments/show_batch}

+ *

+ * @param string $cids 需要查询的批量评论ID，用半角逗号分隔，最大50

+ * @return array

+ */

+function comments_show_batch( $cids )

+{

+$params = array();

+if (is_array( $cids) && !empty( $cids)) {

+foreach($cids as $k => $v) {

+$this->id_format($cids[$k]);

+}

+$params['cids'] = join(',', $cids);

+} else {

+$params['cids'] = $cids;

+}

+return $this->oauth->get( 'comments/show_batch', $params );

+}

+

+

+/**

+ * 对一条微博进行评论

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/comments/create comments/create}

+ *

+ * @param string $comment 评论内容，内容不超过140个汉字。

+ * @param int $id 需要评论的微博ID。

+ * @param int $comment_ori 当评论转发微博时，是否评论给原微博，0：否、1：是，默认为0。

+ * @return array

+ */

+function send_comment( $id , $comment , $comment_ori = 0)

+{

+$params = array();

+$params['comment'] = $comment;

+$this->id_format($id);

+$params['id'] = $id;

+$params['comment_ori'] = $comment_ori;

+return $this->oauth->post( 'comments/create', $params );

+}

+

+/**

+ * 删除当前用户的微博评论信息。

+ *

+ * 注意：只能删除自己发布的评论，发部微博的用户不可以删除其他人的评论。

+ *

对应API：{@link http://open.weibo.com/wiki/2/statuses/comment_destroy statuses/comment_destroy}

+ *

+ * @access public

+ * @param int $cid 要删除的评论id

+ * @return array

+ */

+function comment_destroy( $cid )

+{

+$params = array();

+$params['cid'] = $cid;

+return $this->oauth->post( 'comments/destroy', $params);

+}

+

+

+/**

+ * 根据评论ID批量删除评论

+ *

+ * 注意：只能删除自己发布的评论，发部微博的用户不可以删除其他人的评论。

+ *

对应API：{@link http://open.weibo.com/wiki/2/comments/destroy_batch comments/destroy_batch}

+ *

+ * @access public

+ * @param string $ids 需要删除的评论ID，用半角逗号隔开，最多20个。

+ * @return array

+ */

+function comment_destroy_batch( $ids )

+{

+$params = array();

+if (is_array($ids) && !empty($ids)) {

+foreach($ids as $k => $v) {

+$this->id_format($ids[$k]);

+}

+$params['cids'] = join(',', $ids);

+} else {

+$params['cids'] = $ids;

+}

+return $this->oauth->post( 'comments/destroy_batch', $params);

+}

+

+

+/**

+ * 回复一条评论

+ *

+ * 为防止重复，发布的信息与最后一条评论/回复信息一样话，将会被忽略。

+ *

对应API：{@link http://open.weibo.com/wiki/2/comments/reply comments/reply}

+ *

+ * @access public

+ * @param int $sid 微博id

+ * @param string $text 评论内容。

+ * @param int $cid 评论id

+ * @param int $without_mention 1：回复中不自动加入“回复@用户名”，0：回复中自动加入“回复@用户名”.默认为0.

+ * @param int $comment_ori 当评论转发微博时，是否评论给原微博，0：否、1：是，默认为0。

+ * @return array

+ */

+function reply( $sid, $text, $cid, $without_mention = 0, $comment_ori = 0 )

+{

+$this->id_format( $sid );

+$this->id_format( $cid );

+$params = array();

+$params['id'] = $sid;

+$params['comment'] = $text;

+$params['cid'] = $cid;

+$params['without_mention'] = $without_mention;

+$params['comment_ori'] = $comment_ori;

+

+return $this->oauth->post( 'comments/reply', $params );

+

+}

+

+/**

+ * 根据用户UID或昵称获取用户资料

+ *

+ * 按用户UID或昵称返回用户资料，同时也将返回用户的最新发布的微博。

+ *

对应API：{@link http://open.weibo.com/wiki/2/users/show users/show}

+ *

+ * @access public

+ * @param int $uid 用户UID。

+ * @return array

+ */

+function show_user_by_id( $uid )

+{

+$params=array();

+if ( $uid !== NULL ) {

+$this->id_format($uid);

+$params['uid'] = $uid;

+}

+

+return $this->oauth->get('users/show', $params );

+}

+

+/**

+ * 根据用户UID或昵称获取用户资料

+ *

+ * 按用户UID或昵称返回用户资料，同时也将返回用户的最新发布的微博。

+ *

对应API：{@link http://open.weibo.com/wiki/2/users/show users/show}

+ *

+ * @access public

+ * @param string $screen_name 用户UID。

+ * @return array

+ */

+function show_user_by_name( $screen_name )

+{

+$params = array();

+$params['screen_name'] = $screen_name;

+

+return $this->oauth->get( 'users/show', $params );

+}

+

+/**

+ * 通过个性化域名获取用户资料以及用户最新的一条微博

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/users/domain_show users/domain_show}

+ *

+ * @access public

+ * @param mixed $domain 用户个性域名。例如：lazypeople，而不是http://weibo.com/lazypeople

+ * @return array

+ */

+function domain_show( $domain )

+{

+$params = array();

+$params['domain'] = $domain;

+return $this->oauth->get( 'users/domain_show', $params );

+}

+

+ /**

+ * 批量获取用户信息按uids

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/users/show_batch users/show_batch}

+ *

+ * @param string $uids 需要查询的用户ID，用半角逗号分隔，一次最多20个。

+ * @return array

+ */

+function users_show_batch_by_id( $uids )

+{

+$params = array();

+if (is_array( $uids ) && !empty( $uids )) {

+foreach( $uids as $k => $v ) {

+$this->id_format( $uids[$k] );

+}

+$params['uids'] = join(',', $uids);

+} else {

+$params['uids'] = $uids;

+}

+return $this->oauth->get( 'users/show_batch', $params );

+}

+

+/**

+ * 批量获取用户信息按screen_name

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/users/show_batch users/show_batch}

+ *

+ * @param string $screen_name 需要查询的用户昵称，用半角逗号分隔，一次最多20个。

+ * @return array

+ */

+function users_show_batch_by_name( $screen_name )

+{

+$params = array();

+if (is_array( $screen_name ) && !empty( $screen_name )) {

+$params['screen_name'] = join(',', $screen_name);

+} else {

+$params['screen_name'] = $screen_name;

+}

+return $this->oauth->get( 'users/show_batch', $params );

+}

+

+

+/**

+ * 获取用户的关注列表

+ *

+ * 如果没有提供cursor参数，将只返回最前面的5000个关注id

+ *

对应API：{@link http://open.weibo.com/wiki/2/friendships/friends friendships/friends}

+ *

+ * @access public

+ * @param int $cursor 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。

+ * @param int $count 单页返回的记录条数，默认为50，最大不超过200。

+ * @param int $uid 要获取的用户的ID。

+ * @return array

+ */

+function friends_by_id( $uid, $cursor = 0, $count = 50 )

+{

+$params = array();

+$params['cursor'] = $cursor;

+$params['count'] = $count;

+$params['uid'] = $uid;

+

+return $this->oauth->get( 'friendships/friends', $params );

+}

+

+

+/**

+ * 获取用户的关注列表

+ *

+ * 如果没有提供cursor参数，将只返回最前面的5000个关注id

+ *

对应API：{@link http://open.weibo.com/wiki/2/friendships/friends friendships/friends}

+ *

+ * @access public

+ * @param int $cursor 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。

+ * @param int $count 单页返回的记录条数，默认为50，最大不超过200。

+ * @param string $screen_name 要获取的用户的 screen_name

+ * @return array

+ */

+function friends_by_name( $screen_name, $cursor = 0, $count = 50 )

+{

+$params = array();

+$params['cursor'] = $cursor;

+$params['count'] = $count;

+$params['screen_name'] = $screen_name;

+return $this->oauth->get( 'friendships/friends', $params );

+}

+

+

+/**

+ * 获取两个用户之间的共同关注人列表

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/friendships/friends/in_common friendships/friends/in_common}

+ *

+ * @param int $uid 需要获取共同关注关系的用户UID

+ * @param int $suid 需要获取共同关注关系的用户UID，默认为当前登录用户。

+ * @param int $count 单页返回的记录条数，默认为50。

+ * @param int $page 返回结果的页码，默认为1。

+ * @return array

+ */

+function friends_in_common( $uid, $suid = NULL, $page = 1, $count = 50 )

+{

+$params = array();

+$params['uid'] = $uid;

+$params['suid'] = $suid;

+$params['count'] = $count;

+$params['page'] = $page;

+return $this->oauth->get( 'friendships/friends/in_common', $params );

+}

+

+/**

+ * 获取用户的双向关注列表，即互粉列表

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/friendships/friends/bilateral friendships/friends/bilateral}

+ *

+ * @param int $uid 需要获取双向关注列表的用户UID。

+ * @param int $count 单页返回的记录条数，默认为50。

+ * @param int $page 返回结果的页码，默认为1。

+ * @param int $sort 排序类型，0：按关注时间最近排序，默认为0。

+ * @return array

+ **/

+function bilateral( $uid, $page = 1, $count = 50, $sort = 0 )

+{

+$params = array();

+$params['uid'] = $uid;

+$params['count'] = $count;

+$params['page'] = $page;

+$params['sort'] = $sort;

+return $this->oauth->get( 'friendships/friends/bilateral', $params );

+}

+

+/**

+ * 获取用户的双向关注uid列表

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/friendships/friends/bilateral/ids friendships/friends/bilateral/ids}

+ *

+ * @param int $uid 需要获取双向关注列表的用户UID。

+ * @param int $count 单页返回的记录条数，默认为50。

+ * @param int $page 返回结果的页码，默认为1。

+ * @param int $sort 排序类型，0：按关注时间最近排序，默认为0。

+ * @return array

+ **/

+function bilateral_ids( $uid, $page = 1, $count = 50, $sort = 0)

+{

+$params = array();

+$params['uid'] = $uid;

+$params['count'] = $count;

+$params['page'] = $page;

+$params['sort'] = $sort;

+return $this->oauth->get( 'friendships/friends/bilateral/ids', $params );

+}

+

+/**

+ * 获取用户的关注列表uid

+ *

+ * 如果没有提供cursor参数，将只返回最前面的5000个关注id

+ *

对应API：{@link http://open.weibo.com/wiki/2/friendships/friends/ids friendships/friends/ids}

+ *

+ * @access public

+ * @param int $cursor 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。

+ * @param int $count 每次返回的最大记录数(即页面大小)，不大于5000, 默认返回500。

+ * @param int $uid 要获取的用户 UID，默认为当前用户

+ * @return array

+ */

+function friends_ids_by_id( $uid, $cursor = 0, $count = 500 )

+{

+$params = array();

+$this->id_format($uid);

+$params['uid'] = $uid;

+$params['cursor'] = $cursor;

+$params['count'] = $count;

+return $this->oauth->get( 'friendships/friends/ids', $params );

+}

+

+/**

+ * 获取用户的关注列表uid

+ *

+ * 如果没有提供cursor参数，将只返回最前面的5000个关注id

+ *

对应API：{@link http://open.weibo.com/wiki/2/friendships/friends/ids friendships/friends/ids}

+ *

+ * @access public

+ * @param int $cursor 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。

+ * @param int $count 每次返回的最大记录数(即页面大小)，不大于5000, 默认返回500。

+ * @param string $screen_name 要获取的用户的 screen_name，默认为当前用户

+ * @return array

+ */

+function friends_ids_by_name( $screen_name, $cursor = 0, $count = 500 )

+{

+$params = array();

+$params['cursor'] = $cursor;

+$params['count'] = $count;

+$params['screen_name'] = $screen_name;

+return $this->oauth->get( 'friendships/friends/ids', $params );

+}

+

+

+/**

+ * 批量获取当前登录用户的关注人的备注信息

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/friendships/friends/remark_batch friendships/friends/remark_batch}

+ *

+ * @param string $uids 需要获取备注的用户UID，用半角逗号分隔，最多不超过50个。

+ * @return array

+ **/

+function friends_remark_batch( $uids )

+{

+$params = array();

+if (is_array( $uids ) && !empty( $uids )) {

+foreach( $uids as $k => $v) {

+$this->id_format( $uids[$k] );

+}

+$params['uids'] = join(',', $uids);

+} else {

+$params['uids'] = $uids;

+}

+return $this->oauth->get( 'friendships/friends/remark_batch', $params );

+}

+

+/**

+ * 获取用户的粉丝列表

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/friendships/followers friendships/followers}

+ *

+ * @param int $uid 需要查询的用户UID

+ * @param int $count 单页返回的记录条数，默认为50，最大不超过200。

+ * @param int $cursor false 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。

+ * @return array

+ **/

+function followers_by_id( $uid , $cursor = 0 , $count = 50)

+{

+$params = array();

+$this->id_format($uid);

+$params['uid'] = $uid;

+$params['count'] = $count;

+$params['cursor'] = $cursor;

+return $this->oauth->get( 'friendships/followers', $params );

+}

+

+/**

+ * 获取用户的粉丝列表

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/friendships/followers friendships/followers}

+ *

+ * @param string $screen_name 需要查询的用户的昵称

+ * @param int $count 单页返回的记录条数，默认为50，最大不超过200。

+ * @param int $cursor false 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。

+ * @return array

+ **/

+function followers_by_name( $screen_name, $cursor = 0 , $count = 50 )

+{

+$params = array();

+$params['screen_name'] = $screen_name;

+$params['count'] = $count;

+$params['cursor'] = $cursor;

+return $this->oauth->get( 'friendships/followers', $params );

+}

+

+/**

+ * 获取用户的粉丝列表uid

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/friendships/followers friendships/followers}

+ *

+ * @param int $uid 需要查询的用户UID

+ * @param int $count 单页返回的记录条数，默认为50，最大不超过200。

+ * @param int $cursor 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。

+ * @return array

+ **/

+function followers_ids_by_id( $uid, $cursor = 0 , $count = 50 )

+{

+$params = array();

+$this->id_format($uid);

+$params['uid'] = $uid;

+$params['count'] = $count;

+$params['cursor'] = $cursor;

+return $this->oauth->get( 'friendships/followers/ids', $params );

+}

+

+/**

+ * 获取用户的粉丝列表uid

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/friendships/followers friendships/followers}

+ *

+ * @param string $screen_name 需要查询的用户screen_name

+ * @param int $count 单页返回的记录条数，默认为50，最大不超过200。

+ * @param int $cursor 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。

+ * @return array

+ **/

+function followers_ids_by_name( $screen_name, $cursor = 0 , $count = 50 )

+{

+$params = array();

+$params['screen_name'] = $screen_name;

+$params['count'] = $count;

+$params['cursor'] = $cursor;

+return $this->oauth->get( 'friendships/followers/ids', $params );

+}

+

+/**

+ * 获取优质粉丝

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/friendships/followers/active friendships/followers/active}

+ *

+ * @param int $uid 需要查询的用户UID。

+ * @param int $count 返回的记录条数，默认为20，最大不超过200。

+ * @return array

+ **/

+function followers_active( $uid, $count = 20)

+{

+$param = array();

+$this->id_format($uid);

+$param['uid'] = $uid;

+$param['count'] = $count;

+return $this->oauth->get( 'friendships/followers/active', $param);

+}

+

+

+/**

+ * 获取当前登录用户的关注人中又关注了指定用户的用户列表

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/friendships/friends_chain/followers friendships/friends_chain/followers}

+ *

+ * @param int $uid 指定的关注目标用户UID。

+ * @param int $count 单页返回的记录条数，默认为50。

+ * @param int $page 返回结果的页码，默认为1。

+ * @return array

+ **/

+function friends_chain_followers( $uid, $page = 1, $count = 50 )

+{

+$params = array();

+$this->id_format($uid);

+$params['uid'] = $uid;

+$params['count'] = $count;

+$params['page'] = $page;

+return $this->oauth->get( 'friendships/friends_chain/followers', $params );

+}

+

+/**

+ * 返回两个用户关系的详细情况

+ *

+ * 如果源用户或目的用户不存在，将返回http的400错误

+ *

对应API：{@link http://open.weibo.com/wiki/2/friendships/show friendships/show}

+ *

+ * @access public

+ * @param mixed $target_id 目标用户UID

+ * @param mixed $source_id 源用户UID，可选，默认为当前的用户

+ * @return array

+ */

+function is_followed_by_id( $target_id, $source_id = NULL )

+{

+$params = array();

+$this->id_format($target_id);

+$params['target_id'] = $target_id;

+

+if ( $source_id != NULL ) {

+$this->id_format($source_id);

+$params['source_id'] = $source_id;

+}

+

+return $this->oauth->get( 'friendships/show', $params );

+}

+

+/**

+ * 返回两个用户关系的详细情况

+ *

+ * 如果源用户或目的用户不存在，将返回http的400错误

+ *

对应API：{@link http://open.weibo.com/wiki/2/friendships/show friendships/show}

+ *

+ * @access public

+ * @param mixed $target_name 目标用户的微博昵称

+ * @param mixed $source_name 源用户的微博昵称，可选，默认为当前的用户

+ * @return array

+ */

+function is_followed_by_name( $target_name, $source_name = NULL )

+{

+$params = array();

+$params['target_screen_name'] = $target_name;

+

+if ( $source_name != NULL ) {

+$params['source_screen_name'] = $source_name;

+}

+

+return $this->oauth->get( 'friendships/show', $params );

+}

+

+/**

+ * 关注一个用户。

+ *

+ * 成功则返回关注人的资料，目前最多关注2000人，失败则返回一条字符串的说明。如果已经关注了此人，则返回http 403的状态。关注不存在的ID将返回400。

+ *

对应API：{@link http://open.weibo.com/wiki/2/friendships/create friendships/create}

+ *

+ * @access public

+ * @param int $uid 要关注的用户UID

+ * @return array

+ */

+function follow_by_id( $uid )

+{

+$params = array();

+$this->id_format($uid);

+$params['uid'] = $uid;

+return $this->oauth->post( 'friendships/create', $params );

+}

+

+/**

+ * 关注一个用户。

+ *

+ * 成功则返回关注人的资料，目前的最多关注2000人，失败则返回一条字符串的说明。如果已经关注了此人，则返回http 403的状态。关注不存在的ID将返回400。

+ *

对应API：{@link http://open.weibo.com/wiki/2/friendships/create friendships/create}

+ *

+ * @access public

+ * @param string $screen_name 要关注的用户昵称

+ * @return array

+ */

+function follow_by_name( $screen_name )

+{

+$params = array();

+$params['screen_name'] = $screen_name;

+return $this->oauth->post( 'friendships/create', $params);

+}

+

+

+/**

+ * 根据用户UID批量关注用户

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/friendships/create_batch friendships/create_batch}

+ *

+ * @param string $uids 要关注的用户UID，用半角逗号分隔，最多不超过20个。

+ * @return array

+ */

+function follow_create_batch( $uids )

+{

+$params = array();

+if (is_array($uids) && !empty($uids)) {

+foreach($uids as $k => $v) {

+$this->id_format($uids[$k]);

+}

+$params['uids'] = join(',', $uids);

+} else {

+$params['uids'] = $uids;

+}

+return $this->oauth->post( 'friendships/create_batch', $params);

+}

+

+/**

+ * 取消关注某用户

+ *

+ * 取消关注某用户。成功则返回被取消关注人的资料，失败则返回一条字符串的说明。

+ *

对应API：{@link http://open.weibo.com/wiki/2/friendships/destroy friendships/destroy}

+ *

+ * @access public

+ * @param int $uid 要取消关注的用户UID

+ * @return array

+ */

+function unfollow_by_id( $uid )

+{

+$params = array();

+$this->id_format($uid);

+$params['uid'] = $uid;

+return $this->oauth->post( 'friendships/destroy', $params);

+}

+

+/**

+ * 取消关注某用户

+ *

+ * 取消关注某用户。成功则返回被取消关注人的资料，失败则返回一条字符串的说明。

+ *

对应API：{@link http://open.weibo.com/wiki/2/friendships/destroy friendships/destroy}

+ *

+ * @access public

+ * @param string $screen_name 要取消关注的用户昵称

+ * @return array

+ */

+function unfollow_by_name( $screen_name )

+{

+$params = array();

+$params['screen_name'] = $screen_name;

+return $this->oauth->post( 'friendships/destroy', $params);

+}

+

+/**

+ * 更新当前登录用户所关注的某个好友的备注信息

+ *

+ * 只能修改当前登录用户所关注的用户的备注信息。否则将给出400错误。

+ *

对应API：{@link http://open.weibo.com/wiki/2/friendships/remark/update friendships/remark/update}

+ *

+ * @access public

+ * @param int $uid 需要修改备注信息的用户ID。

+ * @param string $remark 备注信息。

+ * @return array

+ */

+function update_remark( $uid, $remark )

+{

+$params = array();

+$this->id_format($uid);

+$params['uid'] = $uid;

+$params['remark'] = $remark;

+return $this->oauth->post( 'friendships/remark/update', $params);

+}

+

+/**

+ * 获取当前用户最新私信列表

+ *

+ * 返回用户的最新n条私信，并包含发送者和接受者的详细资料。

+ *

对应API：{@link http://open.weibo.com/wiki/2/direct_messages direct_messages}

+ *

+ * @access public

+ * @param int $page 页码

+ * @param int $count 每次返回的最大记录数，最多返回200条，默认50。

+ * @param int64 $since_id 返回ID比数值since_id大(比since_id时间晚的)的私信。可选。

+ * @param int64 $max_id 返回ID不大于max_id(时间不晚于max_id)的私信。可选。

+ * @return array

+ */

+function list_dm( $page = 1, $count = 50, $since_id = 0, $max_id = 0 )

+{

+$params = array();

+if ($since_id) {

+$this->id_format($since_id);

+$params['since_id'] = $since_id;

+}

+if ($max_id) {

+$this->id_format($max_id);

+$params['max_id'] = $max_id;

+}

+

+return $this->request_with_pager( 'direct_messages', $page, $count, $params );

+}

+

+/**

+ * 获取当前用户发送的最新私信列表

+ *

+ * 返回登录用户已发送最新50条私信。包括发送者和接受者的详细资料。

+ *

对应API：{@link http://open.weibo.com/wiki/2/direct_messages/sent direct_messages/sent}

+ *

+ * @access public

+ * @param int $page 页码

+ * @param int $count 每次返回的最大记录数，最多返回200条，默认50。

+ * @param int64 $since_id 返回ID比数值since_id大(比since_id时间晚的)的私信。可选。

+ * @param int64 $max_id 返回ID不大于max_id(时间不晚于max_id)的私信。可选。

+ * @return array

+ */

+function list_dm_sent( $page = 1, $count = 50, $since_id = 0, $max_id = 0 )

+{

+$params = array();

+if ($since_id) {

+$this->id_format($since_id);

+$params['since_id'] = $since_id;

+}

+if ($max_id) {

+$this->id_format($max_id);

+$params['max_id'] = $max_id;

+}

+

+return $this->request_with_pager( 'direct_messages/sent', $page, $count, $params );

+}

+

+

+/**

+ * 获取与当前登录用户有私信往来的用户列表，与该用户往来的最新私信

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/direct_messages/user_list direct_messages/user_list}

+ *

+ * @param int $count 单页返回的记录条数，默认为20。

+ * @param int $cursor 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。

+ * @return array

+ */

+function dm_user_list( $count = 20, $cursor = 0)

+{

+$params = array();

+$params['count'] = $count;

+$params['cursor'] = $cursor;

+return $this->oauth->get( 'direct_messages/user_list', $params );

+}

+

+/**

+ * 获取与指定用户的往来私信列表

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/direct_messages/conversation direct_messages/conversation}

+ *

+ * @param int $uid 需要查询的用户的UID。

+ * @param int $since_id 若指定此参数，则返回ID比since_id大的私信(即比since_id时间晚的私信)，默认为0。

+ * @param int $max_id 若指定此参数，则返回ID小于或等于max_id的私信，默认为0。

+ * @param int $count 单页返回的记录条数，默认为50。

+ * @param int $page 返回结果的页码，默认为1。

+ * @return array

+ */

+function dm_conversation( $uid, $page = 1, $count = 50, $since_id = 0, $max_id = 0)

+{

+$params = array();

+$this->id_format($uid);

+$params['uid'] = $uid;

+if ($since_id) {

+$this->id_format($since_id);

+$params['since_id'] = $since_id;

+}

+if ($max_id) {

+$this->id_format($max_id);

+$params['max_id'] = $max_id;

+}

+$params['count'] = $count;

+$params['page'] = $page;

+return $this->oauth->get( 'direct_messages/conversation', $params );

+}

+

+/**

+ * 根据私信ID批量获取私信内容

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/direct_messages/show_batch direct_messages/show_batch}

+ *

+ * @param string $dmids 需要查询的私信ID，用半角逗号分隔，一次最多50个

+ * @return array

+ */

+function dm_show_batch( $dmids )

+{

+$params = array();

+if (is_array($dmids) && !empty($dmids)) {

+foreach($dmids as $k => $v) {

+$this->id_format($dmids[$k]);

+}

+$params['dmids'] = join(',', $dmids);

+} else {

+$params['dmids'] = $dmids;

+}

+return $this->oauth->get( 'direct_messages/show_batch', $params );

+}

+

+/**

+ * 发送私信

+ *

+ * 发送一条私信。成功将返回完整的发送消息。

+ *

对应API：{@link http://open.weibo.com/wiki/2/direct_messages/new direct_messages/new}

+ *

+ * @access public

+ * @param int $uid 用户UID

+ * @param string $text 要发生的消息内容，文本大小必须小于300个汉字。

+ * @param int $id 需要发送的微博ID。

+ * @return array

+ */

+function send_dm_by_id( $uid, $text, $id = NULL )

+{

+$params = array();

+$this->id_format( $uid );

+$params['text'] = $text;

+$params['uid'] = $uid;

+if ($id) {

+$this->id_format( $id );

+$params['id'] = $id;

+}

+return $this->oauth->post( 'direct_messages/new', $params );

+}

+

+/**

+ * 发送私信

+ *

+ * 发送一条私信。成功将返回完整的发送消息。

+ *

对应API：{@link http://open.weibo.com/wiki/2/direct_messages/new direct_messages/new}

+ *

+ * @access public

+ * @param string $screen_name 用户昵称

+ * @param string $text 要发生的消息内容，文本大小必须小于300个汉字。

+ * @param int $id 需要发送的微博ID。

+ * @return array

+ */

+function send_dm_by_name( $screen_name, $text, $id = NULL )

+{

+$params = array();

+$params['text'] = $text;

+$params['screen_name'] = $screen_name;

+if ($id) {

+$this->id_format( $id );

+$params['id'] = $id;

+}

+return $this->oauth->post( 'direct_messages/new', $params);

+}

+

+/**

+ * 删除一条私信

+ *

+ * 按ID删除私信。操作用户必须为私信的接收人。

+ *

对应API：{@link http://open.weibo.com/wiki/2/direct_messages/destroy direct_messages/destroy}

+ *

+ * @access public

+ * @param int $did 要删除的私信主键ID

+ * @return array

+ */

+function delete_dm( $did )

+{

+$this->id_format($did);

+$params = array();

+$params['id'] = $did;

+return $this->oauth->post('direct_messages/destroy', $params);

+}

+

+/**

+ * 批量删除私信

+ *

+ * 批量删除当前登录用户的私信。出现异常时，返回400错误。

+ *

对应API：{@link http://open.weibo.com/wiki/2/direct_messages/destroy_batch direct_messages/destroy_batch}

+ *

+ * @access public

+ * @param mixed $dids 欲删除的一组私信ID，用半角逗号隔开，或者由一组评论ID组成的数组。最多20个。例如："4976494627, 4976262053"或array(4976494627,4976262053);

+ * @return array

+ */

+function delete_dms( $dids )

+{

+$params = array();

+if (is_array($dids) && !empty($dids)) {

+foreach($dids as $k => $v) {

+$this->id_format($dids[$k]);

+}

+$params['ids'] = join(',', $dids);

+} else {

+$params['ids'] = $dids;

+}

+

+return $this->oauth->post( 'direct_messages/destroy_batch', $params);

+}

+

+

+

+/**

+ * 获取用户基本信息

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/basic account/profile/basic}

+ *

+ * @param int $uid 需要获取基本信息的用户UID，默认为当前登录用户。

+ * @return array

+ */

+function account_profile_basic( $uid = NULL )

+{

+$params = array();

+if ($uid) {

+$this->id_format($uid);

+$params['uid'] = $uid;

+}

+return $this->oauth->get( 'account/profile/basic', $params );

+}

+

+/**

+ * 获取用户的教育信息

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/education account/profile/education}

+ *

+ * @param int $uid 需要获取教育信息的用户UID，默认为当前登录用户。

+ * @return array

+ */

+function account_education( $uid = NULL )

+{

+$params = array();

+if ($uid) {

+$this->id_format($uid);

+$params['uid'] = $uid;

+}

+return $this->oauth->get( 'account/profile/education', $params );

+}

+

+/**

+ * 批量获取用户的教育信息

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/education_batch account/profile/education_batch}

+ *

+ * @param string $uids 需要获取教育信息的用户UID，用半角逗号分隔，最多不超过20。

+ * @return array

+ */

+function account_education_batch( $uids )

+{

+$params = array();

+if (is_array($uids) && !empty($uids)) {

+foreach($uids as $k => $v) {

+$this->id_format($uids[$k]);

+}

+$params['uids'] = join(',', $uids);

+} else {

+$params['uids'] = $uids;

+}

+

+return $this->oauth->get( 'account/profile/education_batch', $params );

+}

+

+

+/**

+ * 获取用户的职业信息

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/career account/profile/career}

+ *

+ * @param int $uid 需要获取教育信息的用户UID，默认为当前登录用户。

+ * @return array

+ */

+function account_career( $uid = NULL )

+{

+$params = array();

+if ($uid) {

+$this->id_format($uid);

+$params['uid'] = $uid;

+}

+return $this->oauth->get( 'account/profile/career', $params );

+}

+

+/**

+ * 批量获取用户的职业信息

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/career_batch account/profile/career_batch}

+ *

+ * @param string $uids 需要获取教育信息的用户UID，用半角逗号分隔，最多不超过20。

+ * @return array

+ */

+function account_career_batch( $uids )

+{

+$params = array();

+if (is_array($uids) && !empty($uids)) {

+foreach($uids as $k => $v) {

+$this->id_format($uids[$k]);

+}

+$params['uids'] = join(',', $uids);

+} else {

+$params['uids'] = $uids;

+}

+

+return $this->oauth->get( 'account/profile/career_batch', $params );

+}

+

+/**

+ * 获取隐私信息设置情况

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/account/get_privacy account/get_privacy}

+ *

+ * @access public

+ * @return array

+ */

+function get_privacy()

+{

+return $this->oauth->get('account/get_privacy');

+}

+

+/**

+ * 获取所有的学校列表

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/school_list account/profile/school_list}

+ *

+ * @param array $query 搜索选项。格式：array('key0'=>'value0', 'key1'=>'value1', ....)。支持的key:

+ * - provinceint省份范围，省份ID。

+ * - cityint城市范围，城市ID。

+ * - areaint区域范围，区ID。

+ * - typeint学校类型，1：大学、2：高中、3：中专技校、4：初中、5：小学，默认为1。

+ * - capitalstring学校首字母，默认为A。

+ * - keywordstring学校名称关键字。

+ * - countint返回的记录条数，默认为10。

+ * 参数keyword与capital二者必选其一，且只能选其一。按首字母capital查询时，必须提供province参数。

+ * @access public

+ * @return array

+ */

+function school_list( $query )

+{

+$params = $query;

+

+return $this->oauth->get( 'account/profile/school_list', $params );

+}

+

+/**

+ * 获取当前登录用户的API访问频率限制情况

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/account/rate_limit_status account/rate_limit_status}

+ *

+ * @access public

+ * @return array

+ */

+function rate_limit_status()

+{

+return $this->oauth->get( 'account/rate_limit_status' );

+}

+

+/**

+ * OAuth授权之后，获取授权用户的UID

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/account/get_uid account/get_uid}

+ *

+ * @access public

+ * @return array

+ */

+function get_uid()

+{

+return $this->oauth->get( 'account/get_uid' );

+}

+

+

+/**

+ * 更改用户资料

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/basic_update account/profile/basic_update}

+ *

+ * @access public

+ * @param array $profile 要修改的资料。格式：array('key1'=>'value1', 'key2'=>'value2', .....)。

+ * 支持修改的项：

+ * - screen_namestring用户昵称，不可为空。

+ * - genderistring用户性别，m：男、f：女，不可为空。

+ * - real_namestring用户真实姓名。

+ * - real_name_visibleint真实姓名可见范围，0：自己可见、1：关注人可见、2：所有人可见。

+ * - provincetrueint省份代码ID，不可为空。

+ * - citytrueint城市代码ID，不可为空。

+ * - birthdaystring用户生日，格式：yyyy-mm-dd。

+ * - birthday_visibleint生日可见范围，0：保密、1：只显示月日、2：只显示星座、3：所有人可见。

+ * - qqstring用户QQ号码。

+ * - qq_visibleint用户QQ可见范围，0：自己可见、1：关注人可见、2：所有人可见。

+ * - msnstring用户MSN。

+ * - msn_visibleint用户MSN可见范围，0：自己可见、1：关注人可见、2：所有人可见。

+ * - urlstring用户博客地址。

+ * - url_visibleint用户博客地址可见范围，0：自己可见、1：关注人可见、2：所有人可见。

+ * - credentials_typeint证件类型，1：身份证、2：学生证、3：军官证、4：护照。

+ * - credentials_numstring证件号码。

+ * - emailstring用户常用邮箱地址。

+ * - email_visibleint用户常用邮箱地址可见范围，0：自己可见、1：关注人可见、2：所有人可见。

+ * - langstring语言版本，zh_cn：简体中文、zh_tw：繁体中文。

+ * - descriptionstring用户描述，最长不超过70个汉字。

+ * 填写birthday参数时，做如下约定：

+ * - 只填年份时，采用1986-00-00格式；

+ * - 只填月份时，采用0000-08-00格式；

+ * - 只填某日时，采用0000-00-28格式。

+ * @return array

+ */

+function update_profile( $profile )

+{

+return $this->oauth->post( 'account/profile/basic_update', $profile);

+}

+

+

+/**

+ * 设置教育信息

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/edu_update account/profile/edu_update}

+ *

+ * @access public

+ * @param array $edu_update 要修改的学校信息。格式：array('key1'=>'value1', 'key2'=>'value2', .....)。

+ * 支持设置的项：

+ * - typeint学校类型，1：大学、2：高中、3：中专技校、4：初中、5：小学，默认为1。必填参数

+ * - school_id`int学校代码，必填参数

+ * - idstring需要修改的教育信息ID，不传则为新建，传则为更新。

+ * - yearint入学年份，最小为1900，最大不超过当前年份

+ * - departmentstring院系或者班别。

+ * - visibleint开放等级，0：仅自己可见、1：关注的人可见、2：所有人可见。

+ * @return array

+ */

+function edu_update( $edu_update )

+{

+return $this->oauth->post( 'account/profile/edu_update', $edu_update);

+}

+

+/**

+ * 根据学校ID删除用户的教育信息

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/edu_destroy account/profile/edu_destroy}

+ *

+ * @param int $id 教育信息里的学校ID。

+ * @return array

+ */

+function edu_destroy( $id )

+{

+$this->id_format( $id );

+$params = array();

+$params['id'] = $id;

+return $this->oauth->post( 'account/profile/edu_destroy', $params);

+}

+

+/**

+ * 设置职业信息

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/car_update account/profile/car_update}

+ *

+ * @param array $car_update 要修改的职业信息。格式：array('key1'=>'value1', 'key2'=>'value2', .....)。

+ * 支持设置的项：

+ * - idstring需要更新的职业信息ID。

+ * - startint进入公司年份，最小为1900，最大为当年年份。

+ * - endint离开公司年份，至今填0。

+ * - departmentstring工作部门。

+ * - visibleint可见范围，0：自己可见、1：关注人可见、2：所有人可见。

+ * - provinceint省份代码ID，不可为空值。

+ * - cityint城市代码ID，不可为空值。

+ * - companystring公司名称，不可为空值。

+ * 参数province与city二者必选其一

+ * 参数id为空，则为新建职业信息，参数company变为必填项，参数id非空，则为更新，参数company可选

+ * @return array

+ */

+function car_update( $car_update )

+{

+return $this->oauth->post( 'account/profile/car_update', $car_update);

+}

+

+/**

+ * 根据公司ID删除用户的职业信息

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/car_destroy account/profile/car_destroy}

+ *

+ * @access public

+ * @param int $id 职业信息里的公司ID

+ * @return array

+ */

+function car_destroy( $id )

+{

+$this->id_format($id);

+$params = array();

+$params['id'] = $id;

+return $this->oauth->post( 'account/profile/car_destroy', $params);

+}

+

+/**

+ * 更改头像

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/account/avatar/upload account/avatar/upload}

+ *

+ * @param string $image_path 要上传的头像路径, 支持url。[只支持png/jpg/gif三种格式, 增加格式请修改get_image_mime方法] 必须为小于700K的有效的GIF, JPG图片. 如果图片大于500像素将按比例缩放。

+ * @return array

+ */

+function update_profile_image( $image_path )

+{

+$params = array();

+$params['image'] = "@{$image_path}";

+

+return $this->oauth->post('account/avatar/upload', $params);

+}

+

+/**

+ * 设置隐私信息

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/account/update_privacy account/update_privacy}

+ *

+ * @param array $privacy_settings 要修改的隐私设置。格式：array('key1'=>'value1', 'key2'=>'value2', .....)。

+ * 支持设置的项：

+ * - commentint是否可以评论我的微博，0：所有人、1：关注的人，默认为0。

+ * - geoint是否开启地理信息，0：不开启、1：开启，默认为1。

+ * - messageint是否可以给我发私信，0：所有人、1：关注的人，默认为0。

+ * - realnameint是否可以通过真名搜索到我，0：不可以、1：可以，默认为0。

+ * - badgeint勋章是否可见，0：不可见、1：可见，默认为1。

+ * - mobileint是否可以通过手机号码搜索到我，0：不可以、1：可以，默认为0。

+ * 以上参数全部选填

+ * @return array

+ */

+function update_privacy( $privacy_settings )

+{

+return $this->oauth->post( 'account/update_privacy', $privacy_settings);

+}

+

+

+/**

+ * 获取当前用户的收藏列表

+ *

+ * 返回用户的发布的最近20条收藏信息，和用户收藏页面返回内容是一致的。

+ *

对应API：{@link http://open.weibo.com/wiki/2/favorites favorites}

+ *

+ * @access public

+ * @param int $page 返回结果的页码，默认为1。

+ * @param int $count 单页返回的记录条数，默认为50。

+ * @return array

+ */

+function get_favorites( $page = 1, $count = 50 )

+{

+$params = array();

+$params['page'] = intval($page);

+$params['count'] = intval($count);

+

+return $this->oauth->get( 'favorites', $params );

+}

+

+

+/**

+ * 根据收藏ID获取指定的收藏信息

+ *

+ * 根据收藏ID获取指定的收藏信息。

+ *

对应API：{@link http://open.weibo.com/wiki/2/favorites/show favorites/show}

+ *

+ * @access public

+ * @param int $id 需要查询的收藏ID。

+ * @return array

+ */

+function favorites_show( $id )

+{

+$params = array();

+$this->id_format($id);

+$params['id'] = $id;

+return $this->oauth->get( 'favorites/show', $params );

+}

+

+

+/**

+ * 根据标签获取当前登录用户该标签下的收藏列表

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/favorites/by_tags favorites/by_tags}

+ *

+ *

+ * @param int $tid 需要查询的标签ID。'

+ * @param int $count 单页返回的记录条数，默认为50。

+ * @param int $page 返回结果的页码，默认为1。

+ * @return array

+ */

+function favorites_by_tags( $tid, $page = 1, $count = 50)

+{

+$params = array();

+$params['tid'] = $tid;

+$params['count'] = $count;

+$params['page'] = $page;

+return $this->oauth->get( 'favorites/by_tags', $params );

+}

+

+

+/**

+ * 获取当前登录用户的收藏标签列表

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/favorites/tags favorites/tags}

+ *

+ * @access public

+ * @param int $count 单页返回的记录条数，默认为50。

+ * @param int $page 返回结果的页码，默认为1。

+ * @return array

+ */

+function favorites_tags( $page = 1, $count = 50)

+{

+$params = array();

+$params['count'] = $count;

+$params['page'] = $page;

+return $this->oauth->get( 'favorites/tags', $params );

+}

+

+

+/**

+ * 收藏一条微博信息

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/favorites/create favorites/create}

+ *

+ * @access public

+ * @param int $sid 收藏的微博id

+ * @return array

+ */

+function add_to_favorites( $sid )

+{

+$this->id_format($sid);

+$params = array();

+$params['id'] = $sid;

+

+return $this->oauth->post( 'favorites/create', $params );

+}

+

+/**

+ * 删除微博收藏。

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/favorites/destroy favorites/destroy}

+ *

+ * @access public

+ * @param int $id 要删除的收藏微博信息ID.

+ * @return array

+ */

+function remove_from_favorites( $id )

+{

+$this->id_format($id);

+$params = array();

+$params['id'] = $id;

+return $this->oauth->post( 'favorites/destroy', $params);

+}

+

+

+/**

+ * 批量删除微博收藏。

+ *

+ * 批量删除当前登录用户的收藏。出现异常时，返回HTTP400错误。

+ *

对应API：{@link http://open.weibo.com/wiki/2/favorites/destroy_batch favorites/destroy_batch}

+ *

+ * @access public

+ * @param mixed $fids 欲删除的一组私信ID，用半角逗号隔开，或者由一组评论ID组成的数组。最多20个。例如："231101027525486630,201100826122315375"或array(231101027525486630,201100826122315375);

+ * @return array

+ */

+function remove_from_favorites_batch( $fids )

+{

+$params = array();

+if (is_array($fids) && !empty($fids)) {

+foreach ($fids as $k => $v) {

+$this->id_format($fids[$k]);

+}

+$params['ids'] = join(',', $fids);

+} else {

+$params['ids'] = $fids;

+}

+

+return $this->oauth->post( 'favorites/destroy_batch', $params);

+}

+

+

+/**

+ * 更新一条收藏的收藏标签

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/favorites/tags/update favorites/tags/update}

+ *

+ * @access public

+ * @param int $id 需要更新的收藏ID。

+ * @param string $tags 需要更新的标签内容，用半角逗号分隔，最多不超过2条。

+ * @return array

+ */

+function favorites_tags_update( $id, $tags )

+{

+$params = array();

+$params['id'] = $id;

+if (is_array($tags) && !empty($tags)) {

+foreach ($tags as $k => $v) {

+$this->id_format($tags[$k]);

+}

+$params['tags'] = join(',', $tags);

+} else {

+$params['tags'] = $tags;

+}

+return $this->oauth->post( 'favorites/tags/update', $params );

+}

+

+/**

+ * 更新当前登录用户所有收藏下的指定标签

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/favorites/tags/update_batch favorites/tags/update_batch}

+ *

+ * @param int $tid 需要更新的标签ID。必填

+ * @param string $tag 需要更新的标签内容。必填

+ * @return array

+ */

+function favorites_update_batch( $tid, $tag )

+{

+$params = array();

+$params['tid'] = $tid;

+$params['tag'] = $tag;

+return $this->oauth->post( 'favorites/tags/update_batch', $params);

+}

+

+/**

+ * 删除当前登录用户所有收藏下的指定标签

+ *

+ * 删除标签后，该用户所有收藏中，添加了该标签的收藏均解除与该标签的关联关系

+ *

对应API：{@link http://open.weibo.com/wiki/2/favorites/tags/destroy_batch favorites/tags/destroy_batch}

+ *

+ * @param int $tid 需要更新的标签ID。必填

+ * @return array

+ */

+function favorites_tags_destroy_batch( $tid )

+{

+$params = array();

+$params['tid'] = $tid;

+return $this->oauth->post( 'favorites/tags/destroy_batch', $params);

+}

+

+/**

+ * 获取某用户的话题

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/trends trends}

+ *

+ * @param int $uid 查询用户的ID。默认为当前用户。可选。

+ * @param int $page 指定返回结果的页码。可选。

+ * @param int $count 单页大小。缺省值10。可选。

+ * @return array

+ */

+function get_trends( $uid = NULL, $page = 1, $count = 10 )

+{

+$params = array();

+if ($uid) {

+$params['uid'] = $uid;

+} else {

+$user_info = $this->get_uid();

+$params['uid'] = $user_info['uid'];

+}

+$this->id_format( $params['uid'] );

+$params['page'] = $page;

+$params['count'] = $count;

+return $this->oauth->get( 'trends', $params );

+}

+

+

+/**

+ * 判断当前用户是否关注某话题

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/trends/is_follow trends/is_follow}

+ *

+ * @access public

+ * @param string $trend_name 话题关键字。

+ * @return array

+ */

+function trends_is_follow( $trend_name )

+{

+$params = array();

+$params['trend_name'] = $trend_name;

+return $this->oauth->get( 'trends/is_follow', $params );

+}

+

+/**

+ * 返回最近一小时内的热门话题

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/trends/hourly trends/hourly}

+ *

+ * @param int $base_app 是否基于当前应用来获取数据。1表示基于当前应用来获取数据，默认为0。可选。

+ * @return array

+ */

+function hourly_trends( $base_app = 0 )

+{

+$params = array();

+$params['base_app'] = $base_app;

+

+return $this->oauth->get( 'trends/hourly', $params );

+}

+

+/**

+ * 返回最近一天内的热门话题

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/trends/daily trends/daily}

+ *

+ * @param int $base_app 是否基于当前应用来获取数据。1表示基于当前应用来获取数据，默认为0。可选。

+ * @return array

+ */

+function daily_trends( $base_app = 0 )

+{

+$params = array();

+$params['base_app'] = $base_app;

+

+return $this->oauth->get( 'trends/daily', $params );

+}

+

+/**

+ * 返回最近一周内的热门话题

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/trends/weekly trends/weekly}

+ *

+ * @access public

+ * @param int $base_app 是否基于当前应用来获取数据。1表示基于当前应用来获取数据，默认为0。可选。

+ * @return array

+ */

+function weekly_trends( $base_app = 0 )

+{

+$params = array();

+$params['base_app'] = $base_app;

+

+return $this->oauth->get( 'trends/weekly', $params );

+}

+

+/**

+ * 关注某话题

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/trends/follow trends/follow}

+ *

+ * @access public

+ * @param string $trend_name 要关注的话题关键词。

+ * @return array

+ */

+function follow_trends( $trend_name )

+{

+$params = array();

+$params['trend_name'] = $trend_name;

+return $this->oauth->post( 'trends/follow', $params );

+}

+

+/**

+ * 取消对某话题的关注

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/trends/destroy trends/destroy}

+ *

+ * @access public

+ * @param int $tid 要取消关注的话题ID。

+ * @return array

+ */

+function unfollow_trends( $tid )

+{

+$this->id_format($tid);

+

+$params = array();

+$params['trend_id'] = $tid;

+

+return $this->oauth->post( 'trends/destroy', $params );

+}

+

+/**

+ * 返回指定用户的标签列表

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/tags tags}

+ *

+ * @param int $uid 查询用户的ID。默认为当前用户。可选。

+ * @param int $page 指定返回结果的页码。可选。

+ * @param int $count 单页大小。缺省值20，最大值200。可选。

+ * @return array

+ */

+function get_tags( $uid = NULL, $page = 1, $count = 20 )

+{

+$params = array();

+if ( $uid ) {

+$params['uid'] = $uid;

+} else {

+$user_info = $this->get_uid();

+$params['uid'] = $user_info['uid'];

+}

+$this->id_format( $params['uid'] );

+$params['page'] = $page;

+$params['count'] = $count;

+return $this->oauth->get( 'tags', $params );

+}

+

+/**

+ * 批量获取用户的标签列表

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/tags/tags_batch tags/tags_batch}

+ *

+ * @param string $uids 要获取标签的用户ID。最大20，逗号分隔。必填

+ * @return array

+ */

+function get_tags_batch( $uids )

+{

+$params = array();

+if (is_array( $uids ) && !empty( $uids )) {

+foreach ($uids as $k => $v) {

+$this->id_format( $uids[$k] );

+}

+$params['uids'] = join(',', $uids);

+} else {

+$params['uids'] = $uids;

+}

+return $this->oauth->get( 'tags/tags_batch', $params );

+}

+

+/**

+ * 返回用户感兴趣的标签

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/tags/suggestions tags/suggestions}

+ *

+ * @access public

+ * @param int $count 单页大小。缺省值10，最大值10。可选。

+ * @return array

+ */

+function get_suggest_tags( $count = 10)

+{

+$params = array();

+$params['count'] = intval($count);

+return $this->oauth->get( 'tags/suggestions', $params );

+}

+

+/**

+ * 为当前登录用户添加新的用户标签

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/tags/create tags/create}

+ *

+ * @access public

+ * @param mixed $tags 要创建的一组标签，每个标签的长度不可超过7个汉字，14个半角字符。多个标签之间用逗号间隔，或由多个标签构成的数组。如："abc,drf,efgh,tt"或array("abc", "drf", "efgh", "tt")

+ * @return array

+ */

+function add_tags( $tags )

+{

+$params = array();

+if (is_array($tags) && !empty($tags)) {

+$params['tags'] = join(',', $tags);

+} else {

+$params['tags'] = $tags;

+}

+return $this->oauth->post( 'tags/create', $params);

+}

+

+/**

+ * 删除标签

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/tags/destroy tags/destroy}

+ *

+ * @access public

+ * @param int $tag_id 标签ID，必填参数

+ * @return array

+ */

+function delete_tag( $tag_id )

+{

+$params = array();

+$params['tag_id'] = $tag_id;

+return $this->oauth->post( 'tags/destroy', $params );

+}

+

+/**

+ * 批量删除标签

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/tags/destroy_batch tags/destroy_batch}

+ *

+ * @access public

+ * @param mixed $ids 必选参数，要删除的tag id，多个id用半角逗号分割，最多10个。或由多个tag id构成的数组。如：“553,554,555"或array(553, 554, 555)

+ * @return array

+ */

+function delete_tags( $ids )

+{

+$params = array();

+if (is_array($ids) && !empty($ids)) {

+$params['ids'] = join(',', $ids);

+} else {

+$params['ids'] = $ids;

+}

+return $this->oauth->post( 'tags/destroy_batch', $params );

+}

+

+

+/**

+ * 验证昵称是否可用，并给予建议昵称

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/register/verify_nickname register/verify_nickname}

+ *

+ * @param string $nickname 需要验证的昵称。4-20个字符，支持中英文、数字、"_"或减号。必填

+ * @return array

+ */

+function verify_nickname( $nickname )

+{

+$params = array();

+$params['nickname'] = $nickname;

+return $this->oauth->get( 'register/verify_nickname', $params );

+}

+

+

+

+/**

+ * 搜索用户时的联想搜索建议

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/search/suggestions/users search/suggestions/users}

+ *

+ * @param string $q 搜索的关键字，必须做URLencoding。必填,中间最好不要出现空格

+ * @param int $count 返回的记录条数，默认为10。

+ * @return array

+ */

+function search_users( $q, $count = 10 )

+{

+$params = array();

+$params['q'] = $q;

+$params['count'] = $count;

+return $this->oauth->get( 'search/suggestions/users', $params );

+}

+

+

+/**

+ * 搜索微博时的联想搜索建议

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/search/suggestions/statuses search/suggestions/statuses}

+ *

+ * @param string $q 搜索的关键字，必须做URLencoding。必填

+ * @param int $count 返回的记录条数，默认为10。

+ * @return array

+ */

+function search_statuses( $q, $count = 10)

+{

+$params = array();

+$params['q'] = $q;

+$params['count'] = $count;

+return $this->oauth->get( 'search/suggestions/statuses', $params );

+}

+

+

+/**

+ * 搜索学校时的联想搜索建议

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/search/suggestions/schools search/suggestions/schools}

+ *

+ * @param string $q 搜索的关键字，必须做URLencoding。必填

+ * @param int $count 返回的记录条数，默认为10。

+ * @param int type 学校类型，0：全部、1：大学、2：高中、3：中专技校、4：初中、5：小学，默认为0。选填

+ * @return array

+ */

+function search_schools( $q, $count = 10, $type = 1)

+{

+$params = array();

+$params['q'] = $q;

+$params['count'] = $count;

+$params['type'] = $type;

+return $this->oauth->get( 'search/suggestions/schools', $params );

+}

+

+/**

+ * 搜索公司时的联想搜索建议

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/search/suggestions/companies search/suggestions/companies}

+ *

+ * @param string $q 搜索的关键字，必须做URLencoding。必填

+ * @param int $count 返回的记录条数，默认为10。

+ * @return array

+ */

+function search_companies( $q, $count = 10)

+{

+$params = array();

+$params['q'] = $q;

+$params['count'] = $count;

+return $this->oauth->get( 'search/suggestions/companies', $params );

+}

+

+

+/**

+ * ＠用户时的联想建议

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/search/suggestions/at_users search/suggestions/at_users}

+ *

+ * @param string $q 搜索的关键字，必须做URLencoding。必填

+ * @param int $count 返回的记录条数，默认为10。

+ * @param int $type 联想类型，0：关注、1：粉丝。必填

+ * @param int $range 联想范围，0：只联想关注人、1：只联想关注人的备注、2：全部，默认为2。选填

+ * @return array

+ */

+function search_at_users( $q, $count = 10, $type=0, $range = 2)

+{

+$params = array();

+$params['q'] = $q;

+$params['count'] = $count;

+$params['type'] = $type;

+$params['range'] = $range;

+return $this->oauth->get( 'search/suggestions/at_users', $params );

+}

+

+

+

+

+

+/**

+ * 搜索与指定的一个或多个条件相匹配的微博

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/search/statuses search/statuses}

+ *

+ * @param array $query 搜索选项。格式：array('key0'=>'value0', 'key1'=>'value1', ....)。支持的key:

+ * - qstring搜索的关键字，必须进行URLencode。

+ * - filter_oriint过滤器，是否为原创，0：全部、1：原创、2：转发，默认为0。

+ * - filter_picint过滤器。是否包含图片，0：全部、1：包含、2：不包含，默认为0。

+ * - fuidint搜索的微博作者的用户UID。

+ * - provinceint搜索的省份范围，省份ID。

+ * - cityint搜索的城市范围，城市ID。

+ * - starttimeint开始时间，Unix时间戳。

+ * - endtimeint结束时间，Unix时间戳。

+ * - countint单页返回的记录条数，默认为10。

+ * - pageint返回结果的页码，默认为1。

+ * - needcountboolean返回结果中是否包含返回记录数，true：返回、false：不返回，默认为false。

+ * - base_appint是否只获取当前应用的数据。0为否(所有数据)，1为是(仅当前应用)，默认为0。

+ * needcount参数不同，会导致相应的返回值结构不同

+ * 以上参数全部选填

+ * @return array

+ */

+function search_statuses_high( $query )

+{

+return $this->oauth->get( 'search/statuses', $query );

+}

+

+

+

+/**

+ * 通过关键词搜索用户

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/search/users search/users}

+ *

+ * @param array $query 搜索选项。格式：array('key0'=>'value0', 'key1'=>'value1', ....)。支持的key:

+ * - qstring搜索的关键字，必须进行URLencode。

+ * - snickint搜索范围是否包含昵称，0：不包含、1：包含。

+ * - sdomainint搜索范围是否包含个性域名，0：不包含、1：包含。

+ * - sintroint搜索范围是否包含简介，0：不包含、1：包含。

+ * - stagint搜索范围是否包含标签，0：不包含、1：包含。

+ * - provinceint搜索的省份范围，省份ID。

+ * - cityint搜索的城市范围，城市ID。

+ * - genderstring搜索的性别范围，m：男、f：女。

+ * - comorschstring搜索的公司学校名称。

+ * - sortint排序方式，1：按更新时间、2：按粉丝数，默认为1。

+ * - countint单页返回的记录条数，默认为10。

+ * - pageint返回结果的页码，默认为1。

+ * - base_appint是否只获取当前应用的数据。0为否(所有数据)，1为是(仅当前应用)，默认为0。

+ * 以上所有参数全部选填

+ * @return array

+ */

+function search_users_keywords( $query )

+{

+return $this->oauth->get( 'search/users', $query );

+}

+

+

+

+/**

+ * 获取系统推荐用户

+ *

+ * 返回系统推荐的用户列表。

+ *

对应API：{@link http://open.weibo.com/wiki/2/suggestions/users/hot suggestions/users/hot}

+ *

+ * @access public

+ * @param string $category 分类，可选参数，返回某一类别的推荐用户，默认为 default。如果不在以下分类中，返回空列表：

+ * - default:人气关注

+ * - ent:影视名星

+ * - hk_famous:港台名人

+ * - model:模特

+ * - cooking:美食&健康

+ * - sport:体育名人

+ * - finance:商界名人

+ * - tech:IT互联网

+ * - singer:歌手

+ * - writer：作家

+ * - moderator:主持人

+ * - medium:媒体总编

+ * - stockplayer:炒股高手

+ * @return array

+ */

+function hot_users( $category = "default" )

+{

+$params = array();

+$params['category'] = $category;

+

+return $this->oauth->get( 'suggestions/users/hot', $params );

+}

+

+/**

+ * 获取用户可能感兴趣的人

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/suggestions/users/may_interested suggestions/users/may_interested}

+ *

+ * @access public

+ * @param int $page 返回结果的页码，默认为1。

+ * @param int $count 单页返回的记录条数，默认为10。

+ * @return array

+ * @ignore

+ */

+function suggestions_may_interested( $page = 1, $count = 10 )

+{

+$params = array();

+$params['page'] = $page;

+$params['count'] = $count;

+return $this->oauth->get( 'suggestions/users/may_interested', $params);

+}

+

+/**

+ * 根据一段微博正文推荐相关微博用户。

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/suggestions/users/by_status suggestions/users/by_status}

+ *

+ * @access public

+ * @param string $content 微博正文内容。

+ * @param int $num 返回结果数目，默认为10。

+ * @return array

+ */

+function suggestions_users_by_status( $content, $num = 10 )

+{

+$params = array();

+$params['content'] = $content;

+$params['num'] = $num;

+return $this->oauth->get( 'suggestions/users/by_status', $params);

+}

+

+/**

+ * 热门收藏

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/suggestions/favorites/hot suggestions/favorites/hot}

+ *

+ * @param int $count 每页返回结果数，默认20。选填

+ * @param int $page 返回页码，默认1。选填

+ * @return array

+ */

+function hot_favorites( $page = 1, $count = 20 )

+{

+$params = array();

+$params['count'] = $count;

+$params['page'] = $page;

+return $this->oauth->get( 'suggestions/favorites/hot', $params);

+}

+

+/**

+ * 把某人标识为不感兴趣的人

+ *

+ * 对应API：{@link http://open.weibo.com/wiki/2/suggestions/users/not_interested suggestions/users/not_interested}

+ *

+ * @param int $uid 不感兴趣的用户的UID。

+ * @return array

+ */

+function put_users_not_interested( $uid )

+{

+$params = array();

+$params['uid'] = $uid;

+return $this->oauth->post( 'suggestions/users/not_interested', $params);

+}

+

+

+

+// =========================================

+

+/**

+ * @ignore

+ */

+protected function request_with_pager( $url, $page = false, $count = false, $params = array() )

+{

+if( $page ) $params['page'] = $page;

+if( $count ) $params['count'] = $count;

+

+return $this->oauth->get($url, $params );

+}

+

+/**

+ * @ignore

+ */

+protected function request_with_uid( $url, $uid_or_name, $page = false, $count = false, $cursor = false, $post = false, $params = array())

+{

+if( $page ) $params['page'] = $page;

+if( $count ) $params['count'] = $count;

+if( $cursor )$params['cursor'] = $cursor;

+

+if( $post ) $method = 'post';

+else $method = 'get';

+

+if ( $uid_or_name !== NULL ) {

+$this->id_format($uid_or_name);

+$params['id'] = $uid_or_name;

+}

+

+return $this->oauth->$method($url, $params );

+

+}

+

+/**

+ * @ignore

+ */

+protected function id_format(&$id) {

+if ( is_float($id) ) {

+$id = number_format($id, 0, '', '');

+} elseif ( is_string($id) ) {

+$id = trim($id);

+}

+}

+

+}

diff --git a/weibo_login.png b/weibo_login.png

new file mode 100644

index 0000000000000000000000000000000000000000..16861ee12411b94eb26c751fcd3ee0f799191395

GIT binary patch

literal 16128

zcmV+bKmWjqP)KLZ*U+5Lu!Sk^o_Z5E4Meg@_7P6crJiNL9pw)e1;Xm069{HJUZAPk55R%$-RIA

z6-eL&AQ0xu!e<4=008gy@A0LT~suv4>S3ILP<0Bm`DLLvaF4FK%)Nj?Pt*r}7;7Xa9z9H|HZjR63e

zC`Tj$K)V27Re@400>HumpsYY5E(E}?0f1SyGDiY{y#)Yvj#!WnKwtoXnL;eg03bL5

z07D)V%>y7z1E4U{zu>7~aD})?0RX_umCct+(lZpemCzb@^6=o|A>zVpu|i=NDG+7}

zl4`aK{0#b-!z=TL9Wt0BGO&T{GJWpjryhdijfaIQ&2!o}p04JRKYg3k&Tf

zVxhe-O!X

z{f;To;xw^bEES6JSc$k$B2CA6xl)ltA<32E66t?3@gJ7`36pmX0IY^jz)rRYwaaY4

ze(nJRiw;=Qb^t(r^DT@T3y}a2XEZW-_W%Hszxj_qD**t_m!#tW0KDiJT&R>6OvVTR

z07RgHDzHHZ48atvzz&?j9lXF70$~P3Knx_nJP`N

z#-MZ2bTkiLfR>_b(HgWKJ%F~Nr_oF3b#wrIijHG|(J>BYjM-sajE6;FiC7vY#};Gd

zST$CUHDeuEH+B^pz@B062qXfFfD`NpUW5?BY=V%GM_5c)L#QR}BeW8_2v-S%gfYS=

zB9o|3v?Y2H`NVi)In3rTB8+ej^>

zQ=~r95NVuDChL%G$=>7$vVg20myx%S50Foi`^m%Pw-h?Xh~i8Mq9jtJloCocWk2Nv

zrJpiFnV_ms&8eQ$2WpIS+6pmtC%Q-`S&GF4Q#^mhymh7E(qNMa}%YZ-ePrx>>xFPTiH1=E+A$W$=bG8>s^

zm=Bn5Rah$aDtr}@$`X}2l~$F0mFKEdRdZE8)p@E5RI61Ft6o-prbbn>P~)iy)E2AN

zsU20jsWz_8Qg>31P|s0cqrPALg8E|(vWA65poU1JRAaZs8I2(p#xiB`SVGovRs-uS

zYnV-9TeA7=Om+qP8+I>yOjAR1s%ETak!GFdam@h^#z)@rS0t$wXH+Irf)+G6c;?H29p+V6F6oj{!|o%K3xI`?%6x;DB|x`n#ibhIR?(H}Q3Gzd138Ei2)WAMz7W9Vy`X}HnwgyEn!VS)>mv$8&{hQn>w4zwy3R}t;BYlZQm5)6pty=DfLrs+A-|>>;~;Q

z_F?uV_HFjh9n2gO9o9Q^JA86v({H5aB!kjoO6

zc9$1ZZKsN-Zl8L~mE{`ly3)1N^`o1+o7}D0ZPeY&J;i;i`%NyJ8_8Y6J?}yE@b_5a

zam?eLr<8@mESk|3$_SkmS{wQ>%qC18))9_|&j{ZT

zes8AvOzF(F2#DZEY>2oYX&IRp`F#{ADl)1r>QS^)ba8a|EY_^#S^HO&t^Rgqwv=MZThqqEWH8

zxJo>d=ABlR_Bh=;eM9Tw|Ih34~oTE|=

zX_mAr*D$vzw@+p(E0Yc6dFE}(8oqt`+R{gE3x4zjX+Sb3_cYE^=

zgB=w+-tUy`ytONMS8KgRef4hA?t0j

zufM;t32jm~jUGrkaOInTZ`zyfns>EuS}G30LFK_G-==(f<51|K&cocp&EJ`SxAh3?

zNO>#LI=^+SEu(FqJ)ynt=!~PC9bO$rzPJB=?=j6w@a-(u02P7

zaQ)#(uUl{HW%tYNS3ItC^iAtK(eKlL`f9+{bJzISE?u8_z3;~C8@FyI-5j_jy7l;W

z_U#vU3hqqYU3!mrul&B+{ptt$59)uk{;_4iZQ%G|z+lhASr6|H35TBkl>gI*;nGLU

zN7W-nBaM%pA0HbH8olyl&XeJ%vZoWz%6?Y=dFykl=imL}`%BMQ{Mhgd`HRoLu6e2R

za__6DuR6yg#~-}Tc|Gx_{H@O0eebyMy5GmWADJlpK>kqk(fVV@r_fLLKIeS?{4e)}

z^ZO;zpECde03c&XQcVB=dL;k=fP(-4`Tqa_faw4Lbua(`>RI+y?e7jKeZ#YO-C

zG%ZO)K~#9!?7exMWL1^#``zcnkaK3#OjS_@38=*=70d|IlBv)L7t{o`eWKnrOPbeS

z(fiEA3A;tfv=yaW8!PqN?a-}~KuHTNO$LH8Lj_|&DHH)!Mb=D3R*o^9z26^a+ULYM

zIY9UO-23^w_=TEzMjwdG0#)lbwVtlT?=iyi0*%-wCCz`

zLCoVGvprYD%&j@*mkRZRQqC#b{S+V+q}HtDEsu`chm}&iaNH8L{D$w-e!*p67!f@!

z>?>!Tq2VXlzbk}xh1NrLomww>_Ak*hKuSraQXzG9D^a(v`?s3M{8Ws=?7`O@G^t|B>-t)0QUc6z!)2bft1oYC_P!1

z(m5TF?s-V}7Dzyd8qBwZGhT-2^Vqo7@AOuv(WnMa_

zm6dBCA;1tILxXLoSuC#h-D{Edo8f$y+V?so5}H@yO;`>UR?bShTtr(i{d~QdQNPb=

z73V++DgqIB&zPfK0T44+yEN-O?{-CuvDD{)^W7U~6&zD~r

z{*$fFe+GOP^R!fRjf{;PpVIX&l?q-Y

zLiZBda{_&?=4hMpeR~ymzM5Osb?k`gD|}nVNHUnI)Ww<

zl>?~Ce#FEJsMm*K>BnLDM+t$9$cdmFT%uw$vI2yRfPC7hs0d+H+V$SRxxdK>C9A{4

zc|y>68AlO1uHvET?8-h3W06?bjp5ABDsFq2Y+wQIn29DH)@q7UFX~OWi;Zt1=8lKcj

zzHw%GRzX&8oFP^$;J8{ClvZ>6sNM|2{RY~lB4)peLP;_tjByrQzedH(8#TA044

LONQ{a`2C&D4

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

7AuWBzu4

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