它对豆瓣 API 进行重新封包。它使用起来非常方便，可以快速开发一个 web 应用。

为什么要另外封包？
对，豆瓣官方提供了一种 PHP 的解决方案，可是需要庞大的支持库：GData（20M左右）以及可能无法修改的环境配置（租用的空间主机会遇到这样的问题）。虽说 Douban API Package 也是基于框架开发，不过 Kohana 是一个纯 PHP5 模式且体积小巧（仅有 478KB），优秀迅捷的框架。最重要的是，Douban API Package 提供了目前官方所有功能的支持。并有线上网站：魔豆 和豆瓣 API 控制台长期运营。

虽然它是基于 Kohana 框架开发，但是并没有使用太多的依赖，稍微熟悉可以轻松分离出来！

安装需求

• PHP 5.2+ with curl module
• Kohana v3 – 一款纯 PHP 5 框架，它的特点就是高安全性，轻量级代码，容易使用。

安装步骤
步骤 0: 部署 Kohana v3

下载并安装 Kohana v3 的过程，请大家参考此教程：使用 Git 部署 Kohana 系统

步骤 1: 下载本扩展!

你可以在部署完毕的 Kohana 系统的根目录执行下面操作：

$ git submodule add git://github.com/icyleaf/douban.git modules/douban

完成！

或者你也可以从本github 项目 下载压缩包放置在 modules 文件夹下面。

步骤 2: 在 bootstrap.php 文件中启用该模块(默认情况下，存储在 `application’ 文件夹)

/**
 * Enable modules. Modules are referenced by a relative or absolute path.
 */
Kohana::modules(array(
     'douban'        => MODPATH.'douban',     // Douban API Module
    // 'database'   => MODPATH.'database',   // Database access
    // 'image'      => MODPATH.'image',      // Image manipulation
    // 'orm'        => MODPATH.'orm',        // Object Relationship Mapping (not complete)
    // 'pagination' => MODPATH.'pagination', // Paging of results
    // 'paypal'     => MODPATH.'paypal',     // PayPal integration (not complete)
    // 'todoist'    => MODPATH.'todoist',    // Todoist integration
    // 'unittest'   => MODPATH.'unittest',   // Unit testing
    // 'codebench'  => MODPATH.'codebench',  // Benchmarking tool
    ));

目录结构

douban
  +--- classes
         +--- controller               # 豆瓣样例
         +--- douban                   # Douban API Package
                +--- api               # Douban API
                +--- core.php          # Douban Core
                +--- oauth.php         # Douban OAuth
                +--- request.php       # Douban Requset
                +--- response.php      # Douban Response
         +--- douban.php               # Douban API Class
  +--- config
         +--- douban.php               # 豆瓣 API 配置文件
         +--- user_agents.php          # 奉送给大家一些手机 User agent 配置文件
  +--- media
         +--- images                   # 奉送给大家豆瓣 API 用到的图像
  +--- vendor
         +--- OAuth.php                # OAuth 官方推荐 PHP 库
  +--- LICENSE
  +--- README.markdown

快速上手
Douban API Package 提供一些演示用例，系统部署完毕后可以通过 http://host/demo_douban 访问。

文件路径：classes/controller/douban_demo.php

源码库：http://github.com/icyleaf/douban

祝你开发顺利！

如果任何疑问或者 Bugs 反馈，即可以在本项目中提交 Issue 或者给我发邮件：icyleaf.cn囧gmail.com （请替换 “囧” 为 @）

项目已开源: http://github.com/icyleaf/modou

豆瓣 API 测试控制台的创造灵感来源于 Facebook Developers Tools 中的 Facebook API Console， 或许大家知道，魔豆是我的另外一个豆瓣 API 应用，由于是自己封装的 Douban API（官方提供的库类要求太多，安装繁琐，这不属于我喜爱简洁，轻便的风格），每次想查看某个 API 接口返回的数据都要写一个 test 跑一下。 麻烦不说，还容易出错，于是，使用自己封装的 Douban API，借鉴 Facebook API Console 的界面和类似的功能显示，终于小有所成，其中为了实现此控制台，封包的库类经过两次大改，虽然改的很辛苦， 但从中学到了很多开发经验。

测试用户必须先进行用户验证才能进行测试，这主要是为了：

1. 避免提交查询中出现错误，并让测试者使用到全部API方法
2. 防止恶意用户利用它做二次api调用，由于测试控制台的传输很简单，提交参数即可查询。

查询方法：

1. 进行用户的登录验证
2. 选择返回的数据类型（支持官方提供的 XML 和 JSON格式）
3. 选择需要查询的API方法（这里我做了分类）
4. 如果查询的方法存在参数，会在方法下面显示。
5. 设置完毕参数后，点击“调用此方法”，稍等片刻即可。

返回的数据结果会在右侧显示出来，其中，右上部分是调用相关 API 的 URL 地址；右下部分是返回的数据结果。

如果，参数设置错误，或者其他问题，返回的结果会以 [CODE] Content 的格式返回，其中 CODE 代码返回的状态码， Content 是返回的信息。

通用参数解释：

• id  – 查询方法涉及到的 id 值（人，书影音，日记，广播，豆邮，同城等）
• message – 广播发送的内容
• title – 日记，豆邮的标题
• content – 主题内容
• city – 同城活动的城市代号（根据我判断，应该是中文的拼音，详细请看官方同城列表中各个城市的url）
• query – 搜索的关键字
• index – 返回多个元素时，起始元素的下标（相当于豆瓣 api 文档中的start-index）
• max – 返回多个entry时，每页最多的结果数（相当于豆瓣 api 文档中的max-results）

其中某些方法（涉及到自身的数据，比如我的信息，我的广播，我的同城）在进行查询的时候可以把 id 留空或者设置为 ‘me’ （不带引号），这样调用结果显示的是自己的信息。

如果长时间(大于1分钟)处于“调用中”，可能是由于程序问题，请刷新后重试。

已知存在的问题：

1. 界面和方法列表在 Chrome 浏览器有不兼容的问题出现
2. 返回数据结果头一行多出一个类似水平制表符的转义符似的

由于目前为止豆瓣 API 还没有封装完成，现只提供用户，广播，书影音，豆邮和日记的不完全功能测试查询。 其余的 API 会尽快添加进去

测试地址：http://ews.im/douban_console