dcarbone/soap-plus

PHP SoapClient wrapper class

Tuesday, September 13, 2016
by dcarbone
Repository
2 Watchers
23 Stars
2,218 Installations

PHP
0 Dependents
0 Suggesters
5 Forks
3 Open issues
24 Versions
65 % Grown

The README.md

soap-plus

, _(*1)

In a nutshell, this class replaces the internal query mechanism used by PHP's SoapClient class. The main reason for this wrapper is to enable consumption of NTLM-authenticated SharePoint SOAP services in a PHP application. This is not a data-mapper, it simply returns data as the normal SoapClient would, but all of the internal querying is handled by the PHP CURL library., _(*2)

Installation

This lib is designed to be used with Composer, _(*3)

"Require" entry:, _(*4)

{
    "dcarbone/soap-plus": "2.1.*"
}

Constructor

The constructor has been overloaded to allow for a few new nifty features. All of the base construction options are usable. To see a list of built-in available options, see here http://www.php.net/manual/en/soapclient.soapclient.php., _(*5)

Additional Options

auth_type, _(*6)

basic
ntlm
digest
any
anysafe
NULL / undefined

These directly relate to the built-in CURLAUTH_XXX options available (see here, search for "CURLAUTH") It is entirely optional, and should only be set if you also define "login" and "password" options., _(*7)

If you define a remote WSDL, the same parameters will be used for WSDL retrieval as well as querying., _(*8)

user_agent, _(*9)

This property is optional, and allows you to define a custom User Agent header value in requests., _(*10)

debug, _(*11)

By setting "debug" => true in your configuration array, every query and result will be stored in an internally array that can be accessed via the methods getDebugQueries() and getDebugResults(). You may also enable/disable debugging post-construct with enableDebug() and disableDebug()., _(*12)

One word of caution on debugging. SOAP results can often be quite large, meaning you could potentially have lots of memory being sucked up for the strings that are saved in the internal array. I would recommend NOT enabling this feature anywhere outside of a dev / local dev environment. I have also provided a resetDebugValue() method which will empty the arrays., _(*13)

wsdl_cache_path, _(*14)

This option will allow you to specify the directory in which the WSDL cache files will be generated. If no value is passed for this option, sys_get_temp_dir value is used., _(*15)

Querying

The typical mechanism by which PHP's SoapClient expects results is for them to be in an array. Coming from the SharePoint world, where most documentation outlines how to construct queries in XML, this can be a bit tedious. As such, I have provided a simple XML -> array conversion functionality in this library. For example:, _(*16)

SharePoint Lists GetListItems, _(*17)

Below is an example XML SOAP query against SharePoint's GetListItems action on the Lists WSDL., _(*18)

<GetListItems xmlns='http://schemas.microsoft.com/sharepoint/soap/'>
  <listName>My List Name</listName>
  <rowLimit>150</rowLimit>
  <query>
    <any>
      <Query xmlns=''>
        <Where>
          <And>
            <Eq>
              <FieldRef Name='Column1' />
              <Value Type='Integer'>1</Value>
            </Eq>
            <And>
              <Neq>
                <FieldRef Name='Column3' />
                <Value Type='Text'>value i don't want</Value>
              </Neq>
              <IsNotNull>
                <FieldRef Name='Column3' />
              </IsNotNull>
            </And>
          </And>
        </Where>
        <OrderBy>
          <FieldRef Name='Column1' Ascending='True' />
          <FieldRef Name='Column2' Ascending='True' />
          <FieldRef Name='Column3' Ascending='True' />
        </OrderBy>
      </Query>
    </any>
  </query>
  <viewFields>
    <any>
      <ViewFields>
        <FieldRef Name='Column1' />
        <FieldRef Name='Column2' />
        <FieldRef Name='Column3' />
      </ViewFields>
    </any>
  </viewFields>
  <queryOptions>
    <any>
      <QueryOptions xmlns=''>
        <DateInUtc>TRUE</DateInUtc>
        <IncludeMandatoryColumns>FALSE</IncludeMandatoryColumns>
      </QueryOptions>
    </any>
  </queryOptions>
</GetListItems>

Using SoapClientPlus, this is transformed into..., _(*19)

array (
  'GetListItems' =>
  array (
    'listName' => 'My List Name',
    'rowLimit' => '150',
    'query' =>
    array (
      'any' => '<Query xmlns=""><Where><And><Eq><FieldRef Name="Column1"/><Value Type="Integer">1</Value></Eq><And><Neq><FieldRef Name="Column3"/><Value Type="Text">value i don\'t want/Value></Neq><IsNotNull><FieldRef Name="Column3"/></IsNotNull></And></And></Where><OrderBy><FieldRef Name="Column1" Ascending="True"/><FieldRef Name="Column2" Ascending="True"/><FieldRef Name="Column3" Ascending="True"/></OrderBy></Query>',
    ),
    'viewFields' =>
    array (
      'any' => '<ViewFields><FieldRef Name="Column1"/><FieldRef Name="Column2"/><FieldRef Name="Column3"/></ViewFields>',
    ),
    'queryOptions' =>
    array (
      'any' => '<QueryOptions xmlns=""><DateInUtc>TRUE</DateInUtc><IncludeMandatoryColumns>FALSE</IncludeMandatoryColumns></QueryOptions>',
    ),
  ),
)

... which is then passed into the standard SoapClient's own __soapCall method., _(*20)

Note You do not HAVE to use XML, you may pass in an array. It is simply there as some people might find it easier to use. I use PHP's SimpleXMLElement implementation to handle the transformation., _(*21)

Questions / Comments

As I stated in the buff, I created this library to help ease the pain of SharePoint services consumption in PHP wherein I had to use the NTLM auth mechanism. I am always open to new feature ideas from the community, so if you are using this library and have a suggestion, please let me know. I always enjoy a good challenge :), _(*22)

The Versions

13/09 2016

dev-master

9999999-dev https://github.com/dcarbone/soap-plus

PHP SoapClient wrapper class

library soap-plus

PHP SoapClient wrapper class

dcarbone/soap-plus

The README.md

soap-plus

Installation

Constructor

Additional Options

Querying

Questions / Comments

The Versions

dev-master

The Requires

The Development Requires

by Daniel Carbone

1.0.0

The Requires

The Development Requires

by Daniel Carbone

0.8.0

The Requires

The Development Requires

by Daniel Carbone

0.7.3

The Requires

The Development Requires

by Daniel Carbone

0.7.2

The Requires

The Development Requires

by Daniel Carbone

0.7.1

The Requires

The Development Requires

by Daniel Carbone

0.7.0

The Requires

The Development Requires

by Daniel Carbone

0.6.1

The Requires

The Development Requires

by Daniel Carbone

0.6.0

The Requires

The Development Requires

by Daniel Carbone

0.5.2

The Requires

by Daniel Carbone

0.5.1

The Requires

by Daniel Carbone

0.5.0

The Requires

by Daniel Carbone

0.4.3

The Requires

by Daniel Carbone

0.4.2

The Requires

by Daniel Carbone

0.4.1

The Requires

by Daniel Carbone

0.4.0

The Requires

by Daniel Carbone

0.3.3

The Requires

by Daniel Carbone

0.3.2

The Requires

by Daniel Carbone

0.3.1

The Requires

by Daniel Carbone

0.3.0

The Requires

by Daniel Carbone