Overview

Namespaces

  • None
  • sinacloud
    • sae

Classes

  • SaeADPNS
  • SaeAPNS
  • SaeChannel
  • SaeDeferredJob
  • SaeFetchInternal
  • SaeKV
  • SaeMail
  • SaeMysql
  • SaeSegment
  • SaeTAdvance
  • SaeTaskQueue
  • SaeTClientV2
  • SaeTOAuthV2
  • SaeVCode
  • sinacloud\sae\Storage
  • vDisk

Exceptions

  • OAuthException
  • sinacloud\sae\StorageException
  • Overview
  • Namespace
  • Class
   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: 
<?php
/**
 * vDisk sdk for SAE and Standard PHP
 *
 * @version $Id$
 * @package sae
 * @author Bruce Chen
 */


/**
 * @ignore
 */
define('URL_GET_TOKEN', 'http://openapi.vdisk.me/?m=auth&a=get_token');
/**
 * @ignore
 */
define('URL_KEEP_TOKEN', 'http://openapi.vdisk.me/?m=user&a=keep_token');
/**
 * @ignore
 */
define('URL_UPLOAD_FILE', 'http://openapi.vdisk.me/?m=file&a=upload_file');
/**
 * @ignore
 */
define('URL_UPLOAD_SHARE_FILE', 'http://openapi.vdisk.me/?m=file&a=upload_share_file');
/**
 * @ignore
 */
define('URL_CREATE_DIR', 'http://openapi.vdisk.me/?m=dir&a=create_dir');
/**
 * @ignore
 */
define('URL_GET_LIST', 'http://openapi.vdisk.me/?m=dir&a=get_list');
/**
 * @ignore
 */
define('URL_GET_QUOTA', 'http://openapi.vdisk.me/?m=file&a=get_quota');
/**
 * @ignore
 */
define('URL_UPLOAD_WITH_SHA1', 'http://openapi.vdisk.me/?m=file&a=upload_with_sha1');
/**
 * @ignore
 */
define('URL_GET_FILE_INFO', 'http://openapi.vdisk.me/?m=file&a=get_file_info');
/**
 * @ignore
 */
define('URL_DELETE_DIR', 'http://openapi.vdisk.me/?m=dir&a=delete_dir');
/**
 * @ignore
 */
define('URL_DELETE_FILE', 'http://openapi.vdisk.me/?m=file&a=delete_file');
/**
 * @ignore
 */
define('URL_COPY_FILE', 'http://openapi.vdisk.me/?m=file&a=copy_file');
/**
 * @ignore
 */
define('URL_MOVE_FILE', 'http://openapi.vdisk.me/?m=file&a=move_file');
/**
 * @ignore
 */
define('URL_RENAME_FILE', 'http://openapi.vdisk.me/?m=file&a=rename_file');
/**
 * @ignore
 */
define('URL_RENAME_DIR', 'http://openapi.vdisk.me/?m=dir&a=rename_dir');
/**
 * @ignore
 */
define('URL_MOVE_DIR', 'http://openapi.vdisk.me/?m=dir&a=move_dir');
/**
 * @ignore
 */
define('URL_SHARE_FILE', 'http://openapi.vdisk.me/?m=file&a=share_file');
/**
 * @ignore
 */
define('URL_CANCEL_SHARE_FILE', 'http://openapi.vdisk.me/?m=file&a=cancel_share_file');
/**
 * @ignore
 */
define('URL_RECYCLE_GET_LIST', 'http://openapi.vdisk.me/?m=recycle&a=get_list');
/**
 * @ignore
 */
define('URL_TRUNCATE_RECYCLE_GET', 'http://openapi.vdisk.me/?m=recycle&a=truncate_recycle');
/**
 * @ignore
 */
define('URL_RECYCLE_DELETE_FILE', 'http://openapi.vdisk.me/?m=recycle&a=delete_file');
/**
 * @ignore
 */
define('URL_RECYCLE_DELETE_DIR', 'http://openapi.vdisk.me/?m=recycle&a=delete_dir');
/**
 * @ignore
 */
define('URL_RECYCLE_RESTORE_FILE', 'http://openapi.vdisk.me/?m=recycle&a=restore_file');
/**
 * @ignore
 */
define('URL_RECYCLE_RESTORE_DIR', 'http://openapi.vdisk.me/?m=recycle&a=restore_dir');
/**
 * @ignore
 */
define('URL_GET_DIRID_WITH_PATH', 'http://openapi.vdisk.me/?m=dir&a=get_dirid_with_path');
/**
 * @ignore
 */
define('URL_EMAIL_SHARE_FILE', 'http://openapi.vdisk.me/?m=file&a=email_share_file');



