PHPackages                             comsave/soap-client - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. comsave/soap-client

ActiveLibrary[API Development](/categories/api)

comsave/soap-client
===================

A PHP client for the Salesforce SOAP API

0.2.2(5y ago)354.9k↓15.2%31MITPHPPHP >=7.2

Since Apr 5Pushed 5y agoCompare

[ Source](https://github.com/comsave/soap-client)[ Packagist](https://packagist.org/packages/comsave/soap-client)[ RSS](/packages/comsave-soap-client/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (4)Versions (19)Used By (1)

A PHP client for the Salesforce SOAP API
========================================

[](#a-php-client-for-the-salesforce-soap-api)

[![Release](https://camo.githubusercontent.com/c2b2c81ecf472d8e778ae449dbe66c3c830bb790f6b7a8a0ff95313e545d313c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f636f6d736176652f736f61702d636c69656e74)](https://github.com/comsave/soap-client/releases)[![Travis](https://camo.githubusercontent.com/88e964ae47e64d25251bc528d97fd066d09aab289db9575895fba6d16afbcb3c/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f636f6d736176652f736f61702d636c69656e74)](https://travis-ci.org/comsave/soap-client)[![Test Coverage](https://camo.githubusercontent.com/5ff3c8d9977d689adafc899cf9ff91036850bc7f5a3c89a5556ee31d4a13b7e7/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636c696d6174652f636f7665726167652f636f6d736176652f736f61702d636c69656e74)](https://codeclimate.com/github/comsave/soap-client)

Introduction
------------

[](#introduction)

This library is a client for the [Salesforce SOAP API](http://www.salesforce.com/us/developer/docs/api/index.htm), and intended as a replacement for the [Force.com Tookit for PHP](http://wiki.developerforce.com/page/Force.com_Toolkit_for_PHP).

### Features

[](#features)

This library’s features include the following.

- Automatic conversion between PHP and SOAP date and datetime objects.
- Automatic conversion of Salesforce (UTC) times to your local timezone.
- Easily extensible through events: add custom logging, caching, error handling etc.
- Iterating over large results sets that require multiple calls to the API is easy through the record iterator.
- The BulkSaver helps you stay within your Salesforce API limits by using bulk creates, deletes, updates and upserts.
- Completely unit tested (still working on that one).
- Use the client in conjunction with the Symfony2 [Mapper Bundle](https://github.com/comsave/salesforce-mapper-bundle)to get even easier access to your Salesforce data.

Installation
------------

[](#installation)

This library is available on [Packagist](http://packagist.org/packages/phpforce/soap-client). The recommended way to install this library is through [Composer](http://getcomposer.org):

```
$ composer require comsave/soap-client
```

Usage
-----

[](#usage)

### The client

[](#the-client)

Use the client to query and manipulate your organisation’s Salesforce data. First construct a client using the builder:

```
$builder = new \Phpforce\SoapClient\ClientBuilder(
  '/path/to/your/salesforce/wsdl/sandbox.enterprise.wsdl.xml',
  'username',
  'password',
  'security_token'
);

$client = $builder->build();
```

### SOQL queries

[](#soql-queries)

```
$results = $client->query('select Name, SystemModstamp from Account limit 5');
```

This will fetch five accounts from Salesforce and return them as a `RecordIterator`. You can now iterate over the results. The account’s `SystemModstamp` is returned as a `\DateTime` object:

```
foreach ($results as $account) {
    echo 'Last modified: ' . $account->SystemModstamp->format('Y-m-d H:i:') . "\n";
}
```

### One-to-many relations (subqueries)

[](#one-to-many-relations-subqueries)

Results from [subqueries](http://www.salesforce.com/us/developer/docs/api/Content/sforce_api_calls_soql_select.htm)are themselves returned as record iterators. So:

```
$accounts = $client->query(
    'select Id, (select Id, Name from Contacts) from Account limit 10'
);

foreach ($accounts as $account) {
    if (isset($account->Contacts)) {
        foreach ($account->Contacts as $contact) {
            echo sprintf("Contact %s has name %s\n", $contact->Id, $contact->Name);
        }
    }
}
```

### Fetching large numbers of records

[](#fetching-large-numbers-of-records)

If you issue a query that returns over 2000 records, only the first 2000 records will be returned by the Salesforce API. Using the `queryLocator`, you can then fetch the following results in batches of 2000. The record iterator does this automatically for you:

```
$accounts = $client->query('Select Name from Account');
echo $accounts->count() . ' accounts returned';
foreach ($accounts as $account) {
    // This will iterate over the 2000 first accounts, then fetch the next 2000
    // and iterate over these, etc. In the end, all your organisations’s accounts
    // will be iterated over.
}
```

### Logging

[](#logging)

To enable logging for the client, call `withLog()` on the builder. For instance when using [Monolog](https://github.com/Seldaek/monolog):

```
$log = new \Monolog\Logger('name');
$log->pushHandler(new \Monolog\Handler\StreamHandler('path/to/your.log'));

$builder = new \Phpforce\SoapClient\ClientBuilder(
  '/path/to/your/salesforce/wsdl/sandbox.enterprise.wsdl.xml',
  'username',
  'password',
  'security_token'
);
$client = $builder->withLog($log)
  ->build();
```

All requests to the Salesforce API, as well as the responses and any errors that it returns, will now be logged.

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity34

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 88.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~121 days

Recently: every ~41 days

Total

17

Last Release

2121d ago

PHP version history (2 changes)0.1.0PHP >=5.3.0

0.1.8PHP >=7.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/ef6e3fb96c5b1241cef409b14786bc41f89b8f111bf05449d7575423d3533f3f?d=identicon)[Dirk-Scholten](/maintainers/Dirk-Scholten)

![](https://www.gravatar.com/avatar/f55e8f65486cf3c22752db9708f78153c0b1b0d5c01632e02d863bf43328868e?d=identicon)[JoeriVeder](/maintainers/JoeriVeder)

---

Top Contributors

[![ddeboer](https://avatars.githubusercontent.com/u/89267?v=4)](https://github.com/ddeboer "ddeboer (99 commits)")[![Dirk-Scholten](https://avatars.githubusercontent.com/u/36883969?v=4)](https://github.com/Dirk-Scholten "Dirk-Scholten (3 commits)")[![christiaan](https://avatars.githubusercontent.com/u/118490?v=4)](https://github.com/christiaan "christiaan (3 commits)")[![simonharris](https://avatars.githubusercontent.com/u/385725?v=4)](https://github.com/simonharris "simonharris (3 commits)")[![j-d](https://avatars.githubusercontent.com/u/1140726?v=4)](https://github.com/j-d "j-d (1 commits)")[![Nyholm](https://avatars.githubusercontent.com/u/1275206?v=4)](https://github.com/Nyholm "Nyholm (1 commits)")[![shaunhardy](https://avatars.githubusercontent.com/u/993596?v=4)](https://github.com/shaunhardy "shaunhardy (1 commits)")[![ikrasnykh](https://avatars.githubusercontent.com/u/532166?v=4)](https://github.com/ikrasnykh "ikrasnykh (1 commits)")

---

Tags

soapcrmsalesforceforce.comweb services

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/comsave-soap-client/health.svg)

```
[![Health](https://phpackages.com/badges/comsave-soap-client/health.svg)](https://phpackages.com/packages/comsave-soap-client)
```

###  Alternatives

[phpforce/soap-client

A PHP client for the Salesforce SOAP API

831.9M1](/packages/phpforce-soap-client)[davispeixoto/laravel5-salesforce

Laravel 5 Salesforce Force.com PHP Toolkit port

47142.8k1](/packages/davispeixoto-laravel5-salesforce)[freshcells/soap-client-bundle

SoapClientBundle for symfony

35151.0k](/packages/freshcells-soap-client-bundle)[ddeboer/salesforce-mapper-bundle

A Salesforce API mapper

2835.2k](/packages/ddeboer-salesforce-mapper-bundle)[davispeixoto/laravel-salesforce

Laravel 4 Salesforce Force.com PHP Toolkit port

1433.1k](/packages/davispeixoto-laravel-salesforce)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)