上次介绍了一下plain framework的基础相关资料，今天该框架正式开源发布。项目的地址托管于github上，我相信大多数朋友都应该知道。今天要介绍的是该框架的目录基本结构，以及分别在linux以及windows平台上安装的例子。为了让初学或者技术不是太扎实的朋友也能快速上手，我在这里一步步从开发环境的搭建讲述到第一个比较完整的示例（网关服务器），每一步都是今日从空白的系统开始及时操作，由简入深，如果大家不太明白请到交流群询问。（新的系统centos7.0及以上我的脚本暂时无法通过环境安装）

源码地址

  https://github.com/viticm/plainframework1

目录结构

框架基本介绍

  地址：http://www.cnblogs.com/lianyue/p/3972492.html

参考手册

  参考手册正在编写过程中，会第一时间先同步到博客上，由于这些文章可能上不了首页，感兴趣的朋友不妨关注博客。

持续更新

  如果框架发现了新的BUG或者有内容更新，将会持续同步到github项目上。

LINUX INSTALL

  本次选用的linux系统为centos（6.5），你可以尝试其他linux系统也可。安装好linux系统，或者已经存在linux系统的情况下，那么我们开始搭建lnmp环境（web开发环境）。你可以在网络上去寻找相关的资料，或者使用我提供的脚本进行安装，不过php版本最好为5.4以上版本，这是为以后扩展预留。

  首先你要确保你的系统中安装了git，如果没有安装请用以下命令安装（需联网）：

yum -y install git

其次将框架源码安装到你的开发目录中，如：

cd ~ && mkdir work #进入用户主目录，并创建工作目录cd work && git clone https://github.com/viticm/plainframework1

  1、使用框架内的脚本进行在线安装（必须使用root权限安装）

cd plainframework1/tools/script/linux/install/ && sudo sh install_web_develop.sh

  2、使用提供的离线包及脚本进行离线安装（必须使用root权限，没有网络的需注意以下说明）

    可以到百度云盘去取该离线安装包：链接：http://pan.baidu.com/s/1eQzQMem 密码：bycv

    将包放到/web目录下并解压，命令如下：

mkdir -p /web && cd /web && tar -xjvf web.tar.bz2

    如果没有网络的情况下，你保证了安装gcc、g++、cmake等必要的工具之后，设置脚本install_web_develop.sh的cDownload=on参数为off。

    运行脚本进行安装（大约30~50分钟）：

sh install_web_develop.sh #运行脚本

    安装成功截图：

    安装成功后，再安装框架的开发环境（使用root安装）：

cd tools/script/linux/install/ && sh install_environment.sh --full

   开发环境成功截图：

  创建用户数据库（网关服务器用）：

cd ~/work/plainframework1/tools/script/sql/ #进入脚本目录mysql -uroot -pmysql #进入mysql命令行mysql> CREATE DATABASE sword_user DEFAULT CHARSET UTF8; //创建数据库mysql> source sword_user.sql; //执行脚本

  配置数据源：

vim /etc/odbc.ini #编辑配置文件

  最终的配置如下，其实可以不更改：

[sword_user]Driver          = /usr/local/lib/mysqlodbc/libmyodbc5a.soDATABASE        = sword_userDESCRIPTION     = MySQL ODBC 5.3 Ansi Driver testSERVER          = localhostUID             = rootPASSWORD        = SOCKET          = [sword_character]Driver          = /usr/local/lib/mysqlodbc/libmyodbc5a.soDATABASE        = sword_characterDESCRIPTION     = MySQL ODBC 5.3 Ansi Driver testSERVER          = localhostUID             = rootPASSWORD        = SOCKET          = 

编译框架

  框架使用了cmake等工具编译，如果你使用了我提供的脚本那么编译环境可以不用自己配置。

  1、编译依赖

cd ~/work/plainframework1/pf/dependencies/lua/ #luacmake ./makecd ~/work/plainframework1/pf/dependencies/iconv/ #iconvcmake ./make

  2、编译框架核心

cd ~/work/plainframework1/pf/core/cmake ./make

编译完整示例

  完整示例中提供了一个网关服务器，其中用到了网络、数据库等核心接口。

cd ~/work/plainframework1/applications/gateway/cmake ./make

运行示例

  1、拷贝运行库

cd ~/work/plainframework1/applications/bin/cp ~/work/plainframework1/pf/dependencies/dll/lib*.so ./cp ~/work/plainframework1/pf/core/dll/libpf_core.so ./

  2、配置文件

cd ~/work/plainframework1/applications/bin/vim config/gateway_info.ini

[System]DBIP=localhostDBPort=3306DBConnectionOrDBName=sword_user; 连接或数据库名称DBUser=rootDBPassword=mysqlDBConnectorType=0; 连接类型 0 odbc,  1 mysql, 2 sqlserver, 3 mongodb（现在只实现了ODBC）EncryptDBPassword=0; 是否加密了数据库密码NetListenIP=127.0.0.1; 网络监听IPNetListenPort=12680; 网络监听端口NetConnectionMax=10240; 最大支持的网络连接数量

  3、运行

cd ~/work/plainframework1/applications/bin/./gateway

RESULT:

WINDOWS INSTALL

  在windows上安装开发环境就相对比较容易了，因为不是使用源码编译安装的。我在这里使用的是wamp作为web开发环境，而odbc则是使用系统自带的odbc32位，如果你的机器不是64位的则没有关系。如果你想将框架和应用编译为64位则使用64位的ODBC，至于原因我就不解释了。

源码下载

  如果用github朋友比较多的可以使用github的客户端，打开源码连接后：

PHP环境变量设置

  将PHP的执行文件的路径设置到你的环境变量中，为了运行框架中的一些脚本，比较重要。

编译框架

  由于vs编译时对重复的文件名则不能正确的链接到目标中，而框架中则存在了许多重复的文件名，所以这里使用到了为windows编译的工具。

  路径: tools\script\bat\rename_forvsbuild.bat

  双击打开，然后输入选项如下：

回车等待工具执行完成：

  进入pf\core\scripts打开工程pf_core.vc9.sln进行编译（目前只支持release编译），当然你可以将此工程转换为vs的其他版本。

编译例子

  同编译框架一样，例子的编译也需要重写项目文件。

  打开tools\script\bat\rename_forvsbuild.bat

  revert to standard是否还原为标准的，不用输入，直接回车，第二次执行该操作时工程将自动还原。

  打开工程文件applications\gateway\scripts\gateway.vc9.sln进行编译。

安装mysql的odbc driver

  地址为：http://dev.mysql.com/downloads/connector/odbc/ 版本3.5以上的即可

创建数据库

  创建名为sword_user的数据库，编码设置为odbc，并在该数据库下执行脚本tools\script\sql\sword_user.sql。

配置ODBC

  由于我使用的是32位的应用，所以使用32位的ODBC，如图：

  添加你的mysql连接信息如下，连接名为sword_user：

运行示例

  拷贝依赖和框架的动态库到applications\bin目录下。

  依赖动态库：pf\dependencies\dll\Release

  框架动态库：pf\core\dll\Release

  保证mysql和数据库成功的前提下运行gateway.exe

RESULT

 成员招募（长期有效）

  如果你也对开源知识比较感兴趣，如果也对网络应用或者网络游戏感兴趣，如果你也对该框架感兴趣，你可以加入我们的QQ群（348477824）。

  欢迎大家进群相互交流学习，同时也欢迎各位朋友对该框架供出自己的一份心力。

plain framework 1 一款主要用于网络（游戏）开发的C/C++框架 安装篇