PHPackages                             mustafaculban/commonroom-php-sdk - 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. mustafaculban/commonroom-php-sdk

ActiveLibrary[API Development](/categories/api)

mustafaculban/commonroom-php-sdk
================================

PHP SDK for Common Room API

v1.0.0(1y ago)22MITPHPPHP >=7.4

Since Nov 28Pushed 1y ago1 watchersCompare

[ Source](https://github.com/mustafaculban/commonroom-php-sdk)[ Packagist](https://packagist.org/packages/mustafaculban/commonroom-php-sdk)[ RSS](/packages/mustafaculban-commonroom-php-sdk/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (2)Versions (2)Used By (0)

Common Room PHP SDK
===================

[](#common-room-php-sdk)

Un-Official PHP SDK for Common Room API integration.

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

[](#installation)

You can install the package via composer:

```
composer require mustafaculban/commonroom-php-sdk
```

Usage
-----

[](#usage)

```
use CommonRoom\CommonRoom;
// Initialize the SDK
$commonRoom = new CommonRoom('your-api-key');
// Use services
try {
// Get contacts
$contacts = $commonRoom->contacts()->getContacts();
// Get activity types
$activityTypes = $commonRoom->activities()->getActivityTypes();
// Add a tag
$tag = $commonRoom->tags()->createTag([
'name' => 'My Tag',
'description' => 'Tag description'
]);
} catch (\Exception $e) {
echo "Error: " . $e->getMessage();
}
```

Advanced Configuration
----------------------

[](#advanced-configuration)

You can pass additional configuration options when initializing the SDK:

```
// Initialize with API key and configuration
$commonRoom = new CommonRoom('your-api-key', [
    'timeout' => 45, // Request timeout in seconds
    'connect_timeout' => 15, // Connection timeout in seconds
    'base_url' => 'https://api.commonroom.io/community/v1' // Optional custom base URL
]);
// Make requests through services
$contacts = $commonRoom->contacts()->getContacts();
```

Available Services
------------------

[](#available-services)

- ApiTokenService
- ActivitiesService
- ContactsService
- SegmentsService
- TagsService

Testing
-------

[](#testing)

To run the tests, you'll need to set up your test environment:

1. Copy `.env.testing.example` to `.env.testing`:

```
cp .env.testing.example .env.testing
```

2. Update `.env.testing` with your test API key:

```
COMMONROOM_TEST_API_KEY=your-test-api-key-here
```

3. Run the tests:

```
composer test
```

Note: For CI/CD, make sure to set the `COMMONROOM_TEST_API_KEY` secret in your GitHub repository settings.

Documentation
-------------

[](#documentation)

For detailed API documentation, please visit [Common Room API Documentation](https://api.commonroom.io/docs).

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

###  Health Score

24

—

LowBetter than 31% of packages

Maintenance37

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

 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

Unknown

Total

1

Last Release

582d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/6876690?v=4)[Mustafa Culban](/maintainers/karamusluk)[@karamusluk](https://github.com/karamusluk)

![](https://avatars.githubusercontent.com/u/56627814?v=4)[Mustafa Culban](/maintainers/mustafaculban)[@mustafaculban](https://github.com/mustafaculban)

---

Top Contributors

[![mustafaculban](https://avatars.githubusercontent.com/u/56627814?v=4)](https://github.com/mustafaculban "mustafaculban (2 commits)")

---

Tags

apisdkcommonroom

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/mustafaculban-commonroom-php-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/mustafaculban-commonroom-php-sdk/health.svg)](https://phpackages.com/packages/mustafaculban-commonroom-php-sdk)
```

###  Alternatives

[deepseek-php/deepseek-php-client

deepseek PHP client is a robust and community-driven PHP client library for seamless integration with the Deepseek API, offering efficient access to advanced AI and data processing capabilities.

46688.8k5](/packages/deepseek-php-deepseek-php-client)[jstolpe/instagram-graph-api-php-sdk

Instagram Graph API PHP SDK

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

PHPackages © 2026

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