README

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.

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

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.

Referências
Funcionalidades
Requisitos (recomendados)
Baixando o pacote crphp/webservice para o servidor
Exemplos de uso
Licença (MIT)

1 - Referências

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

2 - Funcionalidades

Consumir webservice
- Realizar requisições (Request)
- Intercepctar respostas (Response)
- Obter lista de serviços listados no WSDL
- 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.

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:

composer require crphp/webservice

Ou se preferir criar um projeto:

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

Caso ainda não tenha o composer instalado, obtenha este em: https://getcomposer.org/download/

5 - Exemplos de uso

Utilizando a classe ClienteGenerico:

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>';
}

Utilizando a classe 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 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.

crphp / webservice

Maintainers

Details