Douban API Package 发布!

Douban API Package 是一个使用 PHP 开发且基于 Kohana v3 开发的一个扩展(Module)。

它对豆瓣 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 (请替换 “囧” 为 @)

icyleaf

热爱户外的码农、下厨初心者

Beijing, China http://icyleaf.com