1. 安装 MySQL

sudo apt-get install mysql-server mysql-client

安装过程在会提示设置 root 账户的密码，如果是本机测试开发可以留空后稍候设置。

2. 安装 Nginx

# 安装 Nginx
sudo apt-get install nginx
# 启动 Nginx
sudo /etc/init.d/nginx start

完成上面两步之后，打开浏览器，输入 localhost 或 127.0.0.1 如果看到 Welcome to Nginx! 字样就说明安装成功了，是不是很简单

注意，如果你的机器上面如果安装了其他 web 容器（比如 Apache，Lighttd等），启动 ngnix 的时候肯定会报错，因为这些 web 容器启动均占用的 80 端口，更改的方法如下：
编辑 /etc/nginx/sites-available/default 文件，修改 server 段中的 listen 为 localhost:8080，其中 8080 是更改的监听端口：

server {
	listen   localhost:8080;
	server_name  localhost;

# [...]

保存后重启Nginx：

sudo /etc/init.d/nginx restart

3. 安装 PHP5

PHP 在 Nginx 下是通过 FastCGI 模式运行的，使用 Debain 的包管理可以安装 PHP5 和一些必须的（比如，php5-mysql）和可选的扩展（比如，Kohana 要求的 php5-curl，php5-gd，php5-mcrypt），下面前 5 个是必须的，其他可以依据个人需求添加或减少：

sudo apt-get install php5-cgi php5-mysql php5-curl php5-gd php5-mcrypt php5-idn php-pear php5-imagick php5-imap php5-memcache php5-mhash php5-ming php5-pspell php5-recode php5-snmp php5-tidy php5-xmlrpc php5-xsl

安装完毕后，需要编辑 php 的配置：

# 编辑 /etc/php5/cgi/php.ini 文件
# 修改 cgi.fix_pathinfo 的值为 1（如果此项被注解掉了，请删除前面的 # 符号）
cgi.fix_pathinfo = 1

至此 PHP5 已经安装完毕，但是还没有结束，因为我们还没有让它支持 FastCGI 嗯，由于 Debain 包并没有提供单独的 FastCGI 守护程序，因此我们可以使用其他的方式实现，通常使用的是 lighttpd 项目提供的 spawn-fcgi（本文也用的这个，但是它总会出现小毛病，导致 Nginx 服务 Down 掉，稍候也会给出一点解决方案）或者是 PHP-FPM（专门为 PHP 提供 FastCGI 进程管理的软件）

好吧，让我们在安装 lighttpd：

sudo apt-get install lighttpd

安装完毕后会你发现一些错误信息：

Starting web server: lighttpd
2010-05-31 10:44:51: (network.c.300) can’t bind to port: 80 Address already in use failed!

还是上面提到的重复占用端口的问题，不过由于我们只是使用它的 spawn-fcgi 因此我们可以不让它当作服务启动：

sudo update-rc.d -f lighttpd remove

好了，让我们开启 FastCGI 守护进程：

/usr/bin/spawn-fcgi -a 127.0.0.1 -p 9000 -u www-data -g www-data -f /usr/bin/php5-cgi -P /var/run/fastcgi-php.pid

其中 -a 代表 ip 地址， -p 是进程的端口， -u 是用户， -g 是用户组，-f 是 php5-cgi 的执行路径，-P 是进程的 pid，可以适当的在后面在加一个 -C 参数，这个数创建的进程数，本机开发的话一般设置在 3 – 5 左右即可（也可以使用 ab 测试以设置适当的进程数，这样可以防止 Nginx 的无辜 Down 掉）

提示：spawn-fcgi 必须在运行的状况下才能使得 Nginx 支持 PHP 运行，因此可以把上面的启动代码追加到 /etc/rc.local 文件的尾部保存（在 exit 命令之前）。

4. 配置 Nginx

Nginx 的配置相对比较简单，语法很像 PHP 代码，如果不了解的可以参考这个：范例1和范例2
编辑 /etc/nginx/nginx.conf 文件并作如下修改：

[...]
worker_processes  5;
[...]
    keepalive_timeout   2;
[...]

定义虚拟主机的配置项存放在 /etc/nginx/conf.d/ 目录下面，每个虚拟主机配置一个文件并以 .conf 为文件后缀即可，默认是 default，也就是上面修改 Nginx 默认监听端口的文件，这里还要进一步对它配（点击右侧展开）：

[...]
server {
        listen   80;
        server_name  _;

        access_log  /var/log/nginx/localhost.access.log;

        location / {
                root   /var/www/nginx-default;
                index  index.php index.html index.htm;
        }

        location /doc {
                root   /usr/share;
                autoindex on;
                allow 127.0.0.1;
                deny all;
        }

        location /images {
                root   /usr/share;
                autoindex on;
        }

        #error_page  404  /404.html;

        # redirect server error pages to the static page /50x.html
        #
        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
                root   /var/www/nginx-default;
        }

        # proxy the PHP scripts to Apache listening on 127.0.0.1:80
        #
        #location ~ \.php$ {
                #proxy_pass   http://127.0.0.1;
        #}

        # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
        #
        location ~ \.php$ {
                fastcgi_pass   127.0.0.1:9000;
                fastcgi_index  index.php;
                fastcgi_param  SCRIPT_FILENAME  /var/www/nginx-default$fastcgi_script_name;
                include        fastcgi_params;
        }

        # deny access to .htaccess files, if Apache's document root
        # concurs with nginx's one
        #
        location ~ /\.ht {
                deny  all;
        }
}
[...]

