README

Laravel 的 SoapClient 包装器集成。
简化了在 Laravel 应用中使用 Soap 的过程。

请在此处报告任何错误或功能建议
https://github.com/artisaninweb/laravel-soap/issues/

安装

Laravel

####针对 Laravel 5.2 及以上版本的安装

运行 composer require artisaninweb/laravel-soap

在 app/config/app.php 中添加服务提供者。

Artisaninweb\SoapWrapper\ServiceProvider::class, 

要使用别名，请将以下内容添加到 app/config/app.php 中的别名部分。

'SoapWrapper' => Artisaninweb\SoapWrapper\Facade\SoapWrapper::class,  

####针对 Laravel 5.1 及以下版本的安装

在 composer.json 中添加 artisaninweb/laravel-soap 作为依赖项。

{
    "require": {
        "artisaninweb/laravel-soap": "0.3.*"
    }
}

如果你使用的是 Laravel 5.5 或更高版本，你可以跳过以下两个配置设置。

在 app/config/app.php 中添加服务提供者。

'Artisaninweb\SoapWrapper\ServiceProvider'

要使用外观，请将以下内容添加到 app/config/app.php 中的外观部分。

'SoapWrapper' => 'Artisaninweb\SoapWrapper\Facade'

Lumen

打开 bootstrap/app.php 并注册所需的服务提供者

$app->register(Artisaninweb\SoapWrapper\ServiceProvider::class);

注册类别名

class_alias('Artisaninweb\SoapWrapper\Facade', 'SoapWrapper');

必须启用外观。

用法

如何向包装器添加服务并使用它。

<?php

namespace App\Http\Controllers;

use Artisaninweb\SoapWrapper\SoapWrapper;
use App\Soap\Request\GetConversionAmount;
use App\Soap\Response\GetConversionAmountResponse;

class SoapController
{
  /**
   * @var SoapWrapper
   */
  protected $soapWrapper;

  /**
   * SoapController constructor.
   *
   * @param SoapWrapper $soapWrapper
   */
  public function __construct(SoapWrapper $soapWrapper)
  {
    $this->soapWrapper = $soapWrapper;
  }

  /**
   * Use the SoapWrapper
   */
  public function show() 
  {
    $this->soapWrapper->add('Currency', function ($service) {
      $service
        ->wsdl('http://currencyconverter.kowabunga.net/converter.asmx?WSDL')
        ->trace(true)
        ->classmap([
          GetConversionAmount::class,
          GetConversionAmountResponse::class,
        ]);
    });

    // Without classmap
    $response = $this->soapWrapper->call('Currency.GetConversionAmount', [
      'CurrencyFrom' => 'USD', 
      'CurrencyTo'   => 'EUR', 
      'RateDate'     => '2014-06-05', 
      'Amount'       => '1000',
    ]);

    var_dump($response);

    // With classmap
    $response = $this->soapWrapper->call('Currency.GetConversionAmount', [
      new GetConversionAmount('USD', 'EUR', '2014-06-05', '1000')
    ]);

    var_dump($response);
    exit;
  }
}

服务函数

$this->soapWrapper->add('Currency', function ($service) {
    $service
        ->wsdl()                 // The WSDL url
        ->trace(true)            // Optional: (parameter: true/false)
        ->header()               // Optional: (parameters: $namespace,$name,$data,$mustunderstand,$actor)
        ->customHeader()         // Optional: (parameters: $customerHeader) Use this to add a custom SoapHeader or extended class                
        ->cookie()               // Optional: (parameters: $name,$value)
        ->location()             // Optional: (parameter: $location)
        ->certificate()          // Optional: (parameter: $certLocation)
        ->cache(WSDL_CACHE_NONE) // Optional: Set the WSDL cache
    
        // Optional: Set some extra options
        ->options([
            'login' => 'username',
            'password' => 'password'
        ])

        // Optional: Classmap
        ->classmap([
          GetConversionAmount::class,
          GetConversionAmountResponse::class,
        ]);
});

类映射

如果你使用类映射，你可以添加如下的文件夹，例如：

• App\Soap
• App\Soap\Request
• App\Soap\Response

请求: App\Soap\Request\GetConversionAmount

<?php

namespace App\Soap\Request;

class GetConversionAmount
{
  /**
   * @var string
   */
  protected $CurrencyFrom;

  /**
   * @var string
   */
  protected $CurrencyTo;

  /**
   * @var string
   */
  protected $RateDate;

  /**
   * @var string
   */
  protected $Amount;

  /**
   * GetConversionAmount constructor.
   *
   * @param string $CurrencyFrom
   * @param string $CurrencyTo
   * @param string $RateDate
   * @param string $Amount
   */
  public function __construct($CurrencyFrom, $CurrencyTo, $RateDate, $Amount)
  {
    $this->CurrencyFrom = $CurrencyFrom;
    $this->CurrencyTo   = $CurrencyTo;
    $this->RateDate     = $RateDate;
    $this->Amount       = $Amount;
  }

  /**
   * @return string
   */
  public function getCurrencyFrom()
  {
    return $this->CurrencyFrom;
  }

  /**
   * @return string
   */
  public function getCurrencyTo()
  {
    return $this->CurrencyTo;
  }

  /**
   * @return string
   */
  public function getRateDate()
  {
    return $this->RateDate;
  }

  /**
   * @return string
   */
  public function getAmount()
  {
    return $this->Amount;
  }
}

响应: App\Soap\Response\GetConversionAmountResponse

<?php

namespace App\Soap\Response;

class GetConversionAmountResponse
{
  /**
   * @var string
   */
  protected $GetConversionAmountResult;

  /**
   * GetConversionAmountResponse constructor.
   *
   * @param string
   */
  public function __construct($GetConversionAmountResult)
  {
    $this->GetConversionAmountResult = $GetConversionAmountResult;
  }

  /**
   * @return string
   */
  public function getGetConversionAmountResult()
  {
    return $this->GetConversionAmountResult;
  }
}