crphp/webservice

用于消费webservice的库。

v3.0.0 2018-08-21 23:17 UTC

This package is auto-updated.

Last update: 2024-09-09 18:07:22 UTC


README

Total Downloads Latest Stable Version License

这是一个用于消费webservice的基本库。此包允许通过类SoapClient或通过由CURL构建的通用类ClienteGenerico进行消费。

此库遵循PSR-2标准,因此这意味着它与PSR-1标准兼容。

在此文档中的“必须”,“不应”,“需要”,“应该”,“不应”,“可能”,“不可能”,“推荐”,“可以”和“可选”等关键词应按RFC 2119中的描述进行解释。自由翻译RFC 2119 pt-br

  1. 参考文献
  2. 功能
  3. 要求(推荐)
  4. 将crphp/webservice包下载到服务器
  5. 使用示例
  6. 许可证(MIT)

1 - 参考文献

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许可证的规定。