说明下里面的个别参数：
server_name 是虚拟主机的服务器入口名称，可以是 IP 也可以是域名。
location 段，我在 index 追加了 index.php， root 路径是 /var/www/nginx-default 说明该虚拟主机的根目录在这里。
最重要的是关于 PHP 部分的 location 段：~ \.php$ {} ，Nginx 默认没有开启，我们要确保它开启并在 fastcgi_param 一行更改了参数（因为浏览器调用的默认 PHP 解析器无法找到 PHP 脚本）：

fastcgi_param SCRIPT_FILENAME /var/www/nginx-default$fastcgi_script_name;

最后确保在 include 和 fastcgi_params 之间隔出几个空格（BUG）

重启 Nginx，然后编辑一个 info.php 文件：

// 创建 /var/www/nginx-default/info.php 文件

保存后在浏览器访问（比如：http://localhost/info.php 或 http://localhost:8080/info.php)，如看到 phpinfo 的参数页面说明配置安装成功

5. 安装&配置 Kohana

Kohana 采用的 v3 版本，安装步骤（本文把 kohana 存放在 /home/icyleaf/php/kohana 目录）
添加 Nginx 虚拟主机配置文件：

# 创建 /etc/nginx/conf.d/kohana.conf 文件
server {
	listen   kohana.local:8080;
	server_name  kohana.local;
	access_log  /var/log/nginx/kohana.access.log;

	# define server root path
	set $root_path /home/icyleaf/php/kohana;

	location / {
		root   $root_path;
		index  index.php index.html index.htm;

		if (!-e $request_filename) {
		    rewrite ^/(.*)$ /index.php?kohana_uri=/$1 last;
		}
	}

	# pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
	#
	location ~ \.php$ {
		root   $root_path;
		fastcgi_pass   127.0.0.1:9000;
		fastcgi_index  index.php;
		fastcgi_param  SCRIPT_FILENAME  $root_path$fastcgi_script_name;
		include fastcgi_params;
	}
}

配置中首先定义了一个变量 $root_path 指定 Kohana 的源码的路径，对于 Kohana 的 URL rewrite url 重点是 location 段的：

if (!-e $request_filename) {
	rewrite ^/(.*)$ /index.php?kohana_uri=/$1 last;
}

编辑完成后重载 Nginx 配置：

sudo /etc/init.d/nginx reload

至此教程结束，额外说明的是 Kohana 默认的 .htaccess 对 Nginx 无效可有可无

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

更新：Kohana 官方已经做出最终裁决！

两天前我(Shadowhand)曾经说过关于 2.4 和 3.0 版本的问题和它们之间的关系已经做出的解答。之后的今天和其他开发者见面（with more of the devs），这似乎是错误的。所以长话短说，我们现在有两个选择：

1. 我们在一个月内分别发布 2.4 和 3.0。 2.4 将会经可能的兼容 2.3.x 版本但是其中 Database 和 i18n 是全新的不同于 2.3 的系统。 3.0 也将不同于 2.4 的 Database，但是 i18n 系统还是和 2.4 一致。

2. 完全抛弃 2.4 而专攻 3.0 版本，它将会有一个全新的类似 2.4 版本的 Database 特性，但是语法和更多的特性稍有些不同。 3.0 在发布的同时，新的网站和用户手册也会同步完成。

2.4 和 3.0 版本大约将会在同一天发布（2009年的8月下旬或9月上旬）。两个版本都不会去兼容 2.3.4 版本。虽然升级至 2.4 版本将会少于升级至 3.0 的兼容工作。（请记住，我们从来没有建议和要求用户升级到哪个核心版本）

我本可以行使 BDFL（Benevolent Dictator For Life，代表少数开源软件开发者的领头人）权利做个强制决定，但是我觉得还是听一听社区的声音。你们认为哪个是 Kohana 在未来长期（至少 6 个月以上）开发基础的最好选择呢?

更新： 选择第二项，将会抛弃 2.3.x 版本公开发布的版本修复

——–
原文：Official 2.3, 2.4, 3.0 Decisions – We need your feedback!

———我是华丽的分割线————–

KO3 RC1 目前已经发布，详情请看这里，希望大家喜欢 Kohana，关注 Kohana，使用 Kohana 的朋友留下你的看法，这对Kohana自身和社区用户都是有益的！

——–关于 E-TextEditor  的分割线—————

今天前去 Textmate clone 的软件 Intype论坛瞅了一眼，惊奇的发现同样是 Textmate clone 的 E-TextEditor 居然在今年3月份宣布开源，而5月份就在 Github 放出了源码！而且声称会开发 Linux 版本并且弘扬 Linux 的精神，Linux 版本统统免费！详情请看 Intype 论坛

而且已经有Linux用户编译运行了 E-TextEditor 详情请看：Building the E text editor on Fedora 10

不知道身为 Textmate clone 的 Intype 会做何打算，它们目前正在全力开发新的版本（貌似内核和界面全部重新），拭目以待！