欢迎各位兄弟 发布技术文章

这里的技术是共享的

You are here

首页

七牛 PHP SDK历史文档

星期三, 2017-07-19 07:00 — adminshiping1

PHP SDK历史文档

chenxiaoxiao 更新时间：2017-01-23 10:32:48

此 SDK 适用于 PHP 5.1.0 及其以上版本。

SDK源码地址：https://github.com/qiniu/php-sdk/tags

安装

获取Access Key 和 Secret Key

要接入七牛云存储，您需要拥有一对有效的 Access Key 和 Secret Key 用来进行签名认证。可以通过如下步骤获得：

  1. 开通七牛开发者帐号
  2. 登录七牛开发者自助平台，查看 Access Key 和 Secret Key

空间资源管理

查看单个文件属性信息

示例代码如下：



  1. require_once("qiniu/rs.php");
  2.  
  3. $bucket = "phpsdk";
  4. $key = "pic.jpg";
  5. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  6. $secretKey = '<YOUR_APP_SECRET_KEY>';
  7.  
  8. Qiniu_SetKeys($accessKey, $secretKey);
  9. $client = new Qiniu_MacHttpClient(null);
  10.  
  11. list($ret, $err) = Qiniu_RS_Stat($client, $bucket, $key);
  12. echo "Qiniu_RS_Stat result: \n";
  13. if ($err !== null) {
  14. var_dump($err);
  15. } else {
  16. var_dump($ret);
  17. }
复制单个文件
示例代码如下：




  1. require_once("qiniu/rs.php");
  2.  
  3. $bucket = "phpsdk";
  4. $key = "pic.jpg";
  5. $key1 = "file_name1";
  6. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  7. $secretKey = '<YOUR_APP_SECRET_KEY>';
  8.  
  9. Qiniu_SetKeys($accessKey, $secretKey);
  10. $client = new Qiniu_MacHttpClient(null);
  11.  
  12. $err = Qiniu_RS_Copy($client, $bucket, $key, $bucket, $key1);
  13. echo "====> Qiniu_RS_Copy result: \n";
  14. if ($err !== null) {
  15. var_dump($err);
  16. } else {
  17. echo "Success!";
  18. }
移动单个文件
示例代码如下：




  1. require_once("qiniu/rs.php");
  2.  
  3. $bucket = "phpsdk";
  4. $key = "pic.jpg";
  5. $key1 = "file_name1";
  6. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  7. $secretKey = '<YOUR_APP_SECRET_KEY>';
  8.  
  9. Qiniu_SetKeys($accessKey, $secretKey);
  10. $client = new Qiniu_MacHttpClient(null);
  11.  
  12. $err = Qiniu_RS_Move($client, $bucket, $key, $bucket, $key1);
  13. echo "====> Qiniu_RS_Move result: \n";
  14. if ($err !== null) {
  15. var_dump($err);
  16. } else {
  17. echo "Success!";
  18. }
删除单个文件
示例代码如下：




  1. require_once("qiniu/rs.php");
  2.  
  3. $bucket = "phpsdk";
  4. $key1 = "file_name1";
  5. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  6. $secretKey = '<YOUR_APP_SECRET_KEY>';
  7.  
  8. Qiniu_SetKeys($accessKey, $secretKey);
  9. $client = new Qiniu_MacHttpClient(null);
  10.  
  11. $err = Qiniu_RS_Delete($client, $bucket, $key1);
  12. echo "====> Qiniu_RS_Delete result: \n";
  13. if ($err !== null) {
  14. var_dump($err);
  15. } else {
  16. echo "Success!";
  17. }
上传下载接口
文件上传
为了尽可能地改善终端用户的上传体验，七牛云存储首创了客户端直传功能。一般云存储的上传流程是：




  1. 客户端（终端用户） => 业务服务器 => 云存储服务
这样多了一次上传的流程，和本地存储相比，会相对慢一些。但七牛引入了客户端直传，将整个上传过程调整为：




  1. 客户端（终端用户） => 七牛 => 业务服务器
