ソクラテス/ソーダ-PHP

该软件包最新版本(v1.1.0)没有提供许可证信息。

一个简化了从PHP访问SODA服务的库

v1.1.0 2016-09-21 17:30 UTC

This package is not auto-updated.

Last update: 2024-09-14 17:03:50 UTC


README

Build Status

索克拉特斯 - 基础PHP库

此库提供了一个简单的包装器,用于从PHP访问Socrata开放数据API的一些功能。目前它支持HTTP GET、POST和PUT操作。

该库非常简单。要访问Socrata API,首先实例化一个“Socrata”对象,传入您要访问的数据站点的域名。该库还将接受包括协议在内的完整根路径(例如:http://data.medicare.gov)。然后,您可以使用其包含的方法进行简单的API调用

支持的PHP版本

为了通过HTTPS访问SODA API,客户端现在必须支持TLS协议的扩展Server Name Indication (SNI)。这意味着什么?这意味着如果您使用ソーダ-PHP,您必须使用PHP 5.6或更高版本,因为PHP是从那时起开始支持SNI的。

安装

通过composer

composer require socrata/soda-php

使用方法

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

在您的API调用中,指定完整端点相对路径(例如:/resource/abcd-2345.json)或数据集ID(例如:abcd-2345)。

查询

简单过滤器SoQL查询可以作为参数传递给get函数

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

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

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

发布

要使用该库发布数据,您可以使用PUT(替换)或POST(更新)方法

$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);

该库还包括一个简单的示例应用程序,它从数据集中检索行并将其以简单的表格形式输出。

许可证

Apache许可证,版本2.0。更多信息请参阅许可证文件