image.png
引言
Perfect 是一个完整和强大的工具箱，框架和应用程序服务器为Linux，iOS和MacOS（OS X）。它提供了Swift工程师为开发面向客户端和服务器端应用程序的Swift编程语言开发轻量级，可维护，可扩展的应用程序和其他REST服务所需的一切。
接下来几篇我对 Perfect 框架进行记录。感兴趣的可以看：
Swift Perfect - Ubuntu 服务器部署
Swift Perfect - 七牛上传文件
Swift Perfect - iOS消息推送(APNs)之获取 APNs 授权码
Swift Perfect - 使用 systemd 命令服务器项目后台运行
Ubuntu 环境下 Nginx 的安装部署
Swift Perfect - Nginx 配置 HTTPS 服务器
Perfect 七牛上传文件库
如果有能帮助到大家的地方，希望能点个赞，顺便给GitHub上点个赞
我自己简单封装成 Swift Package 库 (需要Swift 4.2 环境)
https://github.com/LeeCenY/Perfect-Qiniu
依赖库：
.package(url: "https://github.com/PerfectlySoft/Perfect-CURL.git", from: "3.0.6"),
.package(url: "https://github.com/PerfectlySoft/Perfect-Crypto.git", from: "3.1.2")
安装：
.package(url: "https://github.com/LeeCenY/Perfect-Qiniu.git", from: "1.0.4")
使用：
let config = QiniuConfiguration(accessKey: AccessKey, secretKey: SecretKey, scope: scope, fixedZone: .HNzone, DEBUG: false)
_ = try Qiniu.upload(fileName: zipName, file: thisZipFile, config: config)
异常处理：
public enum UploadError: Error {
case badToken
case RequestfFailed(String)
}
上传地址
https://developer.qiniu.com/kodo/manual/1671/region-endpoint
请求元素
upload_token: 上传凭证
fileName: UUID - 房间号 - 年月日
fileBinaryData： 图片 data 格式
上传凭证
- 1.构造上传策略：
scope = 'my-rent:502-201804.jpg' # my-rent 空间名称 502-201804图片名称
deadline = 1451491200 # 授权有效期截止到 2015-12-31 00:00:00（该有效期指上传完成后在七牛生成文件的时间，而非上传的开始时间）
#图片的名称、大小、宽高和校验值
returnBody = '{
"name": "\(fname)",
"size": "\(fsize)",
"w": "\(imageInfo.width)",
"h": "\(imageInfo.height)",
"hash": "\(etag)"
}
- 将上传策略序列化成为JSON：
putPolicy =
'{
"scope": "my-bucket:sunflower.jpg",
"deadline":1451491200,
"returnBody":
"{
\"name\":$(fname),
\"size\":$(fsize),
\"w\":$(imageInfo.width),
\"h\":$(imageInfo.height),
\"hash\":$(etag)
}"
}'
- 3.对 JSON 编码的上传策略进行URL 安全的 Base64 编码 PerfectCrypto，得到待签名字符串：
encodedPutPolicy = urlsafe_base64_encode(putPolicy)
#实际值为：
encodedPutPolicy = "eyJzY29wZSI6Im15LWJ1Y2tldDpzdW5mbG93ZXIuanBnIiwiZGVhZGxpbmUiOjE0NTE0OTEyMDAsInJldHVybkJvZHkiOiJ7XCJuYW1lXCI6JChmbmFtZSksXCJzaXplXCI6JChmc2l6ZSksXCJ3XCI6JChpbWFnZUluZm8ud2lkdGgpLFwiaFwiOiQoaW1hZ2VJbmZvLmhlaWdodCksXCJoYXNoXCI6JChldGFnKX0ifQ=="
- 4.使用访问密钥（AK/SK）对上一步生成的待签名字符串计算HMAC-SHA1签名：
sign = hmac_sha1(encodedPutPolicy, "<SecretKey>")
#假设 SecretKey 为 MY_SECRET_KEY，实际签名为：
sign = "c10e287f2b1e7f547b20a9ebce2aada26ab20ef2"
- 5.对签名进行URL安全的Base64编码：
encodedSign = urlsafe_base64_encode(sign)
#最终签名值为：
encodedSign = "wQ4ofysef1R7IKnrziqtomqyDvI="
- 6.将访问密钥（AK/SK）、encodedSign 和 encodedPutPolicy 用英文符号 : 连接起来：
uploadToken = AccessKey + ':' + encodedSign + ':' + encodedPutPolicy
#假设用户的 AccessKey 为 MY_ACCESS_KEY ，则最后得到的上传凭证应为：
uploadToken = "MY_ACCESS_KEY:wQ4ofysef1R7IKnrziqtomqyDvI=:eyJzY29wZSI6Im15LWJ1Y2tldDpzdW5mbG93ZXIuanBnIiwiZGVhZGxpbmUiOjE0NTE0OTEyMDAsInJldHVybkJvZHkiOiJ7XCJuYW1lXCI6JChmbmFtZSksXCJzaXplXCI6JChmc2l6ZSksXCJ3XCI6JChpbWFnZUluZm8ud2lkdGgpLFwiaFwiOiQoaW1hZ2VJbmZvLmhlaWdodCksXCJoYXNoXCI6JChldGFnKX0ifQ=="
let fields = CURL.POSTFields()
let _ = fields.append(key: "token", value: token)
let _ = fields.append(key: "key", value: "测试")
let _ = fields.append(key: "file", path: file)
let curl = CURL(url: "https://up-z2.qiniup.com/")
let ret = curl.formAddPost(fields: fields)
defer { curl.close() }
guard ret.rawValue == 0 else {
throw Exception.INVALID_URL(curl.strError(code: ret))
}
let _ = curl.setOption(CURLOPT_VERBOSE, int: self.DEBUG ? 1 : 0 )
let r = curl.performFullySync()
var ptr = r.bodyBytes
ptr.append(0)
let s = String(cString: ptr)
guard r.resultCode == 0, r.responseCode == 200 else {
throw Exception.INVALID_URL(s)
}
return try s.jsonDecode() as? [String:Any] ?? [:]
