1:    2:    3:    4:    5:    6:    7:    8:    9:   10:   11:   12:   13:   14:   15:   16:   17:   18:   19:   20:   21:   22:   23:   24:   25:   26:   27:   28:   29:   30:   31:   32:   33:   34:   35:   36:   37:   38:   39:   40:   41:   42:   43:   44:   45:   46:   47:   48:   49:   50:   51:   52:   53:   54:   55:   56:   57:   58:   59:   60:   61:   62:   63:   64:   65:   66:   67:   68:   69:   70:   71:   72:   73:   74:   75:   76:   77:   78:   79:   80:   81:   82:   83:   84:   85:   86:   87:   88:   89:   90:   91:   92:   93:   94:   95:   96:   97:   98:   99:  100:  101:  102:  103:  104:  105:  106:  107:  108:  109:  110:  111:  112:  113:  114:  115:  116:  117:  118:  119:  120:  121:  122:  123:  124:  125:  126:  127:  128:  129:  130:  131:  132:  133:  134:  135:  136:  137:  138:  139:  140:  141:  142:  143:  144:  145:  146:  147:  148:  149:  150:  151:  152:  153:  154:  155:  156:  157:  158:  159:  160:  161:  162:  163:  164:  165:  166:  167:  168:  169:  170:  171:  172:  173:  174:  175:  176:  177:  178:  179:  180:  181:  182:  183:  184:  185:  186:  187:  188:  189:  190:  191:  192:  193:  194:  195:  196:  197:  198:  199:  200:  201:  202:  203:  204:  205:  206:  207:  208:  209:  210:  211:  212:  213:  214:  215:  216:  217:  218:  219:  220:  221:  222:  223:  224:  225:  226:  227:  228:  229:  230:  231:  232:  233:  234:  235:  236:  237:  238:  239:  240:  241:  242:  243:  244:  245:  246:  247:  248:  249:  250:  251:  252:  253:  254:  255:  256:  257:  258:  259:  260:  261:  262:  263:  264:  265:  266:  267:  268:  269:  270:  271:  272:  273:  274:  275:  276:  277:  278:  279:  280:  281:  282:  283:  284:  285:  286:  287:  288:  289:  290:  291:  292:  293:  294:  295:  296:  297:  298:  299:  300:  301:  302:  303:  304:  305:  306:  307:  308:  309:  310:  311:  312:  313:  314:  315:  316:  317:  318:  319:  320:  321:  322:  323:  324:  325:  326:  327:  328:  329:  330:  331:  332:  333:  334:  335:  336:  337:  338:  339:  340:  341:  342:  343:  344:  345:  346:  347:  348:  349:  350:  351:  352:  353:  354:  355:  356:  357:  358:  359:  360:  361:  362:  363:  364:  365:  366:  367:  368:  369:  370:  371:  372:  373:  374:  375:  376:  377:  378:  379:  380:  381:  382:  383:  384:  385:  386:  387:  388:  389:  390:  391:  392:  393:  394:  395:  396:  397:  398:  399:  400:  401:  402:  403:  404:  405:  406:  407:  408:  409:  410:  411:  412:  413:  414:  415:  416:  417:  418:  419:  420:  421:  422:  423:  424:  425:  426:  427:  428:  429:  430:  431:  432:  433:  434:  435:  436:  437:  438:  439:  440:  441:  442:  443:  444:  445:  446:  447:  448:  449:  450:  451:  452:  453:  454:  455:  456:  457:  458:  459:  460:  461:  462:  463:  464:  465:  466:  467:  468:  469:  470:  471:  472:  473:  474:  475:  476:  477:  478:  479:  480:  481:  482:  483:  484:  485:  486:  487:  488:  489:  490:  491:  492:  493:  494:  495:  496:  497:  498:  499:  500:  501:  502:  503:  504:  505:  506:  507:  508:  509:  510:  511:  512:  513:  514:  515:  516:  517:  518:  519:  520:  521:  522:  523:  524:  525:  526:  527:  528:  529:  530:  531:  532:  533:  534:  535:  536:  537:  538:  539:  540:  541:  542:  543:  544:  545:  546:  547:  548:  549:  550:  551:  552:  553:  554:  555:  556:  557:  558:  559:  560:  561:  562:  563:  564:  565:  566:  567:  568:  569:  570:  571:  572:  573:  574:  575:  576:  577:  578:  579:  580:  581:  582:  583:  584:  585:  586:  587:  588:  589:  590:  591:  592:  593:  594:  595:  596:  597:  598:  599:  600:  601:  602:  603:  604:  605:  606:  607:  608:  609:  610:  611:  612:  613:  614:  615:  616:  617:  618:  619:  620:  621:  622:  623:  624:  625:  626:  627:  628:  629:  630:  631:  632:  633:  634:  635:  636:  637:  638:  639:  640:  641:  642:  643:  644:  645:  646:  647:  648:  649:  650:  651:  652:  653:  654:  655:  656:  657:  658:  659:  660:  661:  662:  663:  664:  665:  666:  667:  668:  669:  670:  671:  672:  673:  674:  675:  676:  677:  678:  679:  680:  681:  682:  683:  684:  685:  686:  687:  688:  689:  690:  691:  692:  693:  694:  695:  696:  697:  698:  699:  700:  701:  702:  703:  704:  705:  706:  707:  708:  709:  710:  711:  712:  713:  714:  715:  716:  717:  718:  719:  720:  721:  722:  723:  724:  725:  726:  727:  728:  729:  730:  731:  732:  733:  734:  735:  736:  737:  738:  739:  740:  741:  742:  743:  744:  745:  746:  747:  748:  749:  750:  751:  752:  753:  754:  755:  756:  757:  758:  759:  760:  761:  762:  763:  764:  765:  766:  767:  768:  769:  770:  771:  772:  773:  774:  775:  776:  777:  778:  779:  780:  781:  782:  783:  784:  785:  786:  787:  788:  789:  790:  791:  792:  793:  794:  795:  796:  797:  798:  799:  800:  801:  802:  803:  804:  805:  806:  807:  808:  809:  810:  811:  812:  813:  814:  815:  816:  817:  818:  819:  820:  821:  822:  823:  824:  825:  826:  827:  828:  829:  830:  831:  832:  833:  834:  835:  836:  837:  838:  839:  840:  841:  842:  843:  844:  845:  846:  847:  848:  849:  850:  851:  852:  853:  854:  855:  856:  857:  858:  859:  860:  861:  862:  863:  864:  865:  866:  867:  868:  869:  870:  871:  872:  873:  874:  875:  876:  877:  878:  879:  880:  881:  882:  883:  884:  885:  886:  887:  888:  889:  890:  891:  892:  893:  894:  895:  896:  897:  898:  899:  900:  901:  902:  903:  904:  905:  906:  907:  908:  909:  910:  911:  912:  913:  914:  915:  916:  917:  918:  919:  920:  921:  922:  923:  924:  925:  926:  927:  928:  929:  930:  931:  932:  933:  934:  935:  936:  937:  938:  939:  940:  941:  942:  943:  944:  945:  946:  947:  948:  949:  950:  951:  952:  953:  954:  955:  956:  957:  958:  959:  960:  961:  962:  963:  964:  965:  966:  967:  968:  969:  970:  971:  972:  973:  974:  975:  976:  977:  978:  979:  980:  981:  982:  983:  984:  985:  986:  987:  988:  989:  990:  991:  992:  993:  994:  995:  996:  997:  998:  999: 1000: 1001: 1002: 1003: 1004: 1005: 1006: 1007: 1008: 1009: 1010: 1011: 1012: 1013: 1014: 1015: 1016: 1017: 1018: 1019: 1020: 1021: 1022: 1023: 1024: 1025: 1026: 1027: 1028: 1029: 1030: 1031: 1032: 1033: 1034: 1035: 1036: 1037: 1038: 1039: 1040: 1041: 1042: 1043: 1044: 1045: 1046: 1047: 1048: 1049: 1050: 1051: 1052: 1053: 1054: 1055: 1056: 1057: 1058: 1059: 1060: 1061: 1062: 1063: 1064: 1065: 1066: 1067: 1068: 1069: 1070: 1071: 1072: 1073: 1074: 1075: 1076: 1077: 1078: 1079: 1080: 1081: 1082: 1083: 1084: 1085: 1086: 1087: 1088: 1089: 1090: 1091: 1092: 1093: 1094: 1095: 1096: 1097: 1098: 1099: 1100: 1101: 1102: 1103: 1104: 1105: 1106: 1107: 1108: 1109: 1110: 1111: 1112: 1113: 1114: 1115: 1116: 1117: 1118: 1119: 1120: 1121: 1122: 1123: 1124: 1125: 1126: 1127: 1128: 1129: 1130: 1131: 1132: 1133: 1134: 1135: 1136: 1137: 1138: 1139: 1140: 1141: 1142: 1143: 1144: 1145: 1146: 1147: 1148: 1149: 1150: 1151: 1152: 1153: 1154: 1155: 1156: 1157: 1158: 1159: 1160: 1161: 1162: 1163: 1164: 1165: 1166: 1167: 1168: 1169: 1170: 1171: 1172: 1173: 1174: 1175: 1176: 1177: 1178: 1179: 1180: 1181: 1182: 1183: 1184: 1185: 1186: 1187: 1188: 1189: 1190: 1191: 1192: 1193: 1194: 1195: 1196: 1197: 1198: 1199: 1200: 1201: 1202: 1203: 1204: 1205: 1206: 1207: 1208: 1209: 1210: 1211: 1212: 1213: 1214: 1215: 1216: 1217: 1218: 1219: 1220: 1221: 1222: 1223: 1224: 1225: 1226: 1227: 1228: 1229: 1230: 1231: 1232: 1233: 1234: 1235: 1236: 1237: 1238: 1239: 1240: 1241: 1242: 1243: 1244: 1245: 1246: 1247: 1248: 1249: 1250: 1251: 1252: 1253: 1254: 1255: 1256: 1257: 1258: 1259: 1260: 1261: 1262: 1263: 1264: 1265: 1266: 1267: 1268: 1269: 1270: 1271: 1272: 1273: 1274: 1275: 1276: 1277: 1278: 1279: 1280: 1281: 1282: 1283: 1284: 1285: 1286: 1287: 1288: 1289: 1290: 1291: 1292: 1293: 1294: 1295: 1296: 1297: 1298: 1299: 1300: 1301: 1302: 1303: 1304: 1305: 1306: 1307: 1308: 1309: 1310: 1311: 1312: 1313: 1314: 1315: 1316: 1317: 1318: 1319: 1320: 1321: 1322: 1323: 1324: 1325: 1326: 1327: 1328: 1329: 1330: 1331: 1332: 1333: 1334: 1335: 1336: 1337: 1338: 1339: 1340: 1341: 1342: 1343: 1344: 1345: 1346: 1347: 1348: 1349: 1350: 1351: 1352: 1353: 1354: 1355: 1356: 1357: 1358: 1359: 1360: 1361: 1362: 1363: 1364: 1365: 1366: 1367: 1368: 1369: 1370: 1371: 1372: 1373: 1374: 1375: 1376: 1377: 1378: 1379: 1380: 1381: 1382: 1383: 1384: 1385: 1386: 1387: 1388: 1389: 1390: 1391: 1392: 1393: 1394: 1395: 1396: 1397: 1398: 1399: 1400: 1401: 1402: 1403: 1404: 1405: 1406: 1407: 1408: 1409: 1410: 1411: 1412: 1413: 1414: 1415: 1416: 1417: 1418: 1419: 1420: 1421: 1422: 1423: 1424: 1425: 1426: 1427: 1428: 1429: 1430: 1431: 1432: 1433: 1434: 1435: 1436: 1437: 1438: 1439: 1440: 1441: 1442: 1443: 1444: 1445: 1446: 1447: 1448: 1449: 1450: 1451: 1452: 1453: 1454: 1455: 1456: 1457: 1458: 1459: 1460: 1461: 1462: 1463: 1464: 1465: 1466: 1467: 1468: 1469: 1470: 1471: 1472: 1473: 1474: 1475: 1476: 1477: 1478: 1479: 1480: 1481: 1482: 1483: 1484: 1485: 1486: 1487: 1488: 1489: 1490: 1491: 1492: 1493: 1494: 1495: 1496: 1497: 1498: 1499: 1500: 1501: 1502: 1503: 1504: 1505: 1506: 1507: 1508: 1509: 1510: 1511: 1512: 1513: 1514: 1515: 1516: 1517: 1518: 1519: 1520: 1521: 1522: 1523: 1524: 1525: 1526: 1527: 1528: 1529: 1530: 1531: 1532: 1533: 1534: 1535: 1536: 1537: 1538: 1539: 1540: 1541: 1542: 1543: 1544: 1545: 1546: 1547: 1548: 1549: 1550: 1551: 1552: 1553: 1554: 1555: 1556: 1557: 1558: 1559: 1560: 1561: 1562: 1563: 1564: 1565: 1566: 1567: 1568: 1569: 1570: 1571: 1572: 1573: 1574: 1575: 1576: 1577: 1578: 1579: 1580: 1581: 1582: 1583: 1584: 1585: 1586: 1587: 1588: 1589: 1590: 1591: 1592: 1593: 1594: 1595: 1596: 1597: 1598: 1599: 1600: 1601: 1602: 1603: 1604: 1605: 1606: 1607: 1608: 1609: 1610: 1611: 1612: 1613: 1614: 1615: 1616: 1617: 1618: 1619: 1620: 1621: 1622: 1623: 1624: 1625: 1626: 1627: 1628: 1629: 1630: 1631: 1632: 1633: 1634: 1635: 1636: 1637: 1638: 1639: 1640: 1641: 1642: 1643: 1644: 1645: 1646: 1647: 1648: 1649: 1650: 1651: 1652: 1653: 1654: 1655: 1656: 1657: 1658: 1659: 1660: 1661: 1662: 1663: 1664: 1665: 1666: 1667: 1668: 1669: 1670: 1671: 1672: 1673: 1674: 1675: 1676: 1677: 1678: 1679: 1680: 1681: 1682: 1683: 1684: 1685: 1686: 1687: 1688: 1689: 1690: 1691: 1692: 1693: 1694: 1695: 1696: 1697: 1698: 1699: 1700: 1701: 1702: 1703: 1704: 1705: 1706: 1707: 1708: 1709: 1710: 1711: 1712: 1713: 1714: 1715: 1716: 1717: 1718: 1719: 1720: 1721: 1722: 1723: 1724: 1725: 1726: 1727: 1728: 1729: 1730: 1731: 1732: 1733: 1734: 1735: 1736: 1737: 1738: 1739: 1740: 1741: 1742: 1743: 1744: 1745: 1746: 1747: 1748: 1749: 1750: 1751: 1752: 1753: 1754: 1755: 1756: 1757: 1758: 1759: 1760: 1761: 1762: 1763: 1764: 1765: 1766: 1767: 1768: 1769: 1770: 1771: 1772: 1773: 1774: 1775: 1776: 1777: 1778: 1779: 1780: 1781: 1782: 1783: 1784: 1785: 1786: 1787: 1788: 1789: 1790: 1791: 1792: 1793: 1794: 1795: 1796: 1797: 1798: 1799: 1800: 1801: 1802: 1803: 1804: 1805: 1806: 1807: 1808: 1809: 1810: 1811: 1812: 1813: 1814: 1815: 1816: 1817: 1818: 1819: 1820: 1821: 1822: 1823: 1824: 1825: 1826: 1827: 1828: 1829: 1830: 1831: 1832: 1833: 1834: 1835: 1836: 1837: 1838: 1839: 1840: 1841: 1842: 1843: 1844: 1845: 1846: 1847: 1848: 1849: 1850: 1851: 1852: 1853: 1854: 1855: 1856: 1857: 1858: 1859: 1860: 1861: 1862: 1863: 1864: 1865: 1866: 1867: 1868: 1869: 1870: 1871: 1872: 1873: 1874: 1875: 1876: 1877: 1878: 1879: 1880: 1881: 1882: 1883: 1884: 1885: 1886: 1887: 1888: 1889: 1890: 1891: 1892: 1893: 1894: 1895: 1896: 1897: 1898: 1899: 1900: 1901: 1902: 1903: 1904: 1905: 1906: 1907: 1908: 1909: 1910: 1911: 1912: 1913: 1914: 1915: 1916: 1917: 1918: 1919: 1920: 1921: 1922: 1923: 1924: 1925: 1926: 1927: 1928: 1929: 1930: 1931: 1932: 1933: 1934: 1935: 1936: 1937: 1938: 1939: 1940: 1941: 1942: 1943: 1944: 1945: 1946: 1947: 1948: 1949: 1950: 1951: 1952: 1953: 1954: 1955: 1956: 1957: 1958: 1959: 1960: 1961: 1962: 1963: 1964: 1965: 1966: 1967: 1968: 1969: 1970: 1971: 1972: 1973: 1974: 1975: 1976: 1977: 1978: 1979: 1980: 1981: 1982: 1983: 1984: 1985: 1986: 1987: 1988: 1989: 1990: 1991: 1992: 1993: 1994: 1995: 1996: 1997: 1998: 1999: 2000: 2001: 2002: 2003: 2004: 2005: 2006: 2007: 2008: 2009: 2010: 2011: 2012: 2013: 2014: 2015: 2016: 2017: 2018: 2019: 2020: 2021: 2022: 2023: 2024: 2025: 2026: 2027: 2028: 2029: 2030: 2031: 2032: 2033: 2034: 2035: 2036: 2037: 2038: 2039: 2040: 2041: 2042: 2043: 2044: 2045: 2046: 2047: 2048: 2049: 2050: 2051: 2052: 2053: 2054: 2055: 2056: 2057: 2058: 2059: 2060: 2061: 2062: 2063: 2064: 2065: 2066: 2067: 2068: 2069: 2070: 2071: 2072: 2073: 2074: 2075: 2076: 2077: 2078: 2079: 2080: 2081: 2082: 2083: 2084: 2085: 2086: 2087: 2088: 2089: 2090: 2091: 2092: 2093: 2094: 2095: 2096: 2097: 2098: 2099: 2100: 2101: 2102: 2103: 2104: 2105: 2106: 2107: 2108: 2109: 2110: 2111: 2112: 2113: 2114: 2115: 2116: 2117: 2118: 2119: 2120: 2121: 2122: 2123: 2124: 2125: 2126: 2127: 2128: 2129: 2130: 2131: 2132: 2133: 2134: 2135: 2136: 2137: 2138: 2139: 2140: 2141: 2142: 2143: 2144: 2145: 2146: 2147: 2148: 2149: 2150: 2151: 2152: 2153: 2154: 2155: 2156: 2157: 2158: 2159: 2160: 2161: 2162: 2163: 2164: 2165: 2166: 2167: 2168: 2169: 2170: 2171: 2172: 2173: 2174: 2175: 2176: 2177: 2178: 2179: 2180: 2181: 2182: 2183: 2184: 2185: 2186: 2187: 2188: 2189: 2190: 2191: 2192: 2193: 2194: 2195: 2196: 2197: 2198: 2199: 2200: 2201: 2202: 2203: 2204: 2205: 2206: 2207: 2208: 2209: 2210: 2211: 2212: 2213: 2214: 2215: 2216: 2217: 2218: 2219: 2220: 2221: 2222: 2223: 2224: 2225: 2226: 2227: 2228: 2229: 2230: 2231: 2232: 2233: 2234: 2235: 2236: 2237: 2238: 2239: 2240: 2241: 2242: 2243: 2244: 2245: 2246: 2247: 2248: 2249: 2250: 2251: 2252: 2253: 2254: 2255: 2256: 2257: 2258: 2259: 2260: 2261: 2262: 2263: 2264: 2265: 2266: 2267: 2268: 2269: 2270: 2271: 2272: 2273: 2274: 2275: 2276: 2277: 2278: 2279: 2280: 2281: 2282: 2283: 2284: 2285: 2286: 2287: 2288: 2289: 2290: 2291: 2292: 2293: 2294: 2295: 2296: 2297: 2298: 2299: 2300: 2301: 2302: 2303: 2304: 2305: 2306: 2307: 2308: 2309: 2310: 2311: 2312: 2313: 2314: 2315: 2316: 2317: 2318: 2319: 2320: 2321: 2322: 2323: 2324: 2325: 2326: 2327: 2328: 2329: 2330: 2331: 2332: 2333: 2334: 2335: 2336: 2337: 2338: 2339: 2340: 2341: 2342: 2343: 2344: 2345: 2346: 2347: 2348: 2349: 2350: 2351: 2352: 2353: 2354: 2355: 2356: 2357: 2358: 2359: 2360: 2361: 2362: 2363: 2364: 2365: 2366: 2367: 2368: 2369: 2370: 2371: 2372: 2373: 2374: 2375: 2376: 2377: 2378: 2379: 2380: 2381: 2382: 2383: 2384: 2385: 2386: 2387: 2388: 2389: 2390: 2391: 2392: 2393: 2394: 2395: 2396: 2397: 2398: 2399: 2400: 2401: 2402: 2403: 2404: 2405: 2406: 2407: 2408: 2409: 2410: 2411: 2412: 2413: 2414: 2415: 2416: 2417: 2418: 2419: 2420: 2421: 2422: 2423: 2424: 2425: 2426: 2427: 2428: 2429: 2430: 2431: 2432: 2433: 2434: 2435: 2436: 2437: 2438: 2439: 2440: 2441: 2442: 2443: 2444: 2445: 2446: 2447: 2448: 2449: 2450: 2451: 2452: 2453: 2454: 2455: 2456: 2457: 2458: 2459: 2460: 2461: 2462: 2463: 2464: 2465: 2466: 2467: 2468: 2469: 2470: 2471: 2472: 2473: 2474: 2475: 2476: 2477: 2478: 2479: 2480: 2481: 2482: 2483: 2484: 2485: 2486: 2487: 2488: 2489: 2490: 2491: 2492: 2493: 2494: 2495: 2496: 2497: 2498: 2499: 2500: 2501: 2502: 2503: 2504: 2505: 2506: 2507: 2508: 2509: 2510: 2511: 2512: 2513: 2514: 2515: 2516: 2517: 2518: 2519: 2520: 2521: 2522: 2523: 2524: 2525: 2526: 2527: 2528: 2529: 2530: 2531: 2532: 2533: 2534: 2535: 2536: 2537: 2538: 2539: 2540: 2541: 2542: 2543: 2544: 2545: 2546: 2547: 2548: 2549: 2550: 2551: 2552: 2553: 2554: 2555: 2556: 2557: 2558: 2559: 2560: 2561: 2562: 2563: 2564: 2565: 2566: 2567: 2568: 2569: 2570: 2571: 2572: 2573: 2574: 2575: 2576: 2577: 2578: 2579: 2580: 2581: 2582: 2583: 2584: 2585: 2586: 2587: 2588: 2589: 2590: 2591: 2592: 2593: 2594: 2595: 2596: 2597: 2598: 2599: 2600: 2601: 2602: 2603: 2604: 2605: 2606: 2607: 2608: 2609: 2610: 2611: 2612: 2613: 2614: 2615: 2616: 2617: 2618: 2619: 2620: 2621: 2622: 2623: 2624: 2625: 2626: 2627: 2628: 2629: 2630: 2631: 2632: 2633: 2634: 2635: 2636: 2637: 2638: 2639: 2640: 2641: 2642: 2643: 2644: 2645: 2646: 2647: 2648: 2649: 2650: 2651: 2652: 2653: 2654: 2655: 2656: 2657: 2658: 2659: 2660: 2661: 2662: 2663: 2664: 2665: 2666: 2667: 2668: 2669: 2670: 2671: 2672: 2673: 2674: 2675: 2676: 2677: 2678: 2679: 2680: 2681: 2682: 2683: 2684: 2685: 2686: 2687: 2688: 2689: 2690: 2691: 2692: 2693: 2694: 2695: 2696: 2697: 2698: 2699: 2700: 2701: 2702: 2703: 2704: 2705: 2706: 2707: 2708: 2709: 2710: 2711: 2712: 2713: 2714: 2715: 2716: 2717: 2718: 2719: 2720: 2721: 2722: 2723: 2724: 2725: 2726: 2727: 2728: 2729: 2730: 2731: 2732: 2733: 2734: 2735: 2736: 2737: 2738: 2739: 2740: 2741: 2742: 2743: 2744: 2745: 2746: 2747: 2748: 2749: 2750: 2751: 2752: 2753: 2754: 2755: 2756: 2757: 2758: 2759: 2760: 2761: 2762: 2763: 2764: 2765: 2766: 2767: 2768: 2769: 2770: 2771: 2772: 2773: 2774: 2775: 2776: 2777: 2778: 2779: 2780: 2781: 2782: 2783: 2784: 2785: 2786: 2787: 2788: 2789: 2790: 2791: 2792: 2793: 2794: 2795: 2796: 2797: 2798: 2799: 2800: 2801: 2802: 2803: 2804: 2805: 2806: 2807: 2808: 2809: 2810: 2811: 2812: 2813: 2814: 2815: 2816: 2817: 2818: 2819: 2820: 2821: 2822: 2823: 2824: 2825: 2826: 2827: 2828: 2829: 2830: 2831: 2832: 2833: 2834: 2835: 2836: 2837: 2838: 2839: 2840: 2841: 2842: 2843: 2844: 2845: 2846: 2847: 2848: 2849: 2850: 2851: 2852: 2853: 2854: 2855: 2856: 2857: 2858: 2859: 2860: 2861: 2862: 2863: 2864: 2865: 2866: 2867: 2868: 2869: 2870: 2871: 2872: 2873: 2874: 2875: 2876: 2877: 2878: 2879: 2880: 2881: 2882: 2883: 2884: 2885: 2886: 2887: 2888: 2889: 2890: 2891: 2892: 2893: 2894: 2895: 2896: 2897: 2898: 2899: 2900: 2901: 2902: 2903: 2904: 2905: 2906: 2907: 2908: 2909: 2910: 2911: 2912: 2913: 2914: 2915: 2916: 2917: 2918: 2919: 2920: 2921: 2922: 2923: 2924: 2925: 2926: 2927: 2928: 2929: 2930: 2931: 2932: 2933: 2934: 2935: 2936: 2937: 2938: 2939: 2940: 2941: 2942: 2943: 2944: 2945: 2946: 2947: 2948: 2949: 2950: 2951: 2952: 2953: 2954: 2955: 2956: 2957: 2958: 2959: 2960: 2961: 2962: 2963: 2964: 2965: 2966: 2967: 2968: 2969: 2970: 2971: 2972: 2973: 2974: 2975: 2976: 2977: 2978: 2979: 2980: 2981: 2982: 2983: 2984: 2985: 2986: 2987: 2988: 2989: 2990: 2991: 2992: 2993: 2994: 2995: 2996: 2997: 2998: 2999: 3000: 3001: 3002: 3003: 3004: 3005: 3006: 3007: 3008: 3009: 3010: 3011: 3012: 3013: 3014: 3015: 3016: 3017: 3018: 3019: 3020: 3021: 3022: 3023: 3024: 3025: 3026: 3027: 3028: 3029: 3030: 3031: 3032: 3033: 3034: 3035: 3036: 3037: 3038: 3039: 3040: 3041: 3042: 3043: 3044: 3045: 3046: 3047: 3048: 3049: 3050: 3051: 3052: 3053: 3054: 3055: 3056: 3057: 3058: 3059: 3060: 3061: 3062: 3063: 3064: 3065: 3066: 3067: 3068: 3069: 3070: 3071: 3072: 3073: 3074: 3075: 3076: 3077: 3078: 3079: 3080: 3081: 3082: 3083: 3084: 3085: 3086: 3087: 3088: 3089: 3090: 3091: 3092: 3093: 3094: 3095: 3096: 3097: 3098: 3099: 3100: 3101: 3102: 3103: 3104: 3105: 3106: 3107: 3108: 3109: 3110: 3111: 3112: 3113: 3114: 3115: 3116: 3117: 3118: 3119: 3120: 3121: 3122: 3123: 3124: 3125: 3126: 3127: 3128: 3129: 3130: 3131: 3132: 3133: 3134: 3135: 3136: 3137: 3138: 3139: 3140: 3141: 3142: 3143: 3144: 3145: 3146: 3147: 3148: 3149: 3150: 3151: 3152: 3153: 3154: 3155: 3156: 3157: 3158: 3159: 3160: 3161: 3162: 3163: 3164: 3165: 3166: 3167: 3168: 3169: 3170: 3171: 3172: 3173: 3174: 3175: 3176: 3177: 3178: 3179: 3180: 3181: 3182: 3183: 3184: 3185: 3186: 3187: 3188: 3189: 3190: 3191: 3192: 3193: 3194: 3195: 3196: 3197: 3198: 3199: 3200: 3201: 3202: 3203: 3204: 3205: 3206: 3207: 3208: 3209: 3210: 3211: 3212: 3213: 3214: 3215: 3216: 3217: 3218: 3219: 3220: 3221: 3222: 3223: 3224: 3225: 3226: 3227: 3228: 3229: 3230: 3231: 3232: 3233: 3234: 3235: 3236: 3237: 3238: 3239: 3240: 3241: 3242: 3243: 3244: 3245: 3246: 3247: 3248: 3249: 3250: 3251: 3252: 3253: 3254: 3255: 3256: 3257: 3258: 3259: 3260: 3261: 3262: 3263: 3264: 3265: 3266: 3267: 3268: 3269: 3270: 3271: 3272: 3273: 3274: 3275: 3276: 3277: 3278: 3279: 3280: 3281: 3282: 3283: 3284: 3285: 3286: 3287: 3288: 3289: 3290: 3291: 3292: 3293: 3294: 3295: 3296: 3297: 3298: 3299: 3300: 3301: 3302: 3303: 3304: 3305: 3306: 3307: 3308: 3309: 3310: 3311: 3312: 3313: 3314: 3315: 3316: 3317: 3318: 3319: 3320: 3321: 3322: 3323: 3324: 3325: 3326: 3327: 3328: 3329: 3330: 3331: 