客户端（终端用户）直接上传到七牛的服务器，通过DNS智能解析，七牛会选择到离终端用户最近的ISP服务商节点，速度会比本地存储快很多。文件上传成功以后，七牛的服务器使用回调功能，只需要将非常少的数据（比如Key）传给应用服务器，应用服务器进行保存即可。
上传流程
在七牛云存储中，整个上传流程大体分为这样几步：
  1. 业务服务器颁发上传凭证给客户端（终端用户）
  2. 客户端凭借上传凭证上传文件到七牛
  3. 在七牛获得完整数据后，发起一个 HTTP 请求回调到业务服务器
  4. 业务服务器保存相关信息，并返回一些信息给七牛
  5. 七牛原封不动地将这些信息转发给客户端（终端用户）
注意：回调到业务服务器的过程是可选的，它取决于业务服务器颁发的上传凭证。
如果没有回调，七牛会返回一些标准的信息（比如文件的 hash）给客户端。如果上传发生在业务服务器，以上流程可以自然简化为：
  1. 业务服务器生成 uptoken（不设置回调，自己回调到自己这里没有意义）
  2. 凭借上传凭证上传文件到七牛
  3. 善后工作，比如保存相关的一些信息
服务端生成 上传凭证代码如下：




  1. require_once("qiniu/rs.php");
  2.  
  3. $bucket = 'phpsdk';
  4. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  5. $secretKey = '<YOUR_APP_SECRET_KEY>';
  6.  
  7. Qiniu_SetKeys($accessKey, $secretKey);
  8. $putPolicy = new Qiniu_RS_PutPolicy($bucket);
  9. $upToken = $putPolicy->Token(null);
上传文件到七牛（通常是客户端完成，但也可以发生在服务端）：
上传字符串




  1. require_once("qiniu/io.php");
  2. require_once("qiniu/rs.php");
  3.  
  4. $bucket = "phpsdk";
  5. $key1 = "file_name1";
  6. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  7. $secretKey = '<YOUR_APP_SECRET_KEY>';
  8.  
  9. Qiniu_SetKeys($accessKey, $secretKey);
  10. $putPolicy = new Qiniu_RS_PutPolicy($bucket);
  11. $upToken = $putPolicy->Token(null);
  12. list($ret, $err) = Qiniu_Put($upToken, $key1, "Qiniu Storage!", null);
  13. echo "====> Qiniu_Put result: \n";
  14. if ($err !== null) {
  15. var_dump($err);
  16. } else {
  17. var_dump($ret);
  18. }
上传本地文件




  1. require_once("qiniu/io.php");
  2. require_once("qiniu/rs.php");
  3.  
  4. $bucket = "phpsdk";
  5. $key1 = "file_name1";
  6. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  7. $secretKey = '<YOUR_APP_SECRET_KEY>';
  8.  
  9. Qiniu_SetKeys($accessKey, $secretKey);
  10. $putPolicy = new Qiniu_RS_PutPolicy($bucket);
  11. $upToken = $putPolicy->Token(null);
  12. $putExtra = new Qiniu_PutExtra();
  13. $putExtra->Crc32 = 1;
  14. list($ret, $err) = Qiniu_PutFile($upToken, $key1, __file__, $putExtra);
  15. echo "====> Qiniu_PutFile result: \n";
  16. if ($err !== null) {
  17. var_dump($err);
  18. } else {
  19. var_dump($ret);
  20. }
