basecamp.php's Introduction

basecamp.php

Lightweight multi-paradigm PHP (JSON) client for the new Basecamp API.

Many thanks to Sandeep Shetty, whose Shopify client provided the inspiration and much of the code for this project.

Requirements

PHP 5.3 with cURL support.

Getting Started

Download

Download the latest version of basecamp.php:

$ curl -L http://github.com/bdunlap/basecamp.php/tarball/master | tar xvz
$ mv bdunlap-basecamp.php-* basecamp.php

Require

<?php
require 'path/to/basecamp.php/basecamp.php';
?>

Limitations

Currently supports private apps only.
This is quick and dirty and will get you started. It does not do client-side caching, which you must implement per 37signals. Pull requests welcome.

Usage

Making API calls:

<?php
$appName = 'MyApp';
$appContact = '[email protected]';

$basecampAccountId = '999999999';
$basecampUsername = 'yourusername';
$basecampPassword = 'yourpassword';

$basecamp = basecamp_api_client($appName, $appContact,
    $basecampAccountId, $basecampUsername, $basecampPassword);

try {
    /**
     * Get a list of all projects:
     */
    $projects = $basecamp('GET', '/projects.json');
    echo "Current list of projects:\n";
    foreach ($projects as $project) {
        echo "\t".$project->name."\n";
    }

    /**
     * Create a new project:
     */
    $project = array(
        'name' => 'My new project!',
    );

    $newProject = $basecamp('POST', '/projects.json', $project);
    echo "New project ID is {$newProject->id}\n";
} catch (Exception $e) {
    die($e->getMessage());
}
?>