A(nother) PHP Foursquare API client
https://developer.foursquare.com/docs/
Composer is currently the only way to install the foursquare client into your project.
{
"require": {
"thetwelvelabs/foursquare": "dev-master@dev"
}
}
$ curl -s http://getcomposer.org/installer | php
$ php composer.phar install
$client = new \TheTwelve\Foursquare\HttpClient\CurlHttpClient($pathToCertificateFile);
$redirector = new \TheTwelve\Foursquare\Redirector\HeaderRedirector();
Note: The redirector is optional and is only needed if you need Foursquare authentication
$factory = new \TheTwelve\Foursquare\ApiGatewayFactory($client, $redirector);
// Required for most requests
$factory->setClientCredentials('CLIENT_ID', 'CLIENT_SECRET');
// Optional
$factory->setEndpointUri('https://api.foursquare.com');
$factory->useVersion(2);
$auth = $factory->getAuthenticationGateway(
'https://foursquare.com/oauth2/authorize',
'https://foursquare.com/oauth2/access_token',
'YOUR_REDIRECT_URL'
);
$auth->initiateLogin();
$code = $_GET['code'];
// You should do some input sanitization to $code here, just in case
$token = $authGateway->authenticateUser($code);
$factory->setToken($token);
$gateway = $factory->getUsersGateway();
$user = $gateway->getUser();
$gateway = $factory->getVenuesGateway();
$venues = $gateway->search(array(
'll' => '40.727198,-73.992289',
'query' => 'Starbucks',
'radius' => 1000,
'intent' => 'checkin'
));
If you're working with Symfony or Silex, you can use the Symfony HttpClient and Redirector
$client = new \TheTwelve\Foursquare\HttpClient\SymfonyHttpClient();
$redirector = new \TheTwelve\Foursquare\Redirector\SymfonyRedirector();
If you're working with Silex, there is a Service Provider available at https://github.com/chriswoodford/FoursquareServiceProvider
If you're using the CurlHttpClient, you will probably want to include the cacert.pem file that can be found at http://curl.haxx.se/docs/caextract.html
You can add this as a dependency in your composer file. Your composer.json might look something like this:
{
"require": {
"thetwelvelabs/foursquare": "dev-master@dev",
"haxx-se/curl": "1.0.0"
},
"repositories": [
{
"type": "package",
"package": {
"name": "haxx-se/curl",
"version": "1.0.0",
"dist": {
"url": "http://curl.haxx.se/ca/cacert.pem",
"type": "file"
}
}
}
]
}
You will be able to find the cacert.pem file in vendor/haxx-se/curl/cacert.pem
This library is released under the MIT License.