上传策略
上传凭证实际上是用 AccessKey/SecretKey 进行数字签名的上传策略(Qiniu_RS_PutPolicy)，它控制则整个上传流程的行为。让我们快速过一遍你都能够决策啥：




  1. class Qiniu_RS_PutPolicy
  2. {
  3. public $Scope; // 必选项。可以是 bucketName 或者 bucketName:key
  4. public $CallbackUrl; // 可选
  5. public $CallbackBody; // 可选
  6. public $ReturnUrl; // 可选， 更贴切的名字是 redirectUrl。
  7. public $ReturnBody; // 可选
  8. public $AsyncOps; // 可选
  9. public $EndUser; // 可选
  10. public $Expires; // 可选。默认是 3600 秒
  11. public $PersistentOps; // 可选。
  12. public $PersistentNotifyUrl; // 如果设置了PersistentOps，必须同时设置此项。
  13. }
  • scope 限定客户端的权限。如果 scope 是 bucket，则客户端只能新增文件到指定的 bucket，不能修改文件。如果 scope 为 bucket:key，则客户端可以修改指定的文件。注意： key必须采用utf8编码，如使用非utf8编码访问七牛云存储将反馈错误
  • callbackUrl 设定业务服务器的回调地址，这样业务服务器才能感知到上传行为的发生。
  • callbackBody 设定业务服务器的回调信息。文件上传成功后，七牛向业务服务器的callbackUrl发送的POST请求携带的数据。支持 魔法变量和 自定义变量。
  • returnUrl 设置用于浏览器端文件上传成功后，浏览器执行303跳转的URL，一般为 HTML Form 上传时使用。文件上传成功后浏览器会自动跳转到 returnUrl?upload_ret=returnBody。
  • returnBody 可调整返回给客户端的数据包，支持魔法变量和自定义变量。returnBody 只在没有 callbackUrl 时有效（否则直接返回 callbackUrl 返回的结果）。不同情形下默认返回的 returnBody 并不相同。在一般情况下返回的是文件内容的 hash，也就是下载该文件时的 etag；但指定 returnUrl 时默认的 returnBody 会带上更多的信息。
  • asyncOps 可指定上传完成后，需要自动执行哪些数据处理。这是因为有些数据处理操作（比如音视频转码）比较慢，如果不进行预转可能第一次访问的时候效果不理想，预转可以很大程度改善这一点。
  • persistentOps 可指定音视频文件上传完成后，需要进行的转码持久化操作。asyncOps的处理结果保存在缓存当中，有可能失效。而persistentOps的处理结果以文件形式保存在bucket中，体验更佳。
  • persistentNotifyUrl 音视频转码持久化完成后，七牛的服务器会向用户发送处理结果通知。这里指定的url就是用于接收通知的接口。设置了persistentOps,则需要同时设置此字段。
关于上传策略更完整的说明，请参考上传凭证。
文件下载
七牛云存储上的资源下载分为 公有资源下载 和 私有资源下载 。
私有（private）是 Bucket（空间）的一个属性，一个私有 Bucket 中的资源为私有资源，私有资源不可匿名下载。
新创建的空间（Bucket）缺省为私有，也可以将某个 Bucket 设为公有，公有 Bucket 中的资源为公有资源，公有资源可以匿名下载。
公有资源下载 如果在给bucket绑定了域名的话，可以通过以下地址访问。




  1. [GET] http://<domain>/<key>
示例代码：




  1. $key = 'pic.jpg';
  2. $domain = '7j1xlg.com2.z0.glb.qiniucdn.com';
  3. //$baseUrl 就是您要访问资源的地址
  4. $baseUrl = Qiniu_RS_MakeBaseUrl($domain, $key);
其中<domain>是bucket所对应的域名。七牛云存储为每一个bucket提供一个默认域名。默认域名可以到七牛开发者平台中，空间设置的域名设置一节查询。用户也可以将自有的域名绑定到bucket上，通过自有域名访问七牛云存储。
注意：key必须采用utf8编码，如使用非utf8编码访问七牛云存储将反馈错误
私有资源下载 私有资源必须通过临时下载授权凭证(downloadToken)下载，如下：




  1. [GET] http://<domain>/<key>?e=<deadline>&token=<downloadToken>
注意：尖括号不是必需，代表替换项。
私有下载链接可以使用 SDK 提供的如下方法生成：




  1. require_once("qiniu/rs.php");
  2.  
  3. $key = 'pic.jpg';
  4. $domain = '7j1xlg.com2.z0.glb.qiniucdn.com';
  5. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  6. $secretKey = '<YOUR_APP_SECRET_KEY>';
  7.  
  8. Qiniu_SetKeys($accessKey, $secretKey); 
  9. $baseUrl = Qiniu_RS_MakeBaseUrl($domain, $key);
  10. $getPolicy = new Qiniu_RS_GetPolicy();
  11. $privateUrl = $getPolicy->MakeRequest($baseUrl, null);
  12. echo "====> getPolicy result: \n";
  13. echo $privateUrl . "\n";
