# 生成带授权信息的表单上传参数
#### 功能说明
生成用于鉴权的请求参数，以进行基于浏览器的POST表单上传。
![](https://support.huaweicloud.com/api-obs_php_sdk_api_zh/public_sys-resources/note_3.0-zh-cn.png)
使用SDK生成用于鉴权的请求参数包括两个：
- Policy，对应表单中policy字段。
- Signature，对应表单中的signature字段。
 
#### 方法定义
```
ObsClient->createPostSignature(array $parameter)
```
#### 请求参数
| **字段名**    | **类型**            | **约束** | **说明**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| Bucket     | string            | 可选     | 桶名。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Key        | string            | 可选     | 对象名，对应表单中的key字段。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Expires    | integer           | 可选     | 表单上传鉴权参数的过期时间（单位：秒），默认值300。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| FormParams | associative array | 可选     | 除key、policy、signature外，表单上传时的其他参数，支持的值： - acl  - cache-control  - content-type  - content-disposition  - content-encoding  - expires   |
   
#### 返回结果
| **字段名**      | **类型** | **说明**                     |
|:---|:---|:---|
| OriginPolicy | String | Policy未经过base64之前的值，仅用于校验。 |
| Policy       | String | 表单中的policy。                |
| Signature    | String | 表单中的signature。             |
   
#### 代码样例
```
try {
       $resp = $obsClient->createPostSignature( [ 
              'Bucket' => 'bucketname',
              'Key' => 'objectkey',
              'Expires' => 3600,
              'FormParams' => [
                     'acl' => 'public-read',
                     'content-type' => 'text/plain',
              ]
       ] );
       printf ( "Policy:%s\n", $resp ['Policy'] );
       printf ( "Signature:%s\n", $resp ['Signature'] );
} catch ( Obs\Common\ObsException $obsException ) {
       printf ( "ExceptionCode:%s\n", $obsException->getExceptionCode () );
       printf ( "ExceptionMessage:%s\n", $obsException->getExceptionMessage () );
}
```