/**
 * 微盘API
 *
 * 微盘Open API是为第三方开发者提供的一套REST接口,通过该接口任何第三方的公司和个人都可以创建基于微盘的应用.更多{@link http://vdisk.me/api 相关说明} .
 * 
 * 使用方法:
 * <code>
 * include_once('vdisk.ex.class.php');
 * $appkey = 1234567;
 * $appsecret = '123456739cc20556637a576ea1234567';
 * $username = 'username@gmail.com';
 * $password = '123456';
 * 
 * $vdisk = new vDisk($appkey, $appsecret);
 * 
 * $vdisk->get_token($username, $password);
 * $_SESSION['token'] = $vdisk->token;
 * 
 * $vdisk->keep_token();
 * 
 * $r = $vdisk->upload_share_file('文件.txt', 0);
 * $r = $vdisk->get_list(0);
 * $r = $vdisk->get_quota();
 * $r = $vdisk->upload_with_md5('测试.pdf', '03d5717869bb075e3bad73b527fabc8a');
 * $r = $vdisk->get_file_info(219379);
 * $r = $vdisk->create_dir('测试一下');
 * $r = $vdisk->delete_dir(35647);
 * $r = $vdisk->delete_file(123);
 * $r = $vdisk->copy_file(219379, 0, '副本.txt');
 * $r = $vdisk->move_file(219379, 0, '副本.txt');
 * $r = $vdisk->rename_file(219379, '新的新的新的.z');
 * $r = $vdisk->rename_dir(3929, '新的新的新的');
 * $r = $vdisk->move_dir(3929, "我的图片们", 0);
 * print_r($r);
 * </code>
 * 
 * @link http://vdisk.me/api
 * @package sae
 * @version $Id$
 * @author Bruce Chen
 */
class vDisk 
{

    /**
     * @ignore
     */
    public $appkey;
    /**
     * @ignore
     */
    public $appsecret;
    /**
     * @ignore
     */
    public $username;
    /**
     * @ignore
     */
    public $password;
    /**
     * @ignore
     */
    public $token;

    private $_errno;    
    private $_error;


    /**
     * 构造函数
     *
     * @param string $app_key 分配给你的appkey
     * @param string $app_secret 分配给你的appsecret
     *
     * @return void 
     *
     * @author Bruce Chen
     *
     */
    public function __construct($app_key, $app_secret)
    {
        if(!($app_key && $app_secret)) 
        {   
            $this->set_error(-2, 'app_key or app_secret empty');
            return;
        }

        $this->appkey = $app_key;
        $this->appsecret = $app_secret;
        $this->set_error(-1, 'empty');
    }


    /**
     * 获得token
     *
     * @param string $username 
     * @param string $password 
     * @param string $app_type 可选参数, 如:$app_type=sinat (注意: 目前支持微博帐号)
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function get_token($username, $password, $app_type=null)
    {

        $this->username = $username;
        $this->password = $password;

        $time = time();
        $param = array( 

                'account' => $username, 
                'password' => $password, 
                'time' => $time,
                'appkey' => $this->appkey,
                'signature' => hash_hmac('sha256', "account={$username}&appkey={$this->appkey}&password={$password}&time={$time}", $this->appsecret, false)
                
                );
                
        if($app_type) $param['app_type'] = $app_type;

        $data = $this->_request(URL_GET_TOKEN, $param);

        if($data && $data['err_code'] == 0)
        {
            $this->token = $data['data']['token'];
        }

        return $data;
    }


    /**
     * 保持token
     *
     * @param string $token 可选参数
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function keep_token($token=null)
    {
        if($token)
        {
            $this->token = $token;
        }

        if($this->token)
        {
            $param = array(

                    'token' => $this->token
                    );

            $data = $this->_request(URL_KEEP_TOKEN, $param);

            return $data;
        }
        else
        {
            return false;
        }
    }


    /**
     * 上传文件(10M以下)
     *
     * @param string $file_path 本地文件真实路径
     *
     * @param int $dir_id 目录id
     *
     * @param string $cover 可选参数, yes:覆盖; no:如有重名返回错误信息
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function upload_file($file_path, $dir_id, $cover='yes')
    {

        if($this->token)
        {
            $param = array(

                    'file' => '@'.$file_path,
                    'token' => $this->token,
                    'dir_id' => $dir_id,
                    'cover' => $cover
                    );

            $data = $this->_request(URL_UPLOAD_FILE, $param);

            return $data;
        }
        else
        {
            return false;
        }

    }


    /**
     * 上传并分享文件(10M以下)
     *
     * @param string $file_path 本地文件真实路径
     *
     * @param int $dir_id 目录id
     *
     * @param string $cover 可选参数, yes:覆盖; no:如有重名返回错误信息
     *
     * @return array 包含分享后的url
     *
     * @author Bruce Chen
     *
     */
    public function upload_share_file($file_path, $dir_id, $cover='yes')
    {
        if($this->token)
        {
            $param = array(

                    'file' => '@'.$file_path,
                    'token' => $this->token,
                    'dir_id' => $dir_id,
                    'cover' => $cover
                    );

            $data = $this->_request(URL_UPLOAD_SHARE_FILE, $param);

            return $data;
        }
        else
        {
            return false;
        }
    }


