PHPackages                             socrata/soda-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. socrata/soda-php

ActiveLibrary[API Development](/categories/api)

socrata/soda-php
================

A simple library to make it easier to access SODA services from PHP

v1.1.0(9y ago)6332.5k↓31.7%27[4 issues](https://github.com/socrata/soda-php/issues)PHPPHP ~5.3

Since Oct 21Pushed 4y ago61 watchersCompare

[ Source](https://github.com/socrata/soda-php)[ Packagist](https://packagist.org/packages/socrata/soda-php)[ Docs](http://dev.socrata.com)[ RSS](/packages/socrata-soda-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)DependenciesVersions (5)Used By (0)

[![Build Status](https://camo.githubusercontent.com/d7dcae385625edd244b6655ba7934da058f7f1c568af976af20644bd86378161/68747470733a2f2f7472617669732d63692e6f72672f736f63726174612f736f64612d7068702e7376673f6272616e63683d63687269736d657463616c66253246747261766973)](https://travis-ci.org/socrata/soda-php)

Socrata - Basic PHP Library
===========================

[](#socrata---basic-php-library)

This library provides a simple wrapper for accessing some of the features of the Socrata Open Data API from PHP. Currently it supports HTTP GET, POST, and PUT operations.

The library is very simple. To access the Socrata API, you first instantiate a "Socrata" object, passing in the domain of the data site you wish to access. The library will also accept the full root path including the protocol (ex: `http://data.medicare.gov`). Then you can use its included methods to make simple API calls:

Supported PHP versions
----------------------

[](#supported-php-versions)

In order to access the SODA API via HTTPS, clients must now [support the Server Name Indication (SNI)](https://dev.socrata.com/changelog/2016/08/24/sni-now-required-for-https-connections.html) extension to the TLS protocol. What does this mean? It means that if you're using `soda-php`, you must [use PHP 5.6 or above](https://en.wikipedia.org/wiki/Server_Name_Indication), as that is when PHP introduced support for SNI.

Install
-------

[](#install)

Via composer

```
composer require socrata/soda-php
```

Usage
-----

[](#usage)

```
$socrata = new Socrata("data.medicare.gov");
$response = $socrata->get("abcd-2345");
```

In your API calls, specify ether the full endpoint relative path (eg: `/resource/abcd-2345.json`), or the dataset ID (eg: `abcd-2345`).

Querying
--------

[](#querying)

[Simple filters](http://dev.socrata.com/docs/filtering.html) and [SoQL Queries](http://dev.socrata.com/docs/queries.html) can be passed as a parameter to the `get` function:

```
$socrata = new Socrata("data.austintexas.gov", $app_token);

$params = array("\$where" => "within_circle(location, $latitude, $longitude, $range)");

$response = $socrata->get($view_uid, $params);
```

Publishing
----------

[](#publishing)

To use the library to publish data you can use the PUT (replace) or POST (upsert) methods:

```
$socrata = new Socrata("data.medicare.gov", $app_token, $user_name, $password);

// Publish data via 'upsert'
$response = $socrata->post("abcd-2345", $data_as_json);

// Publish data via 'replace'
$response = $socrata->put("abcd-2345", $data_as_json);
```

The library also includes a simple example application, which retrieves rows from a dataset and dumps them in a simple table.

License
-------

[](#license)

Apache License, Version 2.0. Please see [License File](LICENSE) for more information.

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity42

Moderate usage in the ecosystem

Community25

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 67.5% 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 ~700 days

Total

2

Last Release

3526d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/19971?v=4)[Chris Metcalf](/maintainers/chrismetcalf)[@chrismetcalf](https://github.com/chrismetcalf)

---

Top Contributors

[![chrismetcalf](https://avatars.githubusercontent.com/u/19971?v=4)](https://github.com/chrismetcalf "chrismetcalf (27 commits)")[![nickescobedo](https://avatars.githubusercontent.com/u/2837169?v=4)](https://github.com/nickescobedo "nickescobedo (3 commits)")[![alaurenz](https://avatars.githubusercontent.com/u/303765?v=4)](https://github.com/alaurenz "alaurenz (3 commits)")[![issa-tseng](https://avatars.githubusercontent.com/u/117762?v=4)](https://github.com/issa-tseng "issa-tseng (2 commits)")[![texdc](https://avatars.githubusercontent.com/u/1590605?v=4)](https://github.com/texdc "texdc (2 commits)")[![ebollens](https://avatars.githubusercontent.com/u/761092?v=4)](https://github.com/ebollens "ebollens (1 commits)")[![charlieman](https://avatars.githubusercontent.com/u/104643?v=4)](https://github.com/charlieman "charlieman (1 commits)")[![aepton](https://avatars.githubusercontent.com/u/470427?v=4)](https://github.com/aepton "aepton (1 commits)")

---

Tags

engineeringSODAsocrata

### Embed Badge

![Health badge](/badges/socrata-soda-php/health.svg)

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

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

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

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[facebook/php-business-sdk

PHP SDK for Facebook Business

90821.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

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

Google API Core for PHP

265103.1M454](/packages/google-gax)[google/common-protos

Google API Common Protos for PHP

173103.7M50](/packages/google-common-protos)

PHPackages © 2026

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