
# 异步调用
![](https://support.huaweicloud.com/sdk-php-devg-obs/public_sys-resources/notice_3.0-zh-cn.png)
开发过程中，您有任何问题可以在GitHub上[提交issue](https://github.com/huaweicloud/huaweicloud-sdk-php-obs/issues)，或者在[华为云对象存储服务论坛](https://bbs.huaweicloud.com/forum/forum-620-1.html)中发帖求助。[接口参考文档](https://support.huaweicloud.com/api-obs_php_sdk_api_zh/obs_38_0001.html)详细介绍了每个接口的参数和使用方法。
OBS PHP SDK的桶相关接口和对象相关接口均支持以"Async"结尾的方式进行异步调用（例如，同步方法为ObsClient-\>putObject，则异步方法为ObsClient-\>putObjectAsync），并将返回结果输出到回调函数中。回调函数依次包含[SDK自定义异常](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1602.html)和[SDK公共结果对象](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1603.html)两个参数，如果回调函数中SDK自定义异常参数不为空，则表明操作失败；反之，则表明操作成功。
以异步调用方式上传对象的示例代码如下：
```
<?php
// 引入依赖库
require 'vendor/autoload.php';
// 使用源码安装时引入SDK代码库
// require 'obs-autoloader.php';
// 声明命名空间
use Obs\ObsClient;
// 创建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',
]);
// 异步调用方式上传对象
$promise = $obsClient->putObjectAsync([ 
    'Bucket' => 'bucketname',
    'Key' => 'objectname',
    'Body' => 'Hello OBS' 
], function ($obsException, $resp) {
       if ($obsException === null) {
              printf( "RequestId:%s\n", $resp['RequestId']);
       } else {
              printf("putObjectFailed: Status:%d, Code:%s, Message:%s\n", $e->getStatusCode(), $e->getExceptionCode(), $e->getExceptionMessage());
       }
});
$promise->wait ();
```
![](https://support.huaweicloud.com/sdk-php-devg-obs/public_sys-resources/note_3.0-zh-cn.png)
异步调用会立即返回异步调用结果对象（GuzzleHttp\\Promise\\Promise），需要调用该对象的wait方法以等待异步调用完成。
