337 lines
9.9 KiB
PHP
337 lines
9.9 KiB
PHP
<?php
|
||
|
||
namespace Qiniu;
|
||
|
||
use Qiniu\Config;
|
||
|
||
if (!defined('QINIU_FUNCTIONS_VERSION')) {
|
||
define('QINIU_FUNCTIONS_VERSION', Config::SDK_VER);
|
||
|
||
/**
|
||
* 计算文件的crc32检验码:
|
||
*
|
||
* @param $file string 待计算校验码的文件路径
|
||
*
|
||
* @return string 文件内容的crc32校验码
|
||
*/
|
||
function crc32_file($file)
|
||
{
|
||
$hash = hash_file('crc32b', $file);
|
||
$array = unpack('N', pack('H*', $hash));
|
||
return sprintf('%u', $array[1]);
|
||
}
|
||
|
||
/**
|
||
* 计算输入流的crc32检验码
|
||
*
|
||
* @param $data string 待计算校验码的字符串
|
||
*
|
||
* @return string 输入字符串的crc32校验码
|
||
*/
|
||
function crc32_data($data)
|
||
{
|
||
$hash = hash('crc32b', $data);
|
||
$array = unpack('N', pack('H*', $hash));
|
||
return sprintf('%u', $array[1]);
|
||
}
|
||
|
||
/**
|
||
* 对提供的数据进行urlsafe的base64编码。
|
||
*
|
||
* @param string $data 待编码的数据，一般为字符串
|
||
*
|
||
* @return string 编码后的字符串
|
||
* @link http://developer.qiniu.com/docs/v6/api/overview/appendix.html#urlsafe-base64
|
||
*/
|
||
function base64_urlSafeEncode($data)
|
||
{
|
||
$find = array('+', '/');
|
||
$replace = array('-', '_');
|
||
return str_replace($find, $replace, base64_encode($data));
|
||
}
|
||
|
||
/**
|
||
* 对提供的urlsafe的base64编码的数据进行解码
|
||
*
|
||
* @param string $str 待解码的数据，一般为字符串
|
||
*
|
||
* @return string 解码后的字符串
|
||
*/
|
||
function base64_urlSafeDecode($str)
|
||
{
|
||
$find = array('-', '_');
|
||
$replace = array('+', '/');
|
||
return base64_decode(str_replace($find, $replace, $str));
|
||
}
|
||
|
||
/**
|
||
* 二维数组根据某个字段排序
|
||
* @param array $array 要排序的数组
|
||
* @param string $key 要排序的键
|
||
* @param string $sort 排序类型 SORT_ASC SORT_DESC
|
||
* return array 排序后的数组
|
||
*/
|
||
function arraySort($array, $key, $sort = SORT_ASC)
|
||
{
|
||
$keysValue = array();
|
||
foreach ($array as $k => $v) {
|
||
$keysValue[$k] = $v[$key];
|
||
}
|
||
array_multisort($keysValue, $sort, $array);
|
||
return $array;
|
||
}
|
||
|
||
/**
|
||
* Wrapper for JSON decode that implements error detection with helpful
|
||
* error messages.
|
||
*
|
||
* @param string $json JSON data to parse
|
||
* @param bool $assoc When true, returned objects will be converted
|
||
* into associative arrays.
|
||
* @param int $depth User specified recursion depth.
|
||
*
|
||
* @return mixed
|
||
* @throws \InvalidArgumentException if the JSON cannot be parsed.
|
||
* @link http://www.php.net/manual/en/function.json-decode.php
|
||
*/
|
||
function json_decode($json, $assoc = false, $depth = 512)
|
||
{
|
||
static $jsonErrors = array(
|
||
JSON_ERROR_DEPTH => 'JSON_ERROR_DEPTH - Maximum stack depth exceeded',
|
||
JSON_ERROR_STATE_MISMATCH => 'JSON_ERROR_STATE_MISMATCH - Underflow or the modes mismatch',
|
||
JSON_ERROR_CTRL_CHAR => 'JSON_ERROR_CTRL_CHAR - Unexpected control character found',
|
||
JSON_ERROR_SYNTAX => 'JSON_ERROR_SYNTAX - Syntax error, malformed JSON',
|
||
JSON_ERROR_UTF8 => 'JSON_ERROR_UTF8 - Malformed UTF-8 characters, possibly incorrectly encoded'
|
||
);
|
||
|
||
if (empty($json)) {
|
||
return null;
|
||
}
|
||
$data = \json_decode($json, $assoc, $depth);
|
||
|
||
if (JSON_ERROR_NONE !== json_last_error()) {
|
||
$last = json_last_error();
|
||
throw new \InvalidArgumentException(
|
||
'Unable to parse JSON data: '
|
||
. (isset($jsonErrors[$last])
|
||
? $jsonErrors[$last]
|
||
: 'Unknown error')
|
||
);
|
||
}
|
||
|
||
return $data;
|
||
}
|
||
|
||
/**
|
||
* 计算七牛API中的数据格式
|
||
*
|
||
* @param string $bucket 待操作的空间名
|
||
* @param string $key 待操作的文件名
|
||
*
|
||
* @return string 符合七牛API规格的数据格式
|
||
* @link https://developer.qiniu.com/kodo/api/data-format
|
||
*/
|
||
function entry($bucket, $key = null)
|
||
{
|
||
$en = $bucket;
|
||
if ($key !== null) {
|
||
$en = $bucket . ':' . $key;
|
||
}
|
||
return base64_urlSafeEncode($en);
|
||
}
|
||
|
||
/**
|
||
* array 辅助方法，无值时不set
|
||
*
|
||
* @param array $array 待操作array
|
||
* @param string $key key
|
||
* @param string $value value 为null时 不设置
|
||
*
|
||
* @return array 原来的array，便于连续操作
|
||
*/
|
||
function setWithoutEmpty(&$array, $key, $value)
|
||
{
|
||
if (!empty($value)) {
|
||
$array[$key] = $value;
|
||
}
|
||
return $array;
|
||
}
|
||
|
||
/**
|
||
* 缩略图链接拼接
|
||
*
|
||
* @param string $url 图片链接
|
||
* @param int $mode 缩略模式
|
||
* @param int $width 宽度
|
||
* @param int $height 长度
|
||
* @param string $format 输出类型
|
||
* @param int $quality 图片质量
|
||
* @param int $interlace 是否支持渐进显示
|
||
* @param int $ignoreError 忽略结果
|
||
* @return string
|
||
* @link http://developer.qiniu.com/code/v6/api/kodo-api/image/imageview2.html
|
||
* @author Sherlock Ren <sherlock_ren@icloud.com>
|
||
*/
|
||
function thumbnail(
|
||
$url,
|
||
$mode,
|
||
$width,
|
||
$height,
|
||
$format = null,
|
||
$quality = null,
|
||
$interlace = null,
|
||
$ignoreError = 1
|
||
) {
|
||
|
||
static $imageUrlBuilder = null;
|
||
if (is_null($imageUrlBuilder)) {
|
||
$imageUrlBuilder = new \Qiniu\Processing\ImageUrlBuilder;
|
||
}
|
||
|
||
return call_user_func_array(array($imageUrlBuilder, 'thumbnail'), func_get_args());
|
||
}
|
||
|
||
/**
|
||
* 图片水印
|
||
*
|
||
* @param string $url 图片链接
|
||
* @param string $image 水印图片链接
|
||
* @param numeric $dissolve 透明度
|
||
* @param string $gravity 水印位置
|
||
* @param numeric $dx 横轴边距
|
||
* @param numeric $dy 纵轴边距
|
||
* @param numeric $watermarkScale 自适应原图的短边比例
|
||
* @link http://developer.qiniu.com/code/v6/api/kodo-api/image/watermark.html
|
||
* @return string
|
||
* @author Sherlock Ren <sherlock_ren@icloud.com>
|
||
*/
|
||
function waterImg(
|
||
$url,
|
||
$image,
|
||
$dissolve = 100,
|
||
$gravity = 'SouthEast',
|
||
$dx = null,
|
||
$dy = null,
|
||
$watermarkScale = null
|
||
) {
|
||
|
||
static $imageUrlBuilder = null;
|
||
if (is_null($imageUrlBuilder)) {
|
||
$imageUrlBuilder = new \Qiniu\Processing\ImageUrlBuilder;
|
||
}
|
||
|
||
return call_user_func_array(array($imageUrlBuilder, 'waterImg'), func_get_args());
|
||
}
|
||
|
||
/**
|
||
* 文字水印
|
||
*
|
||
* @param string $url 图片链接
|
||
* @param string $text 文字
|
||
* @param string $font 文字字体
|
||
* @param string $fontSize 文字字号
|
||
* @param string $fontColor 文字颜色
|
||
* @param numeric $dissolve 透明度
|
||
* @param string $gravity 水印位置
|
||
* @param numeric $dx 横轴边距
|
||
* @param numeric $dy 纵轴边距
|
||
* @link http://developer.qiniu.com/code/v6/api/kodo-api/image/watermark.html#text-watermark
|
||
* @return string
|
||
* @author Sherlock Ren <sherlock_ren@icloud.com>
|
||
*/
|
||
function waterText(
|
||
$url,
|
||
$text,
|
||
$font = '黑体',
|
||
$fontSize = 0,
|
||
$fontColor = null,
|
||
$dissolve = 100,
|
||
$gravity = 'SouthEast',
|
||
$dx = null,
|
||
$dy = null
|
||
) {
|
||
|
||
static $imageUrlBuilder = null;
|
||
if (is_null($imageUrlBuilder)) {
|
||
$imageUrlBuilder = new \Qiniu\Processing\ImageUrlBuilder;
|
||
}
|
||
|
||
return call_user_func_array(array($imageUrlBuilder, 'waterText'), func_get_args());
|
||
}
|
||
|
||
/**
|
||
* 从uptoken解析accessKey和bucket
|
||
*
|
||
* @param $upToken
|
||
* @return array(ak,bucket,err=null)
|
||
*/
|
||
function explodeUpToken($upToken)
|
||
{
|
||
$items = explode(':', $upToken);
|
||
if (count($items) != 3) {
|
||
return array(null, null, "invalid uptoken");
|
||
}
|
||
$accessKey = $items[0];
|
||
$putPolicy = json_decode(base64_urlSafeDecode($items[2]));
|
||
$scope = $putPolicy->scope;
|
||
$scopeItems = explode(':', $scope);
|
||
$bucket = $scopeItems[0];
|
||
return array($accessKey, $bucket, null);
|
||
}
|
||
|
||
// polyfill ucwords for `php version < 5.4.32` or `5.5.0 <= php version < 5.5.16`
|
||
if (version_compare(phpversion(), "5.4.32") < 0 ||
|
||
(
|
||
version_compare(phpversion(), "5.5.0") >= 0 &&
|
||
version_compare(phpversion(), "5.5.16") < 0
|
||
)
|
||
) {
|
||
function ucwords($str, $delimiters = " \t\r\n\f\v")
|
||
{
|
||
$delims = preg_split('//u', $delimiters, -1, PREG_SPLIT_NO_EMPTY);
|
||
|
||
foreach ($delims as $delim) {
|
||
$str = implode($delim, array_map('ucfirst', explode($delim, $str)));
|
||
}
|
||
|
||
return $str;
|
||
}
|
||
} else {
|
||
function ucwords($str, $delimiters)
|
||
{
|
||
return \ucwords($str, $delimiters);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 将 parse_url 的结果转换回字符串
|
||
* TODO: add unit test
|
||
*
|
||
* @param $parsed_url - parse_url 的结果
|
||
* @return string
|
||
*/
|
||
function unparse_url($parsed_url)
|
||
{
|
||
|
||
$scheme = isset($parsed_url['scheme']) ? $parsed_url['scheme'] . '://' : '';
|
||
|
||
$host = isset($parsed_url['host']) ? $parsed_url['host'] : '';
|
||
|
||
$port = isset($parsed_url['port']) ? ':' . $parsed_url['port'] : '';
|
||
|
||
$user = isset($parsed_url['user']) ? $parsed_url['user'] : '';
|
||
|
||
$pass = isset($parsed_url['pass']) ? ':' . $parsed_url['pass'] : '';
|
||
|
||
$pass = ($user || $pass) ? "$pass@" : '';
|
||
|
||
$path = isset($parsed_url['path']) ? $parsed_url['path'] : '';
|
||
|
||
$query = isset($parsed_url['query']) ? '?' . $parsed_url['query'] : '';
|
||
|
||
$fragment = isset($parsed_url['fragment']) ? '#' . $parsed_url['fragment'] : '';
|
||
|
||
return "$scheme$user$pass$host$port$path$query$fragment";
|
||
}
|
||
}
|