<?php
/**
 * PHP SDK for weibo.com (using OAuth2)
 * 
 * @author Elmer Zhang <freeboy6716@gmail.com>
 */

/**
 * If the class OAuthException has not been declared, extend the Exception class.
 * This is to allow OAuth without the PECL OAuth library
 * 
 * @ignore
 */
if ( ! class_exists( 'OAuthException')) {
    class OAuthException extends Exception {
        // pass
    }
}

/**
 * 新浪微博 OAuth 认证类(OAuth2)
 *
 * 授权机制说明请大家参考微博开放平台文档：{@link http://open.weibo.com/wiki/Oauth2}
 *
 * @package sae
 * @author Elmer Zhang
 * @version 1.0
 */
class SaeTOAuthV2 {
    /**
     * @ignore
     */
    public $client_id;
    /**
     * @ignore
     */
    public $client_secret;
    /**
     * @ignore
     */
    public $access_token;
    /**
     * @ignore
     */
    public $refresh_token;
    /**
     * Contains the last HTTP status code returned. 
     *
     * @ignore
     */
    public $http_code;
    /**
     * Contains the last API call.
     *
     * @ignore
     */
    public $url;
    /**
     * Set up the API root URL.
     *
     * @ignore
     */
    public $host = "https://api.weibo.com/2/";
    /**
     * Set timeout default.
     *
     * @ignore
     */
    public $timeout = 30;
    /**
     * Set connect timeout.
     *
     * @ignore
     */
    public $connecttimeout = 30;
    /**
     * Verify SSL Cert.
     *
     * @ignore
     */
    public $ssl_verifypeer = FALSE;
    /**
     * Respons format.
     *
     * @ignore
     */
    public $format = 'json';
    /**
     * Decode returned json data.
     *
     * @ignore
     */
    public $decode_json = TRUE;
    /**
     * Contains the last HTTP headers returned.
     *
     * @ignore
     */
    public $http_info;
    /**
     * Set the useragnet.
     *
     * @ignore
     */
    public $useragent = 'Sae T OAuth2 v0.1';

