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

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

更新日志

　　2015年1月10日更新lnmp安装脚本，兼容最新centos7以上系统，原网盘地址

源码地址

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/1pJwnHn9 密码：sa9h

将包放到/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.so

DATABASE        = sword_user

DESCRIPTION     = MySQL ODBC 5.3 Ansi Driver test

SERVER          = localhost

UID             = root

PASSWORD        =

SOCKET          = 

[sword_character]

Driver          = /usr/local/lib/mysqlodbc/libmyodbc5a.so

DATABASE        = sword_character

DESCRIPTION     = MySQL ODBC 5.3 Ansi Driver test

SERVER          = localhost

UID             = root

PASSWORD        =

SOCKET          =

编译框架

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

1、编译依赖

cd ~/work/plainframework1/pf/dependencies/lua/ #lua

cmake ./

make

cd ~/work/plainframework1/pf/dependencies/iconv/ #iconv

cmake ./

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=localhost

DBPort=3306

DBConnectionOrDBName=sword_user; 连接或数据库名称

DBUser=root

DBPassword=mysql

DBConnectorType=0; 连接类型 0 odbc,  1 mysql, 2 sqlserver, 3 mongodb（现在只实现了ODBC）

EncryptDBPassword=0; 是否加密了数据库密码

NetListenIP=127.0.0.1; 网络监听IP

NetListenPort=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）。

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