Add PHP-SDK Content (#27)

* Consolidated changes

* Consolidated changes

---------

Co-authored-by: liucheng.yao <[email protected]>

Author: summerboy2134

_config.yml

@@ -249,3 +249,5 @@ collections:
     output: true
   node.js-sdk:
     output: true
+  php-sdk:
+    output: true

_data/navigation.yml

@@ -350,3 +350,46 @@ node.js-sdk:
         url: /node.js-sdk/S3协议常用工具.html
 
 
+
+php-sdk:
+  - title: PHP-SDK
+    children:
+      - title: 概述
+        url:  /php-sdk/概述.html
+      - title: 安装
+        url:   /php-sdk/安装.html
+      - title: 快速使用
+        url:   /php-sdk/快速使用.html
+
+      - title:  文件上传
+        children:
+          - title:  简单上传
+            url:    /php-sdk/简单上传.html
+          - title:  分片上传
+            url:    /php-sdk/分片上传.html
+          - title:  指定存储类型上传
+            url:    /php-sdk/指定存储类型上传.html
+      - title:  文件管理
+        children:
+          - title:  存储类型转换
+            url:    /php-sdk/存储类型转换.html
+          - title:  获取对象权限信息
+            url:    /php-sdk/获取对象权限信息.html
+          - title:  获取对象元数据
+            url:    /php-sdk/获取对象元数据.html
+          - title:  获取目录文件列表
+            url:    /php-sdk/获取目录文件列表.html
+          - title:  文件下载
+            url:    /php-sdk/文件下载.html
+          - title:  删除文件
+            url:    /php-sdk/删除文件.html
+          - title:  拷贝文件
+            url:    /php-sdk/拷贝文件.html
+          - title:  解冻归档文件
+            url:    /php-sdk/解冻归档文件.html
+      - title: AWS S3 协议支持说明
+        url: /php-sdk/S3协议支持说明.html
+      - title: AWS S3 协议常用工具
+        url: /php-sdk/S3协议常用工具.html
+
+

collections/_node.js-sdk/img/cors.png

@@ -25,32 +25,31 @@ sidebar:
 ### 示例
 > 执行该示例前请确保配置文件的正确性<br>以下代码段需要在上下文中运行
 
-<div class="copyable" markdown="1">
+<div class="copyable" markdown="1">
 {% highlight javascript linenos %}
 const {
     CreateMultipartUploadCommand,
     UploadPartCommand,
     CompleteMultipartUploadCommand,
     AbortMultipartUploadCommand
 } = require("@aws-sdk/client-s3");
-const s3 = require('./s3client');
+const s3 = require('../s3client');
 const fs = require('fs');
-const crypto = require('crypto');
+const crypto = require('crypto');
 
 // 计算 MD5
 const calculateMD5 = (data) => {
-    return crypto.createHash('md5').update(data).digest('base64');
+return crypto.createHash('md5').update(data).digest('base64');
 };
 
 const sliceUpload = async (bucketName, key, filePath) => {
-    const fileBuffer = fs.readFileSync(filePath);
-    const partSize = 8 * 1024 * 1024; // 固定8MB
-    const numParts = Math.ceil(fileBuffer.length / partSize);
-    
+const fileBuffer = fs.readFileSync(filePath);
+const partSize = 8 * 1024 * 1024; // 固定8MB
+const numParts = Math.ceil(fileBuffer.length / partSize);
+
     let uploadId;
 
-    try {
-    
+    try {
         // 创建分片上传任务
         const createMultipartUploadResponse = await s3.send(
             new CreateMultipartUploadCommand({
@@ -60,15 +59,13 @@ const sliceUpload = async (bucketName, key, filePath) => {
         );
 
         uploadId = createMultipartUploadResponse.UploadId;
-        const uploadPromises = [];
-        
-         // 分片上传
+        const uploadedParts = [];
+
         for (let partNumber = 1; partNumber <= numParts; partNumber++) {
             const start = (partNumber - 1) * partSize;
             const end = Math.min(start + partSize, fileBuffer.length);
             const partBuffer = fileBuffer.subarray(start, end);
             const md5Hash = calculateMD5(partBuffer);
-
             const uploadPartCommand = new UploadPartCommand({
                 Bucket: bucketName,
                 Key: key,
@@ -78,22 +75,21 @@ const sliceUpload = async (bucketName, key, filePath) => {
                 ContentMD5: md5Hash,
             });
 
-            uploadPromises.push(
-                s3.send(uploadPartCommand).then((uploadPartResponse) => ({
-                    ETag: uploadPartResponse.ETag,
-                    PartNumber: partNumber,
-                }))
-            );
+            const uploadPartResponse = await s3.send(uploadPartCommand);
+            console.log(`Part ${partNumber} uploaded successfully`);
+            uploadedParts.push({
+                ETag: uploadPartResponse.ETag,
+                PartNumber: partNumber,
+            });
         }
-        const uploadedParts = await Promise.all(uploadPromises);
-        
-    // 验证每个分片是否正确上传
+
+        // 验证分片
         uploadedParts.forEach((part) => {
             if (!part.ETag) {
                 throw new Error(`Part ${part.PartNumber} failed to upload.`);
             }
-        });
-        
+        });
+
         // 完成分片上传
         await s3.send(
             new CompleteMultipartUploadCommand({
@@ -110,9 +106,8 @@ const sliceUpload = async (bucketName, key, filePath) => {
     } catch (error) {
         console.error("Error uploading file:", error);
 
-        if (uploadId) {
-        
-            // 如果上传失败，可以选择在此处中止上传
+        if (uploadId) {
+            // 中止上传
             await s3.send(
                 new AbortMultipartUploadCommand({
                     Bucket: bucketName,
@@ -123,12 +118,12 @@ const sliceUpload = async (bucketName, key, filePath) => {
         }
     }
 };
-{% endhighlight %}
-</div>
+{% endhighlight %}
+</div>
 
 > 在 `Example/` 目录中运行以下命令执行该示例
-<div class="copyable" markdown="1">
+<div class="copyable" markdown="1">
 {% highlight bash linenos %}
 $ node SliceUpload.js <bucketName> <keyName> <filePath>
-{% endhighlight %}
+{% endhighlight %}
 </div>

collections/_node.js-sdk/分片上传.md

@@ -5,14 +5,9 @@ sidebar:
 ---
 
 ## 快速运行 SDK 示例
-### 1. 准备工作
-1. 登录[对象存储控制台](https://console.ucloud.cn/ufile/ufile)，创建存储空间。获取存储空间名称和存储空间域名。
-2. 登录[账号管理控制台](https://console.ucloud.cn/uaccount/api_manage)，获取您的项目公钥和私钥。
-3. 配置CORS 规则，来源Origin可以按需配置，Allow-Header 需配成*，Expose-Headers 需要 ETag、Content-Length 以及其他 js 需要读取的 header 字段，如下图所示。
-![image-cors](img/cors.png)
 
-### 2. 配置s3客户端文件
-  确保已完成跨域设置，修改s3client.js 文件
+### 1. 配置s3客户端文件
+在项目根目录下，修改s3client.js 文件
 
 
 <div class="copyable" markdown="1">
@@ -47,9 +42,9 @@ module.exports = s3;
 | signatureVersion  | AWS签名版本，默认使用签名版本 4 来验证请求             | String   | 否        |
 | forcePathStyle    | 使用路径风格或虚拟主机风格，具体参考 AWS S3 协议支持说明     | Boolean  | 否        |
 
-### 3. 运行示例
+### 2. 运行示例
 首先确保已完成SDK示例的本地安装。
-以文件上传为例，必须的输入参数为配置文件对应地域下的`Bucket Name`，以及需要保存在该Bucket 下的`Key Name` (即文件名) ，存储类型默认为标准存储。若要指定存储类型，参照**S3协议支持说明**，确认完输入信息后点击上传文件。
+以文件上传为例，必须的输入参数为配置文件对应地域下的`bucketName`，需要保存在该Bucket 下的`keyname` (即文件名) ，以及待上传的文件的本地路径`filePath`，存储类型默认为标准存储。若要指定存储类型，参照**S3协议支持说明**，确认完输入信息后点击上传文件。
 
 <div class="copyable" markdown="1">
 {% highlight bash linenos %}
@@ -60,7 +55,6 @@ $ node PutObject.js <bucketName> <keyName> <filePath> [storageClass]
 {% endhighlight %}
 </div>
 
-如果浏览器控制台出现了CORS 相关的错误信息，请检查是否正确完成跨域配置。
 
 ### 注意
 * PutObject 目前仅支持 5GB 大小文件，如果需要上传大于 5GB 的文件，请采用分片上传的 API