数据处理接口
七牛支持在云端对图像, 视频, 音频等富媒体进行个性化处理
图像
查看图像属性




  1. require_once("qiniu/rs.php");
  2. require_once("qiniu/fop.php");
  3.  
  4. $key = 'pic.jpg';
  5. $domain = '7j1xlg.com2.z0.glb.qiniucdn.com';
  6. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  7. $secretKey = '<YOUR_APP_SECRET_KEY>';
  8.  
  9. Qiniu_SetKeys($accessKey, $secretKey); 
  10. //生成baseUrl
  11. $baseUrl = Qiniu_RS_MakeBaseUrl($domain, $key);
  12.  
  13. //生成fopUrl
  14. $imgInfo = new Qiniu_ImageInfo;
  15. $imgInfoUrl = $imgInfo->MakeRequest($baseUrl);
  16.  
  17. //对fopUrl 进行签名，生成privateUrl。 公有bucket 此步可以省去。
  18. $getPolicy = new Qiniu_RS_GetPolicy();
  19. $imgInfoPrivateUrl = $getPolicy->MakeRequest($imgInfoUrl, null);
  20. echo "====> imageInfo privateUrl: \n";
  21. echo $imgInfoPrivateUrl . "\n";
将$imgInfoPrivateUrl粘贴到浏览器地址栏中就可以查看该图像的信息了。
查看图片EXIF信息




  1. require_once("qiniu/rs.php");
  2. require_once("qiniu/fop.php");
  3.  
  4. $key = 'pic.jpg';
  5. $domain = '7j1xlg.com2.z0.glb.qiniucdn.com';
  6. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  7. $secretKey = '<YOUR_APP_SECRET_KEY>';
  8.  
  9. Qiniu_SetKeys($accessKey, $secretKey); 
  10. //生成baseUrl
  11. $baseUrl = Qiniu_RS_MakeBaseUrl($domain, $key);
  12.  
  13. //生成fopUrl
  14. $imgExif = new Qiniu_Exif;
  15. $imgExifUrl = $imgExif->MakeRequest($baseUrl);
  16.  
  17. //对fopUrl 进行签名，生成privateUrl。 公有bucket 此步可以省去。
  18. $getPolicy = new Qiniu_RS_GetPolicy();
  19. $imgExifPrivateUrl = $getPolicy->MakeRequest($imgExifUrl, null);
  20. echo "====> imageView privateUrl: \n";
  21. echo $imgExifPrivateUrl . "\n";
生成图片预览




  1. require_once("qiniu/rs.php");
  2. require_once("qiniu/fop.php");
  3.  
  4. $key = 'pic.jpg';
  5. $domain = '7j1xlg.com2.z0.glb.qiniucdn.com';
  6. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  7. $secretKey = '<YOUR_APP_SECRET_KEY>';
  8.  
  9. Qiniu_SetKeys($accessKey, $secretKey); 
  10. //生成baseUrl
  11. $baseUrl = Qiniu_RS_MakeBaseUrl($domain, $key);
  12.  
  13. //生成fopUrl
  14. $imgView = new Qiniu_ImageView;
  15. $imgView->Mode = 1;
  16. $imgView->Width = 60;
  17. $imgView->Height = 120;
  18. $imgViewUrl = $imgView->MakeRequest($baseUrl);
  19.  
  20. //对fopUrl 进行签名，生成privateUrl。 公有bucket 此步可以省去。
  21. $getPolicy = new Qiniu_RS_GetPolicy();
  22. $imgViewPrivateUrl = $getPolicy->MakeRequest($imgViewUrl, null);
  23. echo "====> imageView privateUrl: \n";
  24. echo $imgViewPrivateUrl . "\n";
贡献代码
  1. Fork
  2. 创建您的特性分支 git checkout -b my-new-feature
  3. 提交您的改动 git commit -am ‘Added some feature’
  4. 将您的修改记录提交到远程 git 仓库 git push origin my-new-feature
  5. 然后到 github 网站的该 git 远程仓库的 my-new-feature 分支下发起 Pull Request
