<?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 待计算校验码的字符串 * * @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)); } /** * 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 $bucket 待操作的空间名 * @param $key 待操作的文件名 * * @return string 符合七牛API规格的数据格式 * @link http://developer.qiniu.com/docs/v6/api/reference/data-formats.html */ function entry($bucket, $key) { $en = $bucket; if (!empty($key)) { $en = $bucket . ':' . $key; } return base64_urlSafeEncode($en); } /** * array 辅助方法,无值时不set * * @param $array 待操作array * @param $key key * @param $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_decode($items[2])); $scope = $putPolicy->scope; $scopeItems = explode(':', $scope); $bucket = $scopeItems[0]; return array($accessKey, $bucket, null); } }