Log in

Douban API Package 发布!

Filed under: Kohana, 网络开发 by icyleaf on January 8, 2010.

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 (请替换 "囧" 为 @)

2009年度总结

Filed under: 生活记录 by icyleaf on January 1, 2010.

忙碌了一天下来,刚打开电脑看着 twitter 刷出来的消息发觉已经到了 2010 年。回顾去年的那篇年度总结感受颇多,年度总结这玩意对于自己来说算是一次思维的整理和归档。就算度过了没有硬性计划的 2009 年总结还是多少要写一些。

回顾整个 2009 年做的事情,发现其中一些持续的事情是在完善 2008 年度的计划:

  1. 通过维护一个 PHP5 的轻量级开源框架 Kohana 的中文化社区,开始深层次的了解和读懂一个框架的逻辑和模式;通过参加一年的 OpernParty 开源社区的活动,(不完全)吸收了很多新鲜养分。
  2. 成立 Kohana 中文社区已经有一年多的时间也经历了很多:成功完成了对其中文文档的翻译工作;不断向社区提交和共享代码。然而对于社区的运营也感受颇多,虽然过程是辛苦的,但是我很欣慰。同时还得感谢非正常非人类,e6nian,Codeigniter中国老大 Hex,daqing 对 Kohana 和我的支持!
  3. 2009年读了一些各种各样的书,这些书都是我以前几乎没有涉及过的种类。其中一大部分(感谢 CNBorn 的推荐)得益于公司搬家,使得上下班几乎有两个小时的闲余时间,很多书籍都是在这段时间消灭的。以后还会继续读更多值得看的书,书再多还是不嫌多的。
  4. 2009年度入手了三个数码产品:iPod Touch ,Canon 450D 和 DELL 2209WA。 正式成为 Apple 使用用户和摄影爱好者。
  5. 2008年的那些项目都难产掉了,2009年又有一些项目脚踏实地的进行着:

    • 魔豆:一个用于移动终端,手持设备的非官方版豆瓣网移动版本。
    • 豆瓣 API控制台:魔豆附属项目,开发豆瓣 API 的辅助工具,仅适用于 Firefox。
    • Aplaca:一个轻量级的基于 Kohana v3 开发的论坛系统(目前已上线,因为在开发中暂无发布)。
    • Douban API Package:这是一个重构版本,最近一直在测试和写测试用例,近期会以开源协议的形式发布。
  6. 新疆出差游:得益于 090705 事件造成那个地区封锁了网络,又因公司项目的事情前去出差,第一次坐灰机,第一次跑那么远的地方。详情请参见系列游记
  7. 随着寻找各种北京美食,加上工作的性质,对于运动少了许多,今年之中抽出了不少的周末参与到户外运动之中,即活动了筋骨,也提高了身体机能,还能认识很多驴友和漂亮的风景何乐而不为呢。

总结完毕发现今年的日志数量急剧下降,或许以后的年度日志数量也会在这个数量左右徘徊,随着时间的推移,心智愈加成熟(自我感觉),心要慢慢的静下来(不能在浮躁了)深层次的学习一些技能,继续英语的学习和适当的户外运动,可能的话计划去某个地方游玩。再有就是不能把 2009年的最大的遗憾留在今年,继续加油!

亚心随笔之五

Filed under: 生活记录 by icyleaf on November 26, 2009.

新疆乌市暴走路线图

11月02日以后,基本上工作就忙完了,于是 04 日我准备一次暴走扫街,活动地点是市中心,人民广场附近以及红山公园南邻的人民公园。去那边坐的还是前往二道桥大巴扎的公交车,嗯,看来是热点线路,怪不 得人那么的多。在上面的随笔我应该说过乌市是一个很现代化的城市,整个乌市和其他大城市没什么太大的差别,也就有一个区域是维族居住生活区。所以来到了人 民广场对于周围的环境一点都不陌生,到处高楼大厦,商场一座座,虽然天有点凉,但是人很是很多,一点也看不出来那天是星期三,我直接避开了繁华的路段,转 走些小巷细路的。也没发现太多的东西,嗯,可能这附近还是太大众化了,而且还有王府井...偶尔会有些卖囊的和大面积的买葡萄干之类的干活摊位。

囊

干货摊

See more about this post

亚心随笔之四

Filed under: 生活记录 by icyleaf on November 24, 2009.

就在清真寺旁边有一道短街有好几家当地的新疆维族饭馆,来回转了几圈,看看这家看看那家犹豫不定,不知道是吃手抓饭好呢,还是烤串,烤馕这些的好,突然看见有家是在外面放的一个大锅,一边架子放着带肉的羊骨头,锅里是翻滚的红红的汤,看着新鲜和卖家比划了几下,说要一碗尝尝(汉语也不是很熟练),然后进了里屋,哇,里面坐满了维族人,操着维语不知道在谈论些什么。然而他们的目光大多投向了手持相机的我,心里有些胆怯,找了一个小角落坐了下面重新打量四周,内部也是常见的清真的建筑风格,看来我来到店家还挺不错,而且价格也非常的便宜。不一会一份看着不咋地的饭端了上来,嗯,这应该是囊包肉,看来也不想其他非新疆城市做的那么好看,里面有南瓜,囊,和羊骨头肉,不过还不赖,汤浓肉劲,一会功夫一碗就被我消灭掉了。噢!差点忘记交代,本来想要一份酸奶的,可惜卖家告诉我这个只有早上才有的,但是我在其他地方吃过,味道和乌鲁木齐驻京办事处的差不多,只不过盛酸奶的容器和勺子并没那么精致。

囊包肉

最后给大家看一下这家位处国际市集大巴扎旁边饭馆的菜单价格:
See more about this post

亚心随笔之三

Filed under: 生活记录 by icyleaf on November 20, 2009.

幸好我们的客户是中国移动,人家休息了我们也可以放松一下。 10 月 31 日(星期六),我耐不住性子抓上相机勇敢的出门了。出门前还是到酒店的前台确认了一下外出是否有生命危险,呃,比较没经历过嘛...买了一份带有 公交路线的地图,前往了今天的第一站,乌市最有特色的维族区市集--大巴扎。

大巴扎位于城中心偏南的二道桥,其中“巴扎”在维语里就是集市的意思,它是新疆商业与旅游繁荣的象征,也是乌鲁木齐作为少数民族城市的景观建筑,又是一座标志性建筑。国际大巴扎具有浓郁的伊斯兰建筑风格,在涵盖了建筑的功能性和时代感的基础上,重现了古丝绸之路的繁华,集中体现了浓郁西域民族特色和地域文化(以上文字描述摘自网络)。

这边的公交车也很有特色,也是汉语和维语分别报站和提醒,我还特意录了一段,去大巴扎方向的人非常的多,所以车上人很挤,最初我还是非常小心的自己的贵重物品,和以防扎针事件的发生...不过到后来坐多了,也不顾及那么多了,因为实际上并没有想象中的那么可怕。到了大巴扎后,第一反应是环顾四周不停的看:熙熙攘攘的街道上 全是维族人,感觉就像到达了另个一个国家,一切是那么新鲜。这边分为二道桥市场和新疆国际大巴扎两个部分,既然冲着大巴扎来的,那就先逛它吧,大巴扎是又 一个典型化的商业区,有些类似北京的大栅栏,崭新的建筑就像是北京的老胡同扒倒重新再盖一样的,整个集市分了好些区域,大多数都是吸引外地游客前来购买新疆特色。

Download新疆公交车提示音

See more about this post