许可证
Copyright © 2014 qiniu.com
基于 MIT 协议发布:
以上内容是否对您有帮助？ 
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
PHP SDK历史文档
chenxiaoxiao 更新时间：2017-01-23 10:32:48
此 SDK 适用于 PHP 5.1.0 及其以上版本。
SDK源码地址：https://github.com/qiniu/php-sdk/tags
安装
获取Access Key 和 Secret Key
要接入七牛云存储，您需要拥有一对有效的 Access Key 和 Secret Key 用来进行签名认证。可以通过如下步骤获得：
  1. 开通七牛开发者帐号
  2. 登录七牛开发者自助平台，查看 Access Key 和 Secret Key
空间资源管理
查看单个文件属性信息
示例代码如下：




  1. require_once("qiniu/rs.php");
  2.  
  3. $bucket = "phpsdk";
  4. $key = "pic.jpg";
  5. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  6. $secretKey = '<YOUR_APP_SECRET_KEY>';
  7.  
  8. Qiniu_SetKeys($accessKey, $secretKey);
  9. $client = new Qiniu_MacHttpClient(null);
  10.  
  11. list($ret, $err) = Qiniu_RS_Stat($client, $bucket, $key);
  12. echo "Qiniu_RS_Stat result: \n";
  13. if ($err !== null) {
  14. var_dump($err);
  15. } else {
  16. var_dump($ret);
  17. }
复制单个文件
示例代码如下：




  1. require_once("qiniu/rs.php");
  2.  
  3. $bucket = "phpsdk";
  4. $key = "pic.jpg";
  5. $key1 = "file_name1";
  6. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  7. $secretKey = '<YOUR_APP_SECRET_KEY>';
  8.  
  9. Qiniu_SetKeys($accessKey, $secretKey);
  10. $client = new Qiniu_MacHttpClient(null);
  11.  
  12. $err = Qiniu_RS_Copy($client, $bucket, $key, $bucket, $key1);
  13. echo "====> Qiniu_RS_Copy result: \n";
  14. if ($err !== null) {
  15. var_dump($err);
  16. } else {
  17. echo "Success!";
  18. }
移动单个文件
示例代码如下：




  1. require_once("qiniu/rs.php");
  2.  
  3. $bucket = "phpsdk";
  4. $key = "pic.jpg";
  5. $key1 = "file_name1";
  6. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  7. $secretKey = '<YOUR_APP_SECRET_KEY>';
  8.  
  9. Qiniu_SetKeys($accessKey, $secretKey);
  10. $client = new Qiniu_MacHttpClient(null);
  11.  
  12. $err = Qiniu_RS_Move($client, $bucket, $key, $bucket, $key1);
  13. echo "====> Qiniu_RS_Move result: \n";
  14. if ($err !== null) {
  15. var_dump($err);
  16. } else {
  17. echo "Success!";
  18. }
删除单个文件
示例代码如下：




  1. require_once("qiniu/rs.php");
  2.  
  3. $bucket = "phpsdk";
  4. $key1 = "file_name1";
  5. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  6. $secretKey = '<YOUR_APP_SECRET_KEY>';
  7.  
  8. Qiniu_SetKeys($accessKey, $secretKey);
  9. $client = new Qiniu_MacHttpClient(null);
  10.  
  11. $err = Qiniu_RS_Delete($client, $bucket, $key1);
  12. echo "====> Qiniu_RS_Delete result: \n";
  13. if ($err !== null) {
  14. var_dump($err);
  15. } else {
  16. echo "Success!";
  17. }
上传下载接口
文件上传
为了尽可能地改善终端用户的上传体验，七牛云存储首创了客户端直传功能。一般云存储的上传流程是：




  1. 客户端（终端用户） => 业务服务器 => 云存储服务
这样多了一次上传的流程，和本地存储相比，会相对慢一些。但七牛引入了客户端直传，将整个上传过程调整为：




  1. 客户端（终端用户） => 七牛 => 业务服务器
客户端（终端用户）直接上传到七牛的服务器，通过DNS智能解析，七牛会选择到离终端用户最近的ISP服务商节点，速度会比本地存储快很多。文件上传成功以后，七牛的服务器使用回调功能，只需要将非常少的数据（比如Key）传给应用服务器，应用服务器进行保存即可。
上传流程
在七牛云存储中，整个上传流程大体分为这样几步：
  1. 业务服务器颁发上传凭证给客户端（终端用户）
  2. 客户端凭借上传凭证上传文件到七牛
  3. 在七牛获得完整数据后，发起一个 HTTP 请求回调到业务服务器
  4. 业务服务器保存相关信息，并返回一些信息给七牛
  5. 七牛原封不动地将这些信息转发给客户端（终端用户）
