文档首页/ 对象存储服务 OBS/ SDK参考/ PHP/ 对象相关接口/ 对象基础操作/ 上传对象/ 流式上传
更新时间：2026-09-07 GMT+08:00
查看PDF
分享

流式上传

开发过程中，您有任何问题可以在GitHub上提交issue，或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。

流式上传使用resource或GuzzleHttp\Psr7\StreamInterface作为对象的数据源。以下代码展示了如何进行流式上传：

上传网络流

<?php

// 引入依赖库
require 'vendor/autoload.php';
// 使用源码安装时引入SDK代码库
// require 'obs-autoloader.php';
// 声明命名空间
use Obs\ObsClient;
use Obs\ObsException;
// 创建ObsClient实例
$obsClient = new ObsClient([ 
    //推荐通过环境变量获取访问密钥AK/SK，这里也可以使用其他外部引入方式传入，如果使用硬编码可能会存在泄露风险。
    //您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html
    'key' => getenv('ACCESS_KEY_ID'),
    'secret' => getenv('SECRET_ACCESS_KEY'),
    'endpoint' => 'https://your-endpoint',
]);// 创建网络流
// 注意：fopen 的 URL 模式需要 php.ini 中 allow_url_fopen=On（默认开启，部分生产环境会关闭）
$stream = fopen('https://example.com/data.json', 'r');
if ($stream === false) {
    die('Failed to open URL');
}

try {
     $resp = $obsClient->putObject([
         'Bucket' => 'bucketname',
         'Key' => 'objectname',
         'Body' => $stream
    ]);
    printf("RequestId:%s\n", $resp['RequestId']);
} catch (ObsException $e) {
    printf("PutObjectFailed: Status:%d, Code:%s, Message:%s\n",
        $e->getStatusCode(), $e->getExceptionCode(), $e->getExceptionMessage());
} finally {
    fclose($stream);
    $obsClient->close();
}

上传文件流

// 引入依赖库
require 'vendor/autoload.php';
// 使用源码安装时引入SDK代码库
// require 'obs-autoloader.php';
// 声明命名空间
use Obs\ObsClient;
use Obs\ObsException;
// 创建ObsClient实例
$obsClient = new ObsClient([ 
    //推荐通过环境变量获取访问密钥AK/SK，这里也可以使用其他外部引入方式传入，如果使用硬编码可能会存在泄露风险。
    //您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html
    'key' => getenv('ACCESS_KEY_ID'),
    'secret' => getenv('SECRET_ACCESS_KEY'),
    'endpoint' => 'https://your-endpoint',
]);

try {
     $stream = fopen('localfile', 'r');
     $resp = $obsClient->putObject([
         'Bucket' => 'bucketname',
         'Key' => 'objectname',
         'Body' => $stream
    ]);
    printf("RequestId:%s\n", $resp['RequestId']);
} catch (ObsException $e) {
    printf("PutObjectFailed: Status:%d, Code:%s, Message:%s\n",
        $e->getStatusCode(), $e->getExceptionCode(), $e->getExceptionMessage());
} finally {
    fclose($stream);
    $obsClient->close();
}
  • 使用Body参数指定待上传的流数据时，其值必须是一个resource对象或GuzzleHttp\Psr7\StreamInterface对象。
  • 大文件上传建议使用分段上传。
父主题： 上传对象

相关文档