PHPackages                             simbiotica/cartodbclient-php - 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. simbiotica/cartodbclient-php

ActiveLibrary[API Development](/categories/api)

simbiotica/cartodbclient-php
============================

CartoDB SQL API v2 client for PHP

1.0.0-beta(13y ago)64.3k4[1 PRs](https://github.com/simbiotica/cartoDBclient-PHP/pulls)MITPHPPHP >=5.3.3

Since Apr 4Pushed 10y ago8 watchersCompare

[ Source](https://github.com/simbiotica/cartoDBclient-PHP)[ Packagist](https://packagist.org/packages/simbiotica/cartodbclient-php)[ Docs](https://github.com/simbiotica/cartoDBclient-PHP)[ RSS](/packages/simbiotica-cartodbclient-php/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (1)Versions (3)Used By (0)

CartoDB SQL API v2 Client for PHP by Simbiotica
===============================================

[](#cartodb-sql-api-v2-client-for-php-by-simbiotica)

About
-----

[](#about)

A easy to use PHP client for CartoDB's SQL API v2, using OAuth or API key authentication.

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

[](#installation)

There are two versions of the library: OAuth or API Key. When installing, you have to choose which to use.

This library requires composer, a package manager for PHP. To use the OAuth version, add the following to your composer.json:

```
{
    "require": {
        "simbiotica/cartodbclient-php": "dev-master"
    }
}
```

Or, if you prefer the API key version, use the following:

```
{
    "require": {
        "simbiotica/cartodbclient-php": "dev-api-key"
    }
}
```

After, install it using the command:

```
$ php composer.phar update simbiotica/cartodbclient-php
```

This will install not only this library, but the required dependencies.

Usage - OAuth
-------------

[](#usage---oauth)

Currently two types of connections are supported: PrivateConnection and PublicConnection. Public connections are a subset of Private ones, as they can be established to any public table, with reduced privileges and configuration requirements

Additionally, TokenStorageInterface implementation is required to presist the OAuth Token across requests. We provide SessionStorage and FileStorage, but feel free to implement your own.

For reference, check the Connection class, where you'll find all the handy functions you'll need. There's also a runSql() function for everything that's not covered by existing functions.

All reponses are wrapped as a Payload object, which holds the formated answer, request metadata and a couple of utilities to handle the result.

No actual demo is provided, but you can view a sort-of-example inside the /tests folder. Remember to fill in your data before trying it.

Usage - API Key
---------------

[](#usage---api-key)

Usage with just API key is less secure, but equaly functional and easier to setup.

All connections are supported by the Connection class, which accepts your domain and, optionally, you API key. If you don't provide it, you will have limited access to the tables.

For reference, check the Connection class, where you'll find all the handy functions you'll need. There's also a runSql() function for everything that's not covered by existing functions.

All reponses are wrapped as a Payload object, which holds the formated answer, request metadata and a couple of utilities to handle the result.

No actual demo is provided, but you can view a sort-of-example inside the /tests folder. Remember to fill in your data before trying it.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 84.6% 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

4782d ago

### Community

Maintainers

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

---

Top Contributors

[![tiagojsag](https://avatars.githubusercontent.com/u/973964?v=4)](https://github.com/tiagojsag "tiagojsag (22 commits)")[![d4weed](https://avatars.githubusercontent.com/u/1506306?v=4)](https://github.com/d4weed "d4weed (3 commits)")[![lonamiaec](https://avatars.githubusercontent.com/u/1011930?v=4)](https://github.com/lonamiaec "lonamiaec (1 commits)")

---

Tags

cartodb

### Embed Badge

![Health badge](/badges/simbiotica-cartodbclient-php/health.svg)

```
[![Health](https://phpackages.com/badges/simbiotica-cartodbclient-php/health.svg)](https://phpackages.com/packages/simbiotica-cartodbclient-php)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M475](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M270](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M186](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M33](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M452](/packages/google-gax)

PHPackages © 2026

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