crphp/webservice

Biblioteca genérica para consumir webservice.

crphp/webservice

, _(*1)

Está é uma biblioteca básica para se consumir um webservice. Este pacote permite o consumo via classe SoapClient ou via classe genéria ClienteGenerico construida com CURL., _(*2)

Está biblioteca segue os padrões descritos na PSR-2, logo, isso implica que a mesma está em conformidade com a PSR-1., _(*3)

As palavras-chave "DEVE", "NÃO DEVE", "REQUER", "DEVERIA", "NÃO DEVERIA", "PODERIA", "NÃO PODERIA", "RECOMENDÁVEL", "PODE", e "OPCIONAL" neste documento devem ser interpretadas como descritas no RFC 2119. Tradução livre RFC 2119 pt-br., _(*4)

1. Referências
2. Funcionalidades
3. Requisitos (recomendados)
4. Baixando o pacote crphp/webservice para o servidor
5. Exemplos de uso
6. Licença (MIT)

1 - Referências

• PSR-1
• PSR-2
• RFC 2119 (tradução livre RFC 2119 pt-br)

2 - Funcionalidades

• [x] Consumir webservice
  • [x] Realizar requisições (Request)
  • [x] Intercepctar respostas (Response)
  • [x] Obter lista de serviços listados no WSDL
  • [x] Formatar XML

3 - Requisitos (módulos)

Os módulos abaixos já estão definidos no arquivo composer.json, isso significa que serão validados automaticamente., _(*5)

• REQUER ext-curl
• REQUER ext-soap
• REQUER ext-dom

4 - Baixando o pacote crphp/webservice para o servidor

Para a etapa abaixo estou pressupondo que você tenha o composer instalado e saiba utilizá-lo:, _(*6)

composer require crphp/webservice

Ou se preferir criar um projeto:, _(*7)

composer create-project --prefer-dist crphp/webservice nome_projeto

Caso ainda não tenha o composer instalado, obtenha este em: https://getcomposer.org/download/, _(*8)

5 - Exemplos de uso

Utilizando a classe ClienteGenerico:, _(*9)

use Crphp\Webservice\ClienteGenerico;

// A esquerda do cabeçalho não pode existir espaço em branco
$xml = '
<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 '';
    echo '

' . $obj->formatXML($xml) . '

';
}

Utilizando a classe Soap:, _(*10)

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 '';
    echo "

" . $obj->formatXML($obj->getResponse()) . "

";

    /**
     * Retorna uma string contendo o cabeçalho da resposta http do webservice. Deve vir depois de doRequest()
     *
     * @see http://php.net/manual/pt_BR/function.nl2br.php Documentação para a função nlb2br.
     */
    echo nl2br($obj->getHeader());
} else {
    echo $erro;
}

6 - Licença (MIT)

Todo o conteúdo presente neste diretório segue o que determina a licença MIT., _(*11)