##3.5.1 擴展類庫:七牛云存儲接口調用
此擴展可用于將圖片上傳到七牛云存儲,或者七牛提供的其他功能。
##3.5.2 安裝和配置
###(1)擴展包下載
從 [PhalApi-Library](http://git.oschina.net/dogstar/PhalApi-Library) 擴展庫中下載獲取 **Qiniu** 七牛擴展包,如使用:
```javascript
git clone https://git.oschina.net/dogstar/PhalApi-Library.git
```
然后把 **Qiniu** 目錄復制到 **./PhalApi/Library/** 下,即:
```javascript
cp ./PhalApi-Library/Qiniu/ ./PhalApi/Library/ -R
```
到此安裝完畢!接下是插件的配置。
###(2)擴展包配置
我們需要在 **./Config/app.php** 配置文件中追加以下配置:
```javascript
/**
* 七牛相關配置
*/
'Qiniu' => array(
//統一的key
'accessKey' => '*****',
'secretKey' => '****',
//自定義配置的空間
'space_bucket' => '自定義配置的空間',
'space_host' => 'http://XXXXX.qiniudn.com',
),
```
你也可以不使用配置文件,直接在初始化注冊DI()->qiniu時指定配置。
##3.5.3 入門使用
###(1)入口注冊
```javascript
//$ vim ./Public/init.php
$loader->addDirs('Library');
// 其他代碼....
DI()->qiniu = new Qiniu_Lite();
```
根據上面所說的,你可以也可以指定配置。
```javascript
//$ vim ./Public/init.php
$loader->addDirs('Library');
// 其他代碼....
$qiniuConfig = array( /* 格式參照配置文件 *);
DI()->qiniu = new Qiniu_Lite($qiniuConfig);
```
##3.5.4 示例:圖片上傳
先簡單寫個測試文件:
```javascript
// vim ./Public/test_qiniu.html
<html>
<form method="POST" action="/demo/?service=CDN.uploadFile" enctype="multipart/form-data">
<input type="file" name="file">
<input type="submit">
</form>
</html>
```
效果如下(通常是提供給客戶端上傳的):

###(1)文件上傳接口
然后,我們需要編寫文件上傳接口:
```javascript
<?php
/**
* CDN云端接口
*
* @author: dogstar 2015-03-17
*/
class Api_CDN extends PhalApi_Api
{
const CODE_MISS_UPLOAD_FILE = 1;
const CODE_FAIL_TO_UPLOAD_FILE = 2;
const CODE_FAIL_TO_UPDATE = 3;
public function uploadFile()
{
$rs = array('code' => self::CODE_FAIL_TO_UPLOAD_FILE, 'url' => '', 'msg' => T('fail to upload file'));
if (!isset($_FILES['file'])) {
$rs['code'] = self::CODE_MISS_UPLOAD_FILE;
$rs['msg'] = T('miss upload file');
return $rs;
}
if ($_FILES["file"]["error"] > 0) {
$rs['code'] = self::CODE_FAIL_TO_UPLOAD_FILE;
$rs['msg'] = T('failed to upload file with error: {error}', array('error' => $_FILES['file']['error']));
DI()->logger->debug('failed to upload file with error: ' . $_FILES['file']['error']);
return $rs;
}
$url = DI()->qiniu->uploadFile($_FILES['file']['tmp_name']);
if (!empty($url)) {
$rs['code'] = 0;
$rs['url'] = $url;
$rs['msg'] = '';
}
@unlink($_FILES['file']['tmp_name']);
return $rs;
}
}
```
###(2)運行一下:
缺少上傳文件時:
```javascript
{"ret":200,"data":{"code":1,"url":"","msg":"miss upload file"},"msg":""}
```
上傳失敗時:
```javascript
{"ret":200,"data":{"code":2,"url":"","msg":"fail to upload file"},"msg":""}
```
可以看到對應的日志(如果不想看到此日志,可通過在初始化日志服務時去掉調試日志):
```javascript
2015-03-18 00:07:02|DEBUG|failed to upload file to qiniu|{"Err":"bad token","Reqid":"u1EAAG73DB3PVMwT","Details":"","Code":401}
```
上傳成功時:
```javascript
{"ret":200,"data":{"code":0,"url":"圖片鏈接","msg":""},"msg":""}
```
- 歡迎使用PhalApi!
- 接口,從簡單開始!
- [1.1]-下載與安裝
- [1.2]-創建一個自己的項目
- [1.3]-在線體驗
- [1.4]-文檔、幫助和官網
- [1.10]-對PhalApi框架的抉擇
- [1.11]-快速入門(backup)
- [1.12]-參數規則:接口參數規則配置
- [1.13]-統一的接口請求方式:_sevice=XXX.XXX
- [1.14]-統一的返回格式和結構:ret-data-msg
- [1.15]-數據庫操作:基于NotORM的使用及優化
- [1.16]-配置讀取:內外網環境配置的完美切換
- [1.17]-日記紀錄:簡化版的日記接口
- [1.18]-快速函數:人性化的關懷
- [1.19]-DI服務速查:各資源服務一覽表
- [1.20]-DB操作:數據庫基本操作速查
- [1.21]-類的自動加載:遵循PEAR包的命名規范
- [1.22]-簽名驗證:自定義簽名規則
- [1.23]-請求和響應:GET和POST兩者皆可得及超越JSON格式返回
- [1.24]-緩存策略:更靈活地可配置化的多級緩存
- [1.25]-國際化翻譯:為走向國際化提前做好翻譯準備
- [1.26]-數據安全:數據對稱加密方案
- [1.27]-精益開發:更富表現力的Model層和重量級數據獲取的應對方案
- [1.28]-COOKIE:對COOKIE原生態的支持及記憶加密升級版
- [1.29]-開放與封閉:多入口和統一初始化
- [1.30]-保持的力量:接口開發最佳實踐
- [1.31]-新型計劃任務:以接口形式實現的計劃任務
- [2.11]-核心思想:DI依賴注入-讓資源更可控
- [2.12]-海量數據:可配置的分庫分表
- [2.13]-接口調試:在線SQL語句查看與性能優化
- [2.14]-測試驅動開發:意圖導向編程下的接口開發
- [2.15]-演進:新型計劃任務續篇
- [2.16]-領域驅動設計:應對復雜領域業務的Domain層
- [2.17]-微服務:Api接口服務層
- [2.18]-定制化:資源服務的再實現
- [2.19]-擴展庫:可重用的擴展類庫
- [2.20]-約定編程:架構明顯的編程風格
- [2.21]-服務器統一部署方案簡明版:CentOs---Nginx---php-fpm---MySql-[--Memcached]
- [2.22]-更多工具:精益項目和團隊建設
- [3.1]-擴展類庫:微信開發
- [3.2]-擴展類庫:代理模式下phprpc協議的輕松支持
- [3.3]-擴展類庫:基于PHPMailer的郵件發送
- [3.4]-擴展類庫:優酷開放平臺接口調用
- [3.5]-擴展類庫:七牛云存儲接口調用
- [3.6]-擴展類庫:新型計劃任務
- [3.8]-擴展類庫:用戶、會話和第三方登錄集成
- [3.9]-擴展類庫:swoole支持下的長鏈接和異步任務實現
- [3.11]-擴展類庫:基于FastRoute的快速路由
- [4.2]-開發實戰2:模擬優酷開放平臺接口項目開發
- [4.3]-開發實戰3:一個簡單的小型項目開發(奔跑吧兄弟投票活動)
- [5.1]-架構與思想:PhalApi核心設計和思想解讀
- [5.2]-雜談:扯一些PhalApi的前世和今生
- [5.3]-框架總結:術語表和PHP開發建議
- [5.4]-許可
- [5.5]-聯系和加入我們
- [5.6]-更新日記
- [5.8]-致框架貢獻者:加入PhalApi開源指南
- [6.1]-基于接口查詢語言的SDK包
- [6.2]-SDK包(JAVA版)
- [6.3]-SDK包(PHP版)
- [6.4]-SDK包(Objective-C版)
- [6.5]-SDK包(javascript版)
- [6.6]-SDK包(Ruby版)
- [8.1]-PhalApi視頻教程
- 附錄1:接口文檔參考模板