<?php
/**
 * PHP SDK for weibo.com (using OAuth2).
 *
 * @author Elmer Zhang <freeboy6716@gmail.com>
 */
/**
 * @ignore
 */
class SaeTOAuthException extends Exception
{
    // pass
}
/**
 * 新浪分享 OAuth 认证类(OAuth2).
 *
 * 授权机制说明请大家参考分享开放平台文档：{@link http://open.weibo.com/wiki/Oauth2}
 *
 * @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
     */
    public function accessTokenURL()
    {
        return 'https://api.weibo.com/oauth2/access_token';
    }

    public function getTokenInfoURL()
    {
        return 'https://api.weibo.com/oauth2/get_token_info';
    }

    /**
     * @ignore
     */
    public function authorizeURL()
    {
        return 'https://api.weibo.com/oauth2/authorize';
    }

    /**
     * construct WeiboOAuth object.
     */
    public 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的手机
     *                              - popup			弹窗授权页
     *                              - wap1.2		wap1.2页面
     *                              - wap2.0		wap2.0页面
     *                              - js			js-sdk 专用 授权页面是弹窗，返回结果为js-sdk回掉函数
     *                              - apponweibo	站内应用专用,站内应用不传display参数,并且response_type为token时,默认使用改display.授权后不会返回access_token，只是输出js刷新站内应用父框架
     *
     * @return array
     */
    public function getAuthorizeURL($url, $response_type = 'code', $state = null, $display = null)
    {
        $params = array();
        $params['client_id'] = $this->client_id;
        $params['redirect_uri'] = $url;
        $params['response_type'] = $response_type;
        $params['state'] = $state;
        $params['display'] = $display;

        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
     */
    public function getAccessToken($type, $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 {
            return false; //throw new SaeTOAuthException("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'];
            if (isset($token['refresh_token'])) {
                $this->refresh_token = $token['refresh_token'];
            }
        } else {
            return false; //throw new SaeTOAuthException("get access token failed." . $token['error']);
        }

        return $token;
    }

    /**
     * access_token接口.
     *
     * 对应API：{@link http://open.weibo.com/wiki/OAuth2/get_token_info OAuth2/get_token_info}
     *
     * @param string $access_token
     *
     * @return array
     */
    public function getTokenInfo($access_token)
    {
        $params = array();
        $params['access_token'] = $access_token;
        $response = $this->oAuthRequest($this->getTokenInfoURL(), 'POST', $params);
        $token = json_decode($response, true);

        return $token;
    }

    /**
     * 解析 signed_request.
     *
     * @param string $signed_request 应用框架在加载iframe时会通过向Canvas URL post的参数signed_request
     *
     * @return array
     */
    public 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
     */
    public 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
     */
    public 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
     */
    public 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
     */
    public 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
     */
    public 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
     */
    public 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
     */
    public 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
     */
    public 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
     */
    public 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 <br />
 *
 * @author Easy Chen, Elmer Zhang,Lazypeople
 *
 * @version 1.0
 */
class SaeTClientV2
{
    /**
     * 构造函数.
     *
     * @param mixed $akey          分享开放平台应用APP KEY
     * @param mixed $skey          分享开放平台应用APP SECRET
     * @param mixed $access_token  OAuth认证返回的token
     * @param mixed $refresh_token OAuth认证返回的token secret
     */
    public function __construct($akey, $skey, $access_token, $refresh_token = null)
    {
        $this->oauth = new SaeTOAuthV2($akey, $skey, $access_token, $refresh_token);
    }

    /**
     * 开启调试信息.
     *
     * 开启调试信息后，SDK会将每次请求分享API所发送的POST Data、Headers以及请求信息、返回内容输出出来。
     *
     * @param bool $enable 是否开启调试信息
     */
    public 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，以避免此问题。
     *
     * @param string $ip 用户IP
     *
     * @return bool IP为非法IP字符串时，返回false，否则返回true
     */
    public 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}
     *
     * @param int $count    单页返回的记录条数，默认为50。
     * @param int $page     返回结果的页码，默认为1。
     * @param int $base_app 是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。
     *
     * @return array
     */
    public 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()
     * <br />对应API：{@link http://open.weibo.com/wiki/2/statuses/home_timeline statuses/home_timeline}
     *
     * @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
     */
    public 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()
     * <br />对应API：{@link http://open.weibo.com/wiki/2/statuses/friends_timeline statuses/friends_timeline}
     *
     * @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
     */
    public 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条信息，和用户分享页面返回内容是一致的。此接口也可以请求其他用户的最新发表分享。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/statuses/user_timeline statuses/user_timeline}
     *
     * @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
     */
    public 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条信息，和用户分享页面返回内容是一致的。此接口也可以请求其他用户的最新发表分享。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/statuses/user_timeline statuses/user_timeline}
     *
     * @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
     */
    public 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
     */
    public 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'] = implode(',', $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
     */
    public 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'] = implode(',', $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}
     *
     * @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
     */
    public 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}
     *
     * @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
     */
    public 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的分享消息）
     * <br />对应API：{@link http://open.weibo.com/wiki/2/statuses/mentions statuses/mentions}
     *
     * @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
     */
    public 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的分享信息，作者信息将同时返回。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/statuses/show statuses/show}
     *
     * @param int $id 要获取已发表的分享ID, 如ID不存在返回空
     *
     * @return array
     */
    public 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
     */
    public function show_batch($ids)
    {
        $params = array();
        if (is_array($ids) && !empty($ids)) {
            foreach ($ids as $k => $v) {
                $this->id_format($ids[$k]);
            }
            $params['ids'] = implode(',', $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
     */
    public 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
     */
    public 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
     */
    public 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
     */
    public 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
     */
    public 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
     */
    public 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);
    }

    /**
     * 转发一条分享信息。
     *
     * 可加评论。为防止重复，发布的信息与最新信息一样话，将会被忽略。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/statuses/repost statuses/repost}
     *
     * @param int    $sid        转发的分享ID
     * @param string $text       添加的评论信息。可选。
     * @param int    $is_comment 是否在转发的同时发表评论，0：否、1：评论给当前分享、2：评论给原分享、3：都评论，默认为0。
     *
     * @return array
     */
    public 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删除分享消息。注意：只能删除自己发布的信息。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/statuses/destroy statuses/destroy}
     *
     * @param int $id 要删除的分享ID
     *
     * @return array
     */
    public function delete($id)
    {
        return $this->destroy($id);
    }

    /**
     * 删除一条分享.
     *
     * 删除分享。注意：只能删除自己发布的信息。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/statuses/destroy statuses/destroy}
     *
     * @param int $id 要删除的分享ID
     *
     * @return array
     */
    public function destroy($id)
    {
        $this->id_format($id);
        $params = array();
        $params['id'] = $id;

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

    /**
     * 发表分享.
     *
     * 发布一条分享信息。
     * <br />注意：lat和long参数需配合使用，用于标记发表分享消息时所在的地理位置，只有用户设置中geo_enabled=true时候地理位置信息才有效。
     * <br />注意：为防止重复提交，当用户发布的分享消息与上次成功发布的分享消息内容一样时，将返回400错误，给出错误提示：“40025:Error: repeated weibo text!“。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/statuses/update statuses/update}
     *
     * @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
     */
    public 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。
     * <br />注意：lat和long参数需配合使用，用于标记发表分享消息时所在的地理位置，只有用户设置中geo_enabled=true时候地理位置信息才有效。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/statuses/upload statuses/upload}
     *
     * @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
     */
    public 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
     */
    public function upload_url_text($status, $url)
    {
        $params = array();
        $params['status'] = $status;
        $params['url'] = $url;

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

    /**
     * 获取表情列表.
     *
     * 返回新浪分享官方所有表情、魔法表情的相关信息。包括短语、表情类型、表情分类，是否热门等。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/emotions emotions}
     *
     * @param string $type     表情类别。"face":普通表情，"ani"：魔法表情，"cartoon"：动漫表情。默认为"face"。可选。
     * @param string $language 语言类别，"cnname"简体，"twname"繁体。默认为"cnname"。可选
     *
     * @return array
     */
    public 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
     */
    public 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
     */
    public 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
     */
    public 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条发送及收到的评论。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/comments/timeline comments/timeline}
     *
     * @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
     */
    public 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
     */
    public 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
     */
    public 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'] = implode(',', $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
     */
    public 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);
    }

    /**
     * 删除当前用户的分享评论信息。
     *
     * 注意：只能删除自己发布的评论，发部分享的用户不可以删除其他人的评论。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/statuses/comment_destroy statuses/comment_destroy}
     *
     * @param int $cid 要删除的评论id
     *
     * @return array
     */
    public function comment_destroy($cid)
    {
        $params = array();
        $params['cid'] = $cid;

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

    /**
     * 根据评论ID批量删除评论.
     *
     * 注意：只能删除自己发布的评论，发部分享的用户不可以删除其他人的评论。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/comments/destroy_batch comments/destroy_batch}
     *
     * @param string $ids 需要删除的评论ID，用半角逗号隔开，最多20个。
     *
     * @return array
     */
    public 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'] = implode(',', $ids);
        } else {
            $params['cids'] = $ids;
        }

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

    /**
     * 回复一条评论.
     *
     * 为防止重复，发布的信息与最后一条评论/回复信息一样话，将会被忽略。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/comments/reply comments/reply}
     *
     * @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
     */
    public 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或昵称返回用户资料，同时也将返回用户的最新发布的分享。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/users/show users/show}
     *
     * @param int $uid 用户UID。
     *
     * @return array
     */
    public 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或昵称返回用户资料，同时也将返回用户的最新发布的分享。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/users/show users/show}
     *
     * @param string $screen_name 用户UID。
     *
     * @return array
     */
    public 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}
     *
     * @param mixed $domain 用户个性域名。例如：lazypeople，而不是http://weibo.com/lazypeople
     *
     * @return array
     */
    public 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
     */
    public 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'] = implode(',', $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
     */
    public function users_show_batch_by_name($screen_name)
    {
        $params = array();
        if (is_array($screen_name) && !empty($screen_name)) {
            $params['screen_name'] = implode(',', $screen_name);
        } else {
            $params['screen_name'] = $screen_name;
        }

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

    /**
     * 获取用户的关注列表.
     *
     * 如果没有提供cursor参数，将只返回最前面的5000个关注id
     * <br />对应API：{@link http://open.weibo.com/wiki/2/friendships/friends friendships/friends}
     *
     * @param int $cursor 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。
     * @param int $count  单页返回的记录条数，默认为50，最大不超过200。
     * @param int $uid    要获取的用户的ID。
     *
     * @return array
     */
    public 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
     * <br />对应API：{@link http://open.weibo.com/wiki/2/friendships/friends friendships/friends}
     *
     * @param int    $cursor      返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。
     * @param int    $count       单页返回的记录条数，默认为50，最大不超过200。
     * @param string $screen_name 要获取的用户的 screen_name
     *
     * @return array
     */
    public 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
     */
    public 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
     **/
    public 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
     **/
    public 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
     * <br />对应API：{@link http://open.weibo.com/wiki/2/friendships/friends/ids friendships/friends/ids}
     *
     * @param int $cursor 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。
     * @param int $count  每次返回的最大记录数（即页面大小），不大于5000, 默认返回500。
     * @param int $uid    要获取的用户 UID，默认为当前用户
     *
     * @return array
     */
    public 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
     * <br />对应API：{@link http://open.weibo.com/wiki/2/friendships/friends/ids friendships/friends/ids}
     *
     * @param int    $cursor      返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。
     * @param int    $count       每次返回的最大记录数（即页面大小），不大于5000, 默认返回500。
     * @param string $screen_name 要获取的用户的 screen_name，默认为当前用户
     *
     * @return array
     */
    public 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
     **/
    public 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'] = implode(',', $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
     **/
    public 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
     **/
    public 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
     **/
    public 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
     **/
    public 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
     **/
    public 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
     **/
    public 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错误
     * <br />对应API：{@link http://open.weibo.com/wiki/2/friendships/show friendships/show}
     *
     * @param mixed $target_id 目标用户UID
     * @param mixed $source_id 源用户UID，可选，默认为当前的用户
     *
     * @return array
     */
    public 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错误
     * <br />对应API：{@link http://open.weibo.com/wiki/2/friendships/show friendships/show}
     *
     * @param mixed $target_name 目标用户的分享昵称
     * @param mixed $source_name 源用户的分享昵称，可选，默认为当前的用户
     *
     * @return array
     */
    public 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。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/friendships/create friendships/create}
     *
     * @param int $uid 要关注的用户UID
     *
     * @return array
     */
    public 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。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/friendships/create friendships/create}
     *
     * @param string $screen_name 要关注的用户昵称
     *
     * @return array
     */
    public 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
     */
    public 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'] = implode(',', $uids);
        } else {
            $params['uids'] = $uids;
        }

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

    /**
     * 取消关注某用户.
     *
     * 取消关注某用户。成功则返回被取消关注人的资料，失败则返回一条字符串的说明。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/friendships/destroy friendships/destroy}
     *
     * @param int $uid 要取消关注的用户UID
     *
     * @return array
     */
    public function unfollow_by_id($uid)
    {
        $params = array();
        $this->id_format($uid);
        $params['uid'] = $uid;

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

    /**
     * 取消关注某用户.
     *
     * 取消关注某用户。成功则返回被取消关注人的资料，失败则返回一条字符串的说明。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/friendships/destroy friendships/destroy}
     *
     * @param string $screen_name 要取消关注的用户昵称
     *
     * @return array
     */
    public function unfollow_by_name($screen_name)
    {
        $params = array();
        $params['screen_name'] = $screen_name;

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

    /**
     * 更新当前登录用户所关注的某个好友的备注信息.
     *
     * 只能修改当前登录用户所关注的用户的备注信息。否则将给出400错误。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/friendships/remark/update friendships/remark/update}
     *
     * @param int    $uid    需要修改备注信息的用户ID。
     * @param string $remark 备注信息。
     *
     * @return array
     */
    public 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条私信，并包含发送者和接受者的详细资料。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/direct_messages direct_messages}
     *
     * @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
     */
    public 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条私信。包括发送者和接受者的详细资料。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/direct_messages/sent direct_messages/sent}
     *
     * @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
     */
    public 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
     */
    public 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
     */
    public 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
     */
    public 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'] = implode(',', $dmids);
        } else {
            $params['dmids'] = $dmids;
        }

        return $this->oauth->get('direct_messages/show_batch', $params);
    }

    /**
     * 发送私信
     *
     * 发送一条私信。成功将返回完整的发送消息。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/direct_messages/new direct_messages/new}
     *
     * @param int    $uid  用户UID
     * @param string $text 要发生的消息内容，文本大小必须小于300个汉字。
     * @param int    $id   需要发送的分享ID。
     *
     * @return array
     */
    public 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);
    }

    /**
     * 发送私信
     *
     * 发送一条私信。成功将返回完整的发送消息。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/direct_messages/new direct_messages/new}
     *
     * @param string $screen_name 用户昵称
     * @param string $text        要发生的消息内容，文本大小必须小于300个汉字。
     * @param int    $id          需要发送的分享ID。
     *
     * @return array
     */
    public 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删除私信。操作用户必须为私信的接收人。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/direct_messages/destroy direct_messages/destroy}
     *
     * @param int $did 要删除的私信主键ID
     *
     * @return array
     */
    public function delete_dm($did)
    {
        $this->id_format($did);
        $params = array();
        $params['id'] = $did;

        return $this->oauth->post('direct_messages/destroy', $params);
    }

    /**
     * 批量删除私信
     *
     * 批量删除当前登录用户的私信。出现异常时，返回400错误。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/direct_messages/destroy_batch direct_messages/destroy_batch}
     *
     * @param mixed $dids 欲删除的一组私信ID，用半角逗号隔开，或者由一组评论ID组成的数组。最多20个。例如："4976494627, 4976262053"或array(4976494627,4976262053);
     *
     * @return array
     */
    public function delete_dms($dids)
    {
        $params = array();
        if (is_array($dids) && !empty($dids)) {
            foreach ($dids as $k => $v) {
                $this->id_format($dids[$k]);
            }
            $params['ids'] = implode(',', $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
     */
    public 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
     */
    public 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
     */
    public 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'] = implode(',', $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
     */
    public 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
     */
    public 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'] = implode(',', $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}
     *
     * @return array
     */
    public 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:
     *                     - province	int		省份范围，省份ID。
     *                     - city		int		城市范围，城市ID。
     *                     - area		int		区域范围，区ID。
     *                     - type		int		学校类型，1：大学、2：高中、3：中专技校、4：初中、5：小学，默认为1。
     *                     - capital	string	学校首字母，默认为A。
     *                     - keyword	string	学校名称关键字。
     *                     - count		int		返回的记录条数，默认为10。
     *                     参数keyword与capital二者必选其一，且只能选其一。按首字母capital查询时，必须提供province参数。
     *
     * @return array
     */
    public 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}
     *
     * @return array
     */
    public 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}
     *
     * @return array
     */
    public 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}
     *
     * @param array $profile 要修改的资料。格式：array('key1'=>'value1', 'key2'=>'value2', .....)。
     *                       支持修改的项：
     *                       - screen_name		string	用户昵称，不可为空。
     *                       - gender	i		string	用户性别，m：男、f：女，不可为空。
     *                       - real_name			string	用户真实姓名。
     *                       - real_name_visible	int		真实姓名可见范围，0：自己可见、1：关注人可见、2：所有人可见。
     *                       - province	true	int		省份代码ID，不可为空。
     *                       - city	true		int		城市代码ID，不可为空。
     *                       - birthday			string	用户生日，格式：yyyy-mm-dd。
     *                       - birthday_visible	int		生日可见范围，0：保密、1：只显示月日、2：只显示星座、3：所有人可见。
     *                       - qq				string	用户QQ号码。
     *                       - qq_visible		int		用户QQ可见范围，0：自己可见、1：关注人可见、2：所有人可见。
     *                       - msn				string	用户MSN。
     *                       - msn_visible		int		用户MSN可见范围，0：自己可见、1：关注人可见、2：所有人可见。
     *                       - url				string	用户知识地址。
     *                       - url_visible		int		用户知识地址可见范围，0：自己可见、1：关注人可见、2：所有人可见。
     *                       - credentials_type	int		证件类型，1：身份证、2：学生证、3：军官证、4：护照。
     *                       - credentials_num	string	证件号码。
     *                       - email				string	用户常用邮箱地址。
     *                       - email_visible		int		用户常用邮箱地址可见范围，0：自己可见、1：关注人可见、2：所有人可见。
     *                       - lang				string	语言版本，zh_cn：简体中文、zh_tw：繁体中文。
     *                       - description		string	用户描述，最长不超过70个汉字。
     *                       填写birthday参数时，做如下约定：
     *                       - 只填年份时，采用1986-00-00格式；
     *                       - 只填月份时，采用0000-08-00格式；
     *                       - 只填某日时，采用0000-00-28格式。
     *
     * @return array
     */
    public 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}
     *
     * @param array $edu_update 要修改的学校信息。格式：array('key1'=>'value1', 'key2'=>'value2', .....)。
     *                          支持设置的项：
     *                          - type			int		学校类型，1：大学、2：高中、3：中专技校、4：初中、5：小学，默认为1。必填参数
     *                          - school_id	`	int		学校代码，必填参数
     *                          - id			string	需要修改的教育信息ID，不传则为新建，传则为更新。
     *                          - year			int		入学年份，最小为1900，最大不超过当前年份
     *                          - department	string	院系或者班别。
     *                          - visible		int		开放等级，0：仅自己可见、1：关注的人可见、2：所有人可见。
     *
     * @return array
     */
    public 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
     */
    public 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', .....)。
     *                          支持设置的项：
     *                          - id			string	需要更新的职业信息ID。
     *                          - start			int		进入公司年份，最小为1900，最大为当年年份。
     *                          - end			int		离开公司年份，至今填0。
     *                          - department	string	工作部门。
     *                          - visible		int		可见范围，0：自己可见、1：关注人可见、2：所有人可见。
     *                          - province		int		省份代码ID，不可为空值。
     *                          - city			int		城市代码ID，不可为空值。
     *                          - company		string	公司名称，不可为空值。
     *                          参数province与city二者必选其一<br />
     *                          参数id为空，则为新建职业信息，参数company变为必填项，参数id非空，则为更新，参数company可选
     *
     * @return array
     */
    public 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}
     *
     * @param int $id 职业信息里的公司ID
     *
     * @return array
     */
    public 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
     */
    public 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', .....)。
     *                                支持设置的项：
     *                                - comment	int	是否可以评论我的分享，0：所有人、1：关注的人，默认为0。
     *                                - geo		int	是否开启地理信息，0：不开启、1：开启，默认为1。
     *                                - message	int	是否可以给我发私信，0：所有人、1：关注的人，默认为0。
     *                                - realname	int	是否可以通过真名搜索到我，0：不可以、1：可以，默认为0。
     *                                - badge		int	勋章是否可见，0：不可见、1：可见，默认为1。
     *                                - mobile	int	是否可以通过手机号码搜索到我，0：不可以、1：可以，默认为0。
     *                                以上参数全部选填
     *
     * @return array
     */
    public function update_privacy($privacy_settings)
    {
        return $this->oauth->post('account/update_privacy', $privacy_settings);
    }

    /**
     * 获取当前用户的收藏列表.
     *
     * 返回用户的发布的最近20条收藏信息，和用户收藏页面返回内容是一致的。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/favorites favorites}
     *
     * @param int $page  返回结果的页码，默认为1。
     * @param int $count 单页返回的记录条数，默认为50。
     *
     * @return array
     */
    public 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获取指定的收藏信息。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/favorites/show favorites/show}
     *
     * @param int $id 需要查询的收藏ID。
     *
     * @return array
     */
    public 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
     */
    public 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}
     *
     * @param int $count 单页返回的记录条数，默认为50。
     * @param int $page  返回结果的页码，默认为1。
     *
     * @return array
     */
    public 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}
     *
     * @param int $sid 收藏的分享id
     *
     * @return array
     */
    public 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}
     *
     * @param int $id 要删除的收藏分享信息ID.
     *
     * @return array
     */
    public function remove_from_favorites($id)
    {
        $this->id_format($id);
        $params = array();
        $params['id'] = $id;

        return $this->oauth->post('favorites/destroy', $params);
    }

    /**
     * 批量删除分享收藏。
     *
     * 批量删除当前登录用户的收藏。出现异常时，返回HTTP400错误。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/favorites/destroy_batch favorites/destroy_batch}
     *
     * @param mixed $fids 欲删除的一组私信ID，用半角逗号隔开，或者由一组评论ID组成的数组。最多20个。例如："231101027525486630,201100826122315375"或array(231101027525486630,201100826122315375);
     *
     * @return array
     */
    public 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'] = implode(',', $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}
     *
     * @param int    $id   需要更新的收藏ID。
     * @param string $tags 需要更新的标签内容，用半角逗号分隔，最多不超过2条。
     *
     * @return array
     */
    public 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'] = implode(',', $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
     */
    public function favorites_update_batch($tid, $tag)
    {
        $params = array();
        $params['tid'] = $tid;
        $params['tag'] = $tag;

        return $this->oauth->post('favorites/tags/update_batch', $params);
    }

    /**
     * 删除当前登录用户所有收藏下的指定标签.
     *
     * 删除标签后，该用户所有收藏中，添加了该标签的收藏均解除与该标签的关联关系
     * <br />对应API：{@link http://open.weibo.com/wiki/2/favorites/tags/destroy_batch favorites/tags/destroy_batch}
     *
     * @param int $tid 需要更新的标签ID。必填
     *
     * @return array
     */
    public 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
     */
    public 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}
     *
     * @param string $trend_name 话题关键字。
     *
     * @return array
     */
    public 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
     */
    public 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
     */
    public 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}
     *
     * @param int $base_app 是否基于当前应用来获取数据。1表示基于当前应用来获取数据，默认为0。可选。
     *
     * @return array
     */
    public 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}
     *
     * @param string $trend_name 要关注的话题关键词。
     *
     * @return array
     */
    public 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}
     *
     * @param int $tid 要取消关注的话题ID。
     *
     * @return array
     */
    public 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
     */
    public 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
     */
    public 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'] = implode(',', $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}
     *
     * @param int $count 单页大小。缺省值10，最大值10。可选。
     *
     * @return array
     */
    public 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}
     *
     * @param mixed $tags 要创建的一组标签，每个标签的长度不可超过7个汉字，14个半角字符。多个标签之间用逗号间隔，或由多个标签构成的数组。如："abc,drf,efgh,tt"或array("abc", "drf", "efgh", "tt")
     *
     * @return array
     */
    public function add_tags($tags)
    {
        $params = array();
        if (is_array($tags) && !empty($tags)) {
            $params['tags'] = implode(',', $tags);
        } else {
            $params['tags'] = $tags;
        }

        return $this->oauth->post('tags/create', $params);
    }

    /**
     * 删除标签.
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/tags/destroy tags/destroy}
     *
     * @param int $tag_id 标签ID，必填参数
     *
     * @return array
     */
    public 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}
     *
     * @param mixed $ids 必选参数，要删除的tag id，多个id用半角逗号分割，最多10个。或由多个tag id构成的数组。如：“553,554,555"或array(553, 554, 555)
     *
     * @return array
     */
    public function delete_tags($ids)
    {
        $params = array();
        if (is_array($ids) && !empty($ids)) {
            $params['ids'] = implode(',', $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
     */
    public 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
     */
    public 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
     */
    public 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
     */
    public 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
     */
    public 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
     */
    public 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:
     *                     - q				string	搜索的关键字，必须进行URLencode。
     *                     - filter_ori	int		过滤器，是否为原创，0：全部、1：原创、2：转发，默认为0。
     *                     - filter_pic	int		过滤器。是否包含图片，0：全部、1：包含、2：不包含，默认为0。
     *                     - fuid			int		搜索的分享作者的用户UID。
     *                     - province		int		搜索的省份范围，省份ID。
     *                     - city			int		搜索的城市范围，城市ID。
     *                     - starttime		int		开始时间，Unix时间戳。
     *                     - endtime		int		结束时间，Unix时间戳。
     *                     - count			int		单页返回的记录条数，默认为10。
     *                     - page			int		返回结果的页码，默认为1。
     *                     - needcount		boolean	返回结果中是否包含返回记录数，true：返回、false：不返回，默认为false。
     *                     - base_app		int		是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。
     *                     needcount参数不同，会导致相应的返回值结构不同
     *                     以上参数全部选填
     *
     * @return array
     */
    public 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:
     *                     - q			string	搜索的关键字，必须进行URLencode。
     *                     - snick		int		搜索范围是否包含昵称，0：不包含、1：包含。
     *                     - sdomain	int		搜索范围是否包含个性域名，0：不包含、1：包含。
     *                     - sintro	int		搜索范围是否包含简介，0：不包含、1：包含。
     *                     - stag		int		搜索范围是否包含标签，0：不包含、1：包含。
     *                     - province	int		搜索的省份范围，省份ID。
     *                     - city		int		搜索的城市范围，城市ID。
     *                     - gender	string	搜索的性别范围，m：男、f：女。
     *                     - comorsch	string	搜索的公司学校名称。
     *                     - sort		int		排序方式，1：按更新时间、2：按粉丝数，默认为1。
     *                     - count		int		单页返回的记录条数，默认为10。
     *                     - page		int		返回结果的页码，默认为1。
     *                     - base_app	int		是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。
     *                     以上所有参数全部选填
     *
     * @return array
     */
    public function search_users_keywords($query)
    {
        return $this->oauth->get('search/users', $query);
    }

    /**
     * 获取系统推荐用户.
     *
     * 返回系统推荐的用户列表。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/suggestions/users/hot suggestions/users/hot}
     *
     * @param string $category 分类，可选参数，返回某一类别的推荐用户，默认为 default。如果不在以下分类中，返回空列表：<br />
     *                         - default:人气关注
     *                         - ent:影视名星
     *                         - hk_famous:港台名人
     *                         - model:模特
     *                         - cooking:美食&健康
     *                         - sport:体育名人
     *                         - finance:商界名人
     *                         - tech:IT互联网
     *                         - singer:歌手
     *                         - writer：作家
     *                         - moderator:主持人
     *                         - medium:媒体总编
     *                         - stockplayer:炒股高手
     *
     * @return array
     */
    public 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}
     *
     * @param int $page  返回结果的页码，默认为1。
     * @param int $count 单页返回的记录条数，默认为10。
     *
     * @return array
     * @ignore
     */
    public 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}
     *
     * @param string $content 分享正文内容。
     * @param int    $num     返回结果数目，默认为10。
     *
     * @return array
     */
    public 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
     */
    public 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
     */
    public 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);
        }
    }
}
