$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); } function decodeEntry($entry) { $en = base64_urlSafeDecode($entry); $en = explode(':', $en); if (count($en) == 1) { return array($en[0], null); } return array($en[0], $en[1]); } /** * 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 */ 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 */ 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 */ 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"; } }