注意：回调到业务服务器的过程是可选的，它取决于业务服务器颁发的上传凭证。
如果没有回调，七牛会返回一些标准的信息（比如文件的 hash）给客户端。如果上传发生在业务服务器，以上流程可以自然简化为：
  1. 业务服务器生成 uptoken（不设置回调，自己回调到自己这里没有意义）
  2. 凭借上传凭证上传文件到七牛
  3. 善后工作，比如保存相关的一些信息
服务端生成 上传凭证代码如下：




  1. require_once("qiniu/rs.php");
  2.  
  3. $bucket = 'phpsdk';
  4. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  5. $secretKey = '<YOUR_APP_SECRET_KEY>';
  6.  
  7. Qiniu_SetKeys($accessKey, $secretKey);
  8. $putPolicy = new Qiniu_RS_PutPolicy($bucket);
  9. $upToken = $putPolicy->Token(null);
上传文件到七牛（通常是客户端完成，但也可以发生在服务端）：
上传字符串




  1. require_once("qiniu/io.php");
  2. require_once("qiniu/rs.php");
  3.  
  4. $bucket = "phpsdk";
  5. $key1 = "file_name1";
  6. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  7. $secretKey = '<YOUR_APP_SECRET_KEY>';
  8.  
  9. Qiniu_SetKeys($accessKey, $secretKey);
  10. $putPolicy = new Qiniu_RS_PutPolicy($bucket);
  11. $upToken = $putPolicy->Token(null);
  12. list($ret, $err) = Qiniu_Put($upToken, $key1, "Qiniu Storage!", null);
  13. echo "====> Qiniu_Put result: \n";
  14. if ($err !== null) {
  15. var_dump($err);
  16. } else {
  17. var_dump($ret);
  18. }
上传本地文件




  1. require_once("qiniu/io.php");
  2. require_once("qiniu/rs.php");
  3.  
  4. $bucket = "phpsdk";
  5. $key1 = "file_name1";
  6. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  7. $secretKey = '<YOUR_APP_SECRET_KEY>';
  8.  
  9. Qiniu_SetKeys($accessKey, $secretKey);
  10. $putPolicy = new Qiniu_RS_PutPolicy($bucket);
  11. $upToken = $putPolicy->Token(null);
  12. $putExtra = new Qiniu_PutExtra();
  13. $putExtra->Crc32 = 1;
  14. list($ret, $err) = Qiniu_PutFile($upToken, $key1, __file__, $putExtra);
  15. echo "====> Qiniu_PutFile result: \n";
  16. if ($err !== null) {
  17. var_dump($err);
  18. } else {
  19. var_dump($ret);
  20. }
