PHPackages                             director-moav/the-kof-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. director-moav/the-kof-client

ActiveGit[API Development](/categories/api)

director-moav/the-kof-client
============================

TheKofClient is a PHP client for SurveyMonkey API. Written to be intuitvly used.

v1.0.5(2y ago)015.8k↓50%1PHPPHP &gt;=7.2.0

Since Feb 5Pushed 2y ago1 watchersCompare

[ Source](https://github.com/itay-moav/TheKofClient)[ Packagist](https://packagist.org/packages/director-moav/the-kof-client)[ RSS](/packages/director-moav-the-kof-client/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)DependenciesVersions (15)Used By (0)

Stable release v1.0.1 is out
============================

[](#stable-release-v101-is-out)

TheKofClient
============

[](#thekofclient)

A PHP client for [Survey Monkey API V3 https://developer.surveymonkey.com/api/v3/](https://developer.surveymonkey.com/api/v3/)Project started 7/11/2017
Comments, Patches and Support requests can be sent here, at github.
Current Version: 0.01

Table of Contents
-----------------

[](#table-of-contents)

1. Installing and Configuring

    - Dependencies
    - Installation
2. Quick introduction to the API

    - Intro
    - Survey
    - Collectors
    - Responses
3. Classes and Methods
4. Examples

Installing and Configuring
--------------------------

[](#installing-and-configuring)

### Dependencies

[](#dependencies)

1. **TheKofClient** uses Zend Framework &gt; 2.x HTTP client to communicate with SurveyMonkey servers.
    Later versions of this client might support a more generic way to communicate.
2. While **TheKofClient** is part of the TalisMS library, It is so in name only. It follows the same naming convetions. But, it is a stand alone project.
3. An account at SurveyMonkey with permissions to build apps.
4. An app defined on SurveyMonkey with the permissions you need it to have (I suggest familiarizing yourself with SurveyMonkey APP and API usage before using this client).
5. **Access Token**, which is copied from your app setting screen, and looks something like this `P4BCgR2bIBdtj10AKrCX9sVRx.DHaoYcMgKFMAROePyn.IxS5H8Bovv4pj98M3N0xvIKVxW00o12at-mSgIzGiRR3TSPcVks4TBHp3nCxyd9Kv6Z9OFlrKD1O8UXFsXb`

### Installation

[](#installation)

**Using TalisMS**
copy `TheKof/src` folder of this project, and put it under

**Use as standalone lib with autoloader**
Put `source/Talis` in your include path for PHP.
If you use autoloader, it should translate namespace separators \\ and underscores \_ to url path separators /
and add .php at the end.
Example: The class `\TheKof\SurveyMonkeyClient` will be included like that:

```
require_once('Talis/Extensions/TheKof/SurveyMonkeyClient.php');

```

**Use as standalone lib with simple includes**
For this, copy the file `boundle/thekofclient.php` into your project and `require_once(path/to/thekofclient.php)`.

Quick introduction to the API
-----------------------------

[](#quick-introduction-to-the-api)

### Intro

[](#intro)

**TheKofClient** aims at emulating the API itself as closely as possible, be self documenting as much as possible, and have a simple one point of entry. The examples following this are quick examples of the Client usage and a (very) short explanation of what they do and return. **Those are not working examples, Intention is to show API only.** For working examples check the `examples` folder. `...` Means various parameters.

### Survey

[](#survey)

**fetch** All your surveys. Make sure you have setup the right permission in the APP dashboard on Surveymonkey (Scope: View Surveys)

```
use \TheKof;
$Client = new SurveyMonkeyClient(...);
$surveys_list = $Client->surveys()->get(); //returns a collection (iterable) of your surveys. Defaults to page size of 100 (i.e. the first 100 surveys you own).
$surveys_list = $Client->surveys()->get(2,10); //returns a collection (iterable) of your surveys. Page 2 where page size is 10 surveys
$one_survey   = $Client->surveys(survey_id)->get();//return survey object for survey id=survey_id

$collectors_list = $Client->surveys(survey_id)->collectors()->get();//return collection of Survey Collectors for survey id=survey_id, again, same paging rules as above apply
$one_collector   = $Client->surveys(survey_id)->collectors(collector_id)->get(); //return a collector object for collector id = collector_id

```

**dry** Each method has a `*_dry()` version which can be used without an HTTP client, and will return a data structure represnting the request (url/headers/body)

```
$Client = new SurveyMonkeyClient(...);
$surveys_list_request_data = $Client->surveys()->get_dry();
$surveys_list_request_data = $Client->surveys()->get_dry(2,10);
$one_survey_request_data   = $Client->surveys(survey_id)->get_dry();

$collectors_list_request_data = $Client->surveys(survey_id)->collectors()->get_dry();
$one_collector_request_data   = $Client->surveys(survey_id)->collectors(collector_id)->get_dry();

```

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity26

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~167 days

Recently: every ~466 days

Total

14

Last Release

843d ago

Major Versions

0.8.1 → v1.0.02018-11-20

PHP version history (2 changes)v1.0.0PHP &gt;=7.1.0

v1.0.1PHP &gt;=7.2.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/03f3c97f7282ceff3209b5de959a42c0858a30842bb5149f9e8b2ba61a35d997?d=identicon)[itay-moav](/maintainers/itay-moav)

---

Top Contributors

[![itay-moav](https://avatars.githubusercontent.com/u/852432?v=4)](https://github.com/itay-moav "itay-moav (70 commits)")

---

Tags

phpapisurveymonkeyTheKofClient

### Embed Badge

![Health badge](/badges/director-moav-the-kof-client/health.svg)

```
[![Health](https://phpackages.com/badges/director-moav-the-kof-client/health.svg)](https://phpackages.com/packages/director-moav-the-kof-client)
```

###  Alternatives

[jstolpe/instagram-graph-api-php-sdk

Instagram Graph API PHP SDK

13998.4k2](/packages/jstolpe-instagram-graph-api-php-sdk)

PHPackages © 2026

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