You are here

api.drupal.org

g089h515r806 的头像
Submitted by g089h515r806 on 星期四, 2008-09-18 09:09

http://api.drupal.org/

Drupal官方API文档站点http://api.drupal.org/。在用drupal进行定制开发时,经常到这里逛,现在好长时间不去了。对于初学者特别是那些需要对drupal进行定制的人,要经常地到这个站点逛逛。尽管文档是英文的,但是总比没有的好。

 

      首先,你应该知道为什么要来到这个站点,比如说,你遇到了一个drupal函数drupal_get_form(),想进一步了解它的用法的时候,你就可以访问http://api.drupal.org

 

        来到这里以后,你会在横幅里面看到3个导航,后两个是导航到drupal主站上去的,前一个是让你报告文档bug的,实际上,这3个链接都没用。左上角是一个搜索框,这个有用,刚才我们不是说,你要查找drupal_get_form()的用法么,你可以把drupal_get_form输入到里面,点击Search(搜索)按钮,这样你就进入了另一个页面:http://api.drupal.org/api/function/drupal_get_form/6,你就可以看到这个函数在drupal6下面的文档了,包含函数定义,描述,参数,返回类型,以及代码等等信息。点击顶部的“List references”,你可以看到哪些drupal函数调用了这个函数,以及这个函数调用了哪些其它drupal函数。点击顶部的“View documentation”,你将返回刚才的页面。对于一个drupal函数,api站点中的内容类型基本上是一样的。点击顶部的“Drupal 5”标签,你将看到这个函数在drupal 5中的文档。一般会显示“drupal4.7”,“drupal5”,“drupal6”,“drupal7”四个标签,分别进入这个函数在不同版本下的定义,但是有时候,也有例外,比如 custom_url_rewrite_inbound,这个函数是在drupal6中新加的,那么当你搜索这个函数的时候,就不会在顶部看到“drupal4.7”,“drupal5”这样的标签链接了。

 

      现在,让我们分析一个这个URL: api/function/drupal_get_form/6,共分为4部分,api,function,这两个是不变的,drupal_get_form是你的函数名,6则是drupal的版本号。我们搜索drupal_get_form,直接进入api/function/drupal_get_form/6,为什么不是api/function/drupal_get_form/5呢,因为drupal6是当前推荐使用的版本,已经相当稳定了,所以把你直接带入到6.x中来了。

 

      现在让我们回到drupal API站点的首页,你将会在主内容区域里面,看到3部分:Components of Drupal(Drupal组件),Example modules(模块例子),In-depth discussions(深度讨论)。“Drupal组件”实际上是一个导航,逐步地把你带入到drupal内核组件里面的各个方法中去。“模块例子”则给出了一些模块代码实例,帮你学习,如何编写模块代码,这部分作的比较简陋。“深度讨论”里面有不少好的东东,建议大家有空去读读。这些文章比较有深度,都是drupal高手中的高手写成的。

 

     如果你是搞drupal开发的,那么就到http://api.drupal.org/逛逛吧。

相关链接: http://www.thinkindrupal.com