    /**
     * print the debug info
     *
     * @ignore
     */
    public $debug = FALSE;

    /**
     * boundary of multipart
     * @ignore
     */
    public static $boundary = '';

    /**
     * Set API URLS
     */
    /**
     * @ignore
     */
    function accessTokenURL()  { return 'https://api.weibo.com/oauth2/access_token'; }
    /**
     * @ignore
     */
    function authorizeURL()    { return 'https://api.weibo.com/oauth2/authorize'; }

    /**
     * construct WeiboOAuth object
     */
    function __construct($client_id, $client_secret, $access_token = NULL, $refresh_token = NULL) {
        $this->client_id = $client_id;
        $this->client_secret = $client_secret;
        $this->access_token = $access_token;
        $this->refresh_token = $refresh_token;
    }

    /**
     * authorize接口
     *
     * 对应API：{@link http://open.weibo.com/wiki/Oauth2/authorize Oauth2/authorize}
     *
     * @param string $url 授权后的回调地址,站外应用需与回调地址一致,站内应用需要填写canvas page的地址
     * @param string $response_type 支持的值包括 code 和token 默认值为code
     * @param string $state 用于保持请求和回调的状态。在回调时,会在Query Parameter中回传该参数
     * @param string $display 授权页面类型 可选范围: 
     *  - default       默认授权页面      
     *  - mobile        支持html5的手机        
     *  - 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
     */
    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
     */
    function getAccessToken( $type = 'code', $keys ) {
        $params = array();
        $params['client_id'] = $this->client_id;
        $params['client_secret'] = $this->client_secret;
        if ( $type === 'token' ) {
            $params['grant_type'] = 'refresh_token';
            $params['refresh_token'] = $keys['refresh_token'];
        } elseif ( $type === 'code' ) {
            $params['grant_type'] = 'authorization_code';
            $params['code'] = $keys['code'];
            $params['redirect_uri'] = $keys['redirect_uri'];
        } elseif ( $type === 'password' ) {
            $params['grant_type'] = 'password';
            $params['username'] = $keys['username'];
            $params['password'] = $keys['password'];
        } else {
            throw new OAuthException("wrong auth type");
        }

        $response = $this->oAuthRequest($this->accessTokenURL(), 'POST', $params);
        $token = json_decode($response, true);
        if ( is_array($token) && !isset($token['error']) ) {
            $this->access_token = $token['access_token'];
            //$this->refresh_token = $token['refresh_token'];
        } else {
            throw new OAuthException("get access token failed." . $token['error']);
        }
        return $token;
    }

    /**
     * 解析 signed_request
     *
     * @param string $signed_request 应用框架在加载iframe时会通过向Canvas URL post的参数signed_request
     *
     * @return array
     */
    function parseSignedRequest($signed_request) {
        list($encoded_sig, $payload) = explode('.', $signed_request, 2); 
        $sig = self::base64decode($encoded_sig) ;
        $data = json_decode(self::base64decode($payload), true);
        if (strtoupper($data['algorithm']) !== 'HMAC-SHA256') return '-1';
        $expected_sig = hash_hmac('sha256', $payload, $this->client_secret, true);
        return ($sig !== $expected_sig)? '-2':$data;
    }

    /**
     * @ignore
     */
    function base64decode($str) {
        return base64_decode(strtr($str.str_repeat('=', (4 - strlen($str) % 4)), '-_', '+/'));
    }

    /**
     * 读取jssdk授权信息，用于和jssdk的同步登录
     *
     * @return array 成功返回array('access_token'=>'value', 'refresh_token'=>'value'); 失败返回false
     */
    function getTokenFromJSSDK() {
        $key = "weibojs_" . $this->client_id;
        if ( isset($_COOKIE[$key]) && $cookie = $_COOKIE[$key] ) {
            parse_str($cookie, $token);
            if ( isset($token['access_token']) && isset($token['refresh_token']) ) {
                $this->access_token = $token['access_token'];
                $this->refresh_token = $token['refresh_token'];
                return $token;
            } else {
                return false;
            }
        } else {
            return false;
        }
    }

    /**
     * 从数组中读取access_token和refresh_token
     * 常用于从Session或Cookie中读取token，或通过Session/Cookie中是否存有token判断登录状态。
     *
     * @param array $arr 存有access_token和secret_token的数组
     * @return array 成功返回array('access_token'=>'value', 'refresh_token'=>'value'); 失败返回false
     */
    function getTokenFromArray( $arr ) {
        if (isset($arr['access_token']) && $arr['access_token']) {
            $token = array();
            $this->access_token = $token['access_token'] = $arr['access_token'];
            if (isset($arr['refresh_token']) && $arr['refresh_token']) {
                $this->refresh_token = $token['refresh_token'] = $arr['refresh_token'];
            }

            return $token;
        } else {
            return false;
        }
    }

    /**
     * GET wrappwer for oAuthRequest.
     *
     * @return mixed
     */
    function get($url, $parameters = array()) {
        $response = $this->oAuthRequest($url, 'GET', $parameters);
        if ($this->format === 'json' && $this->decode_json) {
            return json_decode($response, true);
        }
        return $response;
    }

    /**
     * POST wreapper for oAuthRequest.
     *
     * @return mixed
     */
    function post($url, $parameters = array(), $multi = false) {
        $response = $this->oAuthRequest($url, 'POST', $parameters, $multi );
        if ($this->format === 'json' && $this->decode_json) {
            return json_decode($response, true);
        }
        return $response;
    }

    /**
     * DELTE wrapper for oAuthReqeust.
     *
     * @return mixed
     */
    function delete($url, $parameters = array()) {
        $response = $this->oAuthRequest($url, 'DELETE', $parameters);
        if ($this->format === 'json' && $this->decode_json) {
            return json_decode($response, true);
        }
        return $response;
    }

    /**
     * Format and sign an OAuth / API request
     *
     * @return string
     * @ignore
     */
    function oAuthRequest($url, $method, $parameters, $multi = false) {

        if (strrpos($url, 'http://') !== 0 && strrpos($url, 'https://') !== 0) {
            $url = "{$this->host}{$url}.{$this->format}";
    }

    switch ($method) {
        case 'GET':
            $url = $url . '?' . http_build_query($parameters);
            return $this->http($url, 'GET');
        default:
            $headers = array();
            if (!$multi && (is_array($parameters) || is_object($parameters)) ) {
                $body = http_build_query($parameters);
            } else {
                $body = self::build_http_query_multi($parameters);
                $headers[] = "Content-Type: multipart/form-data; boundary=" . self::$boundary;
            }
            return $this->http($url, $method, $body, $headers);
    }
    }

    /**
     * Make an HTTP request
     *
     * @return string API results
     * @ignore
     */
    function http($url, $method, $postfields = NULL, $headers = array()) {
        $this->http_info = array();
        $ci = curl_init();
        /* Curl settings */
        curl_setopt($ci, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_0);
        curl_setopt($ci, CURLOPT_USERAGENT, $this->useragent);
        curl_setopt($ci, CURLOPT_CONNECTTIMEOUT, $this->connecttimeout);
        curl_setopt($ci, CURLOPT_TIMEOUT, $this->timeout);
        curl_setopt($ci, CURLOPT_RETURNTRANSFER, TRUE);
        curl_setopt($ci, CURLOPT_ENCODING, "");
        curl_setopt($ci, CURLOPT_SSL_VERIFYPEER, $this->ssl_verifypeer);
        if (version_compare(phpversion(), '5.4.0', '<')) {
            curl_setopt($ci, CURLOPT_SSL_VERIFYHOST, 1);
        } else {
            curl_setopt($ci, CURLOPT_SSL_VERIFYHOST, 2);
        }
        curl_setopt($ci, CURLOPT_HEADERFUNCTION, array($this, 'getHeader'));
        curl_setopt($ci, CURLOPT_HEADER, FALSE);

        switch ($method) {
            case 'POST':
                curl_setopt($ci, CURLOPT_POST, TRUE);
                if (!empty($postfields)) {
                    curl_setopt($ci, CURLOPT_POSTFIELDS, $postfields);
                    $this->postdata = $postfields;
                }
                break;
            case 'DELETE':
                curl_setopt($ci, CURLOPT_CUSTOMREQUEST, 'DELETE');
                if (!empty($postfields)) {
                    $url = "{$url}?{$postfields}";
                }
        }

        if ( isset($this->access_token) && $this->access_token )
            $headers[] = "Authorization: OAuth2 ".$this->access_token;

        if ( !empty($this->remote_ip) ) {
            if ( defined('SAE_ACCESSKEY') ) {
                $headers[] = "SaeRemoteIP: " . $this->remote_ip;
            } else {
                $headers[] = "API-RemoteIP: " . $this->remote_ip;
            }
        } else {
            if ( !defined('SAE_ACCESSKEY') ) {
                $headers[] = "API-RemoteIP: " . $_SERVER['REMOTE_ADDR'];
            }
        }
        curl_setopt($ci, CURLOPT_URL, $url );
        curl_setopt($ci, CURLOPT_HTTPHEADER, $headers );
        curl_setopt($ci, CURLINFO_HEADER_OUT, TRUE );

        $response = curl_exec($ci);
        $this->http_code = curl_getinfo($ci, CURLINFO_HTTP_CODE);
        $this->http_info = array_merge($this->http_info, curl_getinfo($ci));
        $this->url = $url;

        if ($this->debug) {
            echo "=====post data======\r\n";
            var_dump($postfields);

            echo "=====headers======\r\n";
            print_r($headers);

            echo '=====request info====='."\r\n";
            print_r( curl_getinfo($ci) );

            echo '=====response====='."\r\n";
            print_r( $response );
        }
        curl_close ($ci);
        return $response;
    }

    /**
     * Get the header info to store.
     *
     * @return int
     * @ignore
     */
    function getHeader($ch, $header) {
        $i = strpos($header, ':');
        if (!empty($i)) {
            $key = str_replace('-', '_', strtolower(substr($header, 0, $i)));
            $value = trim(substr($header, $i + 2));
            $this->http_header[$key] = $value;
        }
        return strlen($header);
    }

    /**
     * @ignore
     */
    public static function build_http_query_multi($params) {
        if (!$params) return '';

        uksort($params, 'strcmp');

        $pairs = array();

        self::$boundary = $boundary = uniqid('------------------');
        $MPboundary = '--'.$boundary;
        $endMPboundary = $MPboundary. '--';
        $multipartbody = '';

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

            if( in_array($parameter, array('pic', 'image')) && $value{0} == '@' ) {
                $url = ltrim( $value, '@' );
                $content = file_get_contents( $url );
                $array = explode( '?', basename( $url ) );
                $filename = $array[0];

                $multipartbody .= $MPboundary . "\r\n";
                $multipartbody .= 'Content-Disposition: form-data; name="' . $parameter . '"; filename="' . $filename . '"'. "\r\n";
                $multipartbody .= "Content-Type: image/unknown\r\n\r\n";
                $multipartbody .= $content. "\r\n";
            } else {
                $multipartbody .= $MPboundary . "\r\n";
                $multipartbody .= 'content-disposition: form-data; name="' . $parameter . "\"\r\n\r\n";
                $multipartbody .= $value."\r\n";
            }

        }

        $multipartbody .= $endMPboundary;
        return $multipartbody;
    }
}


/**
 * 新浪微博操作类V2
 *
 * 使用前需要先手工调用saetv2.ex.class.php <br />
 *
 * @package sae
 * @author Easy Chen, Elmer Zhang,Lazypeople
 * @version 1.0
 */
class SaeTClientV2
{
    /**
     * 构造函数
     * 
     * @access public
     * @param mixed $akey 微博开放平台应用APP KEY
     * @param mixed $skey 微博开放平台应用APP SECRET
     * @param mixed $access_token OAuth认证返回的token
     * @param mixed $refresh_token OAuth认证返回的token secret
     * @return void
     */
    function __construct( $akey, $skey, $access_token, $refresh_token = NULL)
    {
        $this->oauth = new SaeTOAuthV2( $akey, $skey, $access_token, $refresh_token );
    }

    /**
     * 开启调试信息
     *
     * 开启调试信息后，SDK会将每次请求微博API所发送的POST Data、Headers以及请求信息、返回内容输出出来。
     *
     * @access public
     * @param bool $enable 是否开启调试信息
     * @return void
     */
    function set_debug( $enable )
    {
        $this->oauth->debug = $enable;
    }

    /**
     * 设置用户IP
     *
     * SDK默认将会通过$_SERVER['REMOTE_ADDR']获取用户IP，在请求微博API时将用户IP附加到Request Header中。但某些情况下$_SERVER['REMOTE_ADDR']取到的IP并非用户IP，而是一个固定的IP（例如使用SAE的Cron或TaskQueue服务时），此时就有可能会造成该固定IP达到微博API调用频率限额，导致API调用失败。此时可使用本方法设置用户IP，以避免此问题。
     *
     * @access public
     * @param string $ip 用户IP
     * @return bool IP为非法IP字符串时，返回false，否则返回true
     */
    function set_remote_ip( $ip )
    {
        if ( ip2long($ip) !== false ) {
            $this->oauth->remote_ip = $ip;
            return true;
        } else {
            return false;
        }
    }

    /**
     * 获取最新的公共微博消息
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/statuses/public_timeline statuses/public_timeline}
     *
     * @access public
     * @param int $count 单页返回的记录条数，默认为50。
     * @param int $page 返回结果的页码，默认为1。
     * @param int $base_app 是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。
     * @return array
     */
    function public_timeline( $page = 1, $count = 50, $base_app = 0 )
    {
        $params = array();
        $params['count'] = intval($count);
        $params['page'] = intval($page);
        $params['base_app'] = intval($base_app);
        return $this->oauth->get('statuses/public_timeline', $params);//可能是接口的bug不能补全
    }