    /**
     * 创建目录
     *
     * @param string $create_name 目录的名称
     *
     * @param int $parent_id 父目录的id
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function create_dir($create_name, $parent_id=0)
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token,
                    'create_name' => $create_name,
                    'parent_id' => $parent_id
                    );

            $data = $this->_request(URL_CREATE_DIR, $param);

            return $data;
        }
        else
        {
            return false;
        }

    }


    /**
     * 获得列表(包括文件和子目录)
     *
     * @param int $dir_id 目录的id
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function get_list($dir_id)
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token,
                    'dir_id' => $dir_id
                    );

            $data = $this->_request(URL_GET_LIST, $param);

            return $data;
        }
        else
        {
            return false;
        }
    }


    /**
     * 获得容量信息
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function get_quota()
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token
                    );

            $data = $this->_request(URL_GET_QUOTA, $param);

            return $data;
        }
        else
        {
            return false;
        }
    }


    /**
     * 无文件上传(md5)
     *
     * @param string $file_name 上传以后的文件名
     * @param string $md5 要上传文件的md5值
     * @param int $dir_id 目标目录的id, 0为根目录
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function upload_with_sha1($file_name, $sha1, $dir_id=0)
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token,
                    'file_name' => $file_name,
                    'sha1' => $sha1,
                    'dir_id' => $dir_id
                    );

            $data = $this->_request(URL_UPLOAD_WITH_SHA1, $param);

            return $data;
        }
        else
        {
            return false;
        }
    }


    /**
     * 获得文件的信息
     *
     * @param int $fid 文件的id
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function get_file_info($fid)
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token,
                    'fid' => $fid,
                    );

            $data = $this->_request(URL_GET_FILE_INFO, $param);

            return $data;
        }
        else
        {
            return false;
        }
    }


    /**
     * 删除目录
     *
     * @param int $dir_id 目录的id
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function delete_dir($dir_id)
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token,
                    'dir_id' => $dir_id,
                    );

            $data = $this->_request(URL_DELETE_DIR, $param);

            return $data;
        }
        else
        {
            return false;
        }
    }


    /**
     * 删除文件
     *
     * @param int $fid 文件的id
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function delete_file($fid)
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token,
                    'fid' => $fid,
                    );

            $data = $this->_request(URL_DELETE_FILE, $param);

            return $data;
        }
        else
        {
            return false;
        }
    }


    /**
     * 复制文件
     *
     * @param int $fid 要复制文件的id
     * @param int $to_dir_id 目标目录的id
     * @param string $new_name 副本文件的名称
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function copy_file($fid, $to_dir_id, $new_name)
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token,
                    'fid' => $fid,
                    'to_dir_id' => $to_dir_id,
                    'new_name' => $new_name
                    );

            $data = $this->_request(URL_COPY_FILE, $param);

            return $data;
        }
        else
        {
            return false;
        }
    }


    /**
     * 移动文件
     *
     * @param int $fid 要移动文件的id
     * @param int $to_dir_id 目标目录的id
     * @param string $new_name 移动后的文件名称
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function move_file($fid, $to_dir_id, $new_name)
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token,
                    'fid' => $fid,
                    'to_dir_id' => $to_dir_id,
                    'new_name' => $new_name
                    );

            $data = $this->_request(URL_MOVE_FILE, $param);

            return $data;
        }
        else
        {
            return false;
        }
    }


    /**
     * 重命名文件
     *
     * @param int $fid 文件的id
     * @param string $new_name 新文件名称
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function rename_file($fid, $new_name)
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token,
                    'fid' => $fid,
                    'new_name' => $new_name
                    );

            $data = $this->_request(URL_RENAME_FILE, $param);

            return $data;
        }
        else
        {
            return false;
        }       
    }


    /**
     * 重命名目录
     *
     * @param int $dir_id 目录的id
     * @param string $new_name 新名称
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function rename_dir($dir_id, $new_name)
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token,
                    'dir_id' => $dir_id,
                    'new_name' => $new_name
                    );

            $data = $this->_request(URL_RENAME_DIR, $param);

            return $data;
        }
        else
        {
            return false;
        }   
    }


    /**
     * 移动目录
     *
     * @param int $dir_id 目录的id
     * @param string $new_name 移动后的名称
     * @param int $to_parent_id 目标目录的id
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function move_dir($dir_id, $new_name, $to_parent_id)
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token,
                    'dir_id' => $dir_id,
                    'new_name' => $new_name,
                    'to_parent_id' => $to_parent_id
                    );

            $data = $this->_request(URL_MOVE_DIR, $param);

            return $data;
        }
        else
        {
            return false;
        }
    }


    /**
     * 分享文件
     *
     * @param int $fid 文件的id
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function share_file($fid)
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token,
                    'fid' => $fid
                    );

            $data = $this->_request(URL_SHARE_FILE, $param);

            return $data;
        }
        else
        {
            return false;
        }
    }


    /**
     * 取消分享
     *
     * @param int $fid 文件的id
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function cancel_share_file($fid)
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token,
                    'fid' => $fid
                    );

            $data = $this->_request(URL_CANCEL_SHARE_FILE, $param);

            return $data;
        }
        else
        {
            return false;
        }
    }


    /**
     * 获得回收站列表
     *
     * @param int $page 第几页
     * @param int $page_size 每页显示条数
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function recycle_get_list($page=1, $page_size=25)
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token,
                    'page' => $page,
                    'page_size' => $page_size
                    );

            $data = $this->_request(URL_RECYCLE_GET_LIST, $param);

            return $data;
        }
        else
        {
            return false;
        }
    }


    /**
     * 清空回收站
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function truncate_recycle()
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token
                    );

            $data = $this->_request(URL_TRUNCATE_RECYCLE_GET, $param);

            return $data;
        }
        else
        {
            return false;
        }
    }

    /**
     * 从回收站中彻底删除一个文件
     *
     * @param int $fid 文件id
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function recycle_delete_file($fid)
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token,
                    'fid' => $fid
                    );

            $data = $this->_request(URL_RECYCLE_DELETE_FILE, $param);

            return $data;
        }
        else
        {
            return false;
        }
    }

    /**
     * 从回收站中彻底删除一个目录
     *
     * @param int $dir_id 目录的id
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function recycle_delete_dir($dir_id)
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token,
                    'dir_id' => $dir_id
                    );

            $data = $this->_request(URL_RECYCLE_DELETE_DIR, $param);

            return $data;
        }
        else
        {
            return false;
        }
    }



    /**
     * 从回收站中还原一个文件
     *
     * @param int $fid 文件id
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function restore_file($fid)
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token,
                    'fid' => $fid
                    );

            $data = $this->_request(URL_RECYCLE_RESTORE_FILE, $param);

            return $data;
        }
        else
        {
            return false;
        }
    }


    /**
     * 从回收站中还原一个目录
     *
     * @param int $dir_id 目录的id
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function restore_dir($dir_id)
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token,
                    'dir_id' => $dir_id
                    );

            $data = $this->_request(URL_RECYCLE_RESTORE_DIR, $param);

            return $data;
        }
        else
        {
            return false;
        }
    }

    /**
     * 通过路径得到目录
     *
     * @param string $path 路径
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function get_dirid_with_path($path)
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token,
                    'path' => $path
                    );

            $data = $this->_request(URL_GET_DIRID_WITH_PATH, $param);

            return $data;
        }
        else
        {
            return false;
        }
    }


    /**
     * 通过邮件发送文件链接
     *
     * @param int $fid
     * @param string $to_email
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    public function email_share_file($fid, $to_email)
    {
        if($this->token)
        {
            $param = array(

                    'token' => $this->token,
                    'fid' => $fid,
                    'to_email' => $to_email
                    );

            $data = $this->_request(URL_EMAIL_SHARE_FILE, $param);

            return $data;
        }
        else
        {
            return false;
        }
    }


    /**
     * 发送http请求, 兼容SEA的Fetchurl, 私有方法
     *
     * @param string $url 
     * @param array $array  POST DATA ($array=null为GET方式)
     *
     * @return array 
     *
     * @author Bruce Chen
     *
     */
    private function _request($url, $array=null)
    {
        $curl = curl_init();
        curl_setopt($curl, CURLOPT_URL, $url);
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
        if($array != null)
        {
            curl_setopt($curl, CURLOPT_POST, true);
            curl_setopt($curl, CURLOPT_POSTFIELDS, $array);
        }
        $data = curl_exec($curl);
        curl_close($curl);
        if($arr = json_decode($data, true))
        {   
            $this->set_error($arr['err_code'], $arr['err_msg']);
            return $arr;
        }
        else
        {
            $this->set_error(-1, 'empty');
            return false;
        }
    }

    /**
     * 返回SaeFetchurl object, 保证只new一次
     *
     * @return SaeFetchurl object 
     *
     * @author Bruce Chen
     *
     */
    private function _f()
    {
        if(!isset($this->_f)) 
            $this->_f = new SaeFetchurl();

        return $this->_f;
    }


    private function set_error($errno, $error) 
    {
        $this->_errno = $errno;
        $this->_error = $error; 
    }

    public function errno() 
    {
        return $this->_errno;   
    }

    public function error() 
    {
        return $this->_error;
    }
}

API documentation generated by ApiGen