Connecting to the API using PHP

Required PHP Extensions

• SOAP
• mcrypt
• openssl

Required PHP version

• 5.2.3 and above

Required PHP Includes

• PHP Starter Kit, including:
  • soap-wsse.php
  • exacttarget_soap_client.php
  • exact_soap_client_creator.php
  • xmlseclibs.php
• nusoap.php
• parsecsv.lib.php

Creating a New exact_target_client.php File

Once you have the required PHP includes installed, enter the following commands in your command line:

(DriveLetter):\Apps\ php5> php.exe exact_soap_client_creator.php https://webservice.exacttarget.com/etframework.wsdl > exacttarget_soap_client.php

Authenticating with xmlseclibs

The xmlseclibs project provides a lightweight PHP library for XML security.

Prerequesite:

• xmlseclibs (available at http://code.google.com/p/xmlseclibs/)
• The generated exacttarget_soap_client.php file (available on the developer community or by downloading from this page)

/* Set include directory for exacttarget PHP SOAP library files.
   The path to these files may already be set for the include_path 
   setting within the php.ini file */
$includeDir = realpath(dirname(__FILE__).'/../includes/');
$path = ini_get('include_path');
$path = $includeDir . PATH_SEPARATOR . $path;
ini_set('include_path', $path);

require('exacttarget_soap_client.php');

/* Set location of WSDL */
$wsdl = 'https://webservice.exacttarget.com/etframework.wsdl';

try	{
	/* Create the Soap Client */
	@$client = new ExactTargetSoapClient($wsdl, array('trace'=>1));
	
	/* Set username and password here */
	$client->username = 'username';
	$client->password = 'password';
      
      /* Other Code Here */

}

The attached file contains all of the object classes contained in the ExactTarget WSDL. Use the objects to review and prepare your API calls.

While the PHP SoapClient class allows for referencing a live version of the WSDL (which it uses when it builds the requests),  you may experience better performance and reliability by saving a local copy of the WSDL at the time you develop your integration. That copy of the WSDL will be included in your project. For example, reference etframework.wsdl instead of the full address.

You can use the following code sample to verify your connection to the ExactTarget API:

$param = new ExactTarget_VersionInfoRequestMsg();
$param->IncludeVersionHistory = True;
$results = $client->VersionInfo($param);
var_dump($results);