    /**
     * 获取当前登录用户及其所关注用户的最新微博消息。
     *
     * 获取当前登录用户及其所关注用户的最新微博消息。和用户登录 http://weibo.com 后在“我的首页”中看到的内容相同。同friends_timeline()
     * <br />对应API：{@link http://open.weibo.com/wiki/2/statuses/home_timeline statuses/home_timeline}
     * 
     * @access public
     * @param int $page 指定返回结果的页码。根据当前登录用户所关注的用户数及这些被关注用户发表的微博数，翻页功能最多能查看的总记录数会有所不同，通常最多能查看1000条左右。默认值1。可选。
     * @param int $count 每次返回的记录数。缺省值50，最大值200。可选。
     * @param int $since_id 若指定此参数，则只返回ID比since_id大的微博消息（即比since_id发表时间晚的微博消息）。可选。
     * @param int $max_id 若指定此参数，则返回ID小于或等于max_id的微博消息。可选。
     * @param int $base_app 是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。
     * @param int $feature 过滤类型ID，0：全部、1：原创、2：图片、3：视频、4：音乐，默认为0。
     * @return array
     */
    function home_timeline( $page = 1, $count = 50, $since_id = 0, $max_id = 0, $base_app = 0, $feature = 0 )
    {
        $params = array();
        if ($since_id) {
            $this->id_format($since_id);
            $params['since_id'] = $since_id;
        }
        if ($max_id) {
            $this->id_format($max_id);
            $params['max_id'] = $max_id;
        }
        $params['count'] = intval($count);
        $params['page'] = intval($page);
        $params['base_app'] = intval($base_app);
        $params['feature'] = intval($feature);

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

    /**
     * 获取当前登录用户及其所关注用户的最新微博消息。
     *
     * 获取当前登录用户及其所关注用户的最新微博消息。和用户登录 http://weibo.com 后在“我的首页”中看到的内容相同。同home_timeline()
     * <br />对应API：{@link http://open.weibo.com/wiki/2/statuses/friends_timeline statuses/friends_timeline}
     * 
     * @access public
     * @param int $page 指定返回结果的页码。根据当前登录用户所关注的用户数及这些被关注用户发表的微博数，翻页功能最多能查看的总记录数会有所不同，通常最多能查看1000条左右。默认值1。可选。
     * @param int $count 每次返回的记录数。缺省值50，最大值200。可选。
     * @param int $since_id 若指定此参数，则只返回ID比since_id大的微博消息（即比since_id发表时间晚的微博消息）。可选。
     * @param int $max_id 若指定此参数，则返回ID小于或等于max_id的微博消息。可选。
     * @param int $base_app 是否基于当前应用来获取数据。1为限制本应用微博，0为不做限制。默认为0。可选。
     * @param int $feature 微博类型，0全部，1原创，2图片，3视频，4音乐. 返回指定类型的微博信息内容。转为为0。可选。
     * @return array
     */
    function friends_timeline( $page = 1, $count = 50, $since_id = 0, $max_id = 0, $base_app = 0, $feature = 0 )
    {
        return $this->home_timeline( $since_id, $max_id, $count, $page, $base_app, $feature);
    }

    /**
     * 获取用户发布的微博信息列表
     *
     * 返回用户的发布的最近n条信息，和用户微博页面返回内容是一致的。此接口也可以请求其他用户的最新发表微博。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/statuses/user_timeline statuses/user_timeline}
     * 
     * @access public
     * @param int $page 页码
     * @param int $count 每次返回的最大记录数，最多返回200条，默认50。
     * @param mixed $uid 指定用户UID或微博昵称
     * @param int $since_id 若指定此参数，则只返回ID比since_id大的微博消息（即比since_id发表时间晚的微博消息）。可选。
     * @param int $max_id 若指定此参数，则返回ID小于或等于max_id的提到当前登录用户微博消息。可选。
     * @param int $base_app 是否基于当前应用来获取数据。1为限制本应用微博，0为不做限制。默认为0。
     * @param int $feature 过滤类型ID，0：全部、1：原创、2：图片、3：视频、4：音乐，默认为0。
     * @param int $trim_user 返回值中user信息开关，0：返回完整的user信息、1：user字段仅返回uid，默认为0。
     * @return array
     */
    function user_timeline_by_id( $uid = NULL , $page = 1 , $count = 50 , $since_id = 0, $max_id = 0, $feature = 0, $trim_user = 0, $base_app = 0)
    {
        $params = array();
        $params['uid']=$uid;
        if ($since_id) {
            $this->id_format($since_id);
            $params['since_id'] = $since_id;
        }
        if ($max_id) {
            $this->id_format($max_id);
            $params['max_id'] = $max_id;
        }
        $params['base_app'] = intval($base_app);
        $params['feature'] = intval($feature);
        $params['count'] = intval($count);
        $params['page'] = intval($page);
        $params['trim_user'] = intval($trim_user);

        return $this->oauth->get( 'statuses/user_timeline', $params );
    }
    
    
    /**
     * 获取用户发布的微博信息列表
     *
     * 返回用户的发布的最近n条信息，和用户微博页面返回内容是一致的。此接口也可以请求其他用户的最新发表微博。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/statuses/user_timeline statuses/user_timeline}
     * 
     * @access public
     * @param string $screen_name 微博昵称，主要是用来区分用户UID跟微博昵称，当二者一样而产生歧义的时候，建议使用该参数 
     * @param int $page 页码
     * @param int $count 每次返回的最大记录数，最多返回200条，默认50。
     * @param int $since_id 若指定此参数，则只返回ID比since_id大的微博消息（即比since_id发表时间晚的微博消息）。可选。
     * @param int $max_id 若指定此参数，则返回ID小于或等于max_id的提到当前登录用户微博消息。可选。
     * @param int $feature 过滤类型ID，0：全部、1：原创、2：图片、3：视频、4：音乐，默认为0。
     * @param int $trim_user 返回值中user信息开关，0：返回完整的user信息、1：user字段仅返回uid，默认为0。
     * @param int $base_app 是否基于当前应用来获取数据。1为限制本应用微博，0为不做限制。默认为0。
     * @return array
     */
    function user_timeline_by_name( $screen_name = NULL , $page = 1 , $count = 50 , $since_id = 0, $max_id = 0, $feature = 0, $trim_user = 0, $base_app = 0 )
    {
        $params = array();
        $params['screen_name'] = $screen_name;
        if ($since_id) {
            $this->id_format($since_id);
            $params['since_id'] = $since_id;
        }
        if ($max_id) {
            $this->id_format($max_id);
            $params['max_id'] = $max_id;
        }
        $params['base_app'] = intval($base_app);
        $params['feature'] = intval($feature);
        $params['count'] = intval($count);
        $params['page'] = intval($page);
        $params['trim_user'] = intval($trim_user);

        return $this->oauth->get( 'statuses/user_timeline', $params );
    }
    
    
    
    /**
     * 批量获取指定的一批用户的timeline
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/statuses/timeline_batch statuses/timeline_batch}
     *
     * @param string $screen_name  需要查询的用户昵称，用半角逗号分隔，一次最多20个
     * @param int    $count        单页返回的记录条数，默认为50。
     * @param int    $page  返回结果的页码，默认为1。 
     * @param int    $base_app  是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。
     * @param int    $feature   过滤类型ID，0：全部、1：原创、2：图片、3：视频、4：音乐，默认为0。
     * @return array
     */
    function timeline_batch_by_name( $screen_name, $page = 1, $count = 50, $feature = 0, $base_app = 0)
    {
        $params = array();
        if (is_array($screen_name) && !empty($screen_name)) {
            $params['screen_name'] = join(',', $screen_name);
        } else {
            $params['screen_name'] = $screen_name;
        }
        $params['count'] = intval($count);
        $params['page'] = intval($page); 
        $params['base_app'] = intval($base_app);
        $params['feature'] = intval($feature);
        return $this->oauth->get('statuses/timeline_batch', $params);
    }

    /**
     * 批量获取指定的一批用户的timeline
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/statuses/timeline_batch statuses/timeline_batch}
     *
     * @param string $uids  需要查询的用户ID，用半角逗号分隔，一次最多20个。
     * @param int    $count        单页返回的记录条数，默认为50。
     * @param int    $page  返回结果的页码，默认为1。 
     * @param int    $base_app  是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。
     * @param int    $feature   过滤类型ID，0：全部、1：原创、2：图片、3：视频、4：音乐，默认为0。
     * @return array
     */
    function timeline_batch_by_id( $uids, $page = 1, $count = 50, $feature = 0, $base_app = 0)
    {
        $params = array();
        if (is_array($uids) && !empty($uids)) {
            foreach($uids as $k => $v) {
                $this->id_format($uids[$k]);
            }
            $params['uids'] = join(',', $uids);
        } else {
            $params['uids'] = $uids;
        }
        $params['count'] = intval($count);
        $params['page'] = intval($page); 
        $params['base_app'] = intval($base_app);
        $params['feature'] = intval($feature);
        return $this->oauth->get('statuses/timeline_batch', $params);
    }


    /**
     * 返回一条原创微博消息的最新n条转发微博消息。本接口无法对非原创微博进行查询。 
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/statuses/repost_timeline statuses/repost_timeline}
     * 
     * @access public
     * @param int $sid 要获取转发微博列表的原创微博ID。
     * @param int $page 返回结果的页码。 
     * @param int $count 单页返回的最大记录数，最多返回200条，默认50。可选。
     * @param int $since_id 若指定此参数，则只返回ID比since_id大的记录（比since_id发表时间晚）。可选。
     * @param int $max_id 若指定此参数，则返回ID小于或等于max_id的记录。可选。
     * @param int $filter_by_author 作者筛选类型，0：全部、1：我关注的人、2：陌生人，默认为0。
     * @return array
     */
    function repost_timeline( $sid, $page = 1, $count = 50, $since_id = 0, $max_id = 0, $filter_by_author = 0 )
    {
        $this->id_format($sid);

        $params = array();
        $params['id'] = $sid;
        if ($since_id) {
            $this->id_format($since_id);
            $params['since_id'] = $since_id;
        }
        if ($max_id) {
            $this->id_format($max_id);
            $params['max_id'] = $max_id;
        }
        $params['filter_by_author'] = intval($filter_by_author);

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

    /**
     * 获取当前用户最新转发的n条微博消息
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/statuses/repost_by_me statuses/repost_by_me}
     * 
     * @access public
     * @param int $page 返回结果的页码。 
     * @param int $count  每次返回的最大记录数，最多返回200条，默认50。可选。
     * @param int $since_id 若指定此参数，则只返回ID比since_id大的记录（比since_id发表时间晚）。可选。
     * @param int $max_id  若指定此参数，则返回ID小于或等于max_id的记录。可选。
     * @return array
     */
    function repost_by_me( $page = 1, $count = 50, $since_id = 0, $max_id = 0 )
    {
        $params = array();
        if ($since_id) {
            $this->id_format($since_id);
            $params['since_id'] = $since_id;
        }
        if ($max_id) {
            $this->id_format($max_id);
            $params['max_id'] = $max_id;
        }

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

    /**
     * 获取@当前用户的微博列表
     *
     * 返回最新n条提到登录用户的微博消息（即包含@username的微博消息）
     * <br />对应API：{@link http://open.weibo.com/wiki/2/statuses/mentions statuses/mentions}
     * 
     * @access public
     * @param int $page 返回结果的页序号。
     * @param int $count 每次返回的最大记录数（即页面大小），不大于200，默认为50。
     * @param int $since_id 若指定此参数，则只返回ID比since_id大的微博消息（即比since_id发表时间晚的微博消息）。可选。
     * @param int $max_id 若指定此参数，则返回ID小于或等于max_id的提到当前登录用户微博消息。可选。
     * @param int $filter_by_author 作者筛选类型，0：全部、1：我关注的人、2：陌生人，默认为0。
     * @param int $filter_by_source 来源筛选类型，0：全部、1：来自微博、2：来自微群，默认为0。
     * @param int $filter_by_type 原创筛选类型，0：全部微博、1：原创的微博，默认为0。
     * @return array
     */
    function mentions( $page = 1, $count = 50, $since_id = 0, $max_id = 0, $filter_by_author = 0, $filter_by_source = 0, $filter_by_type = 0 )
    {
        $params = array();
        if ($since_id) {
            $this->id_format($since_id);
            $params['since_id'] = $since_id;
        }
        if ($max_id) {
            $this->id_format($max_id);
            $params['max_id'] = $max_id;
        }
        $params['filter_by_author'] = $filter_by_author;
        $params['filter_by_source'] = $filter_by_source;
        $params['filter_by_type'] = $filter_by_type;

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


    /**
     * 根据ID获取单条微博信息内容
     *
     * 获取单条ID的微博信息，作者信息将同时返回。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/statuses/show statuses/show}
     * 
     * @access public
     * @param int $id 要获取已发表的微博ID, 如ID不存在返回空
     * @return array
     */
    function show_status( $id )
    {
        $this->id_format($id);
        $params = array();
        $params['id'] = $id;
        return $this->oauth->get('statuses/show', $params);
    }

    /**
     * 根据微博id号获取微博的信息
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/statuses/show_batch statuses/show_batch}
     *
     * @param string $ids 需要查询的微博ID，用半角逗号分隔，最多不超过50个。
     * @return array
     */
    function show_batch( $ids )
    {
        $params=array();
        if (is_array($ids) && !empty($ids)) {
            foreach($ids as $k => $v) {
                $this->id_format($ids[$k]);
            }
            $params['ids'] = join(',', $ids);
        } else {
            $params['ids'] = $ids;
        }
        return $this->oauth->get('statuses/show_batch', $params);
    }

    /**
     * 通过微博（评论、私信）ID获取其MID
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/statuses/querymid statuses/querymid}
     *
     * @param int|string $id  需要查询的微博（评论、私信）ID，批量模式下，用半角逗号分隔，最多不超过20个。
     * @param int $type  获取类型，1：微博、2：评论、3：私信，默认为1。
     * @param int $is_batch 是否使用批量模式，0：否、1：是，默认为0。
     * @return array
     */
    function querymid( $id, $type = 1, $is_batch = 0 )
    {
        $params = array();
        $params['id'] = $id;
        $params['type'] = intval($type);
        $params['is_batch'] = intval($is_batch);
        return $this->oauth->get( 'statuses/querymid',  $params);
    }

    /**
     * 通过微博（评论、私信）MID获取其ID
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/statuses/queryid statuses/queryid}
     *
     * @param int|string $mid  需要查询的微博（评论、私信）MID，批量模式下，用半角逗号分隔，最多不超过20个。
     * @param int $type  获取类型，1：微博、2：评论、3：私信，默认为1。
     * @param int $is_batch 是否使用批量模式，0：否、1：是，默认为0。
     * @param int $inbox  仅对私信有效，当MID类型为私信时用此参数，0：发件箱、1：收件箱，默认为0 。
     * @param int $isBase62 MID是否是base62编码，0：否、1：是，默认为0。
     * @return array
     */
    function queryid( $mid, $type = 1, $is_batch = 0, $inbox = 0, $isBase62 = 0)
    {
        $params = array();
        $params['mid'] = $mid;
        $params['type'] = intval($type);
        $params['is_batch'] = intval($is_batch);
        $params['inbox'] = intval($inbox);
        $params['isBase62'] = intval($isBase62);
        return $this->oauth->get('statuses/queryid', $params);
    }

    /**
     * 按天返回热门微博转发榜的微博列表
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/statuses/hot/repost_daily statuses/hot/repost_daily}
     *
     * @param int $count 返回的记录条数，最大不超过50，默认为20。
     * @param int $base_app 是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。
     * @return array
     */
    function repost_daily( $count = 20, $base_app = 0)
    {
        $params = array();
        $params['count'] = intval($count);
        $params['base_app'] = intval($base_app);
        return $this->oauth->get('statuses/hot/repost_daily',  $params);
    }

    /**
     * 按周返回热门微博转发榜的微博列表
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/statuses/hot/repost_weekly statuses/hot/repost_weekly}
     *
     * @param int $count 返回的记录条数，最大不超过50，默认为20。
     * @param int $base_app 是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。
     * @return array
     */
    function repost_weekly( $count = 20,  $base_app = 0)
    {
        $params = array();
        $params['count'] = intval($count);
        $params['base_app'] = intval($base_app);
        return $this->oauth->get( 'statuses/hot/repost_weekly',  $params);
    }

    /**
     * 按天返回热门微博评论榜的微博列表
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/statuses/hot/comments_daily statuses/hot/comments_daily}
     *
     * @param int $count 返回的记录条数，最大不超过50，默认为20。
     * @param int $base_app 是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。
     * @return array
     */
    function comments_daily( $count = 20,  $base_app = 0)
    {
        $params =  array();
        $params['count'] = intval($count);
        $params['base_app'] = intval($base_app);
        return $this->oauth->get( 'statuses/hot/comments_daily',  $params);
    }

    /**
     * 按周返回热门微博评论榜的微博列表
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/statuses/hot/comments_weekly statuses/hot/comments_weekly}
     *
     * @param int $count 返回的记录条数，最大不超过50，默认为20。
     * @param int $base_app 是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。
     * @return array
     */
    function comments_weekly( $count = 20, $base_app = 0)
    {
        $params =  array();
        $params['count'] = intval($count);
        $params['base_app'] = intval($base_app);
        return $this->oauth->get( 'statuses/hot/comments_weekly', $params);
    }


    /**
     * 转发一条微博信息。
     *
     * 可加评论。为防止重复，发布的信息与最新信息一样话，将会被忽略。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/statuses/repost statuses/repost}
     * 
     * @access public
     * @param int $sid 转发的微博ID
     * @param string $text 添加的评论信息。可选。
     * @param int $is_comment 是否在转发的同时发表评论，0：否、1：评论给当前微博、2：评论给原微博、3：都评论，默认为0。
     * @return array
     */
    function repost( $sid, $text = NULL, $is_comment = 0 )
    {
        $this->id_format($sid);

        $params = array();
        $params['id'] = $sid;
        $params['is_comment'] = $is_comment;
        if( $text ) $params['status'] = $text;

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

    /**
     * 删除一条微博
     * 
     * 根据ID删除微博消息。注意：只能删除自己发布的信息。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/statuses/destroy statuses/destroy}
     * 
     * @access public
     * @param int $id 要删除的微博ID
     * @return array
     */
    function delete( $id )
    {
        return $this->destroy( $id );
    }

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

    
    /**
     * 发表微博
     *
     * 发布一条微博信息。
     * <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}
     * 
     * @access public
     * @param string $status 要更新的微博信息。信息内容不超过140个汉字, 为空返回400错误。
     * @param float $lat 纬度，发表当前微博所在的地理位置，有效范围 -90.0到+90.0, +表示北纬。可选。
     * @param float $long 经度。有效范围-180.0到+180.0, +表示东经。可选。
     * @param mixed $annotations 可选参数。元数据，主要是为了方便第三方应用记录一些适合于自己使用的信息。每条微博可以包含一个或者多个元数据。请以json字串的形式提交，字串长度不超过512个字符，或者数组方式，要求json_encode后字串长度不超过512个字符。具体内容可以自定。例如：'[{"type2":123}, {"a":"b", "c":"d"}]'或array(array("type2"=>123), array("a"=>"b", "c"=>"d"))。
     * @param int $visible    微博的可见性，0：所有人能看，1：仅自己可见，2：密友可见，3：指定分组可见，默认为0
     * @return array
     */
    function update( $status, $lat = NULL, $long = NULL, $annotations = NULL, $visible=0 )
    {
        $params = array();
        $params['status'] = $status;
        $params['visible'] = $visible;
        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}
     * 
     * @access public
     * @param string $status 要更新的微博信息。信息内容不超过140个汉字, 为空返回400错误。
     * @param string $pic_path 要发布的图片路径, 支持url。[只支持png/jpg/gif三种格式, 增加格式请修改get_image_mime方法]
     * @param float $lat 纬度，发表当前微博所在的地理位置，有效范围 -90.0到+90.0, +表示北纬。可选。
     * @param float $long 可选参数，经度。有效范围-180.0到+180.0, +表示东经。可选。
     * @param int $visible    微博的可见性，0：所有人能看，1：仅自己可见，2：密友可见，3：指定分组可见，默认为0
     * @return array
     */
    function upload( $status, $pic_path, $lat = NULL, $long = NULL, $visible=0 )
    {
        $params = array();
        $params['status'] = $status;
        $params['pic'] = '@'.$pic_path;
        $params['visible'] = $visible;
        if ($lat) {
            $params['lat'] = floatval($lat);
        }
        if ($long) {
            $params['long'] = floatval($long);
        }

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

    /**
     * 第三方分享一条链接到微博
     *
     * 目前上传图片大小限制为<5M。 
     * <br />对应API：{@link http://open.weibo.com/wiki/2/statuses/share}
     * 
     * @access public
     * @param string $status 用户分享到微博的文本内容，必须做URLencode，内容不超过140个汉字，文本中不能包含“#话题词#”，同时文本中必须包含至少一个第三方分享到微博的网页URL，且该URL只能是该第三方（调用方）绑定域下的URL链接，绑定域在“我的应用 － 应用信息 － 基本应用信息编辑 － 安全域名”里设置，必填。
     * @param string $pic 用户想要分享到微博的图片，仅支持JPEG、GIF、PNG图片，上传图片大小限制为<5M。上传图片时，POST方式提交请求，需要采用multipart/form-data编码方式，可选。
     * @param string $rip 开发者上报的操作用户真实IP，形如：211.156.0.1，可选。
     * @return array
     */
    function share($status, $pic = false, $rip = false)
    {
        $params = array();
        $params['status'] = $status;
        $with_media = false;
        if ($pic) {
            $params['pic'] = '@'.$pic;
            $with_media = true;
        }
        if ($rip) {
            $params['rip'] = $rip;
        }

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

    /**
     * 指定一个图片URL地址抓取后上传并同时发布一条新微博
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/statuses/upload_url_text statuses/upload_url_text}
     *
     * @param string $status  要发布的微博文本内容，内容不超过140个汉字。
     * @param int $visible    微博的可见性，0：所有人能看，1：仅自己可见，2：密友可见，3：指定分组可见，默认为0
     * @param string $list_id 微博的保护投递指定分组ID，只有当visible参数为3时生效且必选。
     * @param string $pic_id 已经上传的图片pid，多个时使用英文半角逗号符分隔，最多不超过9个。
     * @param float $lat 纬度，有效范围：-90.0到+90.0，+表示北纬，默认为0.0。
     * @param float $long 经度，有效范围：-180.0到+180.0，+表示东经，默认为0.0。
     * @param string $annotations 元数据，主要是为了方便第三方应用记录一些适合于自己使用的信息，每条微博可以包含一个或者多个元数据，
     *                            必须以json字串的形式提交，字串长度不超过512个字符，具体内容可以自定。
     * @param string $url    图片的URL地址，必须以http开头。
     * @return array
     */
    function upload_url_text( $status,  $url , $visible=0, $list_id=NULL, $pic_id=NULL, $lat = NULL, $long=NULL, $annotations=NULL)
    {
        $params = array();
        $params['status'] = $status;
        $params['url'] = $url;
        $params['visible'] = $visible;
        if (!is_null($list_id)) {
            $params['list_id'] = $list_id;
        }
        if (!is_null($pic_id)) {
            $params['pic_id'] = $pic_id;
        }
        if (!is_null($lat)) {
            $params['lat'] = $lat;
        }
        if (!is_null($long)) {
            $params['long'] = $long;
        }
        if (!is_null($annotations)) {
            $params['annotations'] = $annotations;
        }
        return $this->oauth->post( 'statuses/upload_url_text', $params, true );
    }


    /**
     * 获取表情列表
     *
     * 返回新浪微博官方所有表情、魔法表情的相关信息。包括短语、表情类型、表情分类，是否热门等。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/emotions emotions}
     * 
     * @access public
     * @param string $type 表情类别。"face":普通表情，"ani"：魔法表情，"cartoon"：动漫表情。默认为"face"。可选。
     * @param string $language 语言类别，"cnname"简体，"twname"繁体。默认为"cnname"。可选
     * @return array
     */
    function emotions( $type = "face", $language = "cnname" )
    {
        $params = array();
        $params['type'] = $type;
        $params['language'] = $language;
        return $this->oauth->get( 'emotions', $params );
    }


    /**
     * 根据微博ID返回某条微博的评论列表
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/comments/show comments/show}
     *
     * @param int $sid 需要查询的微博ID。
     * @param int $page 返回结果的页码，默认为1。
     * @param int $count 单页返回的记录条数，默认为50。
     * @param int $since_id 若指定此参数，则返回ID比since_id大的评论（即比since_id时间晚的评论），默认为0。
     * @param int $max_id  若指定此参数，则返回ID小于或等于max_id的评论，默认为0。
     * @param int $filter_by_author 作者筛选类型，0：全部、1：我关注的人、2：陌生人，默认为0。
     * @return array
     */
    function get_comments_by_sid( $sid, $page = 1, $count = 50, $since_id = 0, $max_id = 0, $filter_by_author = 0 )
    {
        $params = array();
        $this->id_format($sid);
        $params['id'] = $sid;
        if ($since_id) {
            $this->id_format($since_id);
            $params['since_id'] = $since_id;
        }
        if ($max_id) {
            $this->id_format($max_id);
            $params['max_id'] = $max_id;
        }
        $params['count'] = $count;
        $params['page'] = $page;
        $params['filter_by_author'] = $filter_by_author;
        return $this->oauth->get( 'comments/show',  $params );
    }


    /**
     * 获取当前登录用户所发出的评论列表
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/comments/by_me comments/by_me}
     *
     * @param int $since_id 若指定此参数，则返回ID比since_id大的评论（即比since_id时间晚的评论），默认为0。
     * @param int $max_id 若指定此参数，则返回ID小于或等于max_id的评论，默认为0。
     * @param int $count  单页返回的记录条数，默认为50。
     * @param int $page 返回结果的页码，默认为1。
     * @param int $filter_by_source 来源筛选类型，0：全部、1：来自微博的评论、2：来自微群的评论，默认为0。
     * @return array
     */
    function comments_by_me( $page = 1 , $count = 50, $since_id = 0, $max_id = 0,  $filter_by_source = 0 )
    {
        $params = array();
        if ($since_id) {
            $this->id_format($since_id);
            $params['since_id'] = $since_id;
        }
        if ($max_id) {
            $this->id_format($max_id);
            $params['max_id'] = $max_id;
        }
        $params['count'] = $count;
        $params['page'] = $page;
        $params['filter_by_source'] = $filter_by_source;
        return $this->oauth->get( 'comments/by_me', $params );
    }

    /**
     * 获取当前登录用户所接收到的评论列表
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/comments/to_me comments/to_me}
     *
     * @param int $since_id 若指定此参数，则返回ID比since_id大的评论（即比since_id时间晚的评论），默认为0。
     * @param int $max_id  若指定此参数，则返回ID小于或等于max_id的评论，默认为0。
     * @param int $count 单页返回的记录条数，默认为50。
     * @param int $page 返回结果的页码，默认为1。
     * @param int $filter_by_author 作者筛选类型，0：全部、1：我关注的人、2：陌生人，默认为0。
     * @param int $filter_by_source 来源筛选类型，0：全部、1：来自微博的评论、2：来自微群的评论，默认为0。
     * @return array
     */ 
    function comments_to_me( $page = 1 , $count = 50, $since_id = 0, $max_id = 0, $filter_by_author = 0, $filter_by_source = 0)
    {
        $params = array();
        if ($since_id) {
            $this->id_format($since_id);
            $params['since_id'] = $since_id;
        }
        if ($max_id) {
            $this->id_format($max_id);
            $params['max_id'] = $max_id;
        }
        $params['count'] = $count;
        $params['page'] = $page;
        $params['filter_by_author'] = $filter_by_author;
        $params['filter_by_source'] = $filter_by_source;
        return $this->oauth->get( 'comments/to_me', $params );
    }

    /**
     * 最新评论(按时间)
     *
     * 返回最新n条发送及收到的评论。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/comments/timeline comments/timeline}
     * 
     * @access public
     * @param int $page 页码
     * @param int $count 每次返回的最大记录数，最多返回200条，默认50。
     * @param int $since_id 若指定此参数，则只返回ID比since_id大的评论（比since_id发表时间晚）。可选。
     * @param int $max_id 若指定此参数，则返回ID小于或等于max_id的评论。可选。
     * @return array
     */
    function comments_timeline( $page = 1, $count = 50, $since_id = 0, $max_id = 0 )
    {
        $params = array();
        if ($since_id) {
            $this->id_format($since_id);
            $params['since_id'] = $since_id;
        }
        if ($max_id) {
            $this->id_format($max_id);
            $params['max_id'] = $max_id;
        }

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


    /**
     * 获取最新的提到当前登录用户的评论，即@我的评论
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/comments/mentions comments/mentions}
     *
     * @param int $since_id 若指定此参数，则返回ID比since_id大的评论（即比since_id时间晚的评论），默认为0。
     * @param int $max_id  若指定此参数，则返回ID小于或等于max_id的评论，默认为0。
     * @param int $count 单页返回的记录条数，默认为50。
     * @param int $page 返回结果的页码，默认为1。
     * @param int $filter_by_author  作者筛选类型，0：全部、1：我关注的人、2：陌生人，默认为0。
     * @param int $filter_by_source 来源筛选类型，0：全部、1：来自微博的评论、2：来自微群的评论，默认为0。
     * @return array
     */ 
    function comments_mentions( $page = 1, $count = 50, $since_id = 0, $max_id = 0, $filter_by_author = 0, $filter_by_source = 0)
    {
        $params = array();
        $params['since_id'] = $since_id;
        $params['max_id'] = $max_id;
        $params['count'] = $count;
        $params['page'] = $page;
        $params['filter_by_author'] = $filter_by_author;
        $params['filter_by_source'] = $filter_by_source;
        return $this->oauth->get( 'comments/mentions', $params );
    }


    /**
     * 根据评论ID批量返回评论信息
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/comments/show_batch comments/show_batch}
     *
     * @param string $cids 需要查询的批量评论ID，用半角逗号分隔，最大50
     * @return array
     */
    function comments_show_batch( $cids )
    {
        $params = array();
        if (is_array( $cids) && !empty( $cids)) {
            foreach($cids as $k => $v) {
                $this->id_format($cids[$k]);
            }
            $params['cids'] = join(',', $cids);
        } else {
            $params['cids'] = $cids;
        }
        return $this->oauth->get( 'comments/show_batch', $params );
    }


    /**
     * 对一条微博进行评论
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/comments/create comments/create}
     *
     * @param string $comment 评论内容，内容不超过140个汉字。
     * @param int $id 需要评论的微博ID。
     * @param int $comment_ori 当评论转发微博时，是否评论给原微博，0：否、1：是，默认为0。
     * @return array
     */
    function send_comment( $id , $comment , $comment_ori = 0)
    {
        $params = array();
        $params['comment'] = $comment;
        $this->id_format($id);
        $params['id'] = $id;
        $params['comment_ori'] = $comment_ori;
        return $this->oauth->post( 'comments/create', $params );
    }

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


    /**
     * 根据评论ID批量删除评论
     *
     * 注意：只能删除自己发布的评论，发部微博的用户不可以删除其他人的评论。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/comments/destroy_batch comments/destroy_batch}
     *
     * @access public
     * @param string $ids 需要删除的评论ID，用半角逗号隔开，最多20个。
     * @return array
     */
    function comment_destroy_batch( $ids )
    {
        $params = array();
        if (is_array($ids) && !empty($ids)) {
            foreach($ids as $k => $v) {
                $this->id_format($ids[$k]);
            }
            $params['cids'] = join(',', $ids);
        } else {
            $params['cids'] = $ids;
        }
        return $this->oauth->post( 'comments/destroy_batch', $params);
    }


    /**
     * 回复一条评论
     *
     * 为防止重复，发布的信息与最后一条评论/回复信息一样话，将会被忽略。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/comments/reply comments/reply}
     * 
     * @access public
     * @param int $sid 微博id
     * @param string $text 评论内容。
     * @param int $cid 评论id
     * @param int $without_mention 1：回复中不自动加入“回复@用户名”，0：回复中自动加入“回复@用户名”.默认为0.
     * @param int $comment_ori    当评论转发微博时，是否评论给原微博，0：否、1：是，默认为0。
     * @return array
     */
    function reply( $sid, $text, $cid, $without_mention = 0, $comment_ori = 0 )
    {
        $this->id_format( $sid );
        $this->id_format( $cid );
        $params = array();
        $params['id'] = $sid;
        $params['comment'] = $text;
        $params['cid'] = $cid;
        $params['without_mention'] = $without_mention;
        $params['comment_ori'] = $comment_ori;

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

    }

    /**
     * 根据用户UID或昵称获取用户资料
     *
     * 按用户UID或昵称返回用户资料，同时也将返回用户的最新发布的微博。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/users/show users/show}
     * 
     * @access public
     * @param int  $uid 用户UID。
     * @return array
     */
    function show_user_by_id( $uid )
    {
        $params=array();
        if ( $uid !== NULL ) {
            $this->id_format($uid);
            $params['uid'] = $uid;
        }

        return $this->oauth->get('users/show', $params );
    }
    
    /**
     * 根据用户UID或昵称获取用户资料
     *
     * 按用户UID或昵称返回用户资料，同时也将返回用户的最新发布的微博。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/users/show users/show}
     * 
     * @access public
     * @param string  $screen_name 用户UID。
     * @return array
     */
    function show_user_by_name( $screen_name )
    {
        $params = array();
        $params['screen_name'] = $screen_name;

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

    /**
     * 通过个性化域名获取用户资料以及用户最新的一条微博
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/users/domain_show users/domain_show}
     * 
     * @access public
     * @param mixed $domain 用户个性域名。例如：lazypeople，而不是http://weibo.com/lazypeople
     * @return array
     */
    function domain_show( $domain )
    {
        $params = array();
        $params['domain'] = $domain;
        return $this->oauth->get( 'users/domain_show', $params );
    }

     /**
     * 批量获取用户信息按uids
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/users/show_batch users/show_batch}
     *
     * @param string $uids 需要查询的用户ID，用半角逗号分隔，一次最多20个。
     * @return array
     */
    function users_show_batch_by_id( $uids )
    {
        $params = array();
        if (is_array( $uids ) && !empty( $uids )) {
            foreach( $uids as $k => $v ) {
                $this->id_format( $uids[$k] );
            }
            $params['uids'] = join(',', $uids);
        } else {
            $params['uids'] = $uids;
        }
        return $this->oauth->get( 'users/show_batch', $params );
    }
    
    /**
     * 批量获取用户信息按screen_name
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/users/show_batch users/show_batch}
     *
     * @param string  $screen_name 需要查询的用户昵称，用半角逗号分隔，一次最多20个。
     * @return array
     */
    function users_show_batch_by_name( $screen_name )
    {
        $params = array();
        if (is_array( $screen_name ) && !empty( $screen_name )) {
            $params['screen_name'] = join(',', $screen_name);
        } else {
            $params['screen_name'] = $screen_name;
        }
        return $this->oauth->get( 'users/show_batch', $params );
    }


    /**
     * 获取用户的关注列表
     *
     * 如果没有提供cursor参数，将只返回最前面的5000个关注id
     * <br />对应API：{@link http://open.weibo.com/wiki/2/friendships/friends friendships/friends}
     * 
     * @access public
     * @param int $cursor 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。
     * @param int $count 单页返回的记录条数，默认为50，最大不超过200。
     * @param int $uid  要获取的用户的ID。
     * @return array
     */
    function friends_by_id( $uid, $cursor = 0, $count = 50 )
    {
        $params = array();
        $params['cursor'] = $cursor;
        $params['count'] = $count;
        $params['uid'] = $uid;

        return $this->oauth->get( 'friendships/friends', $params );
    }
    
    
    /**
     * 获取用户的关注列表
     *
     * 如果没有提供cursor参数，将只返回最前面的5000个关注id
     * <br />对应API：{@link http://open.weibo.com/wiki/2/friendships/friends friendships/friends}
     * 
     * @access public
     * @param int $cursor 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。
     * @param int $count 单页返回的记录条数，默认为50，最大不超过200。
     * @param string $screen_name  要获取的用户的 screen_name
     * @return array
     */
    function friends_by_name( $screen_name, $cursor = 0, $count = 50 )
    {
        $params = array();
        $params['cursor'] = $cursor;
        $params['count'] = $count;
        $params['screen_name'] = $screen_name;
        return $this->oauth->get( 'friendships/friends', $params );
    }


    /**
     * 获取两个用户之间的共同关注人列表
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/friendships/friends/in_common friendships/friends/in_common}
     *
     * @param int $uid  需要获取共同关注关系的用户UID
     * @param int $suid  需要获取共同关注关系的用户UID，默认为当前登录用户。
     * @param int $count  单页返回的记录条数，默认为50。
     * @param int $page  返回结果的页码，默认为1。
     * @return array
     */
    function friends_in_common( $uid, $suid = NULL, $page = 1, $count = 50 )
    {
        $params = array();
        $params['uid'] = $uid;
        $params['suid'] = $suid;
        $params['count'] = $count;
        $params['page'] = $page;
        return $this->oauth->get( 'friendships/friends/in_common', $params  );
    }

    /**
     * 获取用户的双向关注列表，即互粉列表
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/friendships/friends/bilateral friendships/friends/bilateral}
     *
     * @param int $uid  需要获取双向关注列表的用户UID。
     * @param int $count  单页返回的记录条数，默认为50。
     * @param int $page  返回结果的页码，默认为1。
     * @param int $sort  排序类型，0：按关注时间最近排序，默认为0。
     * @return array
     **/
    function bilateral( $uid, $page = 1, $count = 50, $sort = 0 )
    {
        $params = array();
        $params['uid'] = $uid;
        $params['count'] = $count;
        $params['page'] = $page;
        $params['sort'] = $sort;
        return $this->oauth->get( 'friendships/friends/bilateral', $params  );
    }

    /**
     * 获取用户的双向关注uid列表
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/friendships/friends/bilateral/ids friendships/friends/bilateral/ids}
     *
     * @param int $uid  需要获取双向关注列表的用户UID。
     * @param int $count 单页返回的记录条数，默认为50。
     * @param int $page  返回结果的页码，默认为1。
     * @param int $sort  排序类型，0：按关注时间最近排序，默认为0。
     * @return array
     **/
    function bilateral_ids( $uid, $page = 1, $count = 50, $sort = 0)
    {
        $params = array();
        $params['uid'] = $uid;
        $params['count'] = $count;
        $params['page'] = $page;
        $params['sort'] = $sort;
        return $this->oauth->get( 'friendships/friends/bilateral/ids',  $params  );
    }

    /**
     * 获取用户的关注列表uid
     *
     * 如果没有提供cursor参数，将只返回最前面的5000个关注id
     * <br />对应API：{@link http://open.weibo.com/wiki/2/friendships/friends/ids friendships/friends/ids}
     * 
     * @access public
     * @param int $cursor 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。
     * @param int $count 每次返回的最大记录数（即页面大小），不大于5000, 默认返回500。
     * @param int $uid 要获取的用户 UID，默认为当前用户
     * @return array
     */
    function friends_ids_by_id( $uid, $cursor = 0, $count = 500 )
    {
        $params = array();
        $this->id_format($uid);
        $params['uid'] = $uid;
        $params['cursor'] = $cursor;
        $params['count'] = $count;
        return $this->oauth->get( 'friendships/friends/ids', $params );
    }
    
    /**
     * 获取用户的关注列表uid
     *
     * 如果没有提供cursor参数，将只返回最前面的5000个关注id
     * <br />对应API：{@link http://open.weibo.com/wiki/2/friendships/friends/ids friendships/friends/ids}
     * 
     * @access public
     * @param int $cursor 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。
     * @param int $count 每次返回的最大记录数（即页面大小），不大于5000, 默认返回500。
     * @param string $screen_name 要获取的用户的 screen_name，默认为当前用户
     * @return array
     */
    function friends_ids_by_name( $screen_name, $cursor = 0, $count = 500 )
    {
        $params = array();
        $params['cursor'] = $cursor;
        $params['count'] = $count;
        $params['screen_name'] = $screen_name;
        return $this->oauth->get( 'friendships/friends/ids', $params );
    }


    /**
     * 批量获取当前登录用户的关注人的备注信息
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/friendships/friends/remark_batch friendships/friends/remark_batch}
     *
     * @param string $uids  需要获取备注的用户UID，用半角逗号分隔，最多不超过50个。
     * @return array
     **/
    function friends_remark_batch( $uids )
    {
        $params = array();
        if (is_array( $uids ) && !empty( $uids )) {
            foreach( $uids as $k => $v) {
                $this->id_format( $uids[$k] );
            }
            $params['uids'] = join(',', $uids);
        } else {
            $params['uids'] = $uids;
        }
        return $this->oauth->get( 'friendships/friends/remark_batch', $params  );
    }

    /**
     * 获取用户的粉丝列表
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/friendships/followers friendships/followers}
     *
     * @param int $uid  需要查询的用户UID
     * @param int $count 单页返回的记录条数，默认为50，最大不超过200。
     * @param int $cursor false 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。
     * @return array
     **/
    function followers_by_id( $uid , $cursor = 0 , $count = 50)
    {
        $params = array();
        $this->id_format($uid);
        $params['uid'] = $uid;
        $params['count'] = $count;
        $params['cursor'] = $cursor;
        return $this->oauth->get( 'friendships/followers', $params  );
    }
    
    /**
     * 获取用户的粉丝列表
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/friendships/followers friendships/followers}
     *
     * @param string $screen_name  需要查询的用户的昵称
     * @param int  $count 单页返回的记录条数，默认为50，最大不超过200。
     * @param int  $cursor false 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。
     * @return array
     **/
    function followers_by_name( $screen_name, $cursor = 0 , $count = 50 )
    {
        $params = array();
        $params['screen_name'] = $screen_name;
        $params['count'] = $count;
        $params['cursor'] = $cursor;
        return $this->oauth->get( 'friendships/followers', $params  );
    }

    /**
     * 获取用户的粉丝列表uid
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/friendships/followers friendships/followers}
     *
     * @param int $uid 需要查询的用户UID
     * @param int $count 单页返回的记录条数，默认为50，最大不超过200。
     * @param int $cursor 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。
     * @return array
     **/
    function followers_ids_by_id( $uid, $cursor = 0 , $count = 50 )
    {
        $params = array();
        $this->id_format($uid);
        $params['uid'] = $uid;
        $params['count'] = $count;
        $params['cursor'] = $cursor;
        return $this->oauth->get( 'friendships/followers/ids', $params  );
    }
    
    /**
     * 获取用户的粉丝列表uid
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/friendships/followers friendships/followers}
     *
     * @param string $screen_name 需要查询的用户screen_name
     * @param int $count 单页返回的记录条数，默认为50，最大不超过200。
     * @param int $cursor 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。
     * @return array
     **/
    function followers_ids_by_name( $screen_name, $cursor = 0 , $count = 50 )
    {
        $params = array();
        $params['screen_name'] = $screen_name;
        $params['count'] = $count;
        $params['cursor'] = $cursor;
        return $this->oauth->get( 'friendships/followers/ids', $params  );
    }

    /**
     * 获取优质粉丝
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/friendships/followers/active friendships/followers/active}
     *
     * @param int $uid 需要查询的用户UID。
     * @param int $count 返回的记录条数，默认为20，最大不超过200。
     * @return array
     **/
    function followers_active( $uid,  $count = 20)
    {
        $param = array();
        $this->id_format($uid);
        $param['uid'] = $uid;
        $param['count'] = $count;
        return $this->oauth->get( 'friendships/followers/active', $param);
    }


    /**
     * 获取当前登录用户的关注人中又关注了指定用户的用户列表
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/friendships/friends_chain/followers friendships/friends_chain/followers}
     *
     * @param int $uid 指定的关注目标用户UID。
     * @param int $count 单页返回的记录条数，默认为50。
     * @param int $page 返回结果的页码，默认为1。
     * @return array
     **/
    function friends_chain_followers( $uid, $page = 1, $count = 50 )
    {
        $params = array();
        $this->id_format($uid);
        $params['uid'] = $uid;
        $params['count'] = $count;
        $params['page'] = $page;
        return $this->oauth->get( 'friendships/friends_chain/followers',  $params );
    }

    /**
     * 返回两个用户关系的详细情况
     *
     * 如果源用户或目的用户不存在，将返回http的400错误
     * <br />对应API：{@link http://open.weibo.com/wiki/2/friendships/show friendships/show}
     * 
     * @access public
     * @param mixed $target_id 目标用户UID
     * @param mixed $source_id 源用户UID，可选，默认为当前的用户
     * @return array
     */
    function is_followed_by_id( $target_id, $source_id = NULL )
    {
        $params = array();
        $this->id_format($target_id);
        $params['target_id'] = $target_id;

        if ( $source_id != NULL ) {
            $this->id_format($source_id);
            $params['source_id'] = $source_id;
        }

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

    /**
     * 返回两个用户关系的详细情况
     *
     * 如果源用户或目的用户不存在，将返回http的400错误
     * <br />对应API：{@link http://open.weibo.com/wiki/2/friendships/show friendships/show}
     * 
     * @access public
     * @param mixed $target_name 目标用户的微博昵称
     * @param mixed $source_name 源用户的微博昵称，可选，默认为当前的用户
     * @return array
     */
    function is_followed_by_name( $target_name, $source_name = NULL )
    {
        $params = array();
        $params['target_screen_name'] = $target_name;

        if ( $source_name != NULL ) {
            $params['source_screen_name'] = $source_name;
        }

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

    /**
     * 关注一个用户。
     *
     * 成功则返回关注人的资料，目前最多关注2000人，失败则返回一条字符串的说明。如果已经关注了此人，则返回http 403的状态。关注不存在的ID将返回400。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/friendships/create friendships/create}
     * 
     * @access public
     * @param int $uid 要关注的用户UID
     * @return array
     */
    function follow_by_id( $uid )
    {
        $params = array();
        $this->id_format($uid);
        $params['uid'] = $uid;
        return $this->oauth->post( 'friendships/create', $params );
    }
    
    /**
     * 关注一个用户。
     *
     * 成功则返回关注人的资料，目前的最多关注2000人，失败则返回一条字符串的说明。如果已经关注了此人，则返回http 403的状态。关注不存在的ID将返回400。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/friendships/create friendships/create}
     * 
     * @access public
     * @param string $screen_name 要关注的用户昵称
     * @return array
     */
    function follow_by_name( $screen_name )
    {
        $params = array();
        $params['screen_name'] = $screen_name;
        return $this->oauth->post( 'friendships/create', $params);
    }


    /**
     * 根据用户UID批量关注用户
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/friendships/create_batch friendships/create_batch}
     *
     * @param string $uids 要关注的用户UID，用半角逗号分隔，最多不超过20个。
     * @return array
     */
    function follow_create_batch( $uids )
    {
        $params = array();
        if (is_array($uids) && !empty($uids)) {
            foreach($uids as $k => $v) {
                $this->id_format($uids[$k]);
            }
            $params['uids'] = join(',', $uids);
        } else {
            $params['uids'] = $uids;
        }
        return $this->oauth->post( 'friendships/create_batch', $params);
    }

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

    /**
     * 更新当前登录用户所关注的某个好友的备注信息
     *
     * 只能修改当前登录用户所关注的用户的备注信息。否则将给出400错误。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/friendships/remark/update friendships/remark/update}
     * 
     * @access public
     * @param int $uid 需要修改备注信息的用户ID。
     * @param string $remark 备注信息。
     * @return array
     */
    function update_remark( $uid, $remark )
    {
        $params = array();
        $this->id_format($uid);
        $params['uid'] = $uid;
        $params['remark'] = $remark;
        return $this->oauth->post( 'friendships/remark/update', $params);
    }

    /**
     * 获取当前用户最新私信列表
     *
     * 返回用户的最新n条私信，并包含发送者和接受者的详细资料。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/direct_messages direct_messages}
     * 
     * @access public
     * @param int $page 页码
     * @param int $count 每次返回的最大记录数，最多返回200条，默认50。
     * @param int64 $since_id 返回ID比数值since_id大（比since_id时间晚的）的私信。可选。
     * @param int64 $max_id 返回ID不大于max_id(时间不晚于max_id)的私信。可选。
     * @return array
     */
    function list_dm( $page = 1, $count = 50, $since_id = 0, $max_id = 0 )
    {
        $params = array();
        if ($since_id) {
            $this->id_format($since_id);
            $params['since_id'] = $since_id;
        }
        if ($max_id) {
            $this->id_format($max_id);
            $params['max_id'] = $max_id;
        }

        return $this->request_with_pager( 'direct_messages', $page, $count, $params );
    }

    /**
     * 获取当前用户发送的最新私信列表
     *
     * 返回登录用户已发送最新50条私信。包括发送者和接受者的详细资料。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/direct_messages/sent direct_messages/sent}
     * 
     * @access public
     * @param int $page 页码
     * @param int $count 每次返回的最大记录数，最多返回200条，默认50。
     * @param int64 $since_id 返回ID比数值since_id大（比since_id时间晚的）的私信。可选。
     * @param int64 $max_id 返回ID不大于max_id(时间不晚于max_id)的私信。可选。
     * @return array
     */
    function list_dm_sent( $page = 1, $count = 50, $since_id = 0, $max_id = 0 )
    {
        $params = array();
        if ($since_id) {
            $this->id_format($since_id);
            $params['since_id'] = $since_id;
        }
        if ($max_id) {
            $this->id_format($max_id);
            $params['max_id'] = $max_id;
        }

        return $this->request_with_pager( 'direct_messages/sent', $page, $count, $params );
    }


    /**
     * 获取与当前登录用户有私信往来的用户列表，与该用户往来的最新私信
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/direct_messages/user_list direct_messages/user_list}
     *
     * @param int $count  单页返回的记录条数，默认为20。
     * @param int $cursor 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。
     * @return array
     */
    function dm_user_list( $count = 20, $cursor = 0)
    {
        $params = array();
        $params['count'] = $count;
        $params['cursor'] = $cursor;
        return $this->oauth->get( 'direct_messages/user_list', $params );
    } 

    /**
     * 获取与指定用户的往来私信列表
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/direct_messages/conversation direct_messages/conversation}
     *
     * @param int $uid 需要查询的用户的UID。
     * @param int $since_id 若指定此参数，则返回ID比since_id大的私信（即比since_id时间晚的私信），默认为0。
     * @param int $max_id  若指定此参数，则返回ID小于或等于max_id的私信，默认为0。
     * @param int $count 单页返回的记录条数，默认为50。
     * @param int $page  返回结果的页码，默认为1。
     * @return array
     */
    function dm_conversation( $uid, $page = 1, $count = 50, $since_id = 0, $max_id = 0)
    {
        $params = array();
        $this->id_format($uid);
        $params['uid'] = $uid;
        if ($since_id) {
            $this->id_format($since_id);
            $params['since_id'] = $since_id;
        }
        if ($max_id) {
            $this->id_format($max_id);
            $params['max_id'] = $max_id;
        }
        $params['count'] = $count;
        $params['page'] = $page;
        return $this->oauth->get( 'direct_messages/conversation', $params );
    }

    /**
     * 根据私信ID批量获取私信内容
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/direct_messages/show_batch direct_messages/show_batch}
     *
     * @param string  $dmids 需要查询的私信ID，用半角逗号分隔，一次最多50个
     * @return array
     */
    function dm_show_batch( $dmids )
    {
        $params = array();
        if (is_array($dmids) && !empty($dmids)) {
            foreach($dmids as $k => $v) {
                $this->id_format($dmids[$k]);
            }
            $params['dmids'] = join(',', $dmids);
        } else {
            $params['dmids'] = $dmids;
        }
        return $this->oauth->get( 'direct_messages/show_batch',  $params );
    }

    /**
     * 发送私信
     *
     * 发送一条私信。成功将返回完整的发送消息。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/direct_messages/new direct_messages/new}
     * 
     * @access public
     * @param int $uid 用户UID
     * @param string $text 要发生的消息内容，文本大小必须小于300个汉字。
     * @param int $id 需要发送的微博ID。
     * @return array
     */
    function send_dm_by_id( $uid, $text, $id = NULL )
    {
        $params = array();
        $this->id_format( $uid );
        $params['text'] = $text;
        $params['uid'] = $uid;
        if ($id) {
            $this->id_format( $id );
            $params['id'] = $id;
        }
        return $this->oauth->post( 'direct_messages/new', $params );
    }
    
    /**
     * 发送私信
     *
     * 发送一条私信。成功将返回完整的发送消息。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/direct_messages/new direct_messages/new}
     * 
     * @access public
     * @param string $screen_name 用户昵称
     * @param string $text 要发生的消息内容，文本大小必须小于300个汉字。
     * @param int $id 需要发送的微博ID。
     * @return array
     */
    function send_dm_by_name( $screen_name, $text, $id = NULL )
    {
        $params = array();
        $params['text'] = $text;
        $params['screen_name'] = $screen_name;
        if ($id) {
            $this->id_format( $id );
            $params['id'] = $id;
        }
        return $this->oauth->post( 'direct_messages/new', $params);
    }

    /**
     * 删除一条私信
     *
     * 按ID删除私信。操作用户必须为私信的接收人。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/direct_messages/destroy direct_messages/destroy}
     * 
     * @access public
     * @param int $did 要删除的私信主键ID
     * @return array
     */
    function delete_dm( $did )
    {
        $this->id_format($did);
        $params = array();
        $params['id'] = $did;
        return $this->oauth->post('direct_messages/destroy', $params);
    }

    /**
     * 批量删除私信
     *
     * 批量删除当前登录用户的私信。出现异常时，返回400错误。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/direct_messages/destroy_batch direct_messages/destroy_batch}
     * 
     * @access public
     * @param mixed $dids 欲删除的一组私信ID，用半角逗号隔开，或者由一组评论ID组成的数组。最多20个。例如："4976494627, 4976262053"或array(4976494627,4976262053);
     * @return array
     */
    function delete_dms( $dids )
    {
        $params = array();
        if (is_array($dids) && !empty($dids)) {
            foreach($dids as $k => $v) {
                $this->id_format($dids[$k]);
            }
            $params['ids'] = join(',', $dids);
        } else {
            $params['ids'] = $dids;
        }

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


    /**
     * 获取用户基本信息
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/basic account/profile/basic}
     *
     * @param int $uid  需要获取基本信息的用户UID，默认为当前登录用户。
     * @return array
     */
    function account_profile_basic( $uid = NULL  )
    {
        $params = array();
        if ($uid) {
            $this->id_format($uid);
            $params['uid'] = $uid;
        }
        return $this->oauth->get( 'account/profile/basic', $params );
    }

    /**
     * 获取用户的教育信息
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/education account/profile/education}
     *
     * @param int $uid  需要获取教育信息的用户UID，默认为当前登录用户。
     * @return array
     */
    function account_education( $uid = NULL )
    {
        $params = array();
        if ($uid) {
            $this->id_format($uid);
            $params['uid'] = $uid;
        }
        return $this->oauth->get( 'account/profile/education', $params );
    }

    /**
     * 批量获取用户的教育信息
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/education_batch account/profile/education_batch}
     *
     * @param string $uids 需要获取教育信息的用户UID，用半角逗号分隔，最多不超过20。
     * @return array
     */
    function account_education_batch( $uids  )
    {
        $params = array();
        if (is_array($uids) && !empty($uids)) {
            foreach($uids as $k => $v) {
                $this->id_format($uids[$k]);
            }
            $params['uids'] = join(',', $uids);
        } else {
            $params['uids'] = $uids;
        }

        return $this->oauth->get( 'account/profile/education_batch', $params );
    }


    /**
     * 获取用户的职业信息
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/career account/profile/career}
     *
     * @param int $uid  需要获取教育信息的用户UID，默认为当前登录用户。
     * @return array
     */
    function account_career( $uid = NULL )
    {
        $params = array();
        if ($uid) {
            $this->id_format($uid);
            $params['uid'] = $uid;
        }
        return $this->oauth->get( 'account/profile/career', $params );
    }

    /**
     * 批量获取用户的职业信息
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/career_batch account/profile/career_batch}
     *
     * @param string $uids 需要获取教育信息的用户UID，用半角逗号分隔，最多不超过20。
     * @return array
     */
    function account_career_batch( $uids )
    {
        $params = array();
        if (is_array($uids) && !empty($uids)) {
            foreach($uids as $k => $v) {
                $this->id_format($uids[$k]);
            }
            $params['uids'] = join(',', $uids);
        } else {
            $params['uids'] = $uids;
        }

        return $this->oauth->get( 'account/profile/career_batch', $params );
    }

    /**
     * 获取隐私信息设置情况
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/account/get_privacy account/get_privacy}
     * 
     * @access public
     * @return array
     */
    function get_privacy()
    {
        return $this->oauth->get('account/get_privacy');
    }

    /**
     * 获取所有的学校列表
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/school_list account/profile/school_list}
     *
     * @param array $query 搜索选项。格式：array('key0'=>'value0', 'key1'=>'value1', ....)。支持的key:
     *  - 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参数。
     * @access public
     * @return array
     */
    function school_list( $query )
    {
        $params = $query;

        return $this->oauth->get( 'account/profile/school_list', $params );
    }

    /**
     * 获取当前登录用户的API访问频率限制情况
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/account/rate_limit_status account/rate_limit_status}
     * 
     * @access public
     * @return array
     */
    function rate_limit_status()
    {
        return $this->oauth->get( 'account/rate_limit_status' );
    }

    /**
     * OAuth授权之后，获取授权用户的UID
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/account/get_uid account/get_uid}
     * 
     * @access public
     * @return array
     */
    function get_uid()
    {
        return $this->oauth->get( 'account/get_uid' );
    }


    /**
     * 更改用户资料
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/basic_update account/profile/basic_update}
     * 
     * @access public
     * @param array $profile 要修改的资料。格式：array('key1'=>'value1', 'key2'=>'value2', .....)。
     * 支持修改的项：
     *  - screen_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
     */
    function update_profile( $profile )
    {
        return $this->oauth->post( 'account/profile/basic_update',  $profile);
    }


    /**
     * 设置教育信息
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/edu_update account/profile/edu_update}
     * 
     * @access public
     * @param array $edu_update 要修改的学校信息。格式：array('key1'=>'value1', 'key2'=>'value2', .....)。
     * 支持设置的项：
     *  - 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
     */
    function edu_update( $edu_update )
    {
        return $this->oauth->post( 'account/profile/edu_update',  $edu_update);
    }

    /**
     * 根据学校ID删除用户的教育信息
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/edu_destroy account/profile/edu_destroy}
     * 
     * @param int $id 教育信息里的学校ID。
     * @return array
     */
    function edu_destroy( $id )
    {
        $this->id_format( $id );
        $params = array();
        $params['id'] = $id;
        return $this->oauth->post( 'account/profile/edu_destroy', $params);
    }

    /**
     * 设置职业信息
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/car_update account/profile/car_update}
     * 
     * @param array $car_update 要修改的职业信息。格式：array('key1'=>'value1', 'key2'=>'value2', .....)。
     * 支持设置的项：
     *  - 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
     */
    function car_update( $car_update )
    {
        return $this->oauth->post( 'account/profile/car_update', $car_update);
    }

    /**
     * 根据公司ID删除用户的职业信息
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/account/profile/car_destroy account/profile/car_destroy}
     * 
     * @access public
     * @param int $id  职业信息里的公司ID
     * @return array
     */
    function car_destroy( $id )
    {
        $this->id_format($id);
        $params = array();
        $params['id'] = $id;
        return $this->oauth->post( 'account/profile/car_destroy', $params);
    }

    /**
     * 更改头像
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/account/avatar/upload account/avatar/upload}
     *
     * @param string $image_path 要上传的头像路径, 支持url。[只支持png/jpg/gif三种格式, 增加格式请修改get_image_mime方法] 必须为小于700K的有效的GIF, JPG图片. 如果图片大于500像素将按比例缩放。
     * @return array
     */
    function update_profile_image( $image_path )
    {
        $params = array();
        $params['image'] = "@{$image_path}";

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

    /**
     * 设置隐私信息
     *
     * 对应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
     */
    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}
     * 
     * @access public
     * @param  int $page 返回结果的页码，默认为1。
     * @param  int $count 单页返回的记录条数，默认为50。
     * @return array
     */
    function get_favorites( $page = 1, $count = 50 )
    {
        $params = array();
        $params['page'] = intval($page);
        $params['count'] = intval($count);

        return $this->oauth->get( 'favorites', $params );
    }


    /**
     * 根据收藏ID获取指定的收藏信息
     *
     * 根据收藏ID获取指定的收藏信息。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/favorites/show favorites/show}
     * 
     * @access public
     * @param int $id 需要查询的收藏ID。
     * @return array
     */
    function favorites_show( $id )
    {
        $params = array();
        $this->id_format($id);
        $params['id'] = $id;
        return $this->oauth->get( 'favorites/show', $params );
    }


    /**
     * 根据标签获取当前登录用户该标签下的收藏列表
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/favorites/by_tags favorites/by_tags}
     *
     * 
     * @param int $tid  需要查询的标签ID。'
     * @param int $count 单页返回的记录条数，默认为50。
     * @param int $page 返回结果的页码，默认为1。
     * @return array
     */
    function favorites_by_tags( $tid, $page = 1, $count = 50)
    {
        $params = array();
        $params['tid'] = $tid;
        $params['count'] = $count;
        $params['page'] = $page;
        return $this->oauth->get( 'favorites/by_tags', $params );
    }


    /**
     * 获取当前登录用户的收藏标签列表
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/favorites/tags favorites/tags}
     * 
     * @access public
     * @param int $count 单页返回的记录条数，默认为50。
     * @param int $page 返回结果的页码，默认为1。
     * @return array
     */
    function favorites_tags( $page = 1, $count = 50)
    {
        $params = array();
        $params['count'] = $count;
        $params['page'] = $page;
        return $this->oauth->get( 'favorites/tags', $params );
    }


    /**
     * 收藏一条微博信息
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/favorites/create favorites/create}
     * 
     * @access public
     * @param int $sid 收藏的微博id
     * @return array
     */
    function add_to_favorites( $sid )
    {
        $this->id_format($sid);
        $params = array();
        $params['id'] = $sid;

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

    /**
     * 删除微博收藏。
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/favorites/destroy favorites/destroy}
     * 
     * @access public
     * @param int $id 要删除的收藏微博信息ID.
     * @return array
     */
    function remove_from_favorites( $id )
    {
        $this->id_format($id);
        $params = array();
        $params['id'] = $id;
        return $this->oauth->post( 'favorites/destroy', $params);
    }


    /**
     * 批量删除微博收藏。
     *
     * 批量删除当前登录用户的收藏。出现异常时，返回HTTP400错误。
     * <br />对应API：{@link http://open.weibo.com/wiki/2/favorites/destroy_batch favorites/destroy_batch}
     * 
     * @access public
     * @param mixed $fids 欲删除的一组私信ID，用半角逗号隔开，或者由一组评论ID组成的数组。最多20个。例如："231101027525486630,201100826122315375"或array(231101027525486630,201100826122315375);
     * @return array
     */
    function remove_from_favorites_batch( $fids )
    {
        $params = array();
        if (is_array($fids) && !empty($fids)) {
            foreach ($fids as $k => $v) {
                $this->id_format($fids[$k]);
            }
            $params['ids'] = join(',', $fids);
        } else {
            $params['ids'] = $fids;
        }

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


    /**
     * 更新一条收藏的收藏标签
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/favorites/tags/update favorites/tags/update}
     * 
     * @access public
     * @param int $id 需要更新的收藏ID。
     * @param string $tags 需要更新的标签内容，用半角逗号分隔，最多不超过2条。
     * @return array
     */
    function favorites_tags_update( $id,  $tags )
    {
        $params = array();
        $params['id'] = $id;
        if (is_array($tags) && !empty($tags)) {
            foreach ($tags as $k => $v) {
                $this->id_format($tags[$k]);
            }
            $params['tags'] = join(',', $tags);
        } else {
            $params['tags'] = $tags;
        }
        return $this->oauth->post( 'favorites/tags/update', $params );
    }

    /**
     * 更新当前登录用户所有收藏下的指定标签
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/favorites/tags/update_batch favorites/tags/update_batch}
     *
     * @param int $tid  需要更新的标签ID。必填
     * @param string $tag  需要更新的标签内容。必填
     * @return array
     */
    function favorites_update_batch( $tid, $tag )
    {
        $params = array();
        $params['tid'] = $tid;
        $params['tag'] = $tag;
        return $this->oauth->post( 'favorites/tags/update_batch', $params);
    }

    /**
     * 删除当前登录用户所有收藏下的指定标签
     *
     * 删除标签后，该用户所有收藏中，添加了该标签的收藏均解除与该标签的关联关系
     * <br />对应API：{@link http://open.weibo.com/wiki/2/favorites/tags/destroy_batch favorites/tags/destroy_batch}
     *
     * @param int $tid  需要更新的标签ID。必填
     * @return array
     */
    function favorites_tags_destroy_batch( $tid )
    {
        $params = array();
        $params['tid'] = $tid;
        return $this->oauth->post( 'favorites/tags/destroy_batch', $params);
    }

    /**
     * 获取某用户的话题
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/trends trends}
     * 
     * @param int $uid 查询用户的ID。默认为当前用户。可选。
     * @param int $page 指定返回结果的页码。可选。
     * @param int $count 单页大小。缺省值10。可选。
     * @return array
     */
    function get_trends( $uid = NULL, $page = 1, $count = 10 )
    {
        $params = array();
        if ($uid) {
            $params['uid'] = $uid;
        } else {
            $user_info = $this->get_uid();
            $params['uid'] = $user_info['uid'];
        }
        $this->id_format( $params['uid'] );
        $params['page'] = $page;
        $params['count'] = $count;
        return $this->oauth->get( 'trends', $params );
    }


    /**
     * 判断当前用户是否关注某话题
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/trends/is_follow trends/is_follow}
     * 
     * @access public
     * @param string $trend_name 话题关键字。
     * @return array
     */
    function trends_is_follow( $trend_name )
    {
        $params = array();
        $params['trend_name'] = $trend_name;
        return $this->oauth->get( 'trends/is_follow', $params );
    }

    /**
     * 返回最近一小时内的热门话题
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/trends/hourly trends/hourly}
     * 
     * @param  int $base_app 是否基于当前应用来获取数据。1表示基于当前应用来获取数据，默认为0。可选。
     * @return array
     */
    function hourly_trends( $base_app = 0 )
    {
        $params = array();
        $params['base_app'] = $base_app;

        return $this->oauth->get( 'trends/hourly', $params );
    }

    /**
     * 返回最近一天内的热门话题
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/trends/daily trends/daily}
     * 
     * @param int $base_app 是否基于当前应用来获取数据。1表示基于当前应用来获取数据，默认为0。可选。
     * @return array
     */
    function daily_trends( $base_app = 0 )
    {
        $params = array();
        $params['base_app'] = $base_app;

        return $this->oauth->get( 'trends/daily', $params );
    }

    /**
     * 返回最近一周内的热门话题
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/trends/weekly trends/weekly}
     * 
     * @access public
     * @param int $base_app 是否基于当前应用来获取数据。1表示基于当前应用来获取数据，默认为0。可选。
     * @return array
     */
    function weekly_trends( $base_app = 0 )
    {
        $params = array();
        $params['base_app'] = $base_app;

        return $this->oauth->get( 'trends/weekly', $params );
    }

    /**
     * 关注某话题
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/trends/follow trends/follow}
     * 
     * @access public
     * @param string $trend_name 要关注的话题关键词。
     * @return array
     */
    function follow_trends( $trend_name )
    {
        $params = array();
        $params['trend_name'] = $trend_name;
        return $this->oauth->post( 'trends/follow', $params );
    }

    /**
     * 取消对某话题的关注
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/trends/destroy trends/destroy}
     * 
     * @access public
     * @param int $tid 要取消关注的话题ID。
     * @return array
     */
    function unfollow_trends( $tid )
    {
        $this->id_format($tid);

        $params = array();
        $params['trend_id'] = $tid;

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

    /**
     * 返回指定用户的标签列表
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/tags tags}
     * 
     * @param int $uid 查询用户的ID。默认为当前用户。可选。
     * @param int $page 指定返回结果的页码。可选。
     * @param int $count 单页大小。缺省值20，最大值200。可选。
     * @return array
     */
    function get_tags( $uid = NULL, $page = 1, $count = 20 )
    {
        $params = array();
        if ( $uid ) {
            $params['uid'] = $uid;
        } else {
            $user_info = $this->get_uid();
            $params['uid'] = $user_info['uid'];
        }
        $this->id_format( $params['uid'] );
        $params['page'] = $page;
        $params['count'] = $count;
        return $this->oauth->get( 'tags', $params );
    }

    /**
     * 批量获取用户的标签列表
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/tags/tags_batch tags/tags_batch}
     * 
     * @param  string $uids 要获取标签的用户ID。最大20，逗号分隔。必填
     * @return array
     */
    function get_tags_batch( $uids )
    {
        $params = array();
        if (is_array( $uids ) && !empty( $uids )) {
            foreach ($uids as $k => $v) {
                $this->id_format( $uids[$k] );
            }
            $params['uids'] = join(',', $uids);
        } else {
            $params['uids'] = $uids;
        }
        return $this->oauth->get( 'tags/tags_batch', $params );
    }

    /**
     * 返回用户感兴趣的标签
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/tags/suggestions tags/suggestions}
     * 
     * @access public
     * @param int $count 单页大小。缺省值10，最大值10。可选。
     * @return array
     */
    function get_suggest_tags( $count = 10)
    {
        $params = array();
        $params['count'] = intval($count);
        return $this->oauth->get( 'tags/suggestions', $params );
    }

    /**
     * 为当前登录用户添加新的用户标签
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/tags/create tags/create}
     * 
     * @access public
     * @param mixed $tags 要创建的一组标签，每个标签的长度不可超过7个汉字，14个半角字符。多个标签之间用逗号间隔，或由多个标签构成的数组。如："abc,drf,efgh,tt"或array("abc", "drf", "efgh", "tt")
     * @return array
     */
    function add_tags( $tags )
    {
        $params = array();
        if (is_array($tags) && !empty($tags)) {
            $params['tags'] = join(',', $tags);
        } else {
            $params['tags'] = $tags;
        }
        return $this->oauth->post( 'tags/create', $params);
    }

    /**
     * 删除标签
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/tags/destroy tags/destroy}
     * 
     * @access public
     * @param int $tag_id 标签ID，必填参数
     * @return array
     */
    function delete_tag( $tag_id )
    {
        $params = array();
        $params['tag_id'] = $tag_id;
        return $this->oauth->post( 'tags/destroy', $params );
    }

    /**
     * 批量删除标签
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/tags/destroy_batch tags/destroy_batch}
     * 
     * @access public
     * @param mixed $ids 必选参数，要删除的tag id，多个id用半角逗号分割，最多10个。或由多个tag id构成的数组。如：“553,554,555"或array(553, 554, 555)
     * @return array
     */
    function delete_tags( $ids )
    {
        $params = array();
        if (is_array($ids) && !empty($ids)) {
            $params['ids'] = join(',', $ids);
        } else {
            $params['ids'] = $ids;
        }
        return $this->oauth->post( 'tags/destroy_batch', $params );
    }


    /**
     * 验证昵称是否可用，并给予建议昵称
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/register/verify_nickname register/verify_nickname}
     *
     * @param string $nickname 需要验证的昵称。4-20个字符，支持中英文、数字、"_"或减号。必填
     * @return array
     */
    function verify_nickname( $nickname )
    {
        $params = array();
        $params['nickname'] = $nickname;
        return $this->oauth->get( 'register/verify_nickname', $params );
    }



    /**
     * 搜索用户时的联想搜索建议
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/search/suggestions/users search/suggestions/users}
     *
     * @param string $q 搜索的关键字，必须做URLencoding。必填,中间最好不要出现空格
     * @param int $count 返回的记录条数，默认为10。
     * @return array
     */
    function search_users( $q,  $count = 10 )
    {
        $params = array();
        $params['q'] = $q;
        $params['count'] = $count;
        return $this->oauth->get( 'search/suggestions/users',  $params );
    }


    /**
     * 搜索微博时的联想搜索建议
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/search/suggestions/statuses search/suggestions/statuses}
     *
     * @param string $q 搜索的关键字，必须做URLencoding。必填
     * @param int $count 返回的记录条数，默认为10。
     * @return array
     */
    function search_statuses( $q,  $count = 10)
    {
        $params = array();
        $params['q'] = $q;
        $params['count'] = $count;
        return $this->oauth->get( 'search/suggestions/statuses', $params );
    }


    /**
     * 搜索学校时的联想搜索建议
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/search/suggestions/schools search/suggestions/schools}
     *
     * @param string $q 搜索的关键字，必须做URLencoding。必填
     * @param int $count 返回的记录条数，默认为10。
     * @param int type 学校类型，0：全部、1：大学、2：高中、3：中专技校、4：初中、5：小学，默认为0。选填
     * @return array
     */
    function search_schools( $q,  $count = 10,  $type = 1)
    {
        $params = array();
        $params['q'] = $q;
        $params['count'] = $count;
        $params['type'] = $type;
        return $this->oauth->get( 'search/suggestions/schools', $params );
    }

    /**
     * 搜索公司时的联想搜索建议
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/search/suggestions/companies search/suggestions/companies}
     *
     * @param string $q 搜索的关键字，必须做URLencoding。必填
     * @param int $count 返回的记录条数，默认为10。
     * @return array
     */
    function search_companies( $q, $count = 10)
    {
        $params = array();
        $params['q'] = $q;
        $params['count'] = $count;
        return $this->oauth->get( 'search/suggestions/companies', $params );
    }


    /**
     * ＠用户时的联想建议
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/search/suggestions/at_users search/suggestions/at_users}
     *
     * @param string $q 搜索的关键字，必须做URLencoding。必填
     * @param int $count 返回的记录条数，默认为10。
     * @param int $type 联想类型，0：关注、1：粉丝。必填
     * @param int $range 联想范围，0：只联想关注人、1：只联想关注人的备注、2：全部，默认为2。选填
     * @return array
     */
    function search_at_users( $q, $count = 10, $type=0, $range = 2)
    {
        $params = array();
        $params['q'] = $q;
        $params['count'] = $count;
        $params['type'] = $type;
        $params['range'] = $range;
        return $this->oauth->get( 'search/suggestions/at_users', $params );
    }


    


    /**
     * 搜索与指定的一个或多个条件相匹配的微博
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/search/statuses search/statuses}
     *
     * @param array $query 搜索选项。格式：array('key0'=>'value0', 'key1'=>'value1', ....)。支持的key:
     *  - 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
     */
    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
     */
    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}
     * 
     * @access public
     * @param string $category 分类，可选参数，返回某一类别的推荐用户，默认为 default。如果不在以下分类中，返回空列表：<br />
     *  - default:人气关注
     *  - ent:影视名星
     *  - hk_famous:港台名人
     *  - model:模特
     *  - cooking:美食&健康
     *  - sport:体育名人
     *  - finance:商界名人
     *  - tech:IT互联网
     *  - singer:歌手
     *  - writer：作家
     *  - moderator:主持人
     *  - medium:媒体总编
     *  - stockplayer:炒股高手
     * @return array
     */
    function hot_users( $category = "default" )
    {
        $params = array();
        $params['category'] = $category;

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

    /**
     * 获取用户可能感兴趣的人
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/suggestions/users/may_interested suggestions/users/may_interested}
     * 
     * @access public
     * @param int $page 返回结果的页码，默认为1。
     * @param int $count 单页返回的记录条数，默认为10。
     * @return array
     * @ignore
     */
    function suggestions_may_interested( $page = 1, $count = 10 )
    {   
        $params = array();
        $params['page'] = $page;
        $params['count'] = $count;
        return $this->oauth->get( 'suggestions/users/may_interested', $params);
    }

    /**
     * 根据一段微博正文推荐相关微博用户。 
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/suggestions/users/by_status suggestions/users/by_status}
     * 
     * @access public
     * @param string $content 微博正文内容。
     * @param int $num 返回结果数目，默认为10。
     * @return array
     */
    function suggestions_users_by_status( $content, $num = 10 )
    {
        $params = array();
        $params['content'] = $content;
        $params['num'] = $num;
        return $this->oauth->get( 'suggestions/users/by_status', $params);
    }

    /**
     * 热门收藏
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/suggestions/favorites/hot suggestions/favorites/hot}
     *
     * @param int $count 每页返回结果数，默认20。选填
     * @param int $page 返回页码，默认1。选填
     * @return array
     */
    function hot_favorites( $page = 1, $count = 20 )
    {
        $params = array();
        $params['count'] = $count;
        $params['page'] = $page;
        return $this->oauth->get( 'suggestions/favorites/hot', $params);
    }

    /**
     * 把某人标识为不感兴趣的人
     *
     * 对应API：{@link http://open.weibo.com/wiki/2/suggestions/users/not_interested suggestions/users/not_interested}
     *
     * @param int $uid 不感兴趣的用户的UID。
     * @return array
     */
    function put_users_not_interested( $uid )
    {
        $params = array();
        $params['uid'] = $uid;
        return $this->oauth->post( 'suggestions/users/not_interested', $params);
    }



    // =========================================

    /**
     * @ignore
     */
    protected function request_with_pager( $url, $page = false, $count = false, $params = array() )
    {
        if( $page ) $params['page'] = $page;
        if( $count ) $params['count'] = $count;

        return $this->oauth->get($url, $params );
    }

    /**
     * @ignore
     */
    protected function request_with_uid( $url, $uid_or_name, $page = false, $count = false, $cursor = false, $post = false, $params = array())
    {
        if( $page ) $params['page'] = $page;
        if( $count ) $params['count'] = $count;
        if( $cursor )$params['cursor'] =  $cursor;

        if( $post ) $method = 'post';
        else $method = 'get';

        if ( $uid_or_name !== NULL ) {
            $this->id_format($uid_or_name);
            $params['id'] = $uid_or_name;
        }

        return $this->oauth->$method($url, $params );

    }

    /**
     * @ignore
     */
    protected function id_format(&$id) {
        if ( is_float($id) ) {
            $id = number_format($id, 0, '', '');
        } elseif ( is_string($id) ) {
            $id = trim($id);
        }
    }

}