INSTALL

nForum 安装说明
======================================================

环境需求
--------------------------
KBS BBS
获取方法: 
    svn co http://svn.kcn.cn/repos/kbs/trunk/kbs_bbs

PHP 5.2+
获取方法: 
    http://www.php.net/downloads.php

Cakephp 1.2.7
获取方法:
    git clone http://github.com/cakephp/cakephp.git
    cd cakephp
    git checkout 1.2.7
或者
    wget -q http://github.com/cakephp/cakephp/tarball/1.2.7

Smarty 2.x+
获取方法:
    http://www.smarty.net/download  
    

nForum 目录结构
--------------------------
nForum/
    |-- INSTALL             安装说明
    |-- README              项目说明
    |-- app
        |-- app_controller.php  
        |-- app_error.php       
        |-- config              配置文件
        |-- controllers         控制器
        |-- index.php           
        |-- plugins             插件    
        |-- tmp                 临时文件
        |-- vendors             库文件
        |-- views               视图
        `-- www                 web目录
    |-- install.sh          安装脚本
    |-- patch               补丁文件
    `-- sql                 数据库文件


安装步骤
--------------------------

1.将Cakephp解压缩，把源码中的cake目录(cake核心库)复制到nForum源码根目录下，进入到nForum目录运行
    chmod +x install.sh
    ./install.sh cake
nForum会在Cakephp上打上一些必要的补丁。在编译前，请在site.h中加上以下宏定义用以启用kbs中nForum的功能:
    #define NFORUM 1    
如果已经安装KBS，请添加宏定义后重新编译安装KBS的PHP模块。

2.安装KBS，Apache，PHP，MYSQL。有关KBS的详细安装步骤请参见http://trac.kcn.cn/kbs/wiki/Installation。安装Apache时请附加mod_rewrite模块。安装PHP时请附加GD库(--with-gd)，pdo-mysql(--with-pdo-mysql=PATH)，exif库(--enable-exif)。

3.将Smarty所在的目录加入php.ini的include_path中。修改cake/console/cake.php文件581行的CURRENTFILE的值，将其改成cake.php文件所在的绝对路径(路径不要包含符号连接)。将php，cake.php所在的目录加入到环境变量PATH中，使得可以直接运行php和cake命令。

4.配置目录nForum支持mod_rewrite，Apache配置如下
    <Directory "/path/to/nForum">
        AllowOverride All 
    </Directory>

5.进入nForum/app/config目录，将nforum.php.example重命名为nforum.php
    $config['user']['face']['dir']默认设置为uploadFace，即wForum所用的头像目录。如果已使用wForum,请在app/www目录下做一个uploadFace的符号链接。
    将nForum/sql中的数据库文件导入进mysql，并配置$config['db']中的值。
详细配置说明请参见此文件注释。