crphp / webservice
用于消费webservice的库。
v3.0.0
2018-08-21 23:17 UTC
Requires
- php: >=5.5.12
- ext-curl: *
- ext-dom: *
- ext-soap: *
README
这是一个用于消费webservice的基本库。此包允许通过类SoapClient或通过由CURL构建的通用类ClienteGenerico进行消费。
此库遵循PSR-2标准,因此这意味着它与PSR-1标准兼容。
在此文档中的“必须”,“不应”,“需要”,“应该”,“不应”,“可能”,“不可能”,“推荐”,“可以”和“可选”等关键词应按RFC 2119中的描述进行解释。自由翻译RFC 2119 pt-br。
1 - 参考文献
- PSR-1
- PSR-2
- RFC 2119(自由翻译 RFC 2119 pt-br)
2 - 功能
- 消费webservice
- 执行请求(Request)
- 拦截响应(Response)
- 获取WSDL中列出的服务列表
- 格式化XML
3 - 要求(模块)
以下模块已在composer.json文件中定义,这意味着它们将自动验证。
- 需要ext-curl
- 需要ext-soap
- 需要ext-dom
4 - 将crphp/webservice包下载到服务器
对于以下步骤,我假设您已安装composer并知道如何使用它
composer require crphp/webservice
或者,如果您想创建一个项目
composer create-project --prefer-dist crphp/webservice nome_projeto
如果您尚未安装composer,可以从以下地址获取: https://getcomposer.org.cn/download/
5 - 使用示例
使用ClientGenerico类:
use Crphp\Webservice\ClienteGenerico;
// A esquerda do cabeçalho não pode existir espaço em branco
$xml = '<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://smartbear.com">
<SOAP-ENV:Body>
<ns1:GetCurrentTime/>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>';
$obj = new ClienteGenerico;
$obj->setRequest('http://endereco_do_webservice')
->doRequest('nome_servico', $xml);
//Retorna um array contendo o cabeçalho da resposta
//$obj->getHeader();
if($xml = $obj->getResponse()) {
// Perfumaria
echo '<script src="https://cdn.rawgit.com/google/code-prettify/master/loader/run_prettify.js"></script>';
echo '<pre class="prettyprint">' . $obj->formatXML($xml) . '</pre>';
}
使用Soap类:
use Crphp\Webservice\Soap;
//No lugar deste array pode ser passada uma string contendo o xml
$args = [
'tag1_exemplo' => 'valor1',
'tag2_exemplo' => 'valor2',
'no_pai' => [
'no_filho' => 'valor1',
]
];
$obj = new Soap;
if($erro = $obj->setRequest('endereco_do_wsdl')) {
exit($erro);
}
// Retorna um array com a lista de serviços contida no WSDL
// $obj->getMethods();
// Se o retorno for null então significa que a consulta não foi realizada
if(!$erro = $obj->doRequest('nomeServico', $args)) {
// Perfumaria
echo '<script src="https://cdn.rawgit.com/google/code-prettify/master/loader/run_prettify.js"></script>';
echo "<pre class='prettyprint' >" . $obj->formatXML($obj->getResponse()) . "</pre>";
/**
* Retorna uma string contendo o cabeçalho da resposta http do webservice. Deve vir depois de doRequest()
*
* @see https://php.ac.cn/manual/pt_BR/function.nl2br.php Documentação para a função nlb2br.
*/
echo nl2br($obj->getHeader());
} else {
echo $erro;
}
6 - 许可证(MIT)
本目录中所有内容均遵循MIT许可证的规定。