php sdk-凯发k8国际娱乐官网入口
本章节介绍新版php sdk,您可以参考本章节进行快速集成开发。
准备工作
- 注册华为帐号并开通华为云,并完成实名认证,帐号不能处于欠费或冻结状态。
- 已具备开发环境,php 5.6 及以上版本,可执行 php --version 检查当前的版本信息。
- 登录“ > 访问秘钥”页面,依据界面操作指引获取access key(ak)和secret access key(sk)。下载的访问秘钥为credentials.csv文件,包含ak/sk信息。
- 登录“”页面,获取“iam用户名”、“帐号名”以及待使用区域的“项目id”。调用服务时会用到这些信息,请提前保存。
本样例以“华北-北京四”区域为例,获取对应的项目id(project_id)。
图1 我的凭证
安装sdk
推荐使用 安装 sdk 。
composer 是 php 的依赖管理工具,允许您在项目中声明依赖关系并安装这些依赖:
// 安装 composer curl -ss https://getcomposer.org/installer | php // 安装 php sdk composer require huaweicloud/huaweicloud-sdk-php
安装完毕后,你需要引入 composer 的自动加载文件:
require 'path/to/vendor/autoload.php';
开始使用
- 导入依赖模块
- 配置客户端连接参数
- 默认配置
// 使用默认配置 $config = httpconfig::getdefaultconfig();
- 网络代理(可选)
// 使用代理服务器 $config->setproxyprotocol('http'); $config->setproxyhost('proxy.huawei.com'); $config->setproxyport(8080); $config->setproxyuser('username'); $config->setproxypassword('password');
- 超时配置(可选)
// 默认连接超时时间为60秒,读取超时时间为120秒。可根据需要修改默认值。 $config->settimeout(120); $config->setconnectiontimeout(60);
- ssl配置(可选)
// 配置跳过服务端证书验证 $config->setignoresslverification(true); // 配置服务器端ca证书,用于sdk验证服务端证书合法性 $config->setcertfile("{yourcertfile}");
- 默认配置
- 配置认证信息
配置ak、sk、projectid信息。华为云通过ak识别用户的身份,通过sk对请求数据进行签名验证,用于确保请求的机密性、完整性和请求者身份的正确性。
// 终端节点以 ocr 服务北京四的 endpoint 为例 $ak = getenv('huaweicloud_sdk_ak'); $sk = getenv('huaweicloud_sdk_sk'); $endpoint = "https://ocr.cn-north-4.myhuaweicloud.com"; $projectid = getenv('project_id'); $credentials = new basiccredentials($ak,$sk,$projectid);
- 认证用的 ak 和sk 硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全。
- 本示例以 ak 和 sk 保存在环境变量中来实现身份验证为例,运行本示例前请先在本地环境中设置环境变量huaweicloud_sdk_ak和huaweicloud_sdk_sk。
认证参数说明:
- 初始化客户端
指定云服务endpoint方式
$client = ocrclient::newbuilder(new ocrclient) ->withhttpconfig($config) ->withendpoint($endpoint) ->withcredentials($credentials) ->build();
- 发送并查看响应
// 以调用通用表格识别接口 recognizegeneraltable 为例 $request = new recognizegeneraltablerequest(); $body = newgeneraltablerequestbody(); $body->set; $request->setbody($body); try { $response = $client->recognizegeneraltable($request); } catch (connectionexception $e) { $msg = $e->getmessage(); echo "\n". $msg ."\n"; } catch (requesttimeoutexception $e) { $msg = $e->getmessage(); echo "\n". $msg ."\n"; } catch (serviceresponseexception $e) { echo "\n"; echo $e->gethttpstatuscode(). "\n"; echo $e->geterrorcode() . "\n"; echo $e->geterrormsg() . "\n"; } echo "\n"; echo $response;
- 异常处理
表1 异常处理 一级分类
一级分类说明
二级分类
二级分类说明
connectionexception
连接类异常
hostunreachableexception
网络不可达、被拒绝。
sslhandshakeexception
ssl认证异常。
requesttimeoutexception
响应超时异常
calltimeoutexception
单次请求,服务器处理超时未返回。
retryoutageexception
在重试策略消耗完成后,仍无有效的响应。
serviceresponseexception
服务器响应异常
serverresponseexception
服务端内部错误,http响应码:[500,]。
clientrequestexception
请求参数不合法,http响应码:[400, 500)
try { $response = $client->recognizegeneraltable($request); } catch (connectionexception $e) { $msg = $e->getmessage(); echo "\n". $msg ."\n"; } catch (requesttimeoutexception $e) { $msg = $e->getmessage(); echo "\n". $msg ."\n"; } catch (serviceresponseexception $e) { echo "\n"; echo $e->gethttpstatuscode(). "\n"; echo $e->geterrorcode() . "\n"; echo $e->geterrormsg() . "\n"; } echo "\n";
使用异步客户端,配置日志等操作,请参见、,sdk使用方法可参考。
代码示例自动生成
提供api检索及平台调试,支持全量快速检索、可视化调试、帮助文档查看、在线咨询。
您只需要在api explorer中修改接口参数,即可自动生成对应的代码示例。同时,可在集成开发环境cloudide中完成代码的构建、调试、运行等操作。
意见反馈
文档内容是否对您有帮助?
如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