上传策略
上传凭证实际上是用 AccessKey/SecretKey 进行数字签名的上传策略(Qiniu_RS_PutPolicy)，它控制则整个上传流程的行为。让我们快速过一遍你都能够决策啥：




  1. class Qiniu_RS_PutPolicy
  2. {
  3. public $Scope; // 必选项。可以是 bucketName 或者 bucketName:key
  4. public $CallbackUrl; // 可选
  5. public $CallbackBody; // 可选
  6. public $ReturnUrl; // 可选， 更贴切的名字是 redirectUrl。
  7. public $ReturnBody; // 可选
  8. public $AsyncOps; // 可选
  9. public $EndUser; // 可选
  10. public $Expires; // 可选。默认是 3600 秒
  11. public $PersistentOps; // 可选。
  12. public $PersistentNotifyUrl; // 如果设置了PersistentOps，必须同时设置此项。
  13. }
  • scope 限定客户端的权限。如果 scope 是 bucket，则客户端只能新增文件到指定的 bucket，不能修改文件。如果 scope 为 bucket:key，则客户端可以修改指定的文件。注意： key必须采用utf8编码，如使用非utf8编码访问七牛云存储将反馈错误
  • callbackUrl 设定业务服务器的回调地址，这样业务服务器才能感知到上传行为的发生。
  • callbackBody 设定业务服务器的回调信息。文件上传成功后，七牛向业务服务器的callbackUrl发送的POST请求携带的数据。支持 魔法变量和 自定义变量。
  • returnUrl 设置用于浏览器端文件上传成功后，浏览器执行303跳转的URL，一般为 HTML Form 上传时使用。文件上传成功后浏览器会自动跳转到 returnUrl?upload_ret=returnBody。
  • returnBody 可调整返回给客户端的数据包，支持魔法变量和自定义变量。returnBody 只在没有 callbackUrl 时有效（否则直接返回 callbackUrl 返回的结果）。不同情形下默认返回的 returnBody 并不相同。在一般情况下返回的是文件内容的 hash，也就是下载该文件时的 etag；但指定 returnUrl 时默认的 returnBody 会带上更多的信息。
  • asyncOps 可指定上传完成后，需要自动执行哪些数据处理。这是因为有些数据处理操作（比如音视频转码）比较慢，如果不进行预转可能第一次访问的时候效果不理想，预转可以很大程度改善这一点。
  • persistentOps 可指定音视频文件上传完成后，需要进行的转码持久化操作。asyncOps的处理结果保存在缓存当中，有可能失效。而persistentOps的处理结果以文件形式保存在bucket中，体验更佳。
  • persistentNotifyUrl 音视频转码持久化完成后，七牛的服务器会向用户发送处理结果通知。这里指定的url就是用于接收通知的接口。设置了persistentOps,则需要同时设置此字段。
关于上传策略更完整的说明，请参考上传凭证。
文件下载
七牛云存储上的资源下载分为 公有资源下载 和 私有资源下载 。
私有（private）是 Bucket（空间）的一个属性，一个私有 Bucket 中的资源为私有资源，私有资源不可匿名下载。
新创建的空间（Bucket）缺省为私有，也可以将某个 Bucket 设为公有，公有 Bucket 中的资源为公有资源，公有资源可以匿名下载。
公有资源下载 如果在给bucket绑定了域名的话，可以通过以下地址访问。




  1. [GET] http://<domain>/<key>
示例代码：




  1. $key = 'pic.jpg';
  2. $domain = '7j1xlg.com2.z0.glb.qiniucdn.com';
  3. //$baseUrl 就是您要访问资源的地址
  4. $baseUrl = Qiniu_RS_MakeBaseUrl($domain, $key);
其中<domain>是bucket所对应的域名。七牛云存储为每一个bucket提供一个默认域名。默认域名可以到七牛开发者平台中，空间设置的域名设置一节查询。用户也可以将自有的域名绑定到bucket上，通过自有域名访问七牛云存储。
注意：key必须采用utf8编码，如使用非utf8编码访问七牛云存储将反馈错误
私有资源下载 私有资源必须通过临时下载授权凭证(downloadToken)下载，如下：




  1. [GET] http://<domain>/<key>?e=<deadline>&token=<downloadToken>
注意：尖括号不是必需，代表替换项。
私有下载链接可以使用 SDK 提供的如下方法生成：




  1. require_once("qiniu/rs.php");
  2.  
  3. $key = 'pic.jpg';
  4. $domain = '7j1xlg.com2.z0.glb.qiniucdn.com';
  5. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  6. $secretKey = '<YOUR_APP_SECRET_KEY>';
  7.  
  8. Qiniu_SetKeys($accessKey, $secretKey); 
  9. $baseUrl = Qiniu_RS_MakeBaseUrl($domain, $key);
  10. $getPolicy = new Qiniu_RS_GetPolicy();
  11. $privateUrl = $getPolicy->MakeRequest($baseUrl, null);
  12. echo "====> getPolicy result: \n";
  13. echo $privateUrl . "\n";
