';
+
+ if (!empty($exifData['camera'])) {
+ $exifHtml .= '
' . htmlspecialchars($exifData['camera']) . '
';
+ }
+
+ $details = array();
+ if (!empty($exifData['exposure'])) {
+ $details[] = '快门:' . htmlspecialchars($exifData['exposure']);
+ }
+ if (!empty($exifData['aperture'])) {
+ $details[] = '光圈:f/' . htmlspecialchars($exifData['aperture']);
+ }
+ if (!empty($exifData['iso'])) {
+ $details[] = 'ISO:' . htmlspecialchars($exifData['iso']);
+ }
+ if (!empty($exifData['focal_length'])) {
+ $details[] = '焦距:' . htmlspecialchars($exifData['focal_length']) . 'mm';
+ }
+
+ if (!empty($details)) {
+ $exifHtml .= '
' . implode(' ', $details) . '
';
+ }
+
+ $exifHtml .= '
' . $imgTag . $exifHtml . '
';
+ }
+ }
+
+ return $imgTag;
+ }, $content);
+ }
+
+ /**
+ * 提取EXIF信息
+ */
+ private static function extractExif($filePath)
+ {
+ if (!function_exists('exif_read_data')) {
+ return array();
+ }
+
+ $exif = @exif_read_data($filePath);
+ if (!$exif) {
+ return array();
+ }
+
+ $result = array();
+
+ // 相机型号
+ if (!empty($exif['Make']) || !empty($exif['Model'])) {
+ $make = !empty($exif['Make']) ? trim($exif['Make']) : '';
+ $model = !empty($exif['Model']) ? trim($exif['Model']) : '';
+ $result['camera'] = trim($make . ' ' . $model);
+ }
+
+ // 曝光时间
+ if (!empty($exif['ExposureTime'])) {
+ $result['exposure'] = $exif['ExposureTime'];
+ }
+
+ // 光圈值
+ if (!empty($exif['FNumber'])) {
+ $fnumber = is_array($exif['FNumber']) ? $exif['FNumber'][0] / $exif['FNumber'][1] : $exif['FNumber'];
+ $result['aperture'] = number_format($fnumber, 1);
+ }
+
+ // ISO
+ if (!empty($exif['ISOSpeedRatings'])) {
+ $result['iso'] = $exif['ISOSpeedRatings'];
+ }
+
+ // 焦距
+ if (!empty($exif['FocalLength'])) {
+ if (is_array($exif['FocalLength'])) {
+ $focal = $exif['FocalLength'][0] / $exif['FocalLength'][1];
+ } else {
+ $focal = $exif['FocalLength'];
+ }
+ $result['focal_length'] = number_format($focal, 1);
+ }
+
+ // 拍摄时间
+ if (!empty($exif['DateTimeOriginal'])) {
+ $result['date'] = date('Y-m-d H:i', strtotime($exif['DateTimeOriginal']));
+ }
+
+ return $result;
+ }
+
+ /**
+ * 检测是否支持WebP转换
+ */
+ private static function canConvertWebp()
+ {
+ if (!extension_loaded('gd')) {
+ return false;
+ }
+
+ $gdInfo = gd_info();
+ return isset($gdInfo['WebP Support']) && $gdInfo['WebP Support'];
+ }
+
+ /**
+ * 压缩图片并转换格式
+ */
+ private static function compressAndConvert($sourcePath, $targetExt, $quality)
+ {
+ $imageInfo = @getimagesize($sourcePath);
+ if (!$imageInfo) {
+ return $sourcePath;
+ }
+
+ $mime = $imageInfo['mime'];
+
+ // 创建图像资源
+ switch ($mime) {
+ case 'image/jpeg':
+ $image = imagecreatefromjpeg($sourcePath);
+ break;
+ case 'image/png':
+ $image = imagecreatefrompng($sourcePath);
+ imagepalettetotruecolor($image);
+ imagealphablending($image, false);
+ imagesavealpha($image, true);
+ break;
+ case 'image/gif':
+ $image = imagecreatefromgif($sourcePath);
+ break;
+ default:
+ return $sourcePath;
+ }
+
+ if (!$image) {
+ return $sourcePath;
+ }
+
+ $tempFile = tempnam(sys_get_temp_dir(), 'img_') . '.' . $targetExt;
+
+ $success = false;
+ switch ($targetExt) {
+ case 'jpg':
+ case 'jpeg':
+ $success = imagejpeg($image, $tempFile, $quality);
+ break;
+ case 'png':
+ $pngQuality = 9 - round(($quality / 100) * 9);
+ $success = imagepng($image, $tempFile, $pngQuality);
+ break;
+ case 'webp':
+ if (self::canConvertWebp()) {
+ $success = imagewebp($image, $tempFile, $quality);
+ }
+ break;
+ }
+
+ imagedestroy($image);
+
+ if ($success && file_exists($tempFile)) {
+ return $tempFile;
+ }
+
+ return $sourcePath;
+ }
+
+ /**
+ * 使用七牛基本图片处理
+ */
+ private static function applyQiniuStyle($url, $option)
+ {
+ $pathInfo = pathinfo($url);
+ $currentExt = isset($pathInfo['extension']) ? strtolower($pathInfo['extension']) : '';
+
+ $needQuality = $option->quality && $option->quality != 85;
+ $needWebP = $option->webp && $currentExt != 'webp';
+
+ if (!$needQuality && !$needWebP) {
+ return $url;
+ }
+
+ $params = array();
+
+ if ($needQuality) {
+ $params[] = 'q/' . intval($option->quality);
+ }
+
+ if ($needWebP) {
+ $params[] = 'format/webp';
+ }
+
+ if (!empty($params)) {
+ $separator = (strpos($url, '?') === false) ? '?' : '&';
+ $url .= $separator . 'imageView2/2/' . implode('/', $params);
+ }
+
+ return $url;
+ }
+
+ /**
+ * 删除文件
+ */
+ public static function deleteFile($filepath)
+ {
+ try {
+ $option = self::getConfig();
+ $auth = new Auth($option->accesskey, $option->secretkey);
+ $bucketMgr = new BucketManager($auth);
+
+ $err = $bucketMgr->delete($option->bucket, $filepath);
+
+ return $err === null;
+ } catch (Exception $e) {
+ return false;
+ }
+ }
+
+ /**
+ * 上传文件到七牛云 - 修复中文文件名问题
+ */
+ public static function uploadFile($file, $content = null)
+ {
+ error_reporting(0);
+
+ if (empty($file['name']) || !isset($file['tmp_name'])) {
+ return array('error' => 1, 'message' => '上传文件无效');
+ }
+
+ // 获取原始文件名
+ $originalName = basename($file['name']);
+
+ // 使用pathinfo正确处理中文字符
+ $pathInfo = pathinfo($originalName);
+ $originalExt = isset($pathInfo['extension']) ? strtolower($pathInfo['extension']) : '';
+ $baseName = isset($pathInfo['filename']) ? $pathInfo['filename'] : '';
+
+ // 校验扩展名
+ if (!Widget_Upload::checkFileType($originalExt)) {
+ return array('error' => 1, 'message' => '不允许上传此类型文件');
+ }
+
+ $option = self::getConfig();
+
+ if (empty($option->bucket) || empty($option->accesskey) || empty($option->secretkey) || empty($option->domain)) {
+ return array('error' => 1, 'message' => '请先正确配置七牛云插件');
+ }
+
+ $date = new Typecho_Date(Typecho_Widget::widget('Widget_Options')->gmtTime);
+
+ // 提取EXIF信息
+ $exifData = array();
+ if ($option->exif && in_array($originalExt, array('jpg', 'jpeg'))) {
+ $exifData = self::extractExif($file['tmp_name']);
+ }
+
+ // 处理图片压缩和转换
+ $tempFile = null;
+ $uploadPath = $file['tmp_name'];
+ $finalExt = $originalExt;
+
+ $supportedImages = array('jpg', 'jpeg', 'png', 'gif');
+ if (in_array($originalExt, $supportedImages)) {
+ $quality = isset($option->quality) ? intval($option->quality) : 85;
+ $quality = max(1, min(100, $quality));
+
+ $targetExt = $originalExt;
+ if ($option->webp && self::canConvertWebp() && $originalExt != 'gif') {
+ $targetExt = 'webp';
+ }
+
+ if ($targetExt != $originalExt || $quality != 85) {
+ $processedPath = self::compressAndConvert($file['tmp_name'], $targetExt, $quality);
+
+ if ($processedPath != $file['tmp_name']) {
+ $uploadPath = $processedPath;
+ $finalExt = $targetExt;
+ $tempFile = $processedPath;
+ }
+ }
+ }
+
+ // 生成存储路径 - 保持原始文件名，只替换文件系统不允许的字符
+ // 处理文件名，保留中文字符，只替换特殊字符
+ $safeName = $baseName;
+
+ // 替换文件系统不允许的字符，但保留中文字符
+ $safeName = preg_replace('/[<>:"\/\\|?*]/', '_', $safeName);
+ // 移除首尾空格
+ $safeName = trim($safeName);
+ // 如果名称为空，使用时间戳
+ if (empty($safeName)) {
+ $safeName = 'image_' . time();
+ }
+
+ if (isset($content)) {
+ $filePath = $content['attachment']->path;
+ self::deleteFile($filePath);
+ } else {
+ $savepath = preg_replace(array('/\{year\}/', '/\{month\}/', '/\{day\}/', '/\{random\}/'),
+ array($date->year, $date->month, $date->day, uniqid()),
+ $option->savepath);
+ $filePath = rtrim($savepath, '/') . '/' . $safeName . '.' . $finalExt;
+ }
+
+ if (!file_exists($uploadPath)) {
+ return array('error' => 1, 'message' => '上传文件不存在');
+ }
+
+ try {
+ $upManager = new UploadManager();
+ $auth = new Auth($option->accesskey, $option->secretkey);
+ $token = $auth->uploadToken($option->bucket);
+
+ // 七牛云SDK会自动处理文件名编码
+ list($ret, $error) = $upManager->putFile($token, $filePath, $uploadPath);
+
+ if ($tempFile && file_exists($tempFile) && $tempFile != $file['tmp_name']) {
+ @unlink($tempFile);
+ }
+
+ if ($error == null) {
+ $rawUrl = Typecho_Common::url($filePath, $option->domain);
+ $processedUrl = self::applyQiniuStyle($rawUrl, $option);
+
+ $fileSize = @filesize($uploadPath);
+
+ $result = array(
+ 'name' => $originalName, // 使用原始文件名
+ 'path' => $filePath,
+ 'size' => $fileSize ? (int)$fileSize : 0,
+ 'type' => $finalExt,
+ 'mime' => $finalExt == 'webp' ? 'image/webp' : Typecho_Common::mimeContentType($uploadPath),
+ 'url' => $processedUrl
+ );
+
+ if (!empty($exifData)) {
+ $result['exif'] = $exifData;
+ }
+
+ return $result;
+ } else {
+ return array('error' => 1, 'message' => '七牛云上传失败: ' . $error->message());
+ }
+ } catch (Exception $e) {
+ if ($tempFile && file_exists($tempFile) && $tempFile != $file['tmp_name']) {
+ @unlink($tempFile);
+ }
+ return array('error' => 1, 'message' => '上传异常: ' . $e->getMessage());
+ }
+ }
+
+ // 上传文件处理函数
+ public static function uploadHandle($file)
+ {
+ return self::uploadFile($file);
+ }
+
+ // 修改文件处理函数
+ public static function modifyHandle($content, $file)
+ {
+ return self::uploadFile($file, $content);
+ }
+
+ // 删除文件处理函数
+ public static function deleteHandle(array $content)
+ {
+ if (isset($content['attachment'])) {
+ self::deleteFile($content['attachment']->path);
+ }
+ }
+
+ // 获取实际文件绝对访问路径
+ public static function attachmentHandle(array $content)
+ {
+ $option = self::getConfig();
+ if (isset($content['attachment'])) {
+ $rawUrl = Typecho_Common::url($content['attachment']->path, $option->domain);
+ return self::applyQiniuStyle($rawUrl, $option);
+ }
+ return '';
+ }
+}
\ No newline at end of file
diff --git a/composer.json b/composer.json
new file mode 100644
index 0000000..97d16ff
--- /dev/null
+++ b/composer.json
@@ -0,0 +1,5 @@
+{
+ "require": {
+ "qiniu/php-sdk": "^7.14"
+ }
+}
diff --git a/composer.lock b/composer.lock
new file mode 100644
index 0000000..e20d4a2
--- /dev/null
+++ b/composer.lock
@@ -0,0 +1,142 @@
+{
+ "_readme": [
+ "This file locks the dependencies of your project to a known state",
+ "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
+ "This file is @generated automatically"
+ ],
+ "content-hash": "e53b7aa650906cf4c75020ac18b97155",
+ "packages": [
+ {
+ "name": "myclabs/php-enum",
+ "version": "1.8.5",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/myclabs/php-enum.git",
+ "reference": "e7be26966b7398204a234f8673fdad5ac6277802"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/myclabs/php-enum/zipball/e7be26966b7398204a234f8673fdad5ac6277802",
+ "reference": "e7be26966b7398204a234f8673fdad5ac6277802",
+ "shasum": ""
+ },
+ "require": {
+ "ext-json": "*",
+ "php": "^7.3 || ^8.0"
+ },
+ "require-dev": {
+ "phpunit/phpunit": "^9.5",
+ "squizlabs/php_codesniffer": "1.*",
+ "vimeo/psalm": "^4.6.2 || ^5.2"
+ },
+ "type": "library",
+ "autoload": {
+ "psr-4": {
+ "MyCLabs\\Enum\\": "src/"
+ },
+ "classmap": [
+ "stubs/Stringable.php"
+ ]
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "PHP Enum contributors",
+ "homepage": "https://github.com/myclabs/php-enum/graphs/contributors"
+ }
+ ],
+ "description": "PHP Enum implementation",
+ "homepage": "https://github.com/myclabs/php-enum",
+ "keywords": [
+ "enum"
+ ],
+ "support": {
+ "issues": "https://github.com/myclabs/php-enum/issues",
+ "source": "https://github.com/myclabs/php-enum/tree/1.8.5"
+ },
+ "funding": [
+ {
+ "url": "https://github.com/mnapoli",
+ "type": "github"
+ },
+ {
+ "url": "https://tidelift.com/funding/github/packagist/myclabs/php-enum",
+ "type": "tidelift"
+ }
+ ],
+ "time": "2025-01-14T11:49:03+00:00"
+ },
+ {
+ "name": "qiniu/php-sdk",
+ "version": "v7.14.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/qiniu/php-sdk.git",
+ "reference": "ee752ffa7263ce99fca0bd7340cf13c486a3516c"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/qiniu/php-sdk/zipball/ee752ffa7263ce99fca0bd7340cf13c486a3516c",
+ "reference": "ee752ffa7263ce99fca0bd7340cf13c486a3516c",
+ "shasum": ""
+ },
+ "require": {
+ "ext-curl": "*",
+ "ext-xml": "*",
+ "myclabs/php-enum": "~1.5.2 || ~1.6.6 || ~1.7.7 || ~1.8.4",
+ "php": ">=5.3.3"
+ },
+ "require-dev": {
+ "paragonie/random_compat": ">=2",
+ "phpunit/phpunit": "^4.8 || ^5.0 || ^6.0 || ^7.0 || ^8.0 || ^9.3.4",
+ "squizlabs/php_codesniffer": "^2.3 || ~3.6"
+ },
+ "type": "library",
+ "autoload": {
+ "files": [
+ "src/Qiniu/functions.php",
+ "src/Qiniu/Http/Middleware/Middleware.php"
+ ],
+ "psr-4": {
+ "Qiniu\\": "src/Qiniu"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Qiniu",
+ "email": "sdk@qiniu.com",
+ "homepage": "http://www.qiniu.com"
+ }
+ ],
+ "description": "Qiniu Resource (Cloud) Storage SDK for PHP",
+ "homepage": "http://developer.qiniu.com/",
+ "keywords": [
+ "cloud",
+ "qiniu",
+ "sdk",
+ "storage"
+ ],
+ "support": {
+ "issues": "https://github.com/qiniu/php-sdk/issues",
+ "source": "https://github.com/qiniu/php-sdk/tree/v7.14.0"
+ },
+ "time": "2024-10-25T08:39:01+00:00"
+ }
+ ],
+ "packages-dev": [],
+ "aliases": [],
+ "minimum-stability": "stable",
+ "stability-flags": [],
+ "prefer-stable": false,
+ "prefer-lowest": false,
+ "platform": [],
+ "platform-dev": [],
+ "plugin-api-version": "2.0.0"
+}
diff --git a/php-sdk/.github/workflows/test-ci.yml b/php-sdk/.github/workflows/test-ci.yml
new file mode 100644
index 0000000..00f964e
--- /dev/null
+++ b/php-sdk/.github/workflows/test-ci.yml
@@ -0,0 +1,71 @@
+name: PHP CI with Composer
+
+on: [push, pull_request]
+
+jobs:
+ build:
+ strategy:
+ fail-fast: false
+ matrix:
+ php-versions: ['5.3', '5.4', '5.5', '5.6', '7.0', '7.1', '7.2', '7.3', '7.4', '8.0', '8.1', '8.2']
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v2
+
+ - name: Setup php for mock server
+ uses: shivammathur/setup-php@v2
+ with:
+ php-version: '8.2'
+
+ - name: Install Go
+ uses: actions/setup-go@v2
+ with:
+ go-version: '1.21.x'
+
+ - name: Setup build-in server
+ run: |
+ nohup php -S localhost:9000 -t ./tests/mock-server/ > phpd.log 2>&1 &
+ echo $! > mock-server.pid
+
+ cd tests/socks5-server/
+ nohup go run main.go > ../../socks5.log 2>&1 &
+ echo $! > ../../socks-server.pid
+
+ - name: Setup php
+ uses: shivammathur/setup-php@v2
+ with:
+ php-version: ${{ matrix.php-versions }}
+
+ - name: Install dependencies
+ run: |
+ composer self-update
+ composer install --no-interaction --prefer-source --dev
+
+ - name: Run cases
+ run: |
+ ./vendor/bin/phpcs --standard=PSR2 src
+ ./vendor/bin/phpcs --standard=PSR2 examples
+ ./vendor/bin/phpcs --standard=PSR2 tests
+ ./vendor/bin/phpunit --coverage-clover=coverage.xml
+ cat mock-server.pid | xargs kill
+ cat socks-server.pid | xargs kill
+
+ env:
+ QINIU_ACCESS_KEY: ${{ secrets.QINIU_ACCESS_KEY }}
+ QINIU_SECRET_KEY: ${{ secrets.QINIU_SECRET_KEY }}
+ QINIU_TEST_BUCKET: ${{ secrets.QINIU_TEST_BUCKET }}
+ QINIU_TEST_DOMAIN: ${{ secrets.QINIU_TEST_DOMAIN }}
+
+ - name: Print mock server log
+ if: ${{ failure() }}
+ run: |
+ cat phpd.log
+
+ - name: Print socks5 server log
+ if: ${{ failure() }}
+ run: |
+ cat socks5.log
+
+ - name: After_success
+ run: bash <(curl -s https://codecov.io/bash)
diff --git a/php-sdk/.github/workflows/version-check.yml b/php-sdk/.github/workflows/version-check.yml
new file mode 100644
index 0000000..983a98f
--- /dev/null
+++ b/php-sdk/.github/workflows/version-check.yml
@@ -0,0 +1,19 @@
+name: PHP SDK Version Check
+on:
+ push:
+ tags:
+ - "v[0-9]+.[0-9]+.[0-9]+"
+jobs:
+ linux:
+ name: Version Check
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout code
+ uses: actions/checkout@v2
+ - name: Set env
+ run: echo "RELEASE_VERSION=${GITHUB_REF#refs/*/v}" >> $GITHUB_ENV
+ - name: Check
+ run: |
+ set -e
+ grep -qF "## ${RELEASE_VERSION}" CHANGELOG.md
+ grep -qF "const SDK_VER = '${RELEASE_VERSION}';" src/Qiniu/Config.php
diff --git a/php-sdk/.gitignore b/php-sdk/.gitignore
new file mode 100644
index 0000000..4c842c8
--- /dev/null
+++ b/php-sdk/.gitignore
@@ -0,0 +1,12 @@
+*.phar
+*.zip
+build/artifacts
+phpunit.xml
+phpunit.functional.xml
+.DS_Store
+.swp
+.build
+composer.lock
+vendor
+src/package.xml
+.idea/
diff --git a/php-sdk/.scrutinizer.yml b/php-sdk/.scrutinizer.yml
new file mode 100644
index 0000000..6a2d0d8
--- /dev/null
+++ b/php-sdk/.scrutinizer.yml
@@ -0,0 +1,42 @@
+filter:
+ excluded_paths: [tests/*]
+checks:
+ php:
+ code_rating: true
+ remove_extra_empty_lines: true
+ remove_php_closing_tag: true
+ remove_trailing_whitespace: true
+ fix_use_statements:
+ remove_unused: true
+ preserve_multiple: false
+ preserve_blanklines: true
+ order_alphabetically: true
+ fix_php_opening_tag: true
+ fix_linefeed: true
+ fix_line_ending: true
+ fix_identation_4spaces: true
+ fix_doc_comments: true
+tools:
+ external_code_coverage:
+ timeout: 1200
+ runs: 3
+ php_analyzer: true
+ php_code_coverage: false
+ php_code_sniffer:
+ config:
+ standard: PSR2
+ filter:
+ paths: ['src']
+ php_loc:
+ enabled: true
+ excluded_dirs: [vendor, tests]
+ php_cpd:
+ enabled: true
+ excluded_dirs: [vendor, tests]
+build:
+ nodes:
+ analysis:
+ tests:
+ override:
+ - php-scrutinizer-run
+
diff --git a/php-sdk/CHANGELOG.md b/php-sdk/CHANGELOG.md
new file mode 100644
index 0000000..6f8da5d
--- /dev/null
+++ b/php-sdk/CHANGELOG.md
@@ -0,0 +1,196 @@
+# Changelog
+
+## 7.14.0 (2024-10-16)
+* 对象存储，持久化处理支持工作流模版
+
+## 7.13.0 (2024-09-05)
+* 对象存储，验证回调方法新增支持 Qiniu 签名
+* 对象存储，调整查询空间区域域名顺序与默认空间管理域名
+* 支持闲时任务配置
+
+## 7.12.1 (2024-02-21)
+* 对象存储，添加上传策略部分字段
+
+## 7.12.0 (2023-12-11)
+* 对象存储，支持归档直读存储
+* 对象存储，批量操作支持自动查询 rs 服务域名
+
+## 7.11.0 (2023-09-05)
+* 支持代理
+
+## 7.10.1 (2023-08-04)
+* 修复部分 API 调用中间件合并失败（#417）
+
+## 7.10.0 (2023-06-20)
+* 对象存储，新增请求中间件逻辑，方便拓展请求逻辑
+* 对象存储，新增备用 UC 域名用于查询区域域名
+* 对象存储，修复分片上传初始化失败无法快速失败
+* 对象存储，移除首尔区域
+
+## 7.9.0 (2023-03-31)
+* 对象存储，修复无法对 key 为空字符串的对象进行操作
+* 修复 301 重定向无法正确获取 header 信息
+* 对象存储，新增查询区域域名过期时间
+* 对象存储，更新获取区域域名的接口
+* 对象存储，更新查询 bucket 域名为 uc 服务
+* 对象存储，新增 uc 服务可配置
+
+## 7.8.0 (2022-10-25)
+* 移除不推荐域名，并增加区域亚太-首尔和华东-浙江2
+* 对象存储，修复断点上传的文件内容不正确
+* 对象存储，优化分片上传 ctx 超时检测
+
+## 7.7.0 (2022-09-02)
+* 对象存储，新增支持设置文件级别生命周期 setObjectLifecycle API
+* 对象存储，内置增加七牛新建存储区域域名信息
+* 修复当前已知问题
+
+## 7.6.0 (2022-06-08)
+* 对象存储，管理类 API 发送请求时增加 [X-Qiniu-Date](https://developer.qiniu.com/kodo/3924/common-request-headers) （生成请求的时间） header
+
+
+## 7.5.0 (2022-04-18)
+* 对象存储，新增支持 [深度归档存储类型](https://developer.qiniu.com/kodo/3956/kodo-category#deep_archive)
+
+## 7.4.3 (2022-04-01)
+* 优化签名算法逻辑
+
+## 7.4.2（2022-03-01）
+* 修复已知关于请求 Header 处理不当问题，比如没有处理为大小写不敏感等问题
+
+## 7.4.1（2021-09-24）
+* 修复了 分片上传 v2 已知问题，明确给出了参数不合理情况下对应的错误提示信息
+
+## 7.4.0 (2021-07-19)
+* 【对象存储】支持 [分片上传 v2](https://developer.qiniu.com/kodo/7458/multipartupload) 和 断点续传，使用方式见 [开发者文档](https://developer.qiniu.com/kodo/1241/php#resume-upload-file)
+
+## 7.3.0 (2020-09-24)
+### 新增
+* 【对象存储】增加异步抓取方法与demo
+* 【融合cdn】增加查询CDN刷新记录、查询CDN预取记录方法与demo
+* 【云短信】增加查询短信发送记录的方法
+* 【实时音视频】增加rtc停止房间的合流转推方法
+* 【内容审核】增加图片审核、视频审核方法与demo
+
+### 修复
+* 【对象存储】修复签算 token 时上传策略中的 forceSaveKey 字段不生效的问题
+* 【对象存储】修复更新空间事件通知规则方法
+
+### 优化
+* 【对象存储】创建空间迁移到mkbucketv3 api
+* 优化对 http2 返回头的判断
+* 优化 demo 中的文档注释说明
+* docs 目录下的 rtc demo 移动至 examples/rtc 目录下
+* docs 目录下的 sms demo 移动至 examples/sms 目录下
+
+## 7.2.10 (2019-10-28)
+* 去除云短信类类型指定
+* 修改不传文件名时存在表单上传错误的情况
+
+## 7.2.9 (2019-07-09)
+* 添加空间管理、云短信接口
+* 去除无效参数
+
+## 7.2.7 (2018-11-06)
+* 添加 QVM 内网上传到 KODO 的 zone 设置
+
+## 7.2.6 (2018-05-18)
+* 修复rs，rsf在不同机房默认的https域名
+
+## 7.2.5 (2018-05-10)
+* 修复表单上传中多余的参数checkCrc导致的fname错位问题
+
+## 7.2.4 (2018-05-09)
+### 增加
+* 连麦功能
+
+## 7.2.3 (2018-01-20)
+### 增加
+* 新加坡机房
+### 修正
+* 获取域名的入口域名
+* http回复头部兼容大小写
+
+## 7.2.2 (2017-11-06)
+### 增加
+* Qiniu算法的鉴权方法
+
+## 7.1.4 (2017-06-21)
+### 增加
+* cdn 文件/目录 刷新
+* cdn 获取 流量/带宽
+* cdn 获取域名的访问日志列表
+* cdn 对资源链接进行时间戳防盗链签名
+
+## 7.1.3 (2016-11-18)
+### 增加
+* move, copy操作增加force参数
+
+## 7.1.2 (2016-11-12)
+### 修正
+* 明确抛出获取各区域域名失败时的报错
+
+## 7.1.1 (2016-11-02)
+### 修正
+* 多区域配置文件存储目录从home修改到tmp目录
+
+
+## 7.1.0 (2016-10-22)
+### 增加
+* 多存储区域的支持
+
+## 7.0.8 (2016-07-19)
+### 增加
+* demo
+* https url 支持
+* deleteAfterDays 策略
+* 添加图片处理链接统一拼接方法 by @SherlockRen
+
+## 7.0.7 (2016-01-12)
+### 修正
+* PersistentFop参数pipeline和notify_url失效
+* resume 模式 close file inputstream
+
+## 7.0.6 (2015-12-05)
+### 修正
+* php7.0 Json 对空字符串解析单元测试报错
+* 开启安全模式或者设置可操作目录树时，设置CURLOPT_FOLLOWLOCATION报错, by @twocabbages
+* fetch 支持不指定key, by @sinkcup
+
+## 7.0.5 (2015-10-29)
+### 增加
+* 增加上传策略最小文件大小限制 fsizeMin
+* 增加常见examples
+
+## 7.0.4 (2015-07-23)
+### 修正
+* 一些地方的严格比较检查
+* resumeupload 备用地址失效
+
+## 7.0.3 (2015-07-10)
+### 修改
+* 多zone 支持
+
+## 7.0.2 (2015-04-18)
+### 修改
+* fetch 接口返回内容调整
+* pfop 接口调整
+
+###修正
+* exception 类调用
+
+## 7.0.1 (2015-03-27)
+### 增加
+* 增加代码注释
+
+## 7.0.0 (2015-02-03)
+
+### 增加
+* 简化上传接口
+* 自动选择断点续上传还是直传
+* 重构代码，接口和内部结构更清晰
+* 改变mime
+* 代码覆盖度报告
+* policy改为array, 便于灵活增加，并加入过期字段检查
+* 文件列表支持目录形式
+* 利用元编程方式支持 fop 和 pfop
diff --git a/php-sdk/CONTRIBUTING.md b/php-sdk/CONTRIBUTING.md
new file mode 100644
index 0000000..0466bf9
--- /dev/null
+++ b/php-sdk/CONTRIBUTING.md
@@ -0,0 +1,30 @@
+# 贡献代码指南
+
+我们非常欢迎大家来贡献代码，我们会向贡献者致以最诚挚的敬意。
+
+一般可以通过在Github上提交[Pull Request](https://github.com/qiniu/php-sdk)来贡献代码。
+
+## Pull Request要求
+
+- **[PSR-2 编码风格标准](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md)** 。要通过项目中的code sniffer检查。
+
+- **代码格式** 提交前 请按 ./vendor/bin/phpcbf --standard=PSR2 进行格式化。
+
+- **必须添加测试！** - 如果没有测试（单元测试、集成测试都可以），那么提交的补丁是不会通过的。
+
+- **记得更新文档** - 保证`README.md`以及其他相关文档及时更新，和代码的变更保持一致性。
+
+- **考虑我们的发布周期** - 我们的版本号会服从[SemVer v2.0.0](http://semver.org/)，我们绝对不会随意变更对外的API。
+
+- **创建feature分支** - 最好不要从你的master分支提交 pull request。
+
+- **一个feature提交一个pull请求** - 如果你的代码变更了多个操作，那就提交多个pull请求吧。
+
+- **清晰的commit历史** - 保证你的pull请求的每次commit操作都是有意义的。如果你开发中需要执行多次的即时commit操作，那么请把它们放到一起再提交pull请求。
+
+## 运行测试
+
+``` bash
+./vendor/bin/phpunit tests/Qiniu/Tests/
+
+```
diff --git a/php-sdk/LICENSE b/php-sdk/LICENSE
new file mode 100644
index 0000000..ba646be
--- /dev/null
+++ b/php-sdk/LICENSE
@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Qiniu, Ltd.