Switch branches/tags
Nothing to show
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
..
Failed to load latest commit information.
README
k_test.php
kp.class.php
kuaipan.class.php

README

金山快盘开放平台 PHP SDK
编写:chenall
主页: http://chenall.net
来源: http://chenall.net/post/sdk_kp_php/
时间: 2012-12-26
使用方法:

1.首先初化始一个类.
$kp = new KuaiPan(CONSUMER_KEY,CONSUMER_SECRET);

2.通用API调用方法
 $kp->APINAME($params,$path)
 其中$params是参数列表,可以使用字符串方式也可以使用组数的方式。
 $path,路径,部份API需要带路径信息,可以加上,该参数可以省略。
 如果不需要参数直接留空就行了,
 例子:
  $kp->metadata()
  $kp->metadata('','/mytest');
  $kp->upload_file(array('overwrite'=>"true",'root'=>'app_folder','path'=>'/test.txt'),array('file'=>'@/test.php;filename=test.txt'));

调用API正常的话返回一个JSON OBJECT数据,否则会设置变量$kp->errstr.
只要判断$kp->errstr是否为空就可以知道调用是否成功了。

 目前可使用API,按官方SDK的命名方式
	account_info
	metadata
	history
	shares
	create_folder
	delete
	move
	copy
	copy_ref
	upload_locate
	download_file
	download_file_by_id
	upload_file
	upload_file_by_id
	thumbnail
	documentView
	requestToken
	accessToken

SDK简化版说明 kp.class.php
0.通用操作.
 如果返回值为false,则代表调用失败.错误信息存放在$kp->errstr中.
 所以判断操作是否成功,可以直接判断返回值是否为false也可以判断$kp->errstr是否为空.
 例子:
 $ret = $kp->md('test');
 if ($ret == false)
	echo "创建失败".$kp->errstr;
或
 if (!empty($kp->errstr))
	echo "创建失败".$kp->errstr;

1.授权
 $oauth = $kp->OAuth();
 打开一个窗口供用户信息授权信息,然后返回。
 授权成功后自己请保存以下OAUTH信息,下次可以直接使用。
 $oauth->oauth_token
 $oauth->oauth_token_secret
 以后可以直接使用下面的方法不需要再次授权。
 $kp->oauth_token = $oauth->oauth_token
 $kp->oauth_token_secret = $oauth->oauth_token_secret
2.创建文件夹
 $ret = $kp->md(PATH)
 成功返回: 刚创建的文件夹ID.

3.删除文件(夹)
 彻底删除
 $ret = $kp->rm(PATH)
 删除到回收站
 $ret = $kp->rm(PATH,"false")
 成功返回: true

4.复制文件(夹)
 $ret = $kp->cp(FROM_PATH,TO_PATH);
 成功返回: 新文件夹ID;

5.移动文件(夹)
 $ret = $kp->mv(FROM_PATH,TO_PATH);
 成功返回: true;

6.下载文件
 直接下载
 $ret= $kp->download(PATH,true);
 手动下载,返回一个地址
 $ret= $kp->download(PATH);

7.上传文件
 $ret= $kp->upload(PATH,FILE);
 如果PATH路径最后字符是'/',认为是一个目录,上传到该目录,上传后的文件名从FILE中提取。
 如果PATH路径最后字符不是'/',认为是一个文件,上传后的文件名就是PATH指定的文件名。
 若需要显示上传进度可以使用以下方法。
 $ret= $kp->upload(PATH,FILE,true);
 成功返回: 上传的文件ID.
8.列出文件夹/文件信息
 $ret= $kp->dir(PATH);
 返回内容:
 array
 {
	fileobj0,
	fileobj1,
	fileobjn,
 }
 fileobj->name         文件名
 fileobj->create_time  创建时间
 fileobj->modify_time  修改时间
 fileobj->size         文件大小(k)
 fileobj->file_id      文件夹唯一ID
 fileobj->isfolder     true/false
 可以使用类似如下的方法获取所有内容
 foreach($ret as $file)
 {
	echo '文件名'.$file->name;
 }

可以看一下k_test.php里面的测试实例。