数据处理接口
七牛支持在云端对图像, 视频, 音频等富媒体进行个性化处理
图像
查看图像属性




  1. require_once("qiniu/rs.php");
  2. require_once("qiniu/fop.php");
  3.  
  4. $key = 'pic.jpg';
  5. $domain = '7j1xlg.com2.z0.glb.qiniucdn.com';
  6. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  7. $secretKey = '<YOUR_APP_SECRET_KEY>';
  8.  
  9. Qiniu_SetKeys($accessKey, $secretKey); 
  10. //生成baseUrl
  11. $baseUrl = Qiniu_RS_MakeBaseUrl($domain, $key);
  12.  
  13. //生成fopUrl
  14. $imgInfo = new Qiniu_ImageInfo;
  15. $imgInfoUrl = $imgInfo->MakeRequest($baseUrl);
  16.  
  17. //对fopUrl 进行签名，生成privateUrl。 公有bucket 此步可以省去。
  18. $getPolicy = new Qiniu_RS_GetPolicy();
  19. $imgInfoPrivateUrl = $getPolicy->MakeRequest($imgInfoUrl, null);
  20. echo "====> imageInfo privateUrl: \n";
  21. echo $imgInfoPrivateUrl . "\n";
将$imgInfoPrivateUrl粘贴到浏览器地址栏中就可以查看该图像的信息了。
查看图片EXIF信息




  1. require_once("qiniu/rs.php");
  2. require_once("qiniu/fop.php");
  3.  
  4. $key = 'pic.jpg';
  5. $domain = '7j1xlg.com2.z0.glb.qiniucdn.com';
  6. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  7. $secretKey = '<YOUR_APP_SECRET_KEY>';
  8.  
  9. Qiniu_SetKeys($accessKey, $secretKey); 
  10. //生成baseUrl
  11. $baseUrl = Qiniu_RS_MakeBaseUrl($domain, $key);
  12.  
  13. //生成fopUrl
  14. $imgExif = new Qiniu_Exif;
  15. $imgExifUrl = $imgExif->MakeRequest($baseUrl);
  16.  
  17. //对fopUrl 进行签名，生成privateUrl。 公有bucket 此步可以省去。
  18. $getPolicy = new Qiniu_RS_GetPolicy();
  19. $imgExifPrivateUrl = $getPolicy->MakeRequest($imgExifUrl, null);
  20. echo "====> imageView privateUrl: \n";
  21. echo $imgExifPrivateUrl . "\n";
生成图片预览




  1. require_once("qiniu/rs.php");
  2. require_once("qiniu/fop.php");
  3.  
  4. $key = 'pic.jpg';
  5. $domain = '7j1xlg.com2.z0.glb.qiniucdn.com';
  6. $accessKey = '<YOUR_APP_ACCESS_KEY>';
  7. $secretKey = '<YOUR_APP_SECRET_KEY>';
  8.  
  9. Qiniu_SetKeys($accessKey, $secretKey); 
  10. //生成baseUrl
  11. $baseUrl = Qiniu_RS_MakeBaseUrl($domain, $key);
  12.  
  13. //生成fopUrl
  14. $imgView = new Qiniu_ImageView;
  15. $imgView->Mode = 1;
  16. $imgView->Width = 60;
  17. $imgView->Height = 120;
  18. $imgViewUrl = $imgView->MakeRequest($baseUrl);
  19.  
  20. //对fopUrl 进行签名，生成privateUrl。 公有bucket 此步可以省去。
  21. $getPolicy = new Qiniu_RS_GetPolicy();
  22. $imgViewPrivateUrl = $getPolicy->MakeRequest($imgViewUrl, null);
  23. echo "====> imageView privateUrl: \n";
  24. echo $imgViewPrivateUrl . "\n";
贡献代码
  1. Fork
  2. 创建您的特性分支 git checkout -b my-new-feature
  3. 提交您的改动 git commit -am ‘Added some feature’
  4. 将您的修改记录提交到远程 git 仓库 git push origin my-new-feature
  5. 然后到 github 网站的该 git 远程仓库的 my-new-feature 分支下发起 Pull Request
许可证
Copyright © 2014 qiniu.com
基于 MIT 协议发布:
以上内容是否对您有帮助？ 
  •  
  •  
  •  
  •  
  •  
  •  
  •  
来自 https://developer.qiniu.com/kodo/sdk/1663/legacy-php

普通分类: 
其它
  


  

          
  • 


    
      




  



  

          

                      

    


    
  

    Powered by Drupal  






    
友情链接

  
  

    
校园好文网

  






    
  

    
 www.shipingzhong.cn  个人技术网_前端_后台    备案号:苏